Archives/gnosygnu_xowa
1
0
Fork 0
mirror of https://github.com/gnosygnu/xowa.git synced 2026-03-02 03:49:30 +00:00
Code Issues Projects Releases Wiki Activity

download_central update

Browse Source
This commit is contained in:
gnosygnu
2017-05-23 03:31:48 -04:00
parent 97cea89cca
commit 37d5550c4f
10 changed files with 3034 additions and 1006 deletions
Download Patch File Download Diff File Expand all files Collapse all files

225
home/wiki/Options.html
View File

@@ -25,7 +25,7 @@
<!-- BTN:info -->
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.cfg_edit.help__toggle_all()' title='toggle all help'>&nbsp;</span> <!-- COMBO:cfg_grps -->
<select id='xocfg_nav_select' onchange='xo.cfg_edit.select__send(this);' onkeyup='xo.cfg_edit.select__by_keypress(event, this);' accesskey='l'>
<option value='xowa.app.security'>
<option value='xowa.app.security' selected='selected'>
App - Security
</option>
<option value='xowa.app.startup'>
@@ -64,7 +64,7 @@
<option value='xowa.bldr.db'>
Import - Database
</option>
<option value='xowa.bldr.page_sync' selected='selected'>
<option value='xowa.bldr.page_sync'>
Import - Page sync
</option>
<option value='xowa.bldr.dansguardian'>
@@ -129,99 +129,94 @@
<div>
<p id='page_help_para'>
</p>
<p>
For more information, see <a tabindex="-1" href="/wiki/App/Xtn/Page_sync" id="xolnki_19" title="App/Xtn/Page sync">the page sync help page</a>
</p>
</div>
<h2>
Manual
Web
</h2>
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.bldr.page_sync.manual.enabled")' title='view more info'>&nbsp;</span>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.app.web.enabled")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.bldr.page_sync.manual.enabled__name' class='xocfg_itm_name'>
Enabled
<div id='xowa.app.web.enabled__name' class='xocfg_itm_name'>
Web access enabled
</div><!-- BTN:undo -->
<div id='xowa.bldr.page_sync.manual.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.bldr.page_sync.manual.enabled")' title="reset to &quot;n&quot;">&nbsp;</span>
<div id='xowa.app.web.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.app.web.enabled")' title="reset to &quot;y&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<input id="xowa.bldr.page_sync.manual.enabled" data-xocfg-key="xowa.bldr.page_sync.manual.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox">
<input id="xowa.app.web.enabled" data-xocfg-key="xowa.app.web.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox" checked="checked">
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.bldr.page_sync.manual.enabled__key_box' value='xowa.bldr.page_sync.manual.enabled'> <input type='hidden' id='xowa.bldr.page_sync.manual.enabled__ctx_box' value='app'>
<input type='hidden' id='xowa.app.web.enabled__key_box' value='xowa.app.web.enabled'> <input type='hidden' id='xowa.app.web.enabled__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.bldr.page_sync.manual.enabled_help_div' class='xohelp_div'>
<div id='xowa.bldr.page_sync.manual.enabled_help_msg' class='xohelp_msg'>
<div id='xowa.app.web.enabled_help_div' class='xohelp_div'>
<div id='xowa.app.web.enabled_help_msg' class='xohelp_msg'>
<p>
Choose one of the following:
Choose if XOWA is allowed to access the Web:
</p>
<ul>
<li>
<b>checked</b>: Show "Sync" in sidebar
<b>checked</b>: Allow web access.
</li>
<li>
<b>unchecked</b>: Do not show "Sync" in sidebar
<b>unchecked</b>: Forbid web access. XOWA will not connect to the internet under any circumstances. This is equivalent to pulling the network cable for XOWA only.
</li>
</ul>
<p>
Other notes:
Note that this may cause the app to not behave properly. For example:
</p>
<ul>
<li>
Clicking "Sync" will manually synchronize current page
Images will not download, even if "Retrieve files" is checked
</li>
<li>
"Sync" will never show in the home wiki
Import links on Import/List will not work
</li>
<li>
"Sync" will not work on Special pages
Download dump status on Wiki/Maintenance will not work
</li>
<li>
etc..
</li>
</ul>
<p>
Also, note that this only controls XOWA's access to the internet. <a tabindex="-1" href="/wiki/Options/Apps" id="xolnki_2" title="Options/Apps">Viewer apps</a> may still access the internet. For example, clicking on an external link will still launch a "Web browser". If you have VLC set up to play media files, it may access the internet when you click on a media file. A PDF app may try to update itself when you click on a PDF file.
</p>
<p>
For more information, see <a tabindex="-1" href="/wiki/Help/Privacy" id="xolnki_3" title="Help/Privacy">Help/Privacy</a>
</p>
</div>
</div>
<h2>
Automatic
Privacy
</h2>
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.bldr.page_sync.auto.enabled")' title='view more info'>&nbsp;</span>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.app.logs.enabled")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.bldr.page_sync.auto.enabled__name' class='xocfg_itm_name'>
Enabled
<div id='xowa.app.logs.enabled__name' class='xocfg_itm_name'>
Logs enabled
</div><!-- BTN:undo -->
<div id='xowa.bldr.page_sync.auto.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.bldr.page_sync.auto.enabled")' title="reset to &quot;n&quot;">&nbsp;</span>
<div id='xowa.app.logs.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.app.logs.enabled")' title="reset to &quot;y&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<input id="xowa.bldr.page_sync.auto.enabled" data-xocfg-key="xowa.bldr.page_sync.auto.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox">
<input id="xowa.app.logs.enabled" data-xocfg-key="xowa.app.logs.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox" checked="checked">
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.bldr.page_sync.auto.enabled__key_box' value='xowa.bldr.page_sync.auto.enabled'> <input type='hidden' id='xowa.bldr.page_sync.auto.enabled__ctx_box' value='app'>
<input type='hidden' id='xowa.app.logs.enabled__key_box' value='xowa.app.logs.enabled'> <input type='hidden' id='xowa.app.logs.enabled__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.bldr.page_sync.auto.enabled_help_div' class='xohelp_div'>
<div id='xowa.bldr.page_sync.auto.enabled_help_msg' class='xohelp_msg'>
<div id='xowa.app.logs.enabled_help_div' class='xohelp_div'>
<div id='xowa.app.logs.enabled_help_msg' class='xohelp_msg'>
<p>
Choose one of the following:
Choose if logs are enabled:
</p>
<ul>
<li>
<b>checked</b>: Automatically synchronize page when viewing it
<b>checked</b>: Enable logs. XOWA logs application activity for diagnostic purposes. Note that these logs are never shared or uploaded. See <a tabindex="-1" href="/wiki/Help/Privacy" id="xolnki_4" title="Help/Privacy">Help/Privacy</a> for more info
</li>
<li>
<b>unchecked</b>: (default) Do not automatically synchronize page
</li>
</ul>
<p>
Other notes:
</p>
<ul>
<li>
Pages are automatically synchronized based on options for time and scope. The default behavior is to synchronize when first visiting the page, and then every 24 hours afterwards
</li>
<li>
Automatic synchronization will never occur in the home wiki
<b>unchecked</b>: Disable logs. No messages will be written to the log. You can check by going to Help -&gt; System Data -&gt; Session Log
</li>
</ul>
</div>
@@ -229,69 +224,137 @@
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.bldr.page_sync.auto.interval")' title='view more info'>&nbsp;</span>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.app.bookmarks.enabled")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.bldr.page_sync.auto.interval__name' class='xocfg_itm_name'>
Time to wait before syncs
<div id='xowa.app.bookmarks.enabled__name' class='xocfg_itm_name'>
Bookmarks enabled
</div><!-- BTN:undo -->
<div id='xowa.bldr.page_sync.auto.interval__undo' data-xocfg-type='int' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.bldr.page_sync.auto.interval")' title="reset to &quot;1440&quot;">&nbsp;</span>
<div id='xowa.app.bookmarks.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.app.bookmarks.enabled")' title="reset to &quot;y&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<input id="xowa.bldr.page_sync.auto.interval" data-xocfg-key="xowa.bldr.page_sync.auto.interval" data-xocfg-type="int" accesskey="d" class="xocfg_data__int" type="text" value="1440">
<input id="xowa.app.bookmarks.enabled" data-xocfg-key="xowa.app.bookmarks.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox" checked="checked">
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.bldr.page_sync.auto.interval__key_box' value='xowa.bldr.page_sync.auto.interval'> <input type='hidden' id='xowa.bldr.page_sync.auto.interval__ctx_box' value='app'>
<input type='hidden' id='xowa.app.bookmarks.enabled__key_box' value='xowa.app.bookmarks.enabled'> <input type='hidden' id='xowa.app.bookmarks.enabled__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.bldr.page_sync.auto.interval_help_div' class='xohelp_div'>
<div id='xowa.bldr.page_sync.auto.interval_help_msg' class='xohelp_msg'>
<div id='xowa.app.bookmarks.enabled_help_div' class='xohelp_div'>
<div id='xowa.app.bookmarks.enabled_help_msg' class='xohelp_msg'>
<p>
Enter the number of minutes to wait before checking for a new update:
Choose if bookmarks are enabled:
</p>
<ul>
<li>
<b>checked</b>: Enable bookmarks. XOWA adds bookmarks whenever the user chooses "Bookmark this page". Note that these bookmarks are never shared or uploaded. See <a tabindex="-1" href="/wiki/Help/Privacy" id="xolnki_5" title="Help/Privacy">Help/Privacy</a> for more info
</li>
<li>
<b>unchecked</b>: Disable adding bookmarks. No bookmarks will be be added, even if the user clicks "Bookmark this page". You can check by clicking "Bookmark this page" and then clicking "Show all bookmarks"
</li>
</ul>
</div>
</div>
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.app.page_history.enabled")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.app.page_history.enabled__name' class='xocfg_itm_name'>
History enabled
</div><!-- BTN:undo -->
<div id='xowa.app.page_history.enabled__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.app.page_history.enabled")' title="reset to &quot;y&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<input id="xowa.app.page_history.enabled" data-xocfg-key="xowa.app.page_history.enabled" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox" checked="checked">
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.app.page_history.enabled__key_box' value='xowa.app.page_history.enabled'> <input type='hidden' id='xowa.app.page_history.enabled__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.app.page_history.enabled_help_div' class='xohelp_div'>
<div id='xowa.app.page_history.enabled_help_msg' class='xohelp_msg'>
<p>
Choose if page history is enabled:
</p>
<ul>
<li>
<b>checked</b>: Enable page history. XOWA stores viewed pages for the Page History page (History -&gt; Show). Note that this history is never shared or uploaded. See <a tabindex="-1" href="/wiki/Help/Privacy" id="xolnki_6" title="Help/Privacy">Help/Privacy</a> for more info
</li>
<li>
<b>unchecked</b>: Disable page history. No pages will be stored in page history. You can check by going to Help -&gt; System Data -&gt; Page History
</li>
</ul>
</div>
</div>
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.app.page_history.log_all")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.app.page_history.log_all__name' class='xocfg_itm_name'>
Log all page history
</div><!-- BTN:undo -->
<div id='xowa.app.page_history.log_all__undo' data-xocfg-type='bool' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.app.page_history.log_all")' title="reset to &quot;n&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<input id="xowa.app.page_history.log_all" data-xocfg-key="xowa.app.page_history.log_all" data-xocfg-type="bool" accesskey="d" class="xocfg_data__bool" type="checkbox">
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.app.page_history.log_all__key_box' value='xowa.app.page_history.log_all'> <input type='hidden' id='xowa.app.page_history.log_all__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.app.page_history.log_all_help_div' class='xohelp_div'>
<div id='xowa.app.page_history.log_all_help_msg' class='xohelp_msg'>
<p>
Log every page visit in a separate log file
</p>
<ul>
<li>
<b>checked</b>: Logs every page visit in a separate log file: C:\xowa\user\anonymous\app\data\history\log_all.csv
</li>
<li>
<b>unchecked</b> Does not log every page visit to a separate log file.
</li>
</ul>
<p>
XOWA currently consolidates visits to the same page as one entry. For example, 3 visits to en.wikipedia.org/wiki/Earth would show up only once with the <code>date</code> being the most recent one. The <code>date</code> for the previous two entries would be lost. This option retains dates for all 3 entries by logging each visit to a separate file.
</p>
</div>
</div>
<div class="xocfg_row flex_div">
<!-- BTN:help_item -->
<div class='xocfg_itm_help'>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.bldr.page_sync.auto.scope")' title='view more info'>&nbsp;</span>
<span class='xoimg_btn_x16 xoimg_help_tip' href='javascript:void(0)' onclick='return xo.help.toggle("xowa.gui.html_box.page_load_mode")' title='view more info'>&nbsp;</span>
</div><!-- TEXT:key -->
<div id='xowa.bldr.page_sync.auto.scope__name' class='xocfg_itm_name'>
Pages to sync
<div id='xowa.gui.html_box.page_load_mode__name' class='xocfg_itm_name'>
Load HTML to browser method
</div><!-- BTN:undo -->
<div id='xowa.bldr.page_sync.auto.scope__undo' data-xocfg-type='memo' class='xocfg_itm_delete xocfg_itm_hide'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.bldr.page_sync.auto.scope")' title="reset to &quot;*&quot;">&nbsp;</span>
<div id='xowa.gui.html_box.page_load_mode__undo' data-xocfg-type='list:xowa.gui.html_box.page_load_mode' class='xocfg_itm_delete'>
<span class='xoimg_btn_x16 xoimg_list_undo' onclick='return xo.cfg_edit.delete__send("xowa.gui.html_box.page_load_mode")' title="reset to &quot;mem&quot;">&nbsp;</span>
</div><!-- TEXT:val -->
<div class='xocfg_itm_data'>
<textarea id="xowa.bldr.page_sync.auto.scope" data-xocfg-key="xowa.bldr.page_sync.auto.scope" data-xocfg-type="memo" accesskey="d" class="xocfg_data__memo" rows="4">
*
</textarea>
<select id="xowa.gui.html_box.page_load_mode" data-xocfg-key="xowa.gui.html_box.page_load_mode" data-xocfg-type="list:xowa.gui.html_box.page_load_mode" accesskey="d" class="xocfg_data__list" size="2">
<option value="mem">
mem
</option>
<option value="url" selected="selected">
url
</option>
</select>
</div><!-- HIDDEN:key,ctx -->
<input type='hidden' id='xowa.bldr.page_sync.auto.scope__key_box' value='xowa.bldr.page_sync.auto.scope'> <input type='hidden' id='xowa.bldr.page_sync.auto.scope__ctx_box' value='app'>
<input type='hidden' id='xowa.gui.html_box.page_load_mode__key_box' value='xowa.gui.html_box.page_load_mode'> <input type='hidden' id='xowa.gui.html_box.page_load_mode__ctx_box' value='app'>
</div><!-- DIV:help -->
<div id='xowa.bldr.page_sync.auto.scope_help_div' class='xohelp_div'>
<div id='xowa.bldr.page_sync.auto.scope_help_msg' class='xohelp_msg'>
<div id='xowa.gui.html_box.page_load_mode_help_div' class='xohelp_div'>
<div id='xowa.gui.html_box.page_load_mode_help_msg' class='xohelp_msg'>
<p>
Specify specific page titles to sync:
Choose how HTML is loaded into the browser: This is a performance optimization with privacy implications
</p>
<ul>
<li>
<b>*:Main_Page</b>: means sync all Main_Pages in all wikis
<b>mem</b>: Load HTML through memory by calling <code>browser.setText(html)</code>. For unknown reasons, SWT / XULRunner uses more memory when loading HTML by setText -- as much as 5 - 10 MB for a page like en.w:Earth.
</li>
<li>
<b>*</b>: is a wildcard and means sync all pages in all wikis
</li>
<li>
Individual pages can be specified on each line.
<b>url</b>: Load HTML through the file system by calling <code>browser.setUrl(file, html)</code>. This call uses less memory, but requires writing the HTML to disk. (see /xowa/user/anonymous/app/tmp/html) Although setting HTML via disk is theoretically slower than memory, the time difference is not noticeable. This may be more of an issue for users with privacy concerns. For more info on the latter, see <a tabindex="-1" href="/wiki/Help/Privacy" id="xolnki_7" title="Help/Privacy">Help/Privacy</a>.
</li>
</ul>
<p>
For example, the following would only auto-synchronize two pages: the Main_Page and Earth in English Wikipedia:
</p>
<pre>
en.w:Main_Page
en.w:Earth
</pre>
<p>
Note that all lines must be separated by a UNIX line ending (ASCII 10) not a Windows line ending (ASCII 13 + ASCII 10)
Note that <b>mem</b> is currently the default, but <b>url</b> will be made the default in a future release.
</p>
</div>
</div>