Accueil Explorer Aide
Connexion
mirrors
/
SingleFile
miroir de https://github.com/gildas-lormeau/SingleFile
1
0
Fork 0
Fichiers Tickets 0 Wiki
Aborescence: b7dcd632dc
Branches Tags
SingleFile
/
extension
/
ui
/
pages
/
help.html

help.html 43 KB
Historique Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738 
  1. <!DOCTYPE html>
    2. 

  2. <html>
    3. 

  3. 

  4. <head>
    5. 

  5. 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    6. 

  6. 	<title>SingleFile help</title>
    7. 

  7. 	<link rel="stylesheet" href="help.css">
    8. 

  8. 	<meta name="viewport" content="width=device-width,initial-scale=1">
    9. 

  9. </head>
    10. 

  10. 

  11. <body>
    12. 

  12. 	<div>
    13. 

  13. 		<div id="titleBorder">
    14. 

  14. 			<h2>SingleFile</h2>
    15. 

  15. 			<h4>Save a complete page into a single HTML file</h4>
    16. 

  16. 		</div> <span id="index"> <a href="#getting-started">Getting started</a> - <a href="#general-notes">Additional
    17. 

  17. 				notes</a> - <a href="#options">Options description</a> - <a href="#annotation-editor">Annotation
    18. 

  18. 				editor</a> - <a href="#notes">Technical notes</a> - <a href="#template-variables">Template variables</a>
    19. 

  19. 			- <a href="#known-issues">Known issues</a> - <a href="#unknown-issues">Troubleshooting unknown issues</a> -
    20. 

  20. 			<a href="#contributors">Contributors</a> </span>
    21. 

  21. 		<hr>
    22. 

  22. 		<ol>
    23. 

  23. 			<li><a id="getting-started">Getting started</a>
    24. 

  24. 				<ul>
    25. 

  25. 					<li>Wait until the page is fully loaded.</li>
    26. 

  26. 					<li>Click on the SingleFile button <img src="../resources/icon_16.png" class="icon"> in the
    27. 

  27. 						extension toolbar to process and save the page.</li>
    28. 

  28. 					<li>You can click again on the button to cancel the action when processing a page.</li>
    29. 

  29. 				</ul>
    30. 

  30. 			</li>
    31. 

  31. 			<li><a id="general-notes">Additional notes</a>
    32. 

  32. 				<ul>
    33. 

  33. 					<li>To save multiple tabs, select them first and click on the SingleFile button <img
    34. 

  34. 							src="../resources/icon_16.png" class="icon">.</li>
    35. 

  35. 					<li>Open the context menu by right-clicking the SingleFile button <img
    36. 

  36. 							src="../resources/icon_16.png" class="icon"> in the extension toolbar or on the webpage. It
    37. 

  37. 						allows you to save: <ul>
    38. 

  38. 							<li>the current tab,</li>
    39. 

  39. 							<li>or the selected content,</li>
    40. 

  40. 							<li>or the selected frame.</li>
    41. 

  41. 						</ul>
    42. 

  42. 					</li>
    43. 

  43. 					<li>You can also process multiple tabs in one click and save: <ul>
    44. 

  44. 							<li>the selected tabs,</li>
    45. 

  45. 							<li>or the unpinned tabs,</li>
    46. 

  46. 							<li>or all the tabs.</li>
    47. 

  47. 						</ul>
    48. 

  48. 					</li>
    49. 

  49. 					<li>The context menu also allows you to activate the auto-save of: <ul>
    50. 

  50. 							<li>the current tab,</li>
    51. 

  51. 							<li>or the unpinned tabs,</li>
    52. 

  52. 							<li>or all the tabs.</li>
    53. 

  53. 						</ul>
    54. 

  54. 					</li>
    55. 

  55. 					<li>You can highlight text, add notes, format and remove content before saving the page with the <a
    56. 

  56. 							href="#annotation-editor">Annotation editor</a> by selecting "Annotate and save the page..."
    57. 

  57. 						in the context menu</li>
    58. 

  58. 					<li>With auto-save active, pages are automatically saved every time after being loaded (or before
    59. 

  59. 						being unloaded if not). </li>
    60. 

  60. 					<li>Select "Save Selection" from the context menu without selecting any content first to display a
    61. 

  61. 						selector that will help you choose content by hovering over it with the mouse.</li>
    62. 

  62. 					<li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
    63. 

  63. 					<li>Enable the option "Destination &gt; upload to Google Drive" to upload pages to Google Drive</li>
    64. 

  64. 					<li>You can use the customizable shortcut Ctrl+Shift+Y to save the current tab or the selected tabs.
    65. 

  65. 						Go to about:addons and select "Manage extension shortcuts" in the cogwheel menu to change it in
    66. 

  66. 						Firefox. Go to chrome://extensions/shortcuts to change it in Chrome..</li>
    67. 

  67. 					<li>The default save folder is the download folder configured in your browser, cf. about:preferences
    68. 

  68. 						in Firefox and chrome://settings in Chrome.</li>
    69. 

  69. 				</ul>
    70. 

  70. 			</li>
    71. 

  71. 			<li><a id="options">Options description</a>
    72. 

  72. 				<p>You can customize SingleFile through the options page. Right-click on SingleFile button <img
    73. 

  73. 						src="../resources/icon_16.png" class="icon"> in the browser toolbar and select "Options"/"Manage
    74. 

  74. 					extension" in the context menu to open the options page.</p>
    75. 

  75. 				<p>Profiles</p>
    76. 

  76. 				<ul>
    77. 

  77. 					<li>
    78. 

  78. 						<p>A profile is a set of user-defined options associated to a unique name.</p>
    79. 

  79. 						<p>The drop-down list in the upper right of the options page allows you to select a profile and
    80. 

  80. 							modify the associated options. The buttons next to the drop-down list allows you
    81. 

  81. 							respectively to create, delete and rename a profile. </p>
    82. 

  82. 					</li>
    83. 

  83. 					<li>
    84. 

  84. 						<p>You can select the default profile through the context menu of SingleFile. The selection is
    85. 

  85. 							persistent and applied to all tabs. </p>
    86. 

  86. 					</li>
    87. 

  87. 					<li>
    88. 

  88. 						<p>You can also override the default profile by associating a profile to a complete or partial
    89. 

  89. 							URL. See the description of the <a href="#auto-settings-rules">Auto-settings rules</a>
    90. 

  90. 							feature for more info. </p>
    91. 

  91. 					</li>
    92. 

  92. 				</ul>
    93. 

  93. 				<p>User interface</p>
    94. 

  94. 				<ul>
    95. 

  95. 					<li data-options-label="addMenuEntryLabel"> <span class="option">Option: add entry in the context
    96. 

  96. 							menu of the webpage</span>
    97. 

  97. 						<p>Check this option to display an entry for SingleFile in the context menu of the webpage. The
    98. 

  98. 							context menu of the SingleFile button <img src="../resources/icon_16.png" class="icon"> in
    99. 

  99. 							the extension toolbar is displayed whether this option is checked or not. </p>
    100. 

  100. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    101. 

  101. 					</li>
    102. 

  102. 					<li data-options-label="shadowEnabledLabel"> <span class="option">Option: overlay a shadow on the
    103. 

  103. 							page during processing</span>
    104. 

  104. 						<p>Check this option to overlay a shadow on the page when SingleFile is retrieving page
    105. 

  105. 							resources. This reminds you that you should not close the tab. </p>
    106. 

  106. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    107. 

  107. 					</li>
    108. 

  108. 					<li data-options-label="displayInfobarLabel"> <span class="option">Option: display an infobar when
    109. 

  109. 							viewing a saved page</span>
    110. 

  110. 						<p>Check this option to display the ℹ button at the top right of the page when viewing a saved
    111. 

  111. 							page. By clicking this button, you can get more information about the saved date and open
    112. 

  112. 							the original URL.</p>
    113. 

  113. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    114. 

  114. 					</li>
    115. 

  115. 					<li data-options-label="infobarTemplateLabel"> <span class="option">Option: template of the infobar
    116. 

  116. 							content</span>
    117. 

  117. 						<p>The template allows you to customize the content displayed in the infobar. You can use any
    118. 

  118. 							valid character, <code>\n</code> for new lines or <code>\t</code> for tabs. You can also use
    119. 

  119. 							any variables from <a href="#template-variables">this list</a> anywhere in the template. If
    120. 

  120. 							the template or the resulting content is empty, the infobar will display the saved date by
    121. 

  121. 							default. </p>
    122. 

  122. 						<p>Template examples:</p>
    123. 

  123. 						<ul>
    124. 

  124. 							<li><code>{url-href} ({date-iso})</code> will produce contents like "https://www.example.com
    125. 

  125. 								(2018-09-15 11 06 03 PM)".</li>
    126. 

  126. 							<li><code>Title: {page-title}</code> will produce contents like "Title: Example Domain" for
    127. 

  127. 								a page having "Example Domain" as title.</li>
    128. 

  128. 						</ul>
    129. 

  129. 					</li>
    130. 

  130. 					<li data-options-label="confirmInfobarLabel"> <span class="option">Option: open a prompt dialog to
    131. 

  131. 							edit the infobar content</span>
    132. 

  132. 						<p>Check this option to display a prompt dialog in order to confirm the infobar content before
    133. 

  133. 							saving the page. </p>
    134. 

  134. 					</li>
    135. 

  135. 					<li data-options-label="autoCloseLabel"> <span class="option">Option: auto-close the tab after the
    136. 

  136. 							page is saved</span>
    137. 

  137. 						<p>Check this option to automatically close the tab after saving the page displayed inside. </p>
    138. 

  138. 					</li>
    139. 

  139. 				</ul>
    140. 

  140. 				<p>File name</p>
    141. 

  141. 				<ul>
    142. 

  142. 					<li data-options-label="filenameTemplateLabel"> <span class="option">Option: template</span>
    143. 

  143. 						<p>The template allows you to customize the file name of saved pages. You can use any valid
    144. 

  144. 							character and "/" to create sub-folders (with the option "save pages in background" active).
    145. 

  145. 							You can also use any variables from <a href="#template-variables">this list</a> anywhere in
    146. 

  146. 							the template.</p>
    147. 

  147. 						<p>Invalid characters are automatically transformed and collapsed to underscores. File names
    148. 

  148. 							cannot exceed 192 characters and are truncated if longer. The invalid characters are:
    149. 

  149. 							<code>[</code> <code>~</code> <code>+</code> <code>\</code> <code>?</code> <code>%</code>
    150. 

  150. 							<code>*</code> <code>:</code> <code>|</code> <code>"</code> <code>&lt;</code>
    151. 

  151. 							<code>&gt;</code> and control characters from 0 to 31 in the ASCII table.</p>
    152. 

  152. 						<p>Template examples:</p>
    153. 

  153. 						<ul>
    154. 

  154. 							<li><code>{page-title} ({date-iso} {time-locale}).html</code> will produce filenames like
    155. 

  155. 								"Introduction to SingleFile (2018-09-15 11_06_03 PM).html" for a page having
    156. 

  156. 								"Introduction to SingleFile" as title.</li>
    157. 

  157. 							<li><code>archives/{url-last-segment} - {date-iso}</code> will produce filenames like
    158. 

  158. 								"welcome - 2018-09-15" for a page hosted on https://example.com/welcome.html. The saved
    159. 

  159. 								files will be saved in the sub-directory "archives".</li>
    160. 

  160. 							<li><code>archives/{year-locale}/{month-locale}/{day-locale}/{page-title}.html</code> will
    161. 

  161. 								produce filenames like "Introduction to SingleFile.html" stored into 3 sub-directories
    162. 

  162. 								in the "archives" folder, one for each part of the save date (e.g.
    163. 

  163. 								"2018/9/15/Introduction to SingleFile.html").</li>
    164. 

  164. 						</ul>
    165. 

  165. 					</li>
    166. 

  166. 					<li data-options-label="filenameMaxLengthLabel"> <span class="option">Option: max length
    167. 

  167. 							(bytes)</span>
    168. 

  168. 						<p>Specify the maximum length in bytes of the filename.</p>
    169. 

  169. 					</li>
    170. 

  170. 					<li data-options-label="confirmFilenameLabel"> <span class="option">Option: open the "Save as"
    171. 

  171. 							dialog to confirm the file name</span>
    172. 

  172. 						<p>Check this option to display the "Save as" dialog in order to confirm the file name before
    173. 

  173. 							saving the page. If the option "save pages in background" is unchecked then a prompt dialog
    174. 

  174. 							will be displayed instead of the "Save as" dialog. </p>
    175. 

  175. 					</li>
    176. 

  176. 					<li data-options-label="filenameConflictActionLabel"> <span class="option">Option: file name
    177. 

  177. 							conflict resolution</span>
    178. 

  178. 						<p>Choose the most appropriate action when the filename of the saved page is conflicting with
    179. 

  179. 							existing ones on the filesystem. The "skip duplicate files" action only detects duplicates
    180. 

  180. 							among files downloaded during the current browsing session.</p>
    181. 

  181. 					</li>
    182. 

  182. 				</ul>
    183. 

  183. 				<p>HTML content</p>
    184. 

  184. 				<ul>
    185. 

  185. 					<li data-options-label="compressHTMLLabel"> <span class="option">Option: compress HTML
    186. 

  186. 							content</span>
    187. 

  187. 						<p>Check this option to remove all HTML comments and unneeded tags, spaces, quotes and
    188. 

  188. 							whitespace characters. Checking this option helps to reduce the size of the file without
    189. 

  189. 							altering the document.</p>
    190. 

  190. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    191. 

  191. 					</li>
    192. 

  192. 					<li data-options-label="removeImportsLabel"> <span class="option">Option: remove HTML imports</span>
    193. 

  193. 						<p>Check this option to remove all link elements used to import HTML documents. Checking this
    194. 

  194. 							option can help to reduce the size of the file without altering the document.</p>
    195. 

  195. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    196. 

  196. 					</li>
    197. 

  197. 					<li data-options-label="removeHiddenElementsLabel"> <span class="option">Option: remove hidden
    198. 

  198. 							elements</span>
    199. 

  199. 						<p>Check this option to remove all hidden elements. Checking this option can help to reduce the
    200. 

  200. 							size of the file without altering the document. It may also increase the CPU consumption and
    201. 

  201. 							the time needed to save a page.</p>
    202. 

  202. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    203. 

  203. 					</li>
    204. 

  204. 					<li data-options-label="removeFramesLabel"> <span class="option">Option: remove frames</span>
    205. 

  205. 						<p>Check this option to remove all frame and iframe elements. Checking this option can
    206. 

  206. 							considerably reduce the size of the file without altering the document most of the time. It
    207. 

  207. 							may also decrease the time needed to save a page.</p>
    208. 

  208. 					</li>
    209. 

  209. 					<li data-options-label="includeInfobarLabel">Option: include infobar in the saved page <p>Check this
    210. 

  210. 							option to display the ℹ button at the top right of the page when viewing a saved page in a
    211. 

  211. 							browser where SingleFile is not installed.</p>
    212. 

  212. 					</li>
    213. 

  213. 					<li data-options-label="saveRawPageLabel"> <span class="option">Option: save raw page</span>
    214. 

  214. 						<p>Check this option to save the page without interpreting JavaScript. Checking this option may
    215. 

  215. 							alter the document.</p>
    216. 

  216. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    217. 

  217. 					</li>
    218. 

  218. 				</ul>
    219. 

  219. 				<p>Stylesheets</p>
    220. 

  220. 				<ul>
    221. 

  221. 					<li data-options-label="removeUnusedStylesLabel"> <span class="option">Option: remove unused
    222. 

  222. 							styles</span>
    223. 

  223. 						<p>Check this option to remove all the CSS rules and styles that do not match any element in the
    224. 

  224. 							saved page. Checking this option will not alter the document and can considerably reduce the
    225. 

  225. 							size of the file. It will also increase the CPU consumption and the time needed to save a
    226. 

  226. 							page.</p>
    227. 

  227. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    228. 

  228. 					</li>
    229. 

  229. 					<li data-options-label="removeAlternativeMediasLabel"> <span class="option">Option: remove
    230. 

  230. 							stylesheets for alternative devices to screens</span>
    231. 

  231. 						<p>Check this option to remove stylesheets that are not used for the screen display like
    232. 

  232. 							stylesheets for print preview and speech synthesizers. Checking this option can help to
    233. 

  233. 							reduce the size of the file.</p>
    234. 

  234. 					</li>
    235. 

  235. 					<li data-options-label="compressCSSLabel"> <span class="option">Option: compress CSS content</span>
    236. 

  236. 						<p>Check this option to minify CSS stylesheets. Checking this option can reduce size of the file
    237. 

  237. 							without altering the document. It may also increase the CPU consumption and the time needed
    238. 

  238. 							to save a page.</p>
    239. 

  239. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    240. 

  240. 					</li>
    241. 

  241. 				</ul>
    242. 

  242. 				<p>Images</p>
    243. 

  243. 				<ul>
    244. 

  244. 					<li data-options-label="groupDuplicateImagesLabel"> <span class="option">Option: group duplicate
    245. 

  245. 							images together</span>
    246. 

  246. 						<p>Check this option to avoid saving multiple times duplicate images. Checking this option
    247. 

  247. 							should not alter the document in modern browsers and can considerably reduce the size of the
    248. 

  248. 							file.</p>
    249. 

  249. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    250. 

  250. 					</li>
    251. 

  251. 					<li data-options-label="loadDeferredImagesLabel"> <span class="option">Option: save deferred
    252. 

  252. 							images</span>
    253. 

  253. 						<p>Check this option to save all the deferred images that are not yet displayed. This may help
    254. 

  254. 							to save all the images without scrolling the page. This feature does its best effort and is
    255. 

  255. 							not guaranteed to work on all sites. It will also increase the time needed to save a page.
    256. 

  256. 						</p>
    257. 

  257. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    258. 

  258. 					</li>
    259. 

  259. 					<li data-options-label="loadDeferredImagesMaxIdleTimeLabel"> <span class="option">Option: maximum
    260. 

  260. 							idle time (ms)</span>
    261. 

  261. 						<p>Specify the maximum delay of time to wait for deferred images. You can increase this value if
    262. 

  262. 							for example the network or system conditions are degraded. You can also decrease this value
    263. 

  263. 							otherwise.</p>
    264. 

  264. 					</li>
    265. 

  265. 					<li data-options-label="loadDeferredImagesKeepZoomLevelLabel"> <span class="option">Option: zoom out
    266. 

  266. 							the page</span>
    267. 

  267. 						<p>Check this option to save the entire content of a page by zooming out the page. This can help
    268. 

  268. 							saving pages using infinite virtual lists for example. </p>
    269. 

  269. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    270. 

  270. 					</li>
    271. 

  271. 					<li data-options-label="removeAlternativeImagesLabel"> <span class="option">Option: remove images
    272. 

  272. 							for alternative screen resolutions</span>
    273. 

  273. 						<p>Check this option to remove images that are alternatives in lower and/or higher resolutions
    274. 

  274. 							to the ones displayed by default. Checking this option can considerably reduce the size of
    275. 

  275. 							the file.</p>
    276. 

  276. 					</li>
    277. 

  277. 				</ul>
    278. 

  278. 				<p>Fonts</p>
    279. 

  279. 				<ul>
    280. 

  280. 					<li data-options-label="removeUnusedFontsLabel"> <span class="option">Option: remove unused
    281. 

  281. 							fonts</span>
    282. 

  282. 						<p>Check this option to remove all font CSS rules that do not match any content. Checking this
    283. 

  283. 							option should not alter the document and can considerably reduce the size of the file.</p>
    284. 

  284. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    285. 

  285. 					</li>
    286. 

  286. 					<li data-options-label="removeAlternativeFontsLabel"> <span class="option">Option: remove
    287. 

  287. 							alternative fonts</span>
    288. 

  288. 						<p>Check this option to remove fonts that are alternatives to the ones used. Checking this
    289. 

  289. 							option should not alter the document and can considerably reduce the size of the file.</p>
    290. 

  290. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    291. 

  291. 					</li>
    292. 

  292. 				</ul>
    293. 

  293. 				<p>Other resources</p>
    294. 

  294. 				<ul>
    295. 

  295. 					<li data-options-label="removeScriptsLabel"> <span class="option">Option: remove scripts</span>
    296. 

  296. 						<p>Check this option to remove all the JavaScript scripts. Unchecking this option may alter the
    297. 

  297. 							document and may introduce privacy or security issues.</p>
    298. 

  298. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    299. 

  299. 					</li>
    300. 

  300. 					<li data-options-label="removeVideoLabel"> <span class="option">Option: remove video sources</span>
    301. 

  301. 						<p>Check this option to empty the "src" attribute of all video elements.</p>
    302. 

  302. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    303. 

  303. 					</li>
    304. 

  304. 					<li data-options-label="removeAudioLabel"> <span class="option">Option: remove audio sources</span>
    305. 

  305. 						<p>Check this option to empty the "src" attribute of all audio elements.</p>
    306. 

  306. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    307. 

  307. 					</li>
    308. 

  308. 				</ul>
    309. 

  309. 				<p>Destination</p>
    310. 

  310. 				<ul>
    311. 

  311. 					<li data-options-label="saveToFilesystemLabel"> <span class="option">Option: save to
    312. 

  312. 							filesystem</span>
    313. 

  313. 						<p>Check this option to save the downloaded page on the filesystem of your computer.</p>
    314. 

  314. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    315. 

  315. 					</li>
    316. 

  316. 					<li data-options-label="saveToClipboardLabel"> <span class="option">Option: copy to clipboard</span>
    317. 

  317. 						<p>Check this option to copy the page to the clipboard.</p>
    318. 

  318. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    319. 

  319. 					</li>
    320. 

  320. 					<li data-options-label="saveToGDriveLabel"> <span class="option">Option: upload to Google
    321. 

  321. 							Drive</span>
    322. 

  322. 						<p>Check this option to save the page on Google Drive.</p>
    323. 

  323. 						<p>The permissions requested by SingleFile allow it to access only to the files and folders it
    324. 

  324. 							has created. When you uncheck this option, SingleFile revokes automatically its access to
    325. 

  325. 							your Google Drive account. </p>
    326. 

  326. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    327. 

  327. 					</li>
    328. 

  328. 				</ul>
    329. 

  329. 				<p>Annotation editor</p>
    330. 

  330. 				<ul>
    331. 

  331. 					<li data-options-label="defaultEditorModeLabel"> <span class="option">Option: default mode</span>
    332. 

  332. 						<p>Select the default mode when opening the annotation editor. The available choices are:
    333. 

  333. 						<ul>
    334. 

  334. 							<li><code>normal</code>: default value</li>
    335. 

  335. 							<li><code>edit the page</code>: enable the button <img
    336. 

  336. 									src="../resources/button_note_edit.png" class="icon button"></li>
    337. 

  337. 							<li><code>format the page</code>: enable the button <img
    338. 

  338. 									src="../resources/button_note_format.png" class="icon button"> if the page can be
    339. 

  339. 								formatted</li>
    340. 

  340. 							<li><code>remove elements</code>: enable the button <img
    341. 

  341. 									src="../resources/button_cut_inner.png" class="icon button"></li>
    342. 

  342. 							<li><code>remove external elements</code>: enable the button <img
    343. 

  343. 									src="../resources/button_cut_outer.png" class="icon button"></li>
    344. 

  344. 						</ul>
    345. 

  345. 						</p>
    346. 

  346. 					</li>
    347. 

  347. 					<li data-options-label="applySystemThemeLabel"> <span class="option">Option: apply the system theme
    348. 

  348. 							when formatting a page in the annotation editor</span>
    349. 

  349. 						<p>Uncheck this option if you do not want to apply the theme of the operating system or the
    350. 

  350. 							browser (e.g. dark or light) when you click on the button "Format the page for better
    351. 

  351. 							readability" in the annotation editor.</p>
    352. 

  352. 					</li>
    353. 

  353. 					<li data-options-label="warnUnsavedPageLabel"> <span class="option">Option: warn if leaving page
    354. 

  354. 							with unsaved changes</span>
    355. 

  355. 						<p>Check this option to display a blocking popup when you leave the annotation editor (e.g.
    356. 

  356. 							close the tab) without saving the changes.</p>
    357. 

  357. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    358. 

  358. 					</li>
    359. 

  359. 					<li data-options-label="openEditorLabel"> <span class="option">Option: edit page before
    360. 

  360. 							saving</span>
    361. 

  361. 						<p>Check this option to open the annotation editor before saving any page. Checking this option
    362. 

  362. 							removes the entry "Annotate and save the page..." from the context menu.</p>
    363. 

  363. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    364. 

  364. 					</li>
    365. 

  365. 					<li data-options-label="autoOpenEditorLabel"> <span class="option">Option: open the annotation
    366. 

  366. 							editor when viewing a page saved with SingleFile </span>
    367. 

  367. 						<p>Check this option to open the annotation editor when displaying a page saved by SingleFile.
    368. 

  368. 						</p>
    369. 

  369. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    370. 

  370. 					</li>
    371. 

  371. 				</ul>
    372. 

  372. 				<p>Bookmarks</p>
    373. 

  373. 				<ul>
    374. 

  374. 					<li data-options-label="saveCreatedBookmarksLabel"> <span class="option">Option: save the page of a
    375. 

  375. 							newly created bookmark</span>
    376. 

  376. 						<p>Check this option to save pages that you add into your bookmarks. Note that if the page is to
    377. 

  377. 							be saved is not already displayed in a tab, SingleFile will open temporarily a new tab to
    378. 

  378. 							save the page. </p>
    379. 

  379. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    380. 

  380. 					</li>
    381. 

  381. 					<li data-options-label="replaceBookmarkURLLabel"> <span class="option">Option: link the new bookmark
    382. 

  382. 							to the saved page</span>
    383. 

  383. 						<p>Check this option to replace the URL of the page added into your bookmark with the file URI
    384. 

  384. 							of the saved page on your disk. </p>
    385. 

  385. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    386. 

  386. 					</li>
    387. 

  387. 					<li data-options-label="ignoredBookmarkFoldersLabel"> <span class="option">Option: ignored
    388. 

  388. 							folders</span>
    389. 

  389. 						<p>Enter a list of bookmark folder names to ignore. The folder names must be separated with a
    390. 

  390. 							comma.
    391. 

  391. 						</p>
    392. 

  392. 					</li>
    393. 

  393. 				</ul>
    394. 

  394. 				<p>Auto-save</p>
    395. 

  395. 				<ul>
    396. 

  396. 					<li data-options-label="autoSaveLoadOrUnloadLabel"> <span class="option">Option: auto-save after
    397. 

  397. 							page load or on page unload</span>
    398. 

  398. 						<p>Check this option to auto-save pages after being loaded. If you browse to another page before
    399. 

  399. 							the page is fully loaded then the page will be saved just before being unloaded. With this
    400. 

  400. 							option active, you are guaranteed pages will always be saved. Some frame contents may be
    401. 

  401. 							missing (if you unchecked "remove frames") when pages are saved before being unloaded. </p>
    402. 

  402. 					</li>
    403. 

  403. 					<li data-options-label="autoSaveLoadLabel"> <span class="option">Option: auto-save after page
    404. 

  404. 							load</span>
    405. 

  405. 						<p>Check this option to auto-save pages after being loaded.</p>
    406. 

  406. 					</li>
    407. 

  407. 					<li data-options-label="autoSaveUnloadLabel"> <span class="option">Option: auto-save on page
    408. 

  408. 							unload</span>
    409. 

  409. 						<p>Check this option to auto-save pages before being unloaded instead of saving pages after
    410. 

  410. 							being loaded. With this option active, you are guaranteed pages will always be saved but
    411. 

  411. 							some frame contents may be missing (if you unchecked "remove frames"). </p>
    412. 

  412. 					</li>
    413. 

  413. 					<li data-options-label="autoSaveDelayLabel"> <span class="option">Option: auto-save waiting delay
    414. 

  414. 							after load (s)</span>
    415. 

  415. 						<p>Specify the delay in seconds to wait before saving a page when the "auto-save on page load or
    416. 

  416. 							on page unload" or "auto-save on page load" is checked. </p>
    417. 

  417. 					</li>
    418. 

  418. 					<li data-options-label="autoSaveRepeatLabel"> <span class="option">Option: auto-save
    419. 

  419. 							periodically</span>
    420. 

  420. 						<p>Check this option to auto-save pages periodically after load.</p>
    421. 

  421. 					</li>
    422. 

  422. 					<li data-options-label="autoSaveRepeatDelayLabel"> <span class="option">Option: period (s)</span>
    423. 

  423. 						<p>Specify the delay in seconds to wait before each page saving when the "auto-save
    424. 

  424. 							periodically" option is checked. </p>
    425. 

  425. 					</li>
    426. 

  426. 					<li data-options-label="autoSaveExternalSaveLabel"> <span class="option">Option: save the page with
    427. 

  427. 							SingleFile Companion</span>
    428. 

  428. 						<p>Check this option to delegate the saving process to SingleFile Companion. It is a program
    429. 

  429. 							that runs outside the browser and can help to make the saving process more transparent. It
    430. 

  430. 							also allows the pages to be saved in another directory than the download directory. You can
    431. 

  431. 							find more info <a
    432. 

  432. 								href="https://github.com/gildas-lormeau/SingleFile/tree/master/companion">here</a></p>
    433. 

  433. 					</li>
    434. 

  434. 				</ul>
    435. 

  435. 				<p>Misc.</p>
    436. 

  436. 				<ul>
    437. 

  437. 					<li data-options-label="setMaxResourceSizeLabel"> <span class="option">Option: set a maximum size
    438. 

  438. 							for embedded resources (MB)</span>
    439. 

  439. 						<p>Check this option to remove from the saved page embedded resources (i.e. images, stylesheets,
    440. 

  440. 							scripts and iframes) that exceeds a given size.</p>
    441. 

  441. 					</li>
    442. 

  442. 					<li data-options-label="maxResourceSizeLabel"> <span class="option">Option: maximum size (MB)</span>
    443. 

  443. 						<p>Specify the maximum size of embedded resources in megabytes.</p>
    444. 

  444. 					</li>
    445. 

  445. 					<li data-options-label="passReferrerOnErrorLabel"> <span class="option">Option: pass \"Referer\"
    446. 

  446. 							header on
    447. 

  447. 							cross-origin errors</span>
    448. 

  448. 						<p>Check this option to pass the HTTP header "Referer" with the "origin" policy after an 401,
    449. 

  449. 							403, or 404 HTTP error when downloading a cross-origin resource. You should enable this
    450. 

  450. 							option if you cannot download resources blocked by a hotlink protection.</p>
    451. 

  451. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    452. 

  452. 					</li>
    453. 

  453. 					<li data-options-label="addProofLabel"> <span class="option">Option: add proof od existence</span>
    454. 

  454. 						<p>Check this option to create a worldwide proof of the existence of the page you want to save.
    455. 

  455. 						</p>
    456. 

  456. 						<ul>
    457. 

  457. 							<li> <strong>What is a proof of existence (data anchoring)?</strong><br> Data anchoring
    458. 

  458. 								consists in building a time-stamped proof of existence for a data by linking it to a
    459. 

  459. 								tamper resistant and time-stamped blockchain. Data anchoring implementation relies on
    460. 

  460. 								the resilience and immutability of the Bitcoin blockchain to provide the best possible
    461. 

  461. 								security level </li>
    462. 

  462. 							<li> <strong>How does this protect my data?</strong><br> The anchoring mechanism only
    463. 

  463. 								handles data impressions. Your data remains where you calculate the fingerprints, i.e.
    464. 

  464. 								in the browser. Their confidentiality is totally preserved. </li>
    465. 

  465. 							<li> <strong> The day after your backup you can get freely the proof receipt here: <a
    466. 

  466. 										href="https://gildas-lormeau.github.io/singlefile-woleet/index.html">gildas-lormeau.github.io/singlefile-woleet/index.html</a>.
    467. 

  467. 									A proof receipt will be used to verify the validity of the evidence </strong> </li>
    468. 

  468. 						</ul>
    469. 

  469. 						<p> More information <a href="https://doc.woleet.io">doc.woleet.io</a> </p>
    470. 

  470. 					</li>
    471. 

  471. 					<li data-options-label="backgroundSaveLabel"> <span class="option">Option: save pages in
    472. 

  472. 							background</span>
    473. 

  473. 						<p>Uncheck this option if you get invalid file names like
    474. 

  474. 							"37bec68b-446a-46a5-8642-19a89c231b46.html" or interrupted downloads when saving pages. You
    475. 

  475. 							can also uncheck this option if you want the "Save as" dialog to remember the last saved
    476. 

  476. 							path. Unchecking this option prevent using sub-directories in filename templates.</p>
    477. 

  477. 						<p class="notice">It is recommended to <u>check</u> this option</p>
    478. 

  478. 					</li>
    479. 

  479. 					<li data-options-label="displayStatsLabel"> <span class="option">Option: display stats in the
    480. 

  480. 							console after processing</span>
    481. 

  481. 						<p>Check this option to display stats about processing in the JavaScript developer tools of your
    482. 

  482. 							browser. Checking this option may increase the CPU consumption and the time needed to save a
    483. 

  483. 							page. </p>
    484. 

  484. 						<p class="notice">It is recommended to <u>uncheck</u> this option</p>
    485. 

  485. 					</li>
    486. 

  486. 				</ul>
    487. 

  487. 				<p id="auto-settings-rules">Auto-settings rules</p>
    488. 

  488. 				<ul>
    489. 

  489. 					<li>The auto-settings rules let you associate a complete or partial URL with a profile. It also
    490. 

  490. 						allows to associate a specific profile for the auto-save, or to disable it (check "display
    491. 

  491. 						'Auto-save profile' column"). When two or more rules match a URL of a page to save, the rule
    492. 

  492. 						with the longest URL will be chosen. The special profile "-" means the current profile. </li>
    493. 

  493. 					<li>You can use the special value "*" as URL to create a rule that applies to all URLs</li>
    494. 

  494. 					<li>You can use regular expressions by prefixing the URL with "regexp:" (e.g. "regexp:.*\.com" to
    495. 

  495. 						match all URLs containing ".com"). When zero or more rules based on URLs and one or more rules
    496. 

  496. 						based on regular expressions match a URL, the longest rule based on regular expression will be
    497. 

  497. 						chosen. </li>
    498. 

  498. 				</ul>
    499. 

  499. 				<p>Form buttons</p>
    500. 

  500. 				<ul>
    501. 

  501. 					<li><span class="option">synchronize options</span>
    502. 

  502. 						<p>Check this option to synchronize your options and make them available in all instances of the
    503. 

  503. 							browser you are logged into, on different devices.</p>
    504. 

  504. 					</li>
    505. 

  505. 					<li><span class="option">Reset</span>
    506. 

  506. 						<p>Reset all options to their default values.</p>
    507. 

  507. 					</li>
    508. 

  508. 				</ul>
    509. 

  509. 			</li>
    510. 

  510. 			<li><a id="annotation-editor">Annotation editor</a>
    511. 

  511. 				<p>The annotation editor can be opened by selecting "Annotate and save the page" in the context menu or
    512. 

  512. 					by enabling the option "Annotation editor &gt; edit page before saving". It allows you to:
    513. 

  513. 				<ul>
    514. 

  514. 					<li>add notes by clicking one of these buttons: <img src="../resources/button_note_yellow.png"
    515. 

  515. 							class="icon button"> <img src="../resources/button_note_pink.png" class="icon button"> <img
    516. 

  516. 							src="../resources/button_note_blue.png" class="icon button"> <img
    517. 

  517. 							src="../resources/button_note_green.png" class="icon button"></li>
    518. 

  518. 					<li>hide or show notes by clicking the button <img src="../resources/button_note_visible.png"
    519. 

  519. 							class="icon button"></li>
    520. 

  520. 					<li>highlight text by clicking one of these buttons: <img
    521. 

  521. 							src="../resources/button_highlighter_yellow.png" class="icon button"> <img
    522. 

  522. 							src="../resources/button_highlighter_pink.png" class="icon button"> <img
    523. 

  523. 							src="../resources/button_highlighter_blue.png" class="icon button"> <img
    524. 

  524. 							src="../resources/button_highlighter_green.png" class="icon button"></li>
    525. 

  525. 					<li>hide or show highlighted text by clicking the button <img
    526. 

  526. 							src="../resources/button_highlighter_visible.png" class="icon button"></li>
    527. 

  527. 					<li>remove text highlighting by clicking the button <img
    528. 

  528. 							src="../resources/button_highlighter_delete.png" class="icon button"></li>
    529. 

  529. 					<li>edit the page by clicking the button <img src="../resources/button_note_edit.png"
    530. 

  530. 							class="icon button"> </li>
    531. 

  531. 					<li>format the page to improve readability (when possible) by clicking the button <img
    532. 

  532. 							src="../resources/button_note_format.png" class="icon button"> </li>
    533. 

  533. 					<li>remove contents by clicking the button <img src="../resources/button_cut_inner.png"
    534. 

  534. 							class="icon button"> (inner elements) or <img src="../resources/button_cut_outer.png"
    535. 

  535. 							class="icon button"> (outer elements)</li>
    536. 

  536. 					<li>undo removes by clicking the button <img src="../resources/button_undo_cut.png"
    537. 

  537. 							class="icon button"> or the button <img src="../resources/button_undo_all_cut.png"
    538. 

  538. 							class="icon button"> (undo all)
    539. 

  539. 					<li>redo removes by clicking the button <img src="../resources/button_redo_cut.png"
    540. 

  540. 							class="icon button"></li>
    541. 

  541. 					<li>print the page by clicking the button <img src="../resources/button_print.png"
    542. 

  542. 							class="icon button"> or by pressing <code>Ctrl-P</code></li>
    543. 

  543. 					<li>save the page by clicking the button <img src="../resources/button_download.png"
    544. 

  544. 							class="icon button"> or by pressing <code>Ctrl-S</code></li>
    545. 

  545. 				</ul>
    546. 

  546. 				</p>
    547. 

  547. 				<br>
    548. 

  548. 				<p>
    549. 

  549. 					You can use the following keyboard shortcuts when removing contents with <img
    550. 

  550. 						src="../resources/button_cut_inner.png" class="icon button"> or <img
    551. 

  551. 						src="../resources/button_cut_outer.png" class="icon button">:
    552. 

  552. 				<ul>
    553. 

  553. 					<li><code>Tab</code>: expand the selection</li>
    554. 

  554. 					<li><code>Shift-Tab</code>: reduce the selection</li>
    555. 

  555. 					<li><code>Space</code>: remove the selected element</li>
    556. 

  556. 					<li><code>Ctrl-Z</code>: undo the last removal</li>
    557. 

  557. 					<li><code>Ctrl-Shift-Z</code>: redo the last removal</li>
    558. 

  558. 					<li><code>Ctrl</code>: select/unselect multiple elements, releasing the <code>Ctrl</code> key
    559. 

  559. 						validates the selection</li>
    560. 

  560. 					<li><code>Shift</code>: temporarily reverse the type of removal (i.e. removal of inner elements or
    561. 

  561. 						removal of outer elements) on the last selected element and reset the other selected elements if
    562. 

  562. 						any</li>
    563. 

  563. 					<li><code>Escape</code>: reset selected elements</li>
    564. 

  564. 				</ul>
    565. 

  565. 				</p>
    566. 

  566. 				</ul>
    567. 

  567. 			</li>
    568. 

  568. 			<li><a id="template-variables">Template variables</a>
    569. 

  569. 				<p>The template variables are used to customize the infobar content or the file name of a saved page.
    570. 

  570. 					They help to insert dynamic values like the save date or the page title.</p>
    571. 

  571. 				<p> You can limit the length of a dynamic value by adding <code>[<em>maxByteSize</em>]</code> just after
    572. 

  572. 					the variable name. The <code>maxByteSize</code> value is the maximum length of the value in bytes
    573. 

  573. 					(e.g. `{page-title}[20]` to limit the title to 20 bytes).</p>
    574. 

  574. 				<ul>
    575. 

  575. 					<li><code>{page-title}</code>: the title of the page</li>
    576. 

  576. 					<li><code>{page-heading}</code>: the content of the H1 tag in the page</li>
    577. 

  577. 					<li><code>{page-language}</code>: the language of the page</li>
    578. 

  578. 					<li><code>{page-description}</code>: the description of the page</li>
    579. 

  579. 					<li><code>{page-author}</code>: the author of the page</li>
    580. 

  580. 					<li><code>{page-creator}</code>: the creator of the page</li>
    581. 

  581. 					<li><code>{page-publisher}</code>: the publisher of the page</li>
    582. 

  582. 					<li><code>{datetime-iso}</code>: the save date and time in the ISO format (e.g.
    583. 

  583. 						"2018-09-15T22_38_26_317Z")</li>
    584. 

  584. 					<li><code>{datetime-utc}</code>: the save date and time in UTC format (e.g. "Sat, 15 Sep 2018
    585. 

  585. 						22_38_26 GMT")</li>
    586. 

  586. 					<li><code>{datetime-locale}</code>: the localized value of the date and time (e.g. "9_16_2018,
    587. 

  587. 						12_54_31 AM")</li>
    588. 

  588. 					<li><code>{date-iso}</code>: the save date in the ISO format (e.g. "2018-09-15")</li>
    589. 

  589. 					<li><code>{date-locale}</code>: the localized value of the save date (e.g. "16_09_2018")</li>
    590. 

  590. 					<li><code>{time-iso}</code>: the save time in the ISO format (e.g. "22_38_26_317")</li>
    591. 

  591. 					<li><code>{time-locale}</code>: the localized value of the save time (e.g. "00_38_26")</li>
    592. 

  592. 					<li><code>{day-utc}</code>: the day of the save date in UTC format (e.g. "15")</li>
    593. 

  593. 					<li><code>{day-locale}</code>: the localized value of the day (e.g. "15")</li>
    594. 

  594. 					<li><code>{month-utc}</code>: the month of the save date in UTC format (e.g. "09")</li>
    595. 

  595. 					<li><code>{month-locale}</code>: the localized value of the month (e.g. "09")</li>
    596. 

  596. 					<li><code>{year-utc}</code>: the year of the save date in UTC format (e.g. "2018")</li>
    597. 

  597. 					<li><code>{year-locale}</code>: the localized value of the year (e.g. "2018")</li>
    598. 

  598. 					<li><code>{hours-utc}</code>: the hour of the save date in UTC format (e.g. "20")</li>
    599. 

  599. 					<li><code>{hours-locale}</code>: the localized value of the hour (e.g. "22")</li>
    600. 

  600. 					<li><code>{minutes-utc}</code>: the minutes of the save date in UTC format (e.g. "38")</li>
    601. 

  601. 					<li><code>{minutes-locale}</code>: the localized value of the minutes (e.g. "38")</li>
    602. 

  602. 					<li><code>{seconds-utc}</code>: the seconds of the save date in UTC format (e.g. "31")</li>
    603. 

  603. 					<li><code>{seconds-locale}</code>: the localized value of the seconds (e.g. "31")</li>
    604. 

  604. 					<li><code>{url-href}</code>: the URL of the page (e.g. "http://example.com/category/index.html")
    605. 

  605. 					</li>
    606. 

  606. 					<li><code>{url-href-flat}</code>: the URL of the page with replaced slashes (e.g.
    607. 

  607. 						"http__example.com_category_index.html")</li>
    608. 

  608. 					<li><code>{url-pathname}</code>: the path name of the URL (e.g. "category/index.html")</li>
    609. 

  609. 					<li><code>{url-pathname-flat}</code>: the path name of the URL with replaced slashes (e.g.
    610. 

  610. 						"category_index.html")</li>
    611. 

  611. 					<li><code>{url-last-segment}</code>: the last part of the pathname (without the extension) or the
    612. 

  612. 						host if not found (e.g. "index")</li>
    613. 

  613. 					<li><code>{url-protocol}</code>: the protocol of the URL (e.g. "https")</li>
    614. 

  614. 					<li><code>{url-host}</code>: the host name + the port of the URL (e.g. "example.com_8080")</li>
    615. 

  615. 					<li><code>{url-hostname}</code>: the host name of the URL (e.g. "example.com")</li>
    616. 

  616. 					<li><code>{url-port}</code>: the port of the URL (e.g. "8080")</li>
    617. 

  617. 					<li><code>{url-username}</code>: the user name of the URL (e.g. "john_doe")</li>
    618. 

  618. 					<li><code>{url-password}</code>: the password of the URL (e.g. "qwerty123")</li>
    619. 

  619. 					<li><code>{url-search}</code>: the search string of the URL (e.g. "order=ascending")</li>
    620. 

  620. 					<li><code>{url-search-&lt;name&gt;}</code>: the query parameter "&lt;name&gt;" in the the search
    621. 

  621. 						string of the URL (e.g. "url-search-order" will return "ascending" in the previous example)</li>
    622. 

  622. 					<li><code>{url-hash}</code>: the hash of the URL (e.g. "chapter-2")</li>
    623. 

  623. 					<li><code>{url-referrer}</code>: the URI of the page that "linked" to the page (e.g.
    624. 

  624. 						"http://example.com")</li>
    625. 

  625. 					<li><code>{url-referrer-flat}</code>: the URI of the page that "linked" to the page with slashed
    626. 

  626. 						replaced (e.g. "http_example.com")</li>
    627. 

  627. 					<li><code>{bookmark-pathname}</code>: the path name of the newly created bookmark (e.g. "My
    628. 

  628. 						Bookmarks/Last Month") when the option "Bookmarks &gt; save the page of a
    629. 

  629. 						newly created bookmark" is enabled</li>
    630. 

  630. 					<li><code>{bookmark-pathname-flat}</code>: the path name of the newly created bookmark with replaced
    631. 

  631. 						slashes (e.g. "My Bookmarks_Last Month") when the option "Bookmarks &gt; save the page of a
    632. 

  632. 						newly created bookmark" is enabled</li>
    633. 

  633. 					<li><code>{tab-id}</code>: the unique identifier of the tab (e.g. "326")</li>
    634. 

  634. 					<li><code>{tab-index}</code>: the index of the tab in the window (e.g. "1")</li>
    635. 

  635. 					<li><code>{digest-sha-256}</code>: the SHA-256 hash value of the entire page content (e.g.
    636. 

  636. 						e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855)</li>
    637. 

  637. 					<li><code>{digest-sha-384}</code>: the SHA-384 hash value of the entire page content</li>
    638. 

  638. 					<li><code>{digest-sha-512}</code>: the SHA-512 hash value of the entire page content</li>
    639. 

  639. 				</ul>
    640. 

  640. 			</li>
    641. 

  641. 			<li><a id="notes">Technical notes</a>
    642. 

  642. 				<ul>
    643. 

  643. 					<li>All images are converted into <a href="http://en.wikipedia.org/wiki/Base64">base64</a>. </li>
    644. 

  644. 					<li>All resources except frame contents are injected in the document using <a
    645. 

  645. 							href="http://en.wikipedia.org/wiki/Data_URI_scheme">data URI scheme</a>. </li>
    646. 

  646. 					<li>Frame contents are injected as text in the document by using the srcdoc attribute. </li>
    647. 

  647. 				</ul>
    648. 

  648. 			</li>
    649. 

  649. 			<li><a id="known-issues">Known issues</a>
    650. 

  650. 				<ul>
    651. 

  651. 					<li>All browsers
    652. 

  652. 						<ul>
    653. 

  653. 							<li>For security reasons, you cannot save pages hosted on https://chrome.google.com,
    654. 

  654. 								https://addons.mozilla.org and some other Mozilla domains. When this happens, 🚫 is
    655. 

  655. 								displayed on top of the SingleFile icon.</li>
    656. 

  656. 							<li>For security reasons, SingleFile is sometimes unable to save the image representation of
    657. 

  657. 								canvas and snapshots of video elements.</li>
    658. 

  658. 							<li>The last saved path cannot be remembered by default. To circumvent this limitation,
    659. 

  659. 								disable the option "Misc. &gt; Save pages in background".</li>
    660. 

  660. 							<li>The following characters are replaced with _ in filenames: ~, +, \, ?, %, *, :, |, ",
    661. 

  661. 								&lt;, &gt;</li>
    662. 

  662. 						</ul>
    663. 

  663. 					</li>
    664. 

  664. 					<li>Chromium-based browsers
    665. 

  665. 						<ul>
    666. 

  666. 							<li>You must enable the option "Allow access to file URLs" in the extension page to display
    667. 

  667. 								the infobar when viewing a saved page, to save or to annotate a page stored on the
    668. 

  668. 								filesystem.</li>
    669. 

  669. 							<li>If the filename of a saved page looks like "56833935-156b-4d8c-a00f-19599c6513d3",
    670. 

  670. 								disable the option "Misc. &gt; Save pages in background". Reinstalling the browser may
    671. 

  671. 								also fix this issue.</li>
    672. 

  672. 							<li>Disabling the option 'File name &gt; open the "Save as" dialog to confirm the file name'
    673. 

  673. 								will work if and only if "Ask where to save each file before downloading" is disabled in
    674. 

  674. 								chrome://settings/downloads</li>
    675. 

  675. 						</ul>
    676. 

  676. 					</li>
    677. 

  677. 					<li>Firefox
    678. 

  678. 						<ul>
    679. 

  679. 							<li>The "File name &gt; file name conflict resolution" option does not work if set to
    680. 

  680. 								"prompt for a name".
    681. 

  681. 							</li>
    682. 

  682. 							<li>Sometimes, SingleFile is unable to save the contents of sandboxed iframes.</li>
    683. 

  683. 							<li>When processing a page from the filesystem, external resources (e.g. images,
    684. 

  684. 								stylesheets, fonts etc.) will not be embedded into the saved page.</li>
    685. 

  685. 						</ul>
    686. 

  686. 					</li>
    687. 

  687. 				</ul>
    688. 

  688. 			</li>
    689. 

  689. 			<li><a id="unknown-issues">Troubleshooting unknown issues</a>
    690. 

  690. 				<p>Please follow these steps if you find an unknown issue:</p>
    691. 

  691. 				<ul>
    692. 

  692. 					<li>Save the page in incognito.</li>
    693. 

  693. 					<li>If saving page in incognito did not fix the issue, reset SingleFile options.</li>
    694. 

  694. 					<li>If resetting options did not fix the issue, restart the browser.</li>
    695. 

  695. 					<li>If restarting the browser did not fix the issue, try to disable all other extensions to see if
    696. 

  696. 						there is a conflict.</li>
    697. 

  697. 					<li>If there is a conflict then try to determine against which extension(s).</li>
    698. 

  698. 					<li>Please report the issue <a href="https://github.com/gildas-lormeau/SingleFile/issues">here</a>
    699. 

  699. 						with a short description on how to reproduce it.</li>
    700. 

  700. 				</ul>
    701. 

  701. 				<p>Suggestions are welcome :)</p>
    702. 

  702. 			</li>
    703. 

  703. 			<li><a id="contributors">Contributors</a>
    704. 

  704. 				<ul>
    705. 

  705. 					<li>Chinese translation done by yfdyh000 (<a href="https://github.com/yfdyh000">GitHub profile</a>),
    706. 

  706. 						KrasnayaPloshchad (<a href="https://github.com/KrasnayaPloshchad">GitHub profile</a>),
    707. 

  707. 						frostblazergit (<a href="https://github.com/frostblazergit">GitHub profile</a>), NightSharp (<a
    708. 

  708. 							href="https://github.com/NightSharp">GitHub profile</a>) </li>
    709. 

  709. 					<li>Traditional Chinese translation done by frostblazergit (<a
    710. 

  710. 							href="https://github.com/frostblazergit">GitHub profile</a>)</li>
    711. 

  711. 					<li>German translation done by womotroll (<a href="https://github.com/womotroll">GitHub
    712. 

  712. 							profile</a>), bannmann (<a href="https://github.com/bannmann">GitHub profile</a>) </li>
    713. 

  713. 					<li>Japanese translation, done by Shitennouji （四天王寺) (<a
    714. 

  714. 							href="https://github.com/Shitennouji">GitHub profile</a>)</li>
    715. 

  715. 					<li>Polish translation done by xesarni (<a href="https://github.com/xesarni">GitHub profile</a>)
    716. 

  716. 					</li>
    717. 

  717. 					<li>Russian translation done by rstp14 (<a href="https://github.com/rstp14">GitHub profile</a>),
    718. 

  718. 						kramola-RU (<a href="https://github.com/kramola-RU">GitHub profile</a>), solokot (<a
    719. 

  719. 							href="https://github.com/solokot">GitHub profile</a>)</li>
    720. 

  720. 					<li>Ukrainian translation done by perdolka (<a href="https://github.com/perdolka">GitHub
    721. 

  721. 							profile</a>)</li>
    722. 

  722. 					<li>Spanish translation done by strel (<a href="https://github.com/strel">GitHub profile</a>)</li>
    723. 

  723. 				</ul>
    724. 

  724. 			</li>
    725. 

  725. 			<li><a id="icons">Icons</a>
    726. 

  726. 				<ul>
    727. 

  727. 					<li>Icon made by <a href="https://www.flaticon.com/authors/kiranshastry"
    728. 

  728. 							title="Kiranshastry">Kiranshastry</a> from <a href="https://www.flaticon.com/"
    729. 

  729. 							title="Flaticon">www.flaticon.com</a> is licensed by <a
    730. 

  730. 							href="http://creativecommons.org/licenses/by/3.0/" title="Creative Commons BY 3.0"
    731. 

  731. 							target="_blank">CC 3.0 BY</a> </li>
    732. 

  732. 				</ul>
    733. 

  733. 			</li>
    734. 

  734. 		</ol>
    735. 

  735. 	</div>
    736. 

  736. </body>
    737. 

  737. 

  738. </html>
    739.