Inicio Explorar Axuda
Iniciar sesión
mirrors
/
SingleFile
réplica de https://github.com/gildas-lormeau/SingleFile
1
0
Fork 0
Ficheiros Incidencias 0 Wiki
Árbore: 385a3cae36
Ramas Etiquetas
SingleFile
/
WebContent
/
ui
/
pages
/
help.html

help.html 10 KB
Histórico Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173 
  1. <!DOCTYPE html>
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

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

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

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

  7. </head>
    8. 

  8. <body>
    9. 

  9. <div>
    10. 

  10. <div id="titleBorder">
    11. 

  11. <h2><img src="../resources/icon_48.png" id="titleIcon"><span id="title">SingleFile help</span></h2>
    12. 

  12. <h4>SingleFile helps you to archive a complete page into a single HTML file.</h4>
    13. 

  13. </div>
    14. 

  14. <span id="index"><a href="#instructions">Instructions</a> - <a href="#demo">Demo</a> - <a href="#options">Options description</a> - <a href="#folder">Saved archives
    15. 

  15. folder</a> - <a href="#notes">Technical notes</a> - <a href="#knownIssues">Known issues</a> - <a href="#unknownIssues">Unknown issues</a></span>
    16. 

  16. <hr>
    17. 

  17. <ol>
    18. 

  18. 	<li><a id="instructions">Instructions</a>
    19. 

  19. 	<ul>
    20. 

  20. 		<li>wait until the page is fully loaded : you may need to scroll down the entire page and hover dynamic document elements (e.g. "rollover" images) to be sure all elements
    21. 

  21. 		are displayed</li>
    22. 

  22. 		<li>click on the SingleFile icon <img src="../resources/icon_48.png" id="icon"> in the Chrome toolbar or press Ctrl-Shift-S shortcut or use context menu to launch page
    23. 

  23. 		processing</li>
    24. 

  24. 		<li>wait until the shadow disappears then hit Ctrl-S or select "Save as" in the wrench menu and save the page</li>
    25. 

  25. 		<li>all images, style sheets and frame contents are embedded into the ".htm" saved file</li>
    26. 

  26. 	</ul>
    27. 

  27. 	</li>
    28. 

  28. 

  29. 	<li><a id="demo">Demo : SingleFile advantages over default file save</a>
    30. 

  30. 	<div><object width="480" height="385">
    31. 

  31. 		<param name="movie" value="http://www.youtube.com/v/D99LfOF3qis&hl=fr_FR&fs=1&">
    32. 

  32. 		<param name="allowFullScreen" value="true">
    33. 

  33. 		<param name="allowscriptaccess" value="always">
    34. 

  34. 		<embed src="http://www.youtube.com/v/D99LfOF3qis&hl=fr_FR&fs=1&" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="480" height="385"></object>
    35. 

  35. 	</div>
    36. 

  36. 	<li><a id="options">Options description</a>
    37. 

  37. 

  38. 	<p>You can customize the way SingleFile process the page through the options page. Right-click on SingleFile icon <img src="../resources/icon_48.png" id="icon"> in the
    39. 

  39. 	Chrome toolbar and select "Options" in the context menu to open the options page.</p>
    40. 

  40. 	<div class="screenshot"></div>
    41. 

  41. 	<p>Details :</p>
    42. 

  42. 	<ul>
    43. 

  43. 		<li><span class="option">remove frames</span>
    44. 

  44. 		<p>Remove all frames on the page</p>
    45. 

  45. 		<p>You can enable this option if the file size is too large when disabled or to remove some ads.</p>
    46. 

  46. 		<p class="notice">It is recommended to <u>disable</u> this option</p>
    47. 

  47. 		</li>
    48. 

  48. 

  49. 		<li><span class="option">remove scripts</span>
    50. 

  50. 		<p>Remove all javascript scripts</p>
    51. 

  51. 		<p>Most of the time, you don't need javascript into the saved page. If your want to save the page dynamic behavior, you may need to disable this option. Nevertheless, the
    52. 

  52. 		dynamic behavior may not work or document can be altered when opening the saved file.<br>
    53. 

  53. 		It is recommended to enable <span class="option">process raw document</span> if you disable this option.</p>
    54. 

  54. 		<p class="notice">It is recommended to <u>enable</u> this option</p>
    55. 

  55. 		</li>
    56. 

  56. 

  57. 		<li><span class="option">remove objects</span>
    58. 

  58. 		<p>Remove all objects</p>
    59. 

  59. 		<p>Remove all non embeddable elements : flash, java applet ...</p>
    60. 

  60. 		<p class="notice">It is recommended to <u>enable</u> this option if you want to read the saved page offline</p>
    61. 

  61. 		</li>
    62. 

  62. 

  63. 		<li><span class="option">remove hidden elements</span>
    64. 

  64. 		<p>Remove all hidden elements</p>
    65. 

  65. 		<p>Remove all the HTML unvisible elements on the page (with <code>visibility = "hidden"</code>&nbsp;or&nbsp;<code>display = "none"</code>&nbsp;or&nbsp;<code>opacity =
    66. 

  66. 		0</code> CSS property values). This option may alter the document but can considerably reduce the saved file size.</p>
    67. 

  67. 		<p class="notice">It is recommended to <u>disable</u> this option unless the saved file size is too large</p>
    68. 

  68. 		</li>
    69. 

  69. 

  70. 		<li><span class="option">remove unused CSS rules</span>
    71. 

  71. 		<p>Remove all CSS rules that do not match any element</p>
    72. 

  72. 		<p>This option may alter the document but can considerably reduce the saved file size. If you enable this option, it may introduce some incompatibilities issues in the saved
    73. 

  73. 		page when opening it into another browser (i.e. not based on Webkit).</p>
    74. 

  74. 		<p class="notice">It is recommended to <u>disable</u> this option unless the saved file size is too large or you do not want to open the saved page into another browser</p>
    75. 

  75. 		</li>
    76. 

  76. 

  77. 		<li><span class="option">scrapbook the page</span>
    78. 

  78. 		<p>Send the archived page to <a href="https://chrome.google.com/webstore/detail/ihkkeoeinpbomhnpkmmkpggkaefincbn">Scrapbook for SingleFile</a></p>
    79. 

  79. 		<p>This option allows to use SingleFile action icon as a shortcut to send the viewed page to <a
    80. 

  80. 			href="https://chrome.google.com/webstore/detail/ihkkeoeinpbomhnpkmmkpggkaefincbn">Scrapbook for SingleFile</a> extension if installed.</p>
    81. 

  81. 		<p class="notice">It is recommended to <u>disable</u> this option unless you want to use SingleFile icon to scrapbook pages</p>
    82. 

  82. 		</li>
    83. 

  83. 

  84. 		<li><span class="option">process in background</span>
    85. 

  85. 		<p>Process the page in background</p>
    86. 

  86. 		<p>Processing in background means it won't be blocking (*). If you disable this option, a shadow will prevent you to use the page during the SingleFile processing. Even
    87. 

  87. 		though processing may be faster.</p>
    88. 

  88. 		<p class="notice">It is recommended to <u>disable</u> this option unless <span class="option">display processed page</span> option is disabled</p>
    89. 

  89. 		</li>
    90. 

  90. 

  91. 		<li><span class="option">save processed page (*)</span>
    92. 

  92. 		<p>Save the page on filesystem</p>
    93. 

  93. 		<p>When enabled this option allows to save automatically archives on filesystem. See <a href="#folder">Saved archives folder</a> for more details.</p>
    94. 

  94. 		<p class="notice">It is recommended to <u>disable</u> this option unless you want files to be automatically saved</p>
    95. 

  95. 		</li>
    96. 

  96. 

  97. 		<li><span class="option">display processed page (*)</span>
    98. 

  98. 		<p>Display the processed page in the tab</p>
    99. 

  99. 		<p>This option must be enabled if you want to use Chrome "Save as" dialog box to save the processed page. To improve processing speed, you should disable <span class="option">process
    100. 

  100. 		in background</span> when this option is enabled.</p>
    101. 

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

  102. 		</li>
    103. 

  103. 

  104. 		<li><span class="option">max filename length (*)</span>
    105. 

  105. 		<p>Maximum filename length</p>
    106. 

  106. 		<p>Since filesystem restricts filename length and the extension cannot guess this value, you can set it to the maximum allowed by your Operating System.</p>
    107. 

  107. 		<p class="notice">It is recommended to set this option to <u>90</u> if you are using Windows</p>
    108. 

  108. 		</li>
    109. 

  109. 

  110. 		<li><span class="option">process raw document</span>
    111. 

  111. 		<p>Process the raw downloaded document</p>
    112. 

  112. 		<p>This option allows SingleFile to process the downloaded document instead of the displayed document. The main difference is that JavaScript scripts won't be parsed and
    113. 

  113. 		executed. Frames won't be embedded too.</p>
    114. 

  114. 		<p class="notice">It is recommended to <u>disable</u> this option unless <span class="option">remove scripts</span> is disabled</p>
    115. 

  115. 		</li>
    116. 

  116. 

  117. 		<li><span class="option">Reset to default options</span>
    118. 

  118. 		<p>Reset all the options to default state</p>
    119. 

  119. 		</li>
    120. 

  120. 	</ul>
    121. 

  121. 	</li>
    122. 

  122. 

  123. 	<li><a id="folder">Saved archives folder (*)</a>
    124. 

  124. 	<p>When <span class="option">save processed page</span> is enabled, pages will be automatically saved but Chrome will not allow to choose the root folder where archives are
    125. 

  125. 	stored. Neither it will allow to make links pointing to saved files folder. So you have to find "manually" the this folder.</p>
    126. 

  126. 	<p>Files are saved in "FileSystem" folder located into Chrome user data folder:</p>
    127. 

  127. 	<ul style="text-align: left">
    128. 

  128. 		<li>Windows default path: <br>
    129. 

  129. 		<span class="option">%LOCALAPPDATA%\Google\Chrome\User&nbsp;Data\Default\FileSystem\chrome-extension_jemlklgaibiijojffihnhieihhagocma_0\Persistent\</span></li>
    130. 

  130. 		<li>Linux default path: <br>
    131. 

  131. 		<span class="option">~/.config/google-chrome/Default/FileSystem/chrome-extension_jemlklgaibiijojffihnhieihhagocma_0/Persistent/</span></li>
    132. 

  132. 		<li>Mac OS X default path: <br>
    133. 

  133. 		<span class="option">~/Library/Application&nbsp;Support/Google/Chrome/Default/FileSystem/chrome-extension_jemlklgaibiijojffihnhieihhagocma_0/Persistent/</span></li>
    134. 

  134. 	</ul>
    135. 

  135. 	<p>You can create symbolic links to help you to access easily to this folder and use sync services like dropbox. Here are the way of doing it on <a
    136. 

  136. 		href="http://technet.microsoft.com/en-us/library/cc753194(WS.10).aspx">windows (mklink /d)</a> and <a href="http://www.unixtutorial.org/commands/ln/">linux or Mac OS X (ln
    137. 

  137. 	-s)</a>.</p>
    138. 

  138. 	<p>You can also change Chrome user data folder with <a href="http://www.chromium.org/user-experience/user-data-directory">--user-data-dir switch</a>.
    139. 

  139. 	</li>
    140. 

  140. 

  141. 	<li><a id="notes">Technical notes</a>
    142. 

  142. 	<ul>
    143. 

  143. 		<li>all images are converted into <a href="http://en.wikipedia.org/wiki/Base64">base64</a></li>
    144. 

  144. 		<li>frame document contents and automatically saved pages are encoded with <a href="http://en.wikipedia.org/wiki/Utf_8">utf-8 charset</a></li>
    145. 

  145. 		<li>encoded contents are injected in the document using <a href="http://en.wikipedia.org/wiki/Data_URI_scheme">data URI scheme</a></li>
    146. 

  146. 		<li>data URI scheme is supported by the following web browsers: Chrome, Firefox, Opera, Safari, Konqueror and Internet Explorer 8 (limited support : data URIs must be
    147. 

  147. 		smaller than 32 KB, embedded frames are not supported)</li>
    148. 

  148. 		<li>SVG images are supported (SVG document is converted into utf-8 but is not processed)</li>
    149. 

  149. 	</ul>
    150. 

  150. 	</li>
    151. 

  151. 

  152. 	<li><a id="knownIssues">Known issues</a>
    153. 

  153. 	<ul>
    154. 

  154. 		<li>SVG images without src attribute or with empty src attribute are not embedded</li>		
    155. 

  155. 	</ul>
    156. 

  156. 	</li>
    157. 

  157. 

  158. 	<li><a id="unknownIssues">Unknown issues</a>
    159. 

  159. 	<p>If you find an unknown issue (i.e. frozen process, extra saved files, blank or altered document, tab crash...):</p>
    160. 

  160. 	<ul>
    161. 

  161. 		<li>reset options</li>
    162. 

  162. 		<li>disable all other extensions to see if there is a conflict</li>
    163. 

  163. 		<li>if there is a conflict, try to determine against which extension(s)</li>
    164. 

  164. 	</ul>
    165. 

  165. 	<p>Report the issue <a href="https://chrome.google.com/webstore/detail/mpiodijhokgodhhofbcjdecpffjipkle">here</a> with a short description, URL(s), Chrome version, OS version</p>
    166. 

  166. 	</li>
    167. 

  167. </ol>
    168. 

  168. <br>
    169. 

  169. <p class="availability">*: feature only available on Chrome 9+</p>
    170. 

  170. <a href="http://www.w3.org/html/logo/"> <img src="../resources/html5-badge-h-storage.png" alt="HTML5 offline & storage logo" id="logo-html5"
    171. 

  171. 	title="This extension is powered by HTML5 Offline & Storage"> </a></div>
    172. 

  172. </body>
    173. 

  173. </html>
    174.