RFCRestyle

Control the aesthetics and improve the navigability of HTML IETF RFC documents. Optional automatic redirects from TXT docs.

IMPORTANT NOTICE: THIS EXTENSION WILL NO LONGER BE UPDATED. TL;DR: I can't be bothered. The IETF continuously alter their delivery of RFCs (URLs and content), and every time, this extension needs to be altered to account for those changes. Some functionality is already lost/broken and, as time goes on, I expect incremental loss/breakage of functionality until, at some point in the future, it will cease to function entirely. I built the first draft of this extension nearly a decade ago and have updated and improved it many, many times since, but actually hardly ever need it myself. The average approximate user base for years has hovered around 1000, so although that's 1000 people who'll experience minor inconvenience, it's hardly the end of the world. Feel free to take the copyleft open source code and build your own from it, or something. ___________ This extension will be initiated when viewing a selection of ietf.org and rfc-editor.org pages. Although its primary purpose is to restyle HTML RFCs in accordance with the user's preferences, it will also: • Read HTML RFC pages and, from what it finds, create a Table of Contents (ToC) containing links to all page sections and place it in a fixed position at the top-right corner of the window. It's accessible by click, tap or the accesskey "T". • Unearths a color coded legend present in all HTML RFC pages to make it more accessible by the addition of some new HTML, styling, and scripting. Its accesskey is "L" and can also be accessed with a click or tap. • Optionally (disabled by default) automatically redirect from plain text RFCs to their HTML versions. The restyling is mostly color oriented but includes: • Optional (enabled by default) hiding of chunks of white space and "page separators" featured as headers and footers when printing the documents. • An adjustable (from none to shampooed-and-blow-dried-puppy) fuzzy border around the text content to reduce tunnel vision when reading long documents. OPTIONS: • Left clicking the RFCRestyle extension icon will usher forth the options pop-up. This pop-up includes all the controls for setting the options using native Chrome form inputs. Changes to the options are saved automatically. • Up to 5 separate, fully customisable profiles, each with its own unique settings, may be stored for immediate access. The last used profile will be used when next visiting an RFC or Draft. Changes made to the settings of one profile will not affect the settings in other profiles. • Settings can be optionally (disabled by default) set to "sync" across all instances of Chrome the user is logged in to (if the user also has Chrome's sync enabled). Unlike all other settings, this is a global option that affects every profile; it's all-or-nothing! When unchecking the option, synced data will be cleared but the henceforth unsynchronised profiles will remain stored on the local machines previously synced. · Learn more about Chrome sync: https://support.google.com/chrome/answer/165139 ACCESSIBILITY: • All aspects of the extension have been built with accessibility in mind, and no features should be hard to use for anyone. Keyboard and mouse access has been well tested but touch screen access hasn't (although it should be fine). • accesskey access for the ToC and Legend ("T" and "L") is dependant on operating system. On Linux and Windows "alt+<key>" and on Mac "control+option+<key>" or "control+option+shift+<key>" should work. The implementation is in accordance with web standards, so however you normally access web-app functionality via accesskeys will be how to access the ToC and Legend on RFCs while using this extension. For more info please see: https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/accesskey NOTE REGARDING PRINTING: • Due to the multiple changes made to the styling and structure of the affected documents; before printing any document, uncheck the "Restyle" option to temporarily revert to the document's default state, then re-enable the option when finished. PRIVACY: • This extension does not collect or process any personal data or communicate its activity with any external application. Settings are stored locally or optionally synced. If the option to sync the settings to all instances of Chrome the user is logged in to is checked, the settings will be shared with other devices where the user has Chrome's sync enabled, opens Chrome and logs in to their account. OPEN SOURCE & COPYLEFT LICENSED: • The entire GNU GPL v3.0 licensed extension code and other files can be found on GitHub at https://github.com/FredGandt/RFCRestyle • Change-Log from June 8, 2013 available at GitHub