RFCRestyle

RFCRestyle插件简介

RFCRestyle插件描述

This extension will be initiated when viewing a selection of ietf.g pages.

Although its primary purpose is to restyle Drafts  RFCs in accdance with the users preferences, it will also:
• Read HTML RFC  Draft pages , from what it finds, create a Table of Contents (ToC) containing links to all page sections  place it in a fixed position at the topright cner of the window. Its accessible by click, tap  the accesskey "T" (alt+T).
• Unearths a col coded legend present in all HTML RFC pages to make it me accessible by the addition of some new HTML, styling,  scripting. Its accesskey is "L"  can also be accessed with a click  tap.
• Optionally (disabled by default) automatically redirect from plain text RFCs  Drafts to their HTML versions.
• Optionally (enabled by default) automatically redirect from BCPs to the HTML versions of the source RFCs. Where a BCP is "...a concatenation of me than one RFC", the extension will redirect the active tab  create me as needed to open all respective RFCs.
· If the option is disabled, hyperlinks will be added to the BCP to assist manual navigation to the respective RFCs.
• Create hyperlinking to RFCs  BCPs indexed  referenced in RFC  BCP indexes found at "www.ietf.g/download/rfcindex.txt"  "www.ietf.g/rfc/bcpindex.txt" respectively.

The restyling is mostly col iented but includes:
• Setting the monospace font to one of your choice from a selection of common  Google Web fonts. Due to the fmatting of ietf.g RFC  Draft docs, a monospace font is essential f legibility.
• Optional (enabled by default) hiding of chunks of white space  "page separats" featured as headers  footers when printing the documents.
• An adjustable (from none to shampooedblowdriedpuppy) fuzzy bder around the text content to reduce tunnel vision when reading long documents.

OPTIONS:
• When viewing an ietf.g plain text  HTML RFC  Draft; left clicking the RFCRestyle extension icon will usher fth the options popup. This popup includes all the controls f setting the options using native Chrome fm inputs. Changes to the options are saved automatically.
• Up to 5 separate, fully customisable profiles, each with its own unique settings, may be sted f immediate access. The last used profile will be used when next visiting an RFC  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 Chromes sync enabled). Unlike all other settings, this is a global option that affects every profile; its allnothing! When unchecking the option, synced data will be cleared but the hencefth unsynchronised profiles will remain sted on the local machines previously synced.
· Learn me about Chrome sync: https://suppt.google.com/chrome/answer/165139

NOTE REGARDING PRINTING:
• Due to the multiple changes made to the styling  structure of the affected documents; befe printing any document, uncheck the "Restyle" option to temparily revert to the documents default state, then reenable the option when finished.

ACCESSIBILITY:
• All aspects of the extension have been built with accessibility in mind,  no features should be hard to use f anyone. Keyboard  mouse access has been well tested but touch screen access hasnt (although it should be fine).

PRIVACY:
• This extension does not collect  process any personal data  communicate its activity with any external application. Settings are sted locally  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 Chromes sync enabled, opens Chrome  logs in to their account.

OPEN SOURCE & COPYLEFT LICENSED:
• The entire GNU GPL v3.0 licensed extension code  other files can be found on GitHub at https://github.com/FredGt/RFCRestyle

CHANGE LOG (latest first):
• July 24, 2019  Version 2.30
· Removed "tabs" permission statement in manifest.

• February 25, 2019  Version 2.21
· Applied what may turn out to be a tempary fix after an update to Chrome changed its hling of "get"  "set" function calls on local stage areas.
· This may be a sht lived version as another min err has also recently appeared. This err doesnt affect functionality but Id like to quell it when I find a way.

• December 27, 2018  Version 2.2
· Min layout improvement of ToC.
· Fixed inability to navigate to pages within docs from index when "continuous" is checked.

• December 17, 2018  Version 2.1.1
· Fixed a multitude of errs regarding stage  backwards compatibility of settings.
· Changed the creation of links in indexes to be done dynamically on scroll.
· Slightly altered the layout of the options popup.

• December 15, 2018  Version 2.1
· Added optional (on by default because theyre clones of "real" RFCs better viewed in their native fm) auto redirects of BCP[09]+ docs to the respective RFC(s).
· Added hyperlinking of references to RFCs  BCPs in their indexes. RFC index has > 14k links so chugs a bit. If people complain, Ill make it optional  dynamic to compensate.

• December 11, 2018  Version 2.0.8
· Fixed heading margins so they display crectly whether "continuous" is selected  not. Unftunately this required JavaScript intervention as CSS couldnt quite manage it alone.

• December 10, 2018  Version 2.0.7
· Fixed me problems with the ToC, improved its layout a little with indention to match each links descendancy  cleaned up some other code while doing that.
· Almost added a "Minimised scrollbars" option but Chrome gets it wrong until the tab is refreshed  navigated. If I can find a wkaround, Ill add the option later.
· Unless I notice something else Ive done wrong  receive inducing feedback, this should be the last update f a while :)

• December 9, 2018  Version 2.0.6
· Fixed Chrome sync issues  removed a little inefficiency along the way.

• December 6, 2018  Version 2.0.5
· Fixed Table of Contents (ToC) links.

• December 6, 2018  Version 2.0.4
· Fixed the accidental removal of an imptant space character during manual minification.

• December 6, 2018  Version 2.0.3
· Altered the processing der to cure the unsightly flash of the temparily unstyled ToC on long pages; now much smoother loading.
· Improved the minification a bit.
· Fixed a couple of min errs.

• December 5, 2018  Version 2.0.2
· A couple of little tweaks to the page CSS to fix an unusual but potential conflict of browser behaviours; to wrap  not to wrap  that is the question.

• December 4, 2018  Version 2.0.1  NOTE
· After the last update went live, I checked to ensure it was functioning crectly  was surprised by severe display errs caused by crupted CSS. ...
· Fixed in v2.1.1

• December 4, 2018  Version 2.0.1
· Realised a small err when rewriting the above notes f this version  made the change; moved a tooltip in the popup.

• December 4, 2018  Version 2.0 \o/
· This is a big update with many changes/improvements;
· Much better optimization:
· · the background page is no longer persistently active  reducing system resource usage (although, on a per session basis, if the popup is used, background.js remains activated (to be fixed)).
· Addition of the ability to ste multiple unique profiles (e.g. a dark one f night time might be nice).
· Added the option to sync the settings across all instances of Chrome the user is logged in to.
· Changed the way cols are set, from RGB sliders to HTML5 col inputs that utilise Chromes native colpicker UI.
· Made it possible to select from a list of monospace fonts.
· Made effts to improve the accessibility of the ToC  Legend.
· Managed to keep the overall size of the extension from bloating badly with all the additional options by the hard won application of extreme minification.
· As far as I can tell, this should be a smooth transition, with no user actually noticing any change in functionality unless they open the popup. As always, I check f suppt requests every day.

• July 25, 2018  Version 1.2.3.1
· Added a few CSS rules to fix the width of an element at the top of all RFCs, that on some can be wider than the rest of the text, unwelcomely pushing the whole page body of center.

• July 22, 2018  Version 1.2.3.0
· A few min improvements to the code while wking to create an unminified package to publish somewhere f opensource use.

• August 18, 2017  Version 1.2.2.0
· Bug fix; thanks to user feedback via the "suppt" tab on the webste listing :)

• May 6, 2017  Version 1.2.1.5
· Fixed inability to disable auto redirect from TXT to HTML docs.

• April 30, 2017  Version 1.2.1.0
· Updated icons, fixed an encoding issue to allow me efficient execution  thereby reduced the extension weight a bit me.

• April 28, 2017  Version 1.2.0.2
· Crected URL matching to included edge s.
· Discovered another type of document  will add functionality to hle it sometime later.

• April 27, 2017  Version 1.2.0.1
· Added optional automatic redirection from plain text RFCs  Drafts to their HTML versions.
· Further minified  optimised all the code  markup to improve perfmance  reduce "weight".
· Now only wks with secure connections (all ietf.g RFCs  Drafts are fced secure now).

• April 23, 2017  Version 1.1.0.2
· A little minification, added  crected some logic.

• April 23, 2017  Version 1.1.0.0
· Added setting to toggle  the default multipage layout,  a continuous layout with reduced whitespace  no visible page headers  footers.

• April 21, 2017  Version 1.0.5.0
· Tiny accessibility fix.

• April 20, 2017  Version 1.0.4.5
· Fixed several issues caused by resizing the font.

• April 19, 2017  Version 1.0.4.0
· Added ability to change the overall font size f the RFCs,  have various UI elements alter their size to match. Size adjusted by slider.

• April 16, 2016  Version 1.0.3.1
· Changed "offline_enabled" (in the manifest) to "false" as this is a contentious issue,  removed documentation disclaimer about the contention.

• June 28, 2015  Version 1.0.3.0
· A few changes to the CSS to compensate f changes made to the markup. Please let me know if you see anything unpleasant.

• March 9, 2015  Version 1.0.2.7
· Min CSS improvements.

• July 29, 2014  Version 1.0.2.6
· A change in the way Chrome hles "change" events triggered by "range" type inputs (the sliders) broke the desired behaviour, so Ive added an "input" listener.
· Im considering a me maj update to include a user request  generally improve the code, but it seems to be wking okay at the minute.

• April 18, 2014  Version 1.0.2.0
· Fixed insecure request f Inconsolata suppt from Google Web Fonts. Previously requested via "http://". Now requested via "https://" as it should always have been :/

• February 26, 2014  Version 1.0.1.1
· Very min change to CSS (styling) of the TOC (table of contents) heading.

• June 8, 2013  Version 1.0.1.0
· By request, changed URL matching to include drafts. Previously only acted on *://tools.ietf.g/html/rfc*. Now acts on (example) ...html/draft* AND ...html/rfc*
                                

RFCRestyle插件离线安装方法

1.首先用户点击谷歌浏览器右上角的自定义及控制按钮，在下拉框中选择设置。

2.在打开的谷歌浏览器的扩展管理器最左侧选择扩展程序或直接输入：chrome://extensions/

3.找到自己已经下载好的Chrome离线安装文件xxx.crx，然后将其从资源管理器中拖动到Chrome的扩展管理界面中，这时候用户会发现在扩展管理器的中央部分中会多出一个”拖动以安装“的插件按钮。

4.下载 RFCRestyleChrome插件v3.6.1版本到本地。

5.勾选开发者模式，点击加载已解压的扩展程序，将文件夹选择即可安装插件。

注意：最新版本的chrome浏览器直接拖放安装时会出现“程序包无效CRX-HEADER-INVALID”的报错信息，参照这篇文章即可解决