|
@@ -27,7 +27,8 @@
|
|
|
<li>
|
|
<li>
|
|
|
<a id="getting-started">Getting started</a>
|
|
<a id="getting-started">Getting started</a>
|
|
|
<ul>
|
|
<ul>
|
|
|
- <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>
|
|
|
|
|
|
|
+ <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>
|
|
|
<li>Click on the SingleFile button
|
|
<li>Click on the SingleFile button
|
|
|
<img src="../resources/icon_16.png" class="icon"> in the extension toolbar to save the page.</li>
|
|
<img src="../resources/icon_16.png" class="icon"> in the extension toolbar to save the page.</li>
|
|
|
</ul>
|
|
</ul>
|
|
@@ -39,7 +40,8 @@
|
|
|
<img src="../resources/icon_16.png" class="icon">.</li>
|
|
<img src="../resources/icon_16.png" class="icon">.</li>
|
|
|
<li>
|
|
<li>
|
|
|
Open the context menu by right-clicking the SingleFile button
|
|
Open the context menu by right-clicking the SingleFile button
|
|
|
- <img src="../resources/icon_16.png" class="icon"> in the extension toolbar or on the webpage. It allows you to save:
|
|
|
|
|
|
|
+ <img src="../resources/icon_16.png" class="icon"> in the extension toolbar or on the webpage. It allows you to
|
|
|
|
|
+ save:
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>the current tab,</li>
|
|
<li>the current tab,</li>
|
|
|
<li>or the selected content,</li>
|
|
<li>or the selected content,</li>
|
|
@@ -62,7 +64,8 @@
|
|
|
<li>or all tabs.</li>
|
|
<li>or all tabs.</li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
|
- <li>With auto-save active, pages are automatically saved every time after being loaded (or before being unloaded if
|
|
|
|
|
|
|
+ <li>With auto-save active, pages are automatically saved every time after being loaded (or before being unloaded
|
|
|
|
|
+ if
|
|
|
not).
|
|
not).
|
|
|
</li>
|
|
</li>
|
|
|
<li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
|
|
<li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
|
|
@@ -73,15 +76,18 @@
|
|
|
<li>
|
|
<li>
|
|
|
<a id="options">Options description</a>
|
|
<a id="options">Options description</a>
|
|
|
<p>You can customize SingleFile through the options page. Right-click on SingleFile button
|
|
<p>You can customize SingleFile through the options page. Right-click on SingleFile button
|
|
|
- <img src="../resources/icon_16.png" class="icon"> in the browser toolbar and select "Options"/"Manage extension" in
|
|
|
|
|
|
|
+ <img src="../resources/icon_16.png" class="icon"> in the browser toolbar and select "Options"/"Manage extension"
|
|
|
|
|
+ in
|
|
|
the context menu to open the options page.</p>
|
|
the context menu to open the options page.</p>
|
|
|
<p>User interface</p>
|
|
<p>User interface</p>
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">add entry in the context menu of the webpage</span>
|
|
<span class="option">add entry in the context menu of the webpage</span>
|
|
|
- <p>Check this option to display an entry for SingleFile in the context menu of the webpage. The context menu of the
|
|
|
|
|
|
|
+ <p>Check this option to display an entry for SingleFile in the context menu of the webpage. The context menu of
|
|
|
|
|
+ the
|
|
|
SingleFile button
|
|
SingleFile button
|
|
|
- <img src="../resources/icon_16.png" class="icon"> in the extension toolbar is displayed wether this option is checked
|
|
|
|
|
|
|
+ <img src="../resources/icon_16.png" class="icon"> in the extension toolbar is displayed wether this option is
|
|
|
|
|
+ checked
|
|
|
or not.
|
|
or not.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -90,7 +96,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">overlay a shadow on the page during processing</span>
|
|
<span class="option">overlay a shadow on the page during processing</span>
|
|
|
- <p>Check this option to overlay a shadow on the page when SingleFile is retrieving page resources. This reminds you
|
|
|
|
|
|
|
+ <p>Check this option to overlay a shadow on the page when SingleFile is retrieving page resources. This reminds
|
|
|
|
|
+ you
|
|
|
that you should not close the tab.
|
|
that you should not close the tab.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -99,7 +106,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">display an infobar when viewing archives</span>
|
|
<span class="option">display an infobar when viewing archives</span>
|
|
|
- <p>Check this option to display the ❔ button at the top right of the page when viewing a saved page. By clicking this
|
|
|
|
|
|
|
+ <p>Check this option to display the ❔ button at the top right of the page when viewing a saved page. By clicking
|
|
|
|
|
+ this
|
|
|
icon, you can get more information about the saved date and open the original URL.
|
|
icon, you can get more information about the saved date and open the original URL.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -118,8 +126,10 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">open the "Save as" dialog to confirm the file name</span>
|
|
<span class="option">open the "Save as" dialog to confirm the file name</span>
|
|
|
- <p>Check this option to display the "Save as" dialog in order to confirm the file name before saving the page. If the
|
|
|
|
|
- option "save pages in background" is unchecked then a prompt dialog will be displayed instead of the "Save as" dialog.
|
|
|
|
|
|
|
+ <p>Check this option to display the "Save as" dialog in order to confirm the file name before saving the page. If
|
|
|
|
|
+ the
|
|
|
|
|
+ option "save pages in background" is unchecked then a prompt dialog will be displayed instead of the "Save as"
|
|
|
|
|
+ dialog.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>uncheck</u> this option</p>
|
|
<u>uncheck</u> this option</p>
|
|
@@ -129,7 +139,8 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">compress HTML</span>
|
|
<span class="option">compress HTML</span>
|
|
|
- <p>Check this option to remove all HTML comments, and unneeded spaces or returns. This helps to reduce the size of
|
|
|
|
|
|
|
+ <p>Check this option to remove all HTML comments, and unneeded spaces or returns. This helps to reduce the size
|
|
|
|
|
+ of
|
|
|
the file without altering the document.</p>
|
|
the file without altering the document.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -137,7 +148,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove HTML import</span>
|
|
<span class="option">remove HTML import</span>
|
|
|
- <p>Check this option to remove all link elements used to import HTML documents. This can reduce the size of the file
|
|
|
|
|
|
|
+ <p>Check this option to remove all link elements used to import HTML documents. This can reduce the size of the
|
|
|
|
|
+ file
|
|
|
without altering the document most of the time.</p>
|
|
without altering the document most of the time.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -145,8 +157,10 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove frames</span>
|
|
<span class="option">remove frames</span>
|
|
|
- <p>Check this option to remove all frame and iframe elements. This can considerably reduce the size of the file without
|
|
|
|
|
- altering the document most of the time. Checking this this option option may also increase the time needed to save
|
|
|
|
|
|
|
+ <p>Check this option to remove all frame and iframe elements. This can considerably reduce the size of the file
|
|
|
|
|
+ without
|
|
|
|
|
+ altering the document most of the time. Checking this this option option may also increase the time needed to
|
|
|
|
|
+ save
|
|
|
a page</p>
|
|
a page</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -154,7 +168,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove hidden elements</span>
|
|
<span class="option">remove hidden elements</span>
|
|
|
- <p>Check this option to remove all hidden elements. This option can considerably reduce the size of the file without
|
|
|
|
|
|
|
+ <p>Check this option to remove all hidden elements. This option can considerably reduce the size of the file
|
|
|
|
|
+ without
|
|
|
altering the document most of the time.</p>
|
|
altering the document most of the time.</p>
|
|
|
</li>
|
|
</li>
|
|
|
</ul>
|
|
</ul>
|
|
@@ -162,7 +177,8 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">save lazy loaded images</span>
|
|
<span class="option">save lazy loaded images</span>
|
|
|
- <p>Check this option to save all the lazy loaded images that are not displayed. This may help to save all the images
|
|
|
|
|
|
|
+ <p>Check this option to save all the lazy loaded images that are not displayed. This may help to save all the
|
|
|
|
|
+ images
|
|
|
without scrolling the page. This feature is not guaranteed to work on all sites.</p>
|
|
without scrolling the page. This feature is not guaranteed to work on all sites.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -170,7 +186,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove images for alternative resolutions</span>
|
|
<span class="option">remove images for alternative resolutions</span>
|
|
|
- <p>Check this option to remove images that are alternatives in lower and/or higher resolutions to the ones displayed
|
|
|
|
|
|
|
+ <p>Check this option to remove images that are alternatives in lower and/or higher resolutions to the ones
|
|
|
|
|
+ displayed
|
|
|
by default. Checking this this option can considerably reduce the size of the file in some cases.</p>
|
|
by default. Checking this this option can considerably reduce the size of the file in some cases.</p>
|
|
|
</li>
|
|
</li>
|
|
|
</ul>
|
|
</ul>
|
|
@@ -178,7 +195,8 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">compress CSS</span>
|
|
<span class="option">compress CSS</span>
|
|
|
- <p>Check this option to minify CSS stylesheets. This helps to reduce the size of the file without altering the document.
|
|
|
|
|
|
|
+ <p>Check this option to minify CSS stylesheets. This helps to reduce the size of the file without altering the
|
|
|
|
|
+ document.
|
|
|
It also prevents the same resource from being saved several times from a stylesheet by using CSS variables.
|
|
It also prevents the same resource from being saved several times from a stylesheet by using CSS variables.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -187,8 +205,10 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove unused styles</span>
|
|
<span class="option">remove unused styles</span>
|
|
|
- <p>Check this option to remove all CSS rules and styles that do not match any element. Checking this this option should
|
|
|
|
|
- not alter the document and can considerably reduce the size of the file. Checking this this option option may also
|
|
|
|
|
|
|
+ <p>Check this option to remove all CSS rules and styles that do not match any element. Checking this this option
|
|
|
|
|
+ should
|
|
|
|
|
+ not alter the document and can considerably reduce the size of the file. Checking this this option option may
|
|
|
|
|
+ also
|
|
|
increase the CPU consumption and the time needed to save a page.</p>
|
|
increase the CPU consumption and the time needed to save a page.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -196,8 +216,10 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove alternative fonts to woff/otf and unused font rules</span>
|
|
<span class="option">remove alternative fonts to woff/otf and unused font rules</span>
|
|
|
- <p>Check this option to remove fonts that are alternatives to the Web Open Font or OpenType formats, and CSS font rules
|
|
|
|
|
- that are not used. Checking this this option should not alter the document and can considerably reduce the size of
|
|
|
|
|
|
|
+ <p>Check this option to remove fonts that are alternatives to the Web Open Font or OpenType formats, and CSS font
|
|
|
|
|
+ rules
|
|
|
|
|
+ that are not used. Checking this this option should not alter the document and can considerably reduce the size
|
|
|
|
|
+ of
|
|
|
the file in some cases.</p>
|
|
the file in some cases.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
@@ -205,7 +227,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove stylesheets for alternative devices</span>
|
|
<span class="option">remove stylesheets for alternative devices</span>
|
|
|
- <p>Check this option to remove stylesheets that are not used for the screen display like stylesheets for print preview
|
|
|
|
|
|
|
+ <p>Check this option to remove stylesheets that are not used for the screen display like stylesheets for print
|
|
|
|
|
+ preview
|
|
|
and speech synthesizers. Checking this this option can reduce the size of the file.</p>
|
|
and speech synthesizers. Checking this this option can reduce the size of the file.</p>
|
|
|
</li>
|
|
</li>
|
|
|
</ul>
|
|
</ul>
|
|
@@ -213,7 +236,8 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">remove scripts</span>
|
|
<span class="option">remove scripts</span>
|
|
|
- <p>Check this option to remove all scripts. Unchecking this option may alter the document and lead to security issues.</p>
|
|
|
|
|
|
|
+ <p>Check this option to remove all scripts. Unchecking this option may alter the document and lead to security
|
|
|
|
|
+ issues.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>check</u> this option</p>
|
|
<u>check</u> this option</p>
|
|
|
</li>
|
|
</li>
|
|
@@ -236,9 +260,12 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">auto-save on page load or unload</span>
|
|
<span class="option">auto-save on page load or unload</span>
|
|
|
- <p>Check this option to auto-save pages after being loaded. If you browse to another page before the page is fully
|
|
|
|
|
- loaded then the page will be saved just before being unloaded. With this option active, you are guaranteed pages will
|
|
|
|
|
- always be saved but some frame contents may be missing (if you unchecked "remove frames") when pages are saved before
|
|
|
|
|
|
|
+ <p>Check this option to auto-save pages after being loaded. If you browse to another page before the page is
|
|
|
|
|
+ fully
|
|
|
|
|
+ loaded then the page will be saved just before being unloaded. With this option active, you are guaranteed pages
|
|
|
|
|
+ will
|
|
|
|
|
+ always be saved but some frame contents may be missing (if you unchecked "remove frames") when pages are saved
|
|
|
|
|
+ before
|
|
|
being unloaded.
|
|
being unloaded.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -252,15 +279,18 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">auto-save on page unload</span>
|
|
<span class="option">auto-save on page unload</span>
|
|
|
- <p>Check this option to auto-save pages before being unloaded instead of saving pages after being loaded. With this
|
|
|
|
|
- option active, you are guaranteed pages will always be saved but some frame contents may be missing (if you unchecked
|
|
|
|
|
|
|
+ <p>Check this option to auto-save pages before being unloaded instead of saving pages after being loaded. With
|
|
|
|
|
+ this
|
|
|
|
|
+ option active, you are guaranteed pages will always be saved but some frame contents may be missing (if you
|
|
|
|
|
+ unchecked
|
|
|
"remove frames").
|
|
"remove frames").
|
|
|
</p>
|
|
</p>
|
|
|
</li>
|
|
</li>
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">auto-save wait delay after load (sec.)</span>
|
|
<span class="option">auto-save wait delay after load (sec.)</span>
|
|
|
- <p>Specify the amount of time in seconds to wait before saving a page when the "auto-save on page load or on page unload"
|
|
|
|
|
|
|
+ <p>Specify the amount of time in seconds to wait before saving a page when the "auto-save on page load or on page
|
|
|
|
|
+ unload"
|
|
|
or "auto-save on page load" is checked.
|
|
or "auto-save on page load" is checked.
|
|
|
</p>
|
|
</p>
|
|
|
</li>
|
|
</li>
|
|
@@ -269,8 +299,10 @@
|
|
|
<ul>
|
|
<ul>
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">save pages in background</span>
|
|
<span class="option">save pages in background</span>
|
|
|
- <p>Uncheck this option if you get invalid file names like "37bec68b-446a-46a5-8642-19a89c231b46.html" or interrupted downloads
|
|
|
|
|
- when saving pages or if you prefer to use the prompt dialog instead of the "Save as" dialog when "open the 'Save as' dialog
|
|
|
|
|
|
|
+ <p>Uncheck this option if you get invalid file names like "37bec68b-446a-46a5-8642-19a89c231b46.html" or
|
|
|
|
|
+ interrupted downloads
|
|
|
|
|
+ when saving pages or if you prefer to use the prompt dialog instead of the "Save as" dialog when "open the 'Save
|
|
|
|
|
+ as' dialog
|
|
|
to confirm the file name" option is checked.
|
|
to confirm the file name" option is checked.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -279,7 +311,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">display stats in the console after processing</span>
|
|
<span class="option">display stats in the console after processing</span>
|
|
|
- <p>Check this option to display stats about processing in the JavaScript developer tools of your browser. Checking
|
|
|
|
|
|
|
+ <p>Check this option to display stats about processing in the JavaScript developer tools of your browser.
|
|
|
|
|
+ Checking
|
|
|
this option may increase the CPU consumption and the time needed to save a page.
|
|
this option may increase the CPU consumption and the time needed to save a page.
|
|
|
</p>
|
|
</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
@@ -294,7 +327,8 @@
|
|
|
|
|
|
|
|
<li>
|
|
<li>
|
|
|
<span class="option">save raw page</span>
|
|
<span class="option">save raw page</span>
|
|
|
- <p>Check this option to save the page without interpreting JavaScript. Checking this option may alter the document.</p>
|
|
|
|
|
|
|
+ <p>Check this option to save the page without interpreting JavaScript. Checking this option may alter the
|
|
|
|
|
+ document.</p>
|
|
|
<p class="notice">It is recommended to
|
|
<p class="notice">It is recommended to
|
|
|
<u>uncheck</u> this option</p>
|
|
<u>uncheck</u> this option</p>
|
|
|
</li>
|
|
</li>
|
|
@@ -328,13 +362,15 @@
|
|
|
<li>
|
|
<li>
|
|
|
All browsers
|
|
All browsers
|
|
|
<ul>
|
|
<ul>
|
|
|
- <li>For security reasons, you cannot save pages hosted on https://chrome.google.com or https://addons.mozilla.org.</li>
|
|
|
|
|
|
|
+ <li>For security reasons, you cannot save pages hosted on https://chrome.google.com or
|
|
|
|
|
+ https://addons.mozilla.org.</li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
|
<li>
|
|
<li>
|
|
|
Chrome/Opera
|
|
Chrome/Opera
|
|
|
<ul>
|
|
<ul>
|
|
|
- <li>You must enable the option "Allow access to file URLs" in the extension page to display the infobar when viewing
|
|
|
|
|
|
|
+ <li>You must enable the option "Allow access to file URLs" in the extension page to display the infobar when
|
|
|
|
|
+ viewing
|
|
|
a saved page, or to save a page stored on the filesystem.</li>
|
|
a saved page, or to save a page stored on the filesystem.</li>
|
|
|
</ul>
|
|
</ul>
|
|
|
</li>
|
|
</li>
|
|
@@ -361,7 +397,8 @@
|
|
|
<li>If resetting options did not fix the issue, try to disable all other extensions to see if there is a conflict.</li>
|
|
<li>If resetting options did not fix the issue, try to disable all other extensions to see if there is a conflict.</li>
|
|
|
<li>If there is a conflict then try to determine against which extension(s).</li>
|
|
<li>If there is a conflict then try to determine against which extension(s).</li>
|
|
|
<li>Please report the issue
|
|
<li>Please report the issue
|
|
|
- <a href="https://github.com/gildas-lormeau/SingleFile/issues">here</a> with a short description describing how to reproduce
|
|
|
|
|
|
|
+ <a href="https://github.com/gildas-lormeau/SingleFile/issues">here</a> with a short description describing how to
|
|
|
|
|
+ reproduce
|
|
|
the issue, Browser version, OS name and version.</li>
|
|
the issue, Browser version, OS name and version.</li>
|
|
|
</ul>
|
|
</ul>
|
|
|
<p>Suggestions are welcome :)</p>
|
|
<p>Suggestions are welcome :)</p>
|