help.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  5. <title>SingleFile help</title>
  6. <link rel="stylesheet" href="help.css">
  7. </head>
  8. <body>
  9. <div>
  10. <div id="titleBorder">
  11. <h2>SingleFile</h2>
  12. <h4>Save a complete page into a single HTML file</h4>
  13. </div>
  14. <span id="index">
  15. <a href="#instructions">Instructions</a> -
  16. <a href="#general-notes">Additional notes</a> -
  17. <a href="#options">Options description</a> -
  18. <a href="#notes">Technical notes</a> -
  19. <a href="#known-issues">Known issues</a> -
  20. <a href="#unknown-issues">Troubleshooting unknown issues</a>
  21. </span>
  22. <hr>
  23. <ol>
  24. <li>
  25. <a id="instructions">Instructions</a>
  26. <ul>
  27. <li>Wait until the page is fully loaded: you may need to scroll down the entire page to be sure all elements are loaded.</li>
  28. <li>Click on the SingleFile button
  29. <img src="../resources/icon_16.png" class="icon"> in the extension toolbar.</li>
  30. </ul>
  31. </li>
  32. <li>
  33. <a id="general-notes">Additional notes</a>
  34. <ul>
  35. <li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
  36. <li>To save multiple tabs, select them first and click on the SingleFile button <img src="../resources/icon_16.png"
  37. class="icon">.</li>
  38. <li>Use the context menu to save a tab, a selected content, a frame content, unpinned tabs, selected tabs, or all tabs.
  39. The context menu also allows activating automatic page saving of a tab, unpinned tabs, or all tabs.</li>
  40. <li>With auto-save active, the page will be automatically saved every time a new page is loaded. The period of time
  41. to wait before saving the page can be configured in the options page.</li>
  42. </ul>
  43. </li>
  44. <li>
  45. <a id="options">Options description</a>
  46. <p>You can customize SingleFile through the options page. Right-click on SingleFile button
  47. <img src="../resources/icon_16.png" class="icon"> in the browser toolbar and select "Options"/"Manage extension" in
  48. the context menu to open the options page.</p>
  49. <p>Option details :</p>
  50. <ul>
  51. <li>
  52. <span class="option">add entry in the context menu</span>
  53. <p>Check this option to display an entry in the context menu of the webpage to save the entire page or the selected
  54. part.
  55. </p>
  56. <p class="notice">It is recommended to
  57. <u>check</u> this option</p>
  58. </li>
  59. <li>
  60. <span class="option">overlay a shadow on the page during processing</span>
  61. <p>Check this option to overlay a shadow on the page when SingleFile is retrieving page resources. This reminds you
  62. that you should not close the tab.
  63. </p>
  64. <p class="notice">It is recommended to
  65. <u>check</u> this option</p>
  66. </li>
  67. <li>
  68. <span class="option">display an infobar when viewing archives</span>
  69. <p>Check this option to display the ❔ button at the top right of the page when viewing a saved page. By clicking this
  70. icon, you can get more information about the saved date and open the original URL.
  71. </p>
  72. <p class="notice">It is recommended to
  73. <u>check</u> this option</p>
  74. </li>
  75. <li>
  76. <span class="option">display stats in the console after processing</span>
  77. <p>Check this option to display stats about processing in the JavaScript developer tools of your browser. Checking
  78. this option may increase the time needed to process a page.
  79. </p>
  80. <p class="notice">It is recommended to
  81. <u>uncheck</u> this option</p>
  82. </li>
  83. <li>
  84. <span class="option">append the save date to the file name</span>
  85. <p>Check this option to append the save date of the webpage to the file name.
  86. </p>
  87. <p class="notice">It is recommended to
  88. <u>check</u> this option</p>
  89. </li>
  90. <li>
  91. <span class="option">enter file name before saving the page</span>
  92. <p>Check this option to display a prompt asking you to enter the file name of the saved page.
  93. </p>
  94. <p class="notice">It is recommended to
  95. <u>uncheck</u> this option</p>
  96. </li>
  97. <li>
  98. <span class="option">compress HTML</span>
  99. <p>Check this option to remove all HTML comments, and unneeded spaces or returns. This helps to reduce the size of
  100. the file without altering the document.</p>
  101. <p class="notice">It is recommended to
  102. <u>check</u> this option</p>
  103. </li>
  104. <li>
  105. <span class="option">remove HTML import</span>
  106. <p>Check this option to remove all link elements used to import HTML documents. This can reduce the size of the file
  107. without altering the document most of the time.</p>
  108. <p class="notice">It is recommended to
  109. <u>check</u> this option</p>
  110. </li>
  111. <li>
  112. <span class="option">remove frames</span>
  113. <p>Check this option to remove all frame and iframe elements. This can considerably reduce the size of the file without
  114. altering the document most of the time.</p>
  115. <p class="notice">It is recommended to
  116. <u>check</u> this option</p>
  117. </li>
  118. <li>
  119. <span class="option">remove hidden elements</span>
  120. <p>Check this option to remove all hidden elements. This option can considerably reduce the size of the file without
  121. altering the document most of the time.</p>
  122. <p class="notice">It is recommended to
  123. <u>check</u> this option</p>
  124. </li>
  125. <li>
  126. <span class="option">save raw page</span>
  127. <p>Check this option to save the page without interpreting JavaScript. Checking this option may alter the document.</p>
  128. <p class="notice">It is recommended to
  129. <u>uncheck</u> this option</p>
  130. </li>
  131. <li>
  132. <span class="option">remove scripts</span>
  133. <p>Check this option to remove all scripts. Unchecking this option may alter the document.</p>
  134. <p class="notice">It is recommended to
  135. <u>check</u> this option</p>
  136. </li>
  137. <li>
  138. <span class="option">remove video sources</span>
  139. <p>Check this option to empty the "src" attribute of all video elements.</p>
  140. <p class="notice">It is recommended to
  141. <u>check</u> this option</p>
  142. </li>
  143. <li>
  144. <span class="option">remove audio sources</span>
  145. <p>Check this option to empty the "src" attribute of all audio elements.</p>
  146. <p class="notice">It is recommended to
  147. <u>check</u> this option</p>
  148. </li>
  149. <li>
  150. <span class="option">compress CSS</span>
  151. <p>Check this option to minify CSS stylesheets. This helps to reduce the size of the file without altering the document.</p>
  152. <p class="notice">It is recommended to
  153. <u>check</u> this option</p>
  154. </li>
  155. <li>
  156. <span class="option">remove unused CSS rules</span>
  157. <p>Check this option to remove all CSS rules that do not match any element. Checking this this option should not alter
  158. the document and can considerably reduce the size of the file.</p>
  159. <p class="notice">It is recommended to
  160. <u>check</u> this option</p>
  161. </li>
  162. <li>
  163. <span class="option">save lazy loaded images</span>
  164. <p>Check this option to save all the lazy loaded images that are not displayed. This may help to save all the images
  165. without scrolling the page. This feature is not guaranteed to work on all sites.</p>
  166. <p class="notice">It is recommended to
  167. <u>check</u> this option</p>
  168. </li>
  169. <li>
  170. <span class="option">set a maximum size for embedded resources (Mb)</span>
  171. <p>Specify the maximum size of embedded resources (i.e. images, stylesheets, scripts and iframes) in megabytes.
  172. </p>
  173. </li>
  174. <li>
  175. <span class="option">save pages in background</span>
  176. <p>Uncheck this option if you get invalid file names like "37bec68b-446a-46a5-8642-19a89c231b46.html" when saving pages.
  177. </p>
  178. <p class="notice">It is recommended to
  179. <u>check</u> this option</p>
  180. </li>
  181. <li>
  182. <span class="option">auto-save wait delay (sec.)</span>
  183. <p>Specify the time to wait in seconds before saving a page when auto-save is active.
  184. </p>
  185. </li>
  186. <li>
  187. <span class="option">Reset to default options</span>
  188. <p>Reset all the options to their default value.</p>
  189. </li>
  190. </ul>
  191. </li>
  192. <li>
  193. <a id="notes">Technical notes</a>
  194. <ul>
  195. <li>All images are converted into
  196. <a href="http://en.wikipedia.org/wiki/Base64">base64</a>.
  197. </li>
  198. <li>All resources except frame contents are injected in the document using
  199. <a href="http://en.wikipedia.org/wiki/Data_URI_scheme">data URI scheme</a>.
  200. </li>
  201. <li>Frame contents are injected as text in the document by using the srcdoc attribute.
  202. </li>
  203. </ul>
  204. </li>
  205. <li>
  206. <a id="known-issues">Known issues</a>
  207. <ul>
  208. <li>
  209. All browsers
  210. <ul>
  211. <li>After installing the extension, if you want to save a tab that was already opened then you need to refresh it
  212. first.
  213. </li>
  214. <li>For security reasons, you cannot save pages hosted on https://chrome.google.com or https://addons.mozilla.org.</li>
  215. </ul>
  216. </li>
  217. <li>
  218. Chrome/Opera
  219. <ul>
  220. <li>You must enable the option "Allow access to file URLs" in the extension page to display the infobar when viewing
  221. a saved page, or to save a page stored on the filesystem.</li>
  222. <li>If saved pages have file names like "4e5a13fd-6638-4a37-a34b-a3c104ac66b1" instead of the title then it means
  223. another extension is conflicting with SingleFile. You can uncheck the option "save pages in background" to circumvent
  224. this issue.
  225. </li>
  226. </ul>
  227. </li>
  228. <li>
  229. Firefox
  230. <ul>
  231. <li>You cannot save selected tabs via the context menu since multiple tabs cannot be selected.</li>
  232. </ul>
  233. </li>
  234. <li>
  235. Edge
  236. <ul>
  237. <li>The file name looks like "4e5a13fd-6638-4a37-a34b-a3c104ac66b1".</li>
  238. </ul>
  239. </li>
  240. </ul>
  241. </li>
  242. <li>
  243. <a id="unknown-issues">Troubleshooting unknown issues</a>
  244. <p>Please follow these steps if you find an unknown issue:</p>
  245. <ul>
  246. <li>Reset SingleFile options.</li>
  247. <li>If resetting options did not fix the issue, try to disable all other extensions to see if there is a conflict.</li>
  248. <li>If there is a conflict then try to determine against which extension(s).</li>
  249. <li>Please report the issue
  250. <a href="https://github.com/gildas-lormeau/SingleFile/issues">here</a> with a short description describing how to reproduce
  251. the issue, Browser version, OS name and version.</li>
  252. </ul>
  253. <p>Suggestions are welcome :)</p>
  254. </li>
  255. </ol>
  256. </div>
  257. </body>
  258. </html>