|
|
@@ -60,7 +60,7 @@
|
|
|
<li>Select "Save Selection" from the context menu without selecting any content first to display a
|
|
|
selector that will help you choose content by hovering over it with the mouse.</li>
|
|
|
<li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
|
|
|
- <li>Enable the option "Misc. > save to Google Drive" to upload pages to Google Drive</li>
|
|
|
+ <li>Enable the option "Destination > upload to Google Drive" to upload pages to Google Drive</li>
|
|
|
<li>You can use the customizable shortcut Ctrl+Shift+Y to save the current tab or the selected tabs.
|
|
|
Go to about:addons and select "Manage extension shortcuts" in the cogwheel menu to change it in
|
|
|
Firefox. Go to chrome://extensions/shortcuts to change it in Chrome..</li>
|
|
|
@@ -210,6 +210,11 @@
|
|
|
option to display the ℹ button at the top right of the page when viewing a saved page in a
|
|
|
browser where SingleFile is not installed.</p>
|
|
|
</li>
|
|
|
+ <li data-options-label="saveRawPageLabel"> <span class="option">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 class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
+ </li>
|
|
|
</ul>
|
|
|
<p>Stylesheets</p>
|
|
|
<ul>
|
|
|
@@ -301,45 +306,24 @@
|
|
|
<p class="notice">It is recommended to <u>check</u> this option</p>
|
|
|
</li>
|
|
|
</ul>
|
|
|
- <p>Auto-save</p>
|
|
|
+ <p>Destination</p>
|
|
|
<ul>
|
|
|
- <li data-options-label="autoSaveLoadOrUnloadLabel"> <span class="option">Option: auto-save after
|
|
|
- page load or on page 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. Some frame contents may be
|
|
|
- missing (if you unchecked "remove frames") when pages are saved before being unloaded. </p>
|
|
|
- </li>
|
|
|
- <li data-options-label="autoSaveLoadLabel"> <span class="option">Option: auto-save after page
|
|
|
- load</span>
|
|
|
- <p>Check this option to auto-save pages after being loaded.</p>
|
|
|
- </li>
|
|
|
- <li data-options-label="autoSaveUnloadLabel"> <span class="option">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 "remove frames"). </p>
|
|
|
- </li>
|
|
|
- <li data-options-label="autoSaveDelayLabel"> <span class="option">Option: auto-save waiting delay
|
|
|
- after load (s)</span>
|
|
|
- <p>Specify the delay 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. </p>
|
|
|
- </li>
|
|
|
- <li data-options-label="autoSaveRepeatLabel"> <span class="option">Option: auto-save
|
|
|
- periodically</span>
|
|
|
- <p>Check this option to auto-save pages periodically after load.</p>
|
|
|
+ <li data-options-label="saveToFilesystemLabel"> <span class="option">Option: save to
|
|
|
+ filesystem</span>
|
|
|
+ <p>Check this option to save the downloaded page on the filesystem of your computer.</p>
|
|
|
+ <p class="notice">It is recommended to <u>check</u> this option</p>
|
|
|
</li>
|
|
|
- <li data-options-label="autoSaveRepeatDelayLabel"> <span class="option">Option: period (s)</span>
|
|
|
- <p>Specify the delay in seconds to wait before each page saving when the "auto-save
|
|
|
- periodically" option is checked. </p>
|
|
|
+ <li data-options-label="saveToClipboardLabel"> <span class="option">Option: copy to clipboard</span>
|
|
|
+ <p>Check this option to copy the page to the clipboard.</p>
|
|
|
+ <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
- <li data-options-label="autoSaveExternalSaveLabel"> <span class="option">Option: save the page with
|
|
|
- SingleFile Companion</span>
|
|
|
- <p>Check this option to delegate the saving process to SingleFile Companion. It is a program
|
|
|
- that runs outside the browser and can help to make the saving process more transparent. It
|
|
|
- also allows the pages to be saved in another directory than the download directory. You can
|
|
|
- find more info <a
|
|
|
- href="https://github.com/gildas-lormeau/SingleFile/tree/master/companion">here</a></p>
|
|
|
+ <li data-options-label="saveToGDriveLabel"> <span class="option">Option: upload to Google
|
|
|
+ Drive</span>
|
|
|
+ <p>Check this option to save the page on Google Drive.</p>
|
|
|
+ <p>The permissions requested by SingleFile allow it to access only to the files and folders it
|
|
|
+ has created. When you uncheck this option, SingleFile revokes automatically its access to
|
|
|
+ your Google Drive account. </p>
|
|
|
+ <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
</ul>
|
|
|
<p>Annotation editor</p>
|
|
|
@@ -385,23 +369,71 @@
|
|
|
<p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
</ul>
|
|
|
- <p>Misc.</p>
|
|
|
+ <p>Bookmarks</p>
|
|
|
<ul>
|
|
|
- <li data-options-label="backgroundSaveLabel"> <span class="option">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. You
|
|
|
- can also uncheck this option if you want the "Save as" dialog to remember the last saved
|
|
|
- path. Unchecking this option prevent using sub-directories in filename templates.</p>
|
|
|
- <p class="notice">It is recommended to <u>check</u> this option</p>
|
|
|
+ <li data-options-label="saveCreatedBookmarksLabel"> <span class="option">Option: save the page of a
|
|
|
+ newly created bookmark</span>
|
|
|
+ <p>Check this option to save pages that you add into your bookmarks. Note that if the page is to
|
|
|
+ be saved is not already displayed in a tab, SingleFile will open temporarily a new tab to
|
|
|
+ save the page. </p>
|
|
|
+ <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
- <li data-options-label="displayStatsLabel"> <span class="option">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 this option may increase the CPU consumption and the time needed to save a
|
|
|
- page. </p>
|
|
|
+ <li data-options-label="replaceBookmarkURLLabel"> <span class="option">Option: link the new bookmark
|
|
|
+ to the saved page</span>
|
|
|
+ <p>Check this option to replace the URL of the page added into your bookmark with the file URI
|
|
|
+ of the saved page on your disk. </p>
|
|
|
<p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
+ <li data-options-label="ignoredBookmarkFoldersLabel"> <span class="option">Option: ignored
|
|
|
+ folders</span>
|
|
|
+ <p>Enter a list of bookmark folder names to ignore. The folder names must be separated with a
|
|
|
+ comma.
|
|
|
+ </p>
|
|
|
+ </li>
|
|
|
+ </ul>
|
|
|
+ <p>Auto-save</p>
|
|
|
+ <ul>
|
|
|
+ <li data-options-label="autoSaveLoadOrUnloadLabel"> <span class="option">Option: auto-save after
|
|
|
+ page load or on page 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. Some frame contents may be
|
|
|
+ missing (if you unchecked "remove frames") when pages are saved before being unloaded. </p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveLoadLabel"> <span class="option">Option: auto-save after page
|
|
|
+ load</span>
|
|
|
+ <p>Check this option to auto-save pages after being loaded.</p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveUnloadLabel"> <span class="option">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 "remove frames"). </p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveDelayLabel"> <span class="option">Option: auto-save waiting delay
|
|
|
+ after load (s)</span>
|
|
|
+ <p>Specify the delay 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. </p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveRepeatLabel"> <span class="option">Option: auto-save
|
|
|
+ periodically</span>
|
|
|
+ <p>Check this option to auto-save pages periodically after load.</p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveRepeatDelayLabel"> <span class="option">Option: period (s)</span>
|
|
|
+ <p>Specify the delay in seconds to wait before each page saving when the "auto-save
|
|
|
+ periodically" option is checked. </p>
|
|
|
+ </li>
|
|
|
+ <li data-options-label="autoSaveExternalSaveLabel"> <span class="option">Option: save the page with
|
|
|
+ SingleFile Companion</span>
|
|
|
+ <p>Check this option to delegate the saving process to SingleFile Companion. It is a program
|
|
|
+ that runs outside the browser and can help to make the saving process more transparent. It
|
|
|
+ also allows the pages to be saved in another directory than the download directory. You can
|
|
|
+ find more info <a
|
|
|
+ href="https://github.com/gildas-lormeau/SingleFile/tree/master/companion">here</a></p>
|
|
|
+ </li>
|
|
|
+ </ul>
|
|
|
+ <p>Misc.</p>
|
|
|
+ <ul>
|
|
|
<li data-options-label="setMaxResourceSizeLabel"> <span class="option">Option: set a maximum size
|
|
|
for embedded resources (MB)</span>
|
|
|
<p>Check this option to remove from the saved page embedded resources (i.e. images, stylesheets,
|
|
|
@@ -418,17 +450,6 @@
|
|
|
option if you cannot download resources blocked by a hotlink protection.</p>
|
|
|
<p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
- <li data-options-label="saveRawPageLabel"> <span class="option">Option: save raw page</span>
|
|
|
- <p>Check this option to save the page without interpreting JavaScript. Checking this option may
|
|
|
- alter the document, will force the options "remove frames", "remove hidden elements" to be
|
|
|
- enabled and "save deferred images" to be disabled.</p>
|
|
|
- <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
- </li>
|
|
|
- <li data-options-label="saveToClipboardLabel"> <span class="option">Option: save to clipboard</span>
|
|
|
- <p>Check this option to copy the page to the clipboard instead of downloading it on your
|
|
|
- computer. Checking this option will force the "File name" options to be disabled.</p>
|
|
|
- <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
- </li>
|
|
|
<li data-options-label="addProofLabel"> <span class="option">Option: add proof od existence</span>
|
|
|
<p>Check this option to create a worldwide proof of the existence of the page you want to save.
|
|
|
</p>
|
|
|
@@ -447,28 +468,19 @@
|
|
|
</ul>
|
|
|
<p> More information <a href="https://doc.woleet.io">doc.woleet.io</a> </p>
|
|
|
</li>
|
|
|
- <li data-options-label="saveToGDriveLabel"> <span class="option">Option: save to Google Drive</span>
|
|
|
- <p>Check this option to save the page on Google Drive instead of downloading it on your
|
|
|
- computer. Checking this option will force some "File name" options to be disabled. However,
|
|
|
- you can change the value of the "File name > template" option to save files into
|
|
|
- sub-folders, e.g. "<code>SingleFile/{page-title} ({date-iso} {time-locale}).html</code>" to
|
|
|
- save pages in the folder named "SingleFile". </p>
|
|
|
- <p> The permissions requested by SingleFile allow it to access only to the files and folders it
|
|
|
- has created. When you uncheck this option, SingleFile revokes automatically its access to
|
|
|
- your Google Drive account. </p>
|
|
|
- <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
- </li>
|
|
|
- <li data-options-label="saveCreatedBookmarksLabel"> <span class="option">Option: save the page of a
|
|
|
- newly created bookmark</span>
|
|
|
- <p> Check this option to save pages that you add into your bookmarks. Note that if the page is
|
|
|
- to be saved is not already displayed in a tab, SingleFile will open temporarily a new tab to
|
|
|
- save the page. </p>
|
|
|
- <p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
+ <li data-options-label="backgroundSaveLabel"> <span class="option">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. You
|
|
|
+ can also uncheck this option if you want the "Save as" dialog to remember the last saved
|
|
|
+ path. Unchecking this option prevent using sub-directories in filename templates.</p>
|
|
|
+ <p class="notice">It is recommended to <u>check</u> this option</p>
|
|
|
</li>
|
|
|
- <li data-options-label="replaceBookmarkURLLabel"> <span class="option">Option: link the new bookmark
|
|
|
- to the saved page</span>
|
|
|
- <p> Check this option to replace the URL of the page added into your bookmark with the file URI
|
|
|
- of the saved page on your disk. </p>
|
|
|
+ <li data-options-label="displayStatsLabel"> <span class="option">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 this option may increase the CPU consumption and the time needed to save a
|
|
|
+ page. </p>
|
|
|
<p class="notice">It is recommended to <u>uncheck</u> this option</p>
|
|
|
</li>
|
|
|
</ul>
|
|
|
@@ -613,10 +625,10 @@
|
|
|
<li><code>{url-referrer-flat}</code>: the URI of the page that "linked" to the page with slashed
|
|
|
replaced (e.g. "http_example.com")</li>
|
|
|
<li><code>{bookmark-pathname}</code>: the path name of the newly created bookmark (e.g. "My
|
|
|
- Bookmarks/Last Month") when the option "Misc > save the page of a
|
|
|
+ Bookmarks/Last Month") when the option "Bookmarks > save the page of a
|
|
|
newly created bookmark" is enabled</li>
|
|
|
<li><code>{bookmark-pathname-flat}</code>: the path name of the newly created bookmark with replaced
|
|
|
- slashes (e.g. "My Bookmarks_Last Month") when the option "Misc > save the page of a
|
|
|
+ slashes (e.g. "My Bookmarks_Last Month") when the option "Bookmarks > save the page of a
|
|
|
newly created bookmark" is enabled</li>
|
|
|
<li><code>{tab-id}</code>: the unique identifier of the tab (e.g. "326")</li>
|
|
|
<li><code>{tab-index}</code>: the index of the tab in the window (e.g. "1")</li>
|
|
|
@@ -636,7 +648,8 @@
|
|
|
</li>
|
|
|
<li><a id="known-issues">Known issues</a>
|
|
|
<ul>
|
|
|
- <li>All browsers <ul>
|
|
|
+ <li>All browsers
|
|
|
+ <ul>
|
|
|
<li>For security reasons, you cannot save pages hosted on https://chrome.google.com,
|
|
|
https://addons.mozilla.org and some other Mozilla domains. When this happens, 🚫 is
|
|
|
displayed on top of the SingleFile icon.</li>
|
|
|
@@ -648,9 +661,11 @@
|
|
|
<, ></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
- <li>Chrome/Opera <ul>
|
|
|
+ <li>Chromium-based browsers
|
|
|
+ <ul>
|
|
|
<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>
|
|
|
+ the infobar when viewing a saved page, to save or to annotate a page stored on the
|
|
|
+ filesystem.</li>
|
|
|
<li>If the filename of a saved page looks like "56833935-156b-4d8c-a00f-19599c6513d3",
|
|
|
disable the option "Misc. > Save pages in background". Reinstalling the browser may
|
|
|
also fix this issue.</li>
|
|
|
@@ -659,8 +674,10 @@
|
|
|
chrome://settings/downloads</li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
- <li>Firefox <ul>
|
|
|
- <li>The "file name conflict resolution" option does not work if set to "prompt for a name".
|
|
|
+ <li>Firefox
|
|
|
+ <ul>
|
|
|
+ <li>The "File name > file name conflict resolution" option does not work if set to
|
|
|
+ "prompt for a name".
|
|
|
</li>
|
|
|
<li>Sometimes, SingleFile is unable to save the contents of sandboxed iframes.</li>
|
|
|
<li>When processing a page from the filesystem, external resources (e.g. images,
|
Gildas