Explorar o código

formatted doc

Gildas %!s(int64=7) %!d(string=hai) anos
pai
achega
81432dc716
Modificáronse 1 ficheiros con 74 adicións e 37 borrados
  1. 74 37
      extension/ui/pages/help.html

+ 74 - 37
extension/ui/pages/help.html

@@ -27,7 +27,8 @@
 			<li>
 				<a id="getting-started">Getting started</a>
 				<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
 						<img src="../resources/icon_16.png" class="icon"> in the extension toolbar to save the page.</li>
 				</ul>
@@ -39,7 +40,8 @@
 						<img src="../resources/icon_16.png" class="icon">.</li>
 					<li>
 						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>
 							<li>the current tab,</li>
 							<li>or the selected content,</li>
@@ -62,7 +64,8 @@
 							<li>or all tabs.</li>
 						</ul>
 					</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).
 					</li>
 					<li>Right-click on the SingleFile button and select "Options" to open the options page.</li>
@@ -73,15 +76,18 @@
 			<li>
 				<a id="options">Options description</a>
 				<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>
 				<p>User interface</p>
 				<ul>
 					<li>
 						<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
-							<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -90,7 +96,8 @@
 
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -99,7 +106,8 @@
 
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -118,8 +126,10 @@
 
 					<li>
 						<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 class="notice">It is recommended to
 							<u>uncheck</u> this option</p>
@@ -129,7 +139,8 @@
 				<ul>
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -137,7 +148,8 @@
 
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -145,8 +157,10 @@
 
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -154,7 +168,8 @@
 
 					<li>
 						<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>
 					</li>
 				</ul>
@@ -162,7 +177,8 @@
 				<ul>
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -170,7 +186,8 @@
 
 					<li>
 						<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>
 					</li>
 				</ul>
@@ -178,7 +195,8 @@
 				<ul>
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -187,8 +205,10 @@
 
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -196,8 +216,10 @@
 
 					<li>
 						<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>
 						<p class="notice">It is recommended to
 							<u>check</u> this option</p>
@@ -205,7 +227,8 @@
 
 					<li>
 						<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>
 					</li>
 				</ul>
@@ -213,7 +236,8 @@
 				<ul>
 					<li>
 						<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
 							<u>check</u> this option</p>
 					</li>
@@ -236,9 +260,12 @@
 				<ul>
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -252,15 +279,18 @@
 
 					<li>
 						<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").
 						</p>
 					</li>
 
 					<li>
 						<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.
 						</p>
 					</li>
@@ -269,8 +299,10 @@
 				<ul>
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -279,7 +311,8 @@
 
 					<li>
 						<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.
 						</p>
 						<p class="notice">It is recommended to
@@ -294,7 +327,8 @@
 
 					<li>
 						<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
 							<u>uncheck</u> this option</p>
 					</li>
@@ -328,13 +362,15 @@
 					<li>
 						All browsers
 						<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>
 					</li>
 					<li>
 						Chrome/Opera
 						<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>
 						</ul>
 					</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 there is a conflict then try to determine against which extension(s).</li>
 					<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>
 				</ul>
 				<p>Suggestions are welcome :)</p>