| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119 |
- <!DOCTYPE html>
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- <title>SingleFile help</title>
- <link rel="stylesheet" href="help.css">
- </head>
- <body>
- <div>
- <div id="titleBorder">
- <h2><img src="../resources/icon_48.png" id="titleIcon"><span id="title">SingleFile help</span></h2>
- <h4>SingleFile helps you to archive a complete page into a single HTML file.</h4>
- </div>
- <span id="index"><a href="#instructions">Instructions</a> - <a href="#demo">Demo</a> - <a href="#options">Options description</a> - <a href="#notes">Technical notes</a> - <a
- href="#knownIssues">Known issues</a> - <a href="#unknownIssues">Unknown issues</a></span>
- <hr>
- <ol>
- <li><a name="instructions">Instructions</a>
- <ul>
- <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
- are displayed</li>
- <li>click on the SingleFile icon <img src="../resources/icon_48.png" id="icon"> in the chrome toobar</li>
- <li>wait until the the shadow disappears then hit Ctrl-S or select "Save as" in the wrench menu and save the page</li>
- <li>all images, style sheets and (almost all) frame contents are embedded into the ".htm" saved file</li>
- </ul>
- </li>
- <li><a name="demo">Demo : SingleFile advantages over default file save</a>
- <div><object width="480" height="385">
- <param name="movie" value="http://www.youtube.com/v/D99LfOF3qis&hl=fr_FR&fs=1&">
- <param name="allowFullScreen" value="true">
- <param name="allowscriptaccess" value="always">
- <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>
- </div>
- </li>
- <li><a name="options">Options description</a>
- <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
- chrome toobar and select "Options" in the context menu to open the options page.</p>
- <div class="screenshot"></div>
- <p>Details :</p>
- <ul>
- <li><span class="option">remove frames</span>
- <p>Remove all frames on the page</p>
- <p>You can enable this option if the file size is too large when disabled or to remove some ads.</p>
- <p class="notice">It is recommended to <u>disable</u> this option</p>
- </li>
- <li><span class="option">remove scripts</span>
- <p>Remove all javascript scripts</p>
- <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
- dynamic behavior may not work or document can be altered when opening the saved file</p>
- <p class="notice">It is recommended to <u>enable</u> this option</p>
- </li>
- <li><span class="option">remove objects</span>
- <p>Remove all objects</p>
- <p>Remove all non embeddable elements : flash, java applet ...</p>
- <p class="notice">It is recommended to <u>enable</u> this option if you want to read the saved page offline</p>
- </li>
- <li><span class="option">remove hidden elements</span>
- <p>Remove all hidden elements</p>
- <p>Remove all the HTML unvisible elements on the page (with <code>visibility = "hidden"</code> or <code>display = "none"</code> or <code>opacity =
- 0</code> CSS property values). This option may alter the document but can considerably reduce the saved file size.</p>
- <p class="notice">It is recommended to <u>disable</u> this option unless the saved file size is too large</p>
- </li>
- <li><span class="option">remove unused CSS rules</span>
- <p>Remove all unused CSS rules</p>
- <p>Remove all CSS rules that do not match any element. 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 page when opening it into another browser (i.e. not based on Webkit).</p>
- <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>
- </li>
- <li><span class="option">Reset to default options</span>
- <p>Reset all the options to default state</p>
- </li>
- </ul>
- <p>Note : All options are automatically saved</p>
- </li>
- <li><a name="notes">Technical notes</a>
- <ul>
- <li>it is technically not possible to add a "Save" button into chrome extensions or change "Save as" dialog box behavior into pure javascript chrome extensions</li>
- <li>all images are converted into <a href="http://en.wikipedia.org/wiki/Base64">base64</a></li>
- <li>frame document contents are encoded with <a href="http://en.wikipedia.org/wiki/Utf_8">utf-8 charset</a></li>
- <li>encoded contents are injected in the document using <a href="http://en.wikipedia.org/wiki/Data_URI_scheme" target="_blank">data URI scheme</a></li>
- <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
- smaller than 32 KB)</li>
- <li>SVG images are supported (SVG document is converted into utf-8 but is not processed)</li>
- </ul>
- </li>
- <li><a name="knownIssues">Known issues</a>
- <ul>
- <li>frames or SVG images without src attribute or with empty src attribute value are not embedded</li>
- <li>SingleFile does not always work when javascript is blocked by chrome (see <a href="http://www.google.com/support/chrome/bin/answer.py?hl=en&answer=114662">"content
- settings/Javascript" tab in chrome options</a>)</li>
- </ul>
- </li>
- <li><a name="unknownIssues">Unknown issues</a>
- <p>If you find an unknown issue (i.e. frozen process, extra saved files, blank or altered document, tab crash...) :</p>
- <ul>
- <li>test with only <span class="option">remove frames</span>, <span class="option">remove scripts</span> and <span class="option">remove objects</span> enabled in options
- page</li>
- <li>disable all other extensions to see if there is a conflict</li>
- <li>if there is a conflict, try to determine against which extension(s)</li>
- <li>report the issue <a href="https://chrome.google.com/extensions/detail/mpiodijhokgodhhofbcjdecpffjipkle" target="_blank">here</a> with a short description, URL(s), chrome
- version, OS version</li>
- </ul>
- </li>
- </ol>
- </div>
- </body>
- </html>
|