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

v4.5.2.1704

Browse Source
This commit is contained in:
gnosygnu
2017-04-27 21:02:09 -04:00
parent 328c8aadbe
commit fe28f573fb
242 changed files with 3997 additions and 3175 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
home/wiki/Dev/Code.html
View File

@@ -81,19 +81,19 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
XOWA is an offline Wikipedia application. It can run an offline copy of Wikipedia on your computer by using any of the dumps at <a href="https://dumps.wikimedia.org" rel="nofollow" class="external free">https://dumps.wikimedia.org</a> It can run as a standalone GUI application, as a Firefox addon, or as a HTTP server.
</p>
<h2>
<span class="mw-headline" id="License">License</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=License" title="Edit section: License" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="License">License</span>
</h2>
<p>
XOWA is released under the AGPLv3 license. See LICENSE.txt for more information.
</p>
<h2>
<span class="mw-headline" id="Operating_Systems">Operating Systems</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Operating_Systems" title="Edit section: Operating_Systems" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Operating_Systems">Operating Systems</span>
</h2>
<p>
XOWA runs on Linux, Windows, and Mac OS X. These instructions will assume the user is on a 64-bit Linux system. However, if you're on a different system, the same instructions still apply. Simply substitute "linux_64" with the appropriate XOWA operating system name from below:
@@ -119,7 +119,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Software_Requirements">Software Requirements</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Software_Requirements" title="Edit section: Software_Requirements" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Software_Requirements">Software Requirements</span>
</h2>
<p>
XOWA is written in Java and requires 1.6 or above. It has seven dependencies:
@@ -151,10 +151,10 @@
Note that the last two libraries are not currently used in XOWA.
</p>
<h2>
<span class="mw-headline" id="Compilation_instructions_.28ANT_command-line.29">Compilation instructions (ANT command-line)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Compilation_instructions_.28ANT_command-line.29" title="Edit section: Compilation_instructions_.28ANT_command-line.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Compilation_instructions_.28ANT_command-line.29">Compilation instructions (ANT command-line)</span>
</h2>
<h3>
<span class="mw-headline" id="Setup_the_XOWA_app">Setup the XOWA app</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Setup_the_XOWA_app" title="Edit section: Setup_the_XOWA_app" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Setup_the_XOWA_app">Setup the XOWA app</span>
</h3>
<ul>
<li>
@@ -179,7 +179,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="Setup_the_XOWA_source">Setup the XOWA source</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Setup_the_XOWA_source" title="Edit section: Setup_the_XOWA_source" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Setup_the_XOWA_source">Setup the XOWA source</span>
</h3>
<ul>
<li>
@@ -195,7 +195,7 @@
</dd>
</dl>
<h3>
<span class="mw-headline" id="Run_the_ant_file">Run the ant file</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Run_the_ant_file" title="Edit section: Run_the_ant_file" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Run_the_ant_file">Run the ant file</span>
</h3>
<ul>
<li>
@@ -203,16 +203,16 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="IDE_instructions_.28Eclipse.29">IDE instructions (Eclipse)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=IDE_instructions_.28Eclipse.29" title="Edit section: IDE_instructions_.28Eclipse.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="IDE_instructions_.28Eclipse.29">IDE instructions (Eclipse)</span>
</h2>
<h3>
<span class="mw-headline" id="Environment">Environment</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Environment" title="Edit section: Environment" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Environment">Environment</span>
</h3>
<p>
The <b>xowa_source.7z</b> was built with Eclipse Indigo. There are no OS dependencies, nor are there dependencies on Eclipse.
</p>
<h3>
<span class="mw-headline" id="Setup">Setup</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Setup" title="Edit section: Setup" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Setup">Setup</span>
</h3>
<ul>
<li>
@@ -243,19 +243,19 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="Eclipse-specific_settings">Eclipse-specific settings</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Eclipse-specific_settings" title="Edit section: Eclipse-specific_settings" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Eclipse-specific_settings">Eclipse-specific settings</span>
</h3>
<p>
This section documents specific project customizations that differ from the standard Eclipse defaults.
</p>
<h4>
<span class="mw-headline" id="Project_properties">Project properties</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Project_properties" title="Edit section: Project_properties" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Project_properties">Project properties</span>
</h4>
<p>
Resource -&gt; Text file encoding -&gt; Other -&gt; UTF-8
</p>
<h4>
<span class="mw-headline" id="Preferences">Preferences</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Preferences" title="Edit section: Preferences" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Preferences">Preferences</span>
</h4>
<p>
These settings are available under Window -&gt; Preferences
@@ -298,7 +298,7 @@
</dd>
</dl>
<h4>
<span class="mw-headline" id="Configuration_arguments">Configuration arguments</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Configuration_arguments" title="Edit section: Configuration_arguments" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Configuration_arguments">Configuration arguments</span>
</h4>
<ul>
<li>
@@ -316,7 +316,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Coding_style">Coding style</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Code?action=edit&amp;section_key=Coding_style" title="Edit section: Coding_style" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Coding_style">Coding style</span>
</h2>
<p>
For many Java programmers my style will appear idiosyncratic if not downright strange.

12
home/wiki/Dev/Command-line.html
View File

@@ -64,7 +64,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Import_simple.wikipedia.org_through_the_command-line">Import simple.wikipedia.org through the command-line</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Import_simple.wikipedia.org_through_the_command-line" title="Edit section: Import_simple.wikipedia.org_through_the_command-line" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Import_simple.wikipedia.org_through_the_command-line">Import simple.wikipedia.org through the command-line</span>
</h2>
<ul>
<li>
@@ -81,7 +81,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Import_a_different_wiki_by_editing_the_build_script">Import a different wiki by editing the build script</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Import_a_different_wiki_by_editing_the_build_script" title="Edit section: Import_a_different_wiki_by_editing_the_build_script" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Import_a_different_wiki_by_editing_the_build_script">Import a different wiki by editing the build script</span>
</h2>
<ul>
<li>
@@ -98,10 +98,10 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Import_a_wiki_with_a_manual_download">Import a wiki with a manual download</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Import_a_wiki_with_a_manual_download" title="Edit section: Import_a_wiki_with_a_manual_download" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Import_a_wiki_with_a_manual_download">Import a wiki with a manual download</span>
</h2>
<h3>
<span class="mw-headline" id="Download_the_wiki_dump">Download the wiki dump</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Download_the_wiki_dump" title="Edit section: Download_the_wiki_dump" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Download_the_wiki_dump">Download the wiki dump</span>
</h3>
<ul>
<li>
@@ -123,7 +123,7 @@
</dd>
</dl>
<h3>
<span class="mw-headline" id="Specify_location_of_the_wiki_dump">Specify location of the wiki dump</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Specify_location_of_the_wiki_dump" title="Edit section: Specify_location_of_the_wiki_dump" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Specify_location_of_the_wiki_dump">Specify location of the wiki dump</span>
</h3>
<ul>
<li>
@@ -136,7 +136,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Script">Script</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line?action=edit&amp;section_key=Script" title="Edit section: Script" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Script">Script</span>
</h2>
<pre class='code'>
// do not show a "Press enter to continue" at the end of the script

35
home/wiki/Dev/Command-line/Dumps.html
View File

@@ -34,6 +34,9 @@
<p>
XOWA can generate two types of dumps: file-dumps and html-dumps
</p>
<p>
<br>
</p>
<table class="metadata plainlinks ambox ambox-delete" style="">
<tr>
<td class="mbox-empty-cell">
@@ -116,7 +119,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
The download-thumbs script downloads all thumbs for pages in a specific wiki. It works in the following way:
@@ -155,10 +158,10 @@
The script for simple wikipedia is listed below.
</p>
<h2>
<span class="mw-headline" id="Requirements">Requirements</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Requirements" title="Edit section: Requirements" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Requirements">Requirements</span>
</h2>
<h3>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=commons.wikimedia.org" title="Edit section: commons.wikimedia.org" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span>
</h3>
<p>
You will need the latest version of commons.wikimedia.org. Note that if you have an older version, you will have missing images or wrong size information.
@@ -167,13 +170,13 @@
For example, if you have a commons.wikimedia.org from 2015-04-22 and are trying to import a 2015-05-17 English Wikipedia, then any new images added after 2015-04-22 will not be picked up.
</p>
<h3>
<span class="mw-headline" id="www.wikidata.org">www.wikidata.org</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=www.wikidata.org" title="Edit section: www.wikidata.org" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="www.wikidata.org">www.wikidata.org</span>
</h3>
<p>
You also need to have the latest version of www.wikidata.org. Note that English Wikipedia and other wikis uses Wikidata through the {{#property}} call or Module code. If you have an earlier version, then data will be missing or out of date.
</p>
<h3>
<span class="mw-headline" id="Hardware">Hardware</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Hardware" title="Edit section: Hardware" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Hardware">Hardware</span>
</h3>
<p>
You should have a recent-generation machine with relatively high-performance hardware, especially if you're planning to generate images for English Wikipedia.
@@ -202,7 +205,7 @@
For English Wikipedia, it still takes about 50 hours for the entire process.
</p>
<h3>
<span class="mw-headline" id="Internet-connectivity_.28optional.29">Internet-connectivity (optional)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Internet-connectivity_.28optional.29" title="Edit section: Internet-connectivity_.28optional.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Internet-connectivity_.28optional.29">Internet-connectivity (optional)</span>
</h3>
<p>
You should have a broadband connection to the internet. The script will need to download dump files from Wikimedia and some dump files (like English Wikipedia) will be in the 10s of GB.
@@ -211,7 +214,7 @@
You can opt to download these files separately and place them in the appropriate location beforehand. However, the script below assumes that the machine is always online. If you are offline, you will need to comment the "util.download" lines yourself.
</p>
<h3>
<span class="mw-headline" id="Pre-existing_image_databases_for_your_wiki_.28optional.29">Pre-existing image databases for your wiki (optional)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Pre-existing_image_databases_for_your_wiki_.28optional.29" title="Edit section: Pre-existing_image_databases_for_your_wiki_.28optional.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Pre-existing_image_databases_for_your_wiki_.28optional.29">Pre-existing image databases for your wiki (optional)</span>
</h3>
<p>
XOWA will automatically re-use the images from existing image databases so that you do not have to redownload them. This is particularly useful for large wikis where redownloading millions of images would be unwanted.
@@ -228,7 +231,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="gfs">gfs</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=gfs" title="Edit section: gfs" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="gfs">gfs</span>
</h2>
<p>
The script is written in the <code>gfs</code> format. This is a custom scripting format specific to XOWA. It is similar to JSON, but also supports commenting.
@@ -263,16 +266,16 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Terms">Terms</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Terms" title="Edit section: Terms" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Terms">Terms</span>
</h2>
<h3>
<span class="mw-headline" id="lnki">lnki</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=lnki" title="Edit section: lnki" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="lnki">lnki</span>
</h3>
<p>
A <code>lnki</code> is short for "<b>l</b>i<b>nk</b> <b>i</b>nternal". It refers to all wikitext with the double bracket syntax: [[A]]. A more elaborate example for files would be [[File:A.png|thumb|200x300px|upright=.80]]. Note that the abbreviation was chosen to differentiate it from <code>lnke</code> which is short for "<b>l</b>i<b>nk</b> <b>e</b>nternal". For the purposes of the script, all lnki data comes from the current wiki's data dump
</p>
<h3>
<span class="mw-headline" id="orig">orig</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=orig" title="Edit section: orig" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="orig">orig</span>
</h3>
<ul>
<li>
@@ -280,7 +283,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="xfer">xfer</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=xfer" title="Edit section: xfer" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="xfer">xfer</span>
</h3>
<ul>
<li>
@@ -288,7 +291,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="fsdb">fsdb</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=fsdb" title="Edit section: fsdb" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="fsdb">fsdb</span>
</h3>
<ul>
<li>
@@ -299,7 +302,7 @@
<br>
</p>
<h2>
<span class="mw-headline" id="Script:_Simple_Wikipedia_example_with_documentation">Script: Simple Wikipedia example with documentation</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Script:_Simple_Wikipedia_example_with_documentation" title="Edit section: Script:_Simple_Wikipedia_example_with_documentation" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Script:_Simple_Wikipedia_example_with_documentation">Script: Simple Wikipedia example with documentation</span>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -493,7 +496,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29">Script: gnosygnu's actual English Wikipedia script (dirty; provided for reference only)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29" title="Edit section: Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29">Script: gnosygnu's actual English Wikipedia script (dirty; provided for reference only)</span>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -620,7 +623,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Change_log">Change log</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Change_log" title="Edit section: Change_log" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Change_log">Change log</span>
</h2>
<ul>
<li>

4
home/wiki/Dev/Command-line/Site_meta.html
View File

@@ -50,7 +50,7 @@
XOWA can download the metadata for the Wikimedia wikis
</p>
<h2>
<span class="mw-headline" id="Background">Background</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Site_meta?action=edit&amp;section_key=Background" title="Edit section: Background" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Background">Background</span>
</h2>
<p>
Wikimedia exposes an API for accessing the meta-data for a given wiki. For example, for English Wikipedia, the following will return most of the meta-data around the wiki installation.
@@ -62,7 +62,7 @@ https://en.wikipedia.org/w/api.php?action=query&amp;meta=siteinfo&amp;siprop=gen
XOWA can call this API to download metadata for each wiki and save them in a database for data-processing. XOWA uses this info to resolve namespaces, but it will also incorporate other metadata from this API in future releases.
</p>
<h2>
<span class="mw-headline" id="Process">Process</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Site_meta?action=edit&amp;section_key=Process" title="Edit section: Process" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Process">Process</span>
</h2>
<p>
Assuming you are on a Windows system with XOWA installed at <code>C:\xowa</code>

35
home/wiki/Dev/Command-line/Thumbs.html
View File

@@ -34,6 +34,9 @@
<p>
XOWA can generate two types of dumps: file-dumps and html-dumps
</p>
<p>
<br>
</p>
<table class="metadata plainlinks ambox ambox-delete" style="">
<tr>
<td class="mbox-empty-cell">
@@ -116,7 +119,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
The download-thumbs script downloads all thumbs for pages in a specific wiki. It works in the following way:
@@ -155,10 +158,10 @@
The script for simple wikipedia is listed below.
</p>
<h2>
<span class="mw-headline" id="Requirements">Requirements</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Requirements" title="Edit section: Requirements" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Requirements">Requirements</span>
</h2>
<h3>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=commons.wikimedia.org" title="Edit section: commons.wikimedia.org" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span>
</h3>
<p>
You will need the latest version of commons.wikimedia.org. Note that if you have an older version, you will have missing images or wrong size information.
@@ -167,13 +170,13 @@
For example, if you have a commons.wikimedia.org from 2015-04-22 and are trying to import a 2015-05-17 English Wikipedia, then any new images added after 2015-04-22 will not be picked up.
</p>
<h3>
<span class="mw-headline" id="www.wikidata.org">www.wikidata.org</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=www.wikidata.org" title="Edit section: www.wikidata.org" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="www.wikidata.org">www.wikidata.org</span>
</h3>
<p>
You also need to have the latest version of www.wikidata.org. Note that English Wikipedia and other wikis uses Wikidata through the {{#property}} call or Module code. If you have an earlier version, then data will be missing or out of date.
</p>
<h3>
<span class="mw-headline" id="Hardware">Hardware</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Hardware" title="Edit section: Hardware" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Hardware">Hardware</span>
</h3>
<p>
You should have a recent-generation machine with relatively high-performance hardware, especially if you're planning to generate images for English Wikipedia.
@@ -202,7 +205,7 @@
For English Wikipedia, it still takes about 50 hours for the entire process.
</p>
<h3>
<span class="mw-headline" id="Internet-connectivity_.28optional.29">Internet-connectivity (optional)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Internet-connectivity_.28optional.29" title="Edit section: Internet-connectivity_.28optional.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Internet-connectivity_.28optional.29">Internet-connectivity (optional)</span>
</h3>
<p>
You should have a broadband connection to the internet. The script will need to download dump files from Wikimedia and some dump files (like English Wikipedia) will be in the 10s of GB.
@@ -211,7 +214,7 @@
You can opt to download these files separately and place them in the appropriate location beforehand. However, the script below assumes that the machine is always online. If you are offline, you will need to comment the "util.download" lines yourself.
</p>
<h3>
<span class="mw-headline" id="Pre-existing_image_databases_for_your_wiki_.28optional.29">Pre-existing image databases for your wiki (optional)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Pre-existing_image_databases_for_your_wiki_.28optional.29" title="Edit section: Pre-existing_image_databases_for_your_wiki_.28optional.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Pre-existing_image_databases_for_your_wiki_.28optional.29">Pre-existing image databases for your wiki (optional)</span>
</h3>
<p>
XOWA will automatically re-use the images from existing image databases so that you do not have to redownload them. This is particularly useful for large wikis where redownloading millions of images would be unwanted.
@@ -228,7 +231,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="gfs">gfs</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=gfs" title="Edit section: gfs" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="gfs">gfs</span>
</h2>
<p>
The script is written in the <code>gfs</code> format. This is a custom scripting format specific to XOWA. It is similar to JSON, but also supports commenting.
@@ -263,16 +266,16 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Terms">Terms</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Terms" title="Edit section: Terms" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Terms">Terms</span>
</h2>
<h3>
<span class="mw-headline" id="lnki">lnki</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=lnki" title="Edit section: lnki" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="lnki">lnki</span>
</h3>
<p>
A <code>lnki</code> is short for "<b>l</b>i<b>nk</b> <b>i</b>nternal". It refers to all wikitext with the double bracket syntax: [[A]]. A more elaborate example for files would be [[File:A.png|thumb|200x300px|upright=.80]]. Note that the abbreviation was chosen to differentiate it from <code>lnke</code> which is short for "<b>l</b>i<b>nk</b> <b>e</b>nternal". For the purposes of the script, all lnki data comes from the current wiki's data dump
</p>
<h3>
<span class="mw-headline" id="orig">orig</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=orig" title="Edit section: orig" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="orig">orig</span>
</h3>
<ul>
<li>
@@ -280,7 +283,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="xfer">xfer</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=xfer" title="Edit section: xfer" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="xfer">xfer</span>
</h3>
<ul>
<li>
@@ -288,7 +291,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="fsdb">fsdb</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=fsdb" title="Edit section: fsdb" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="fsdb">fsdb</span>
</h3>
<ul>
<li>
@@ -299,7 +302,7 @@
<br>
</p>
<h2>
<span class="mw-headline" id="Script:_Simple_Wikipedia_example_with_documentation">Script: Simple Wikipedia example with documentation</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Script:_Simple_Wikipedia_example_with_documentation" title="Edit section: Script:_Simple_Wikipedia_example_with_documentation" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Script:_Simple_Wikipedia_example_with_documentation">Script: Simple Wikipedia example with documentation</span>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -493,7 +496,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29">Script: gnosygnu's actual English Wikipedia script (dirty; provided for reference only)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29" title="Edit section: Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Script:_gnosygnu.27s_actual_English_Wikipedia_script_.28dirty.3B_provided_for_reference_only.29">Script: gnosygnu's actual English Wikipedia script (dirty; provided for reference only)</span>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -620,7 +623,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Change_log">Change log</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Dumps?action=edit&amp;section_key=Change_log" title="Edit section: Change_log" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Change_log">Change log</span>
</h2>
<ul>
<li>

4
home/wiki/Dev/Command-line/Wikidata.html
View File

@@ -50,7 +50,7 @@
XOWA can import Wikidata through the command-line
</p>
<h2>
<span class="mw-headline" id="Import_using_the_XML_dump">Import using the XML dump</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Wikidata?action=edit&amp;section_key=Import_using_the_XML_dump" title="Edit section: Import_using_the_XML_dump" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Import_using_the_XML_dump">Import using the XML dump</span>
</h2>
<p>
XOWA can build wikidata using the XML dump at www.mediwa/wikidatawiki/. This import is basically the same as an import of any other wiki.
@@ -75,7 +75,7 @@
add ('www.wikidata.org' , 'util.cleanup') {delete_tmp = 'y'; delete_by_match('*.xml|*.sql|*.bz2|*.gz');}
</pre>
<h2>
<span class="mw-headline" id="Import_using_the_JSON_dump">Import using the JSON dump</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Command-line/Wikidata?action=edit&amp;section_key=Import_using_the_JSON_dump" title="Edit section: Import_using_the_JSON_dump" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Import_using_the_JSON_dump">Import using the JSON dump</span>
</h2>
<p>
As of v2.6.3, XOWA also provides basic support for building wikidata from the JSON dump. This support was added for the following reasons:

4
home/wiki/Dev/Config_files.html
View File

@@ -18,7 +18,7 @@
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Overview_.28and_disclaimer.29">Overview (and disclaimer)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files?action=edit&amp;section_key=Overview_.28and_disclaimer.29" title="Edit section: Overview_.28and_disclaimer.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview_.28and_disclaimer.29">Overview (and disclaimer)</span>
</h2>
<p>
XOWA uses a custom text format called gfs (an acronym for the gfs flexible script). It is a plain-text config file with a Java-like syntax.
@@ -47,7 +47,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Recommended_procedure_for_changes">Recommended procedure for changes</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files?action=edit&amp;section_key=Recommended_procedure_for_changes" title="Edit section: Recommended_procedure_for_changes" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Recommended_procedure_for_changes">Recommended procedure for changes</span>
</h2>
<p>
Please follow the steps below when changing config files. Windows instructions are provided in parentheses.

12
home/wiki/Dev/Config_files/Details.html
View File

@@ -45,7 +45,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="General_characteristics">General characteristics</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=General_characteristics" title="Edit section: General_characteristics" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="General_characteristics">General characteristics</span>
</h2>
<p>
A gfs file has the following general characteristics:
@@ -69,13 +69,13 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Comments">Comments</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=Comments" title="Edit section: Comments" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Comments">Comments</span>
</h2>
<p>
Comments can be indicated by the conventional C comments of <code>//</code> or <code>/**/</code>. For example, any text between <code>/*</code> and <code>*/</code> is ignored.
</p>
<h2>
<span class="mw-headline" id="Whitespace">Whitespace</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=Whitespace" title="Edit section: Whitespace" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Whitespace">Whitespace</span>
</h2>
<p>
Whitespace is not significant. There is no difference between the following commands.
@@ -111,7 +111,7 @@ app
Note that tabs (ASCII 9) and carriage returns (ASCII 13) are permitted but not recommended.
</p>
<h2>
<span class="mw-headline" id="Quotes">Quotes</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=Quotes" title="Edit section: Quotes" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Quotes">Quotes</span>
</h2>
<ul>
<li>
@@ -139,7 +139,7 @@ en.wikipedia.org
</dd>
</dl>
<h2>
<span class="mw-headline" id="Booleans">Booleans</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=Booleans" title="Edit section: Booleans" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Booleans">Booleans</span>
</h2>
<p>
Booleans can be indicated in different forms as per the following table:
@@ -205,7 +205,7 @@ en.wikipedia.org
Note that for brevity's sake, <code>'y'</code> and <code>'n'</code> will be used.
</p>
<h2>
<span class="mw-headline" id="Integers">Integers</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Details?action=edit&amp;section_key=Integers" title="Edit section: Integers" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Integers">Integers</span>
</h2>
<p>
Integers can be indicated with or without quotes. Note that without quotes is recommended.

4
home/wiki/Dev/Config_files/Examples.html
View File

@@ -18,7 +18,7 @@
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Changing_a_keyboard_shortcut">Changing a keyboard shortcut</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Examples?action=edit&amp;section_key=Changing_a_keyboard_shortcut" title="Edit section: Changing_a_keyboard_shortcut" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Changing_a_keyboard_shortcut">Changing a keyboard shortcut</span>
</h2>
<ul>
<li>
@@ -65,7 +65,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Changing_the_HTML_view">Changing the HTML view</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Examples?action=edit&amp;section_key=Changing_the_HTML_view" title="Edit section: Changing_the_HTML_view" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Changing_the_HTML_view">Changing the HTML view</span>
</h2>
<ul>
<li>

2
home/wiki/Dev/Config_files/Syntax.html
View File

@@ -18,7 +18,7 @@
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Syntax">Syntax</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Config_files/Syntax?action=edit&amp;section_key=Syntax" title="Edit section: Syntax" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Syntax">Syntax</span>
</h2>
<ul>
<li>

2
home/wiki/Dev/Database/Shell/File.html
View File

@@ -21,7 +21,7 @@
<a href="http://xowa.org/home/wiki/Template:Css/Sqlite.html" id="xolnki_2" title="Template:Css/Sqlite">Template:Css/Sqlite</a>
</p>
<h3>
<span class="mw-headline" id="Get_the_file">Get the file</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Database/Shell/File?action=edit&amp;section_key=Get_the_file" title="Edit section: Get_the_file" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Get_the_file">Get the file</span>
</h3>
<ul>
<li>

2
home/wiki/Dev/Design/CSS.html
View File

@@ -21,7 +21,7 @@
XOWA wiki pages are styled with CSS.
</p>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/CSS?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
XOWA stores the CSS for a wiki page in the following directory: C:\xowa\user\anonymous\wiki\ For example, for simple.wikipedia.org, the css is in C:\xowa\user\anonymous\wiki\simple.wikipedia.org

10
home/wiki/Dev/Design/Data_dump_format.html
View File

@@ -45,7 +45,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="bzip2:_disk_space_vs_speed">bzip2: disk space vs speed</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Data_dump_format?action=edit&amp;section_key=bzip2:_disk_space_vs_speed" title="Edit section: bzip2:_disk_space_vs_speed" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="bzip2:_disk_space_vs_speed">bzip2: disk space vs speed</span>
</h2>
<p>
Currently, reading from a bzip2 file is much slower than unzipping and reading from the xml file.<sup id="cite_ref-0" class="reference"><a href="#cite_note-0">[1]</a></sup>
@@ -65,7 +65,7 @@
If you have the extra disk space, you will want to use the <b>unzip</b> route. If you are low on disk space, then you can use the <b>bzip2</b> route instead
</p>
<h2>
<span class="mw-headline" id="bzip2:_Application_install_.28GUI.29">bzip2: Application install (GUI)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Data_dump_format?action=edit&amp;section_key=bzip2:_Application_install_.28GUI.29" title="Edit section: bzip2:_Application_install_.28GUI.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="bzip2:_Application_install_.28GUI.29">bzip2: Application install (GUI)</span>
</h2>
<p>
By default, the application install uses the <b>unzip</b> route.
@@ -87,7 +87,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Command-line_install">Command-line install</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Data_dump_format?action=edit&amp;section_key=Command-line_install" title="Edit section: Command-line_install" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Command-line_install">Command-line install</span>
</h2>
<p>
The <code>core_init</code> build step now has an extra property: <code>src_bz2_fil_</code>. A sample invocation would be
@@ -113,7 +113,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="gzip">gzip</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Data_dump_format?action=edit&amp;section_key=gzip" title="Edit section: gzip" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="gzip">gzip</span>
</h2>
<p>
Currently, gzip is only used for the /category2/ system.
@@ -127,7 +127,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="References">References</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Data_dump_format?action=edit&amp;section_key=References" title="Edit section: References" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="References">References</span>
</h2>
<ol class="references">
<li id="cite_note-0">

10
home/wiki/Dev/Design/Database.html
View File

@@ -42,13 +42,13 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Database?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
As of v2.4.1.1, XOWA has changed the database layout to be more simple and portable. Regular users should not notice any difference. Users who move XOWA wikis between computer systems will notice some benefits.
</p>
<h2>
<span class="mw-headline" id="Details">Details</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Database?action=edit&amp;section_key=Details" title="Edit section: Details" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Details">Details</span>
</h2>
<ul>
<li>
@@ -84,13 +84,13 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Options">Options</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Database?action=edit&amp;section_key=Options" title="Edit section: Options" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Options">Options</span>
</h2>
<p>
General behavior for "single" vs "multiple" file import can be customized at <a href="http://xowa.org/home/wiki/Options/Import.html" id="xolnki_2" title="Options/Import">Options/Import</a> under Database Layout
</p>
<h2>
<span class="mw-headline" id="Multi-file_layout">Multi-file layout</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Database?action=edit&amp;section_key=Multi-file_layout" title="Edit section: Multi-file_layout" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Multi-file_layout">Multi-file layout</span>
</h2>
<p>
Large wikis will still generate multiple files. This includes English Wikipedia, German Wikipedia as well as about a dozen others. The primary reasons are as follows:
@@ -218,7 +218,7 @@
</tr>
</table>
<h2>
<span class="mw-headline" id="Version_compatibility">Version compatibility</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Database?action=edit&amp;section_key=Version_compatibility" title="Edit section: Version_compatibility" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Version_compatibility">Version compatibility</span>
</h2>
<p>
The formats for wiks and files are interchangable between old and new formats. A user may keep their existing <b>old</b> file databases and still generate <b>new</b> wikis whenever they want to.

16
home/wiki/Dev/Design/Files/Wikia.html
View File

@@ -51,7 +51,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
Some wikis are not Wikimedia Foundation wikis, and may not have their images / files arranged in a WMF filesystem layout
@@ -63,7 +63,7 @@
<br>
</p>
<h2>
<span class="mw-headline" id="Background">Background</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Background" title="Edit section: Background" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Background">Background</span>
</h2>
<p>
Wikimedia Foundation wikis place their images in a precisely defined filesystem layout.
@@ -84,7 +84,7 @@
<br>
</p>
<h2>
<span class="mw-headline" id="Instructions">Instructions</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Instructions" title="Edit section: Instructions" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Instructions">Instructions</span>
</h2>
<ul>
<li>
@@ -127,7 +127,7 @@ app.wikis.get('my_wiki').files.wkrs.get('fs.dir') {
<br>
</p>
<h2>
<span class="mw-headline" id="Image_Magic_and_Inkscape">Image Magic and Inkscape</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Image_Magic_and_Inkscape" title="Edit section: Image_Magic_and_Inkscape" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Image_Magic_and_Inkscape">Image Magic and Inkscape</span>
</h2>
<ul>
<li>
@@ -146,7 +146,7 @@ app.wikis.get('my_wiki').files.wkrs.get('fs.dir') {
<br>
</p>
<h2>
<span class="mw-headline" id=".5Eorig_regy.sqlite3">^orig_regy.sqlite3</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=.5Eorig_regy.sqlite3" title="Edit section: .5Eorig_regy.sqlite3" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id=".5Eorig_regy.sqlite3">^orig_regy.sqlite3</span>
</h2>
<ul>
<li>
@@ -165,7 +165,7 @@ app.wikis.get('my_wiki').files.wkrs.get('fs.dir') {
<br>
</p>
<h2>
<span class="mw-headline" id="Urls">Urls</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Urls" title="Edit section: Urls" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Urls">Urls</span>
</h2>
<ul>
<li>
@@ -192,7 +192,7 @@ app.wikis.get('my_wiki').files.wkrs.get('fs.dir') {
<br>
</p>
<h2>
<span class="mw-headline" id="Orig_directory">Orig directory</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Orig_directory" title="Edit section: Orig_directory" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Orig_directory">Orig directory</span>
</h2>
<ul>
<li>
@@ -217,7 +217,7 @@ app.wikis.get('my_wiki').files.wkrs.get('fs.dir') {
<br>
</p>
<h2>
<span class="mw-headline" id="Thumb_directory">Thumb directory</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Files/Wikia?action=edit&amp;section_key=Thumb_directory" title="Edit section: Thumb_directory" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Thumb_directory">Thumb directory</span>
</h2>
<ul>
<li>

4
home/wiki/Dev/Design/Offline_files.html
View File

@@ -35,7 +35,7 @@
Note that Simple Wikipedia will take 24+ hours and 120 GB for the first run.
</p>
<h2>
<span class="mw-headline" id="Commons_process">Commons process</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Offline_files?action=edit&amp;section_key=Commons_process" title="Edit section: Commons_process" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Commons_process">Commons process</span>
</h2>
<p>
Since most images reside in the commons wiki, commons must be set up. Note that this only needs to be done once for all wikis.
@@ -55,7 +55,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Wiki_process">Wiki process</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Offline_files?action=edit&amp;section_key=Wiki_process" title="Edit section: Wiki_process" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Wiki_process">Wiki process</span>
</h2>
<p>
These steps must be run for the given wiki. Estimated size / times are provided for Simple Wikipedia.

6
home/wiki/Dev/Design/Site_config.html
View File

@@ -18,7 +18,7 @@
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Sample_files">Sample files</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Site_config?action=edit&amp;section_key=Sample_files" title="Edit section: Sample_files" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Sample_files">Sample files</span>
</h2>
<p>
In /xowa/bin/any/xowa/cfg/wiki/api/, each folder has a sample file that can be used for a wiki. To use it do the following:
@@ -41,7 +41,7 @@
The remainder of this article documents the purpose of each file.
</p>
<h2>
<span class="mw-headline" id="extensiontags">extensiontags</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Site_config?action=edit&amp;section_key=extensiontags" title="Edit section: extensiontags" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="extensiontags">extensiontags</span>
</h2>
<p>
The "extensiontags" file lists active extensions. For example, to enable only &lt;ref&gt; and &lt;references&gt;, use the following two lines:
@@ -60,7 +60,7 @@ references
&lt;code&gt;if &lt;complex test&gt; then &lt;do something&gt; else &lt;generate type error&gt;&lt;/code&gt;
</pre>
<h2>
<span class="mw-headline" id="interwikimap">interwikimap</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Site_config?action=edit&amp;section_key=interwikimap" title="Edit section: interwikimap" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="interwikimap">interwikimap</span>
</h2>
<p>
The "interwikimap" file lists active interwiki prefixes. For example, to enable only the interwiki prefix for commons, use the following:

8
home/wiki/Dev/Design/Sqlite/File-sizes.html
View File

@@ -82,7 +82,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="ns_file_map">ns_file_map</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Sqlite/File-sizes?action=edit&amp;section_key=ns_file_map" title="Edit section: ns_file_map" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="ns_file_map">ns_file_map</span>
</h2>
<p>
The ns_file_map argument is a new-line/semi-colon delimited string. The default value is the following:
@@ -97,7 +97,7 @@ Template;Module
Note that an empty string will default everything to be stored in the core database. If a single file database is desired, specify "".
</p>
<h2>
<span class="mw-headline" id="db_text_max_value">db_text_max value</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Sqlite/File-sizes?action=edit&amp;section_key=db_text_max_value" title="Edit section: db_text_max_value" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="db_text_max_value">db_text_max value</span>
</h2>
<p>
This is a number that represents the maximum number of MB of text data that can be stored in the file. Note the following
@@ -131,7 +131,7 @@ Template;Module
</dd>
</dl>
<h2>
<span class="mw-headline" id="db_categorylink_max_and_db_wikidata_max_value">db_categorylink_max and db_wikidata_max value</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Sqlite/File-sizes?action=edit&amp;section_key=db_categorylink_max_and_db_wikidata_max_value" title="Edit section: db_categorylink_max_and_db_wikidata_max_value" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="db_categorylink_max_and_db_wikidata_max_value">db_categorylink_max and db_wikidata_max value</span>
</h2>
<p>
This is a number that represents the maximum number of MB of categorylink data that can be stored in the file. Note the following:
@@ -145,7 +145,7 @@ Template;Module
</li>
</ul>
<h2>
<span class="mw-headline" id="db_wikidata_max_value">db_wikidata_max value</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Design/Sqlite/File-sizes?action=edit&amp;section_key=db_wikidata_max_value" title="Edit section: db_wikidata_max_value" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="db_wikidata_max_value">db_wikidata_max value</span>
</h2>
<p>
This is a number that represents the maximum number of MB of wikidata label data that can be stored in the file. Note the following:

8
home/wiki/Dev/Environment/Viewer_apps.html
View File

@@ -42,7 +42,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Using_viewer_applications">Using viewer applications</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Environment/Viewer_apps?action=edit&amp;section_key=Using_viewer_applications" title="Edit section: Using_viewer_applications" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Using_viewer_applications">Using viewer applications</span>
</h2>
<p>
Viewer applications are generally activated in one of the following two situations:
@@ -71,7 +71,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Assigning_viewer_applications">Assigning viewer applications</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Environment/Viewer_apps?action=edit&amp;section_key=Assigning_viewer_applications" title="Edit section: Assigning_viewer_applications" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Assigning_viewer_applications">Assigning viewer applications</span>
</h2>
<p>
XOWA assigns a file-type to its default viewer-application.
@@ -83,7 +83,7 @@
If you wish to change the viewer application, you can do so in <a href="http://xowa.org/home/wiki/Options/Apps.html" id="xolnki_3" title="Options/Apps">Options/Apps</a>
</p>
<h2>
<span class="mw-headline" id="External_links">External links</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Environment/Viewer_apps?action=edit&amp;section_key=External_links" title="Edit section: External_links" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="External_links">External links</span>
</h2>
<p>
Many articles will have external links. By default, clicking on these links will not result in any action. If you want the external links to open in a web browser, you will need to enable the web viewer application
@@ -92,7 +92,7 @@
If you wish to change the web browser, you can also do so in <a href="http://xowa.org/home/wiki/Options/Apps.html" id="xolnki_4" title="Options/Apps">Options/Apps</a>
</p>
<h2>
<span class="mw-headline" id="Recommended_applications">Recommended applications</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Environment/Viewer_apps?action=edit&amp;section_key=Recommended_applications" title="Edit section: Recommended_applications" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Recommended_applications">Recommended applications</span>
</h2>
<p>
This is a list of recommended open-source applications for each viewer type.

10
home/wiki/Dev/File/Setup/Linux.html
View File

@@ -62,7 +62,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Ubuntu">Ubuntu</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Linux?action=edit&amp;section_key=Ubuntu" title="Edit section: Ubuntu" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Ubuntu">Ubuntu</span>
</h2>
<p>
Ubuntu users should run the following in a terminal:
@@ -72,10 +72,10 @@ sudo apt-get install imagemagick
sudo apt-get install inkscape
</pre>
<h2>
<span class="mw-headline" id="Config_.28all_distros.29">Config (all distros)</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Linux?action=edit&amp;section_key=Config_.28all_distros.29" title="Edit section: Config_.28all_distros.29" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Config_.28all_distros.29">Config (all distros)</span>
</h2>
<h3>
<span class="mw-headline" id="Enable_images">Enable images</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Linux?action=edit&amp;section_key=Enable_images" title="Edit section: Enable_images" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Enable_images">Enable images</span>
</h3>
<ul>
<li>
@@ -86,7 +86,7 @@ sudo apt-get install inkscape
</li>
</ul>
<h3>
<span class="mw-headline" id="Paths">Paths</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Linux?action=edit&amp;section_key=Paths" title="Edit section: Paths" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Paths">Paths</span>
</h3>
<p>
Note that XOWA assumes that ImageMagick and Inkscape have the following paths:
@@ -123,7 +123,7 @@ sudo apt-get install inkscape
</li>
</ul>
<h2>
<span class="mw-headline" id="ImageMagick_source">ImageMagick source</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Linux?action=edit&amp;section_key=ImageMagick_source" title="Edit section: ImageMagick_source" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="ImageMagick_source">ImageMagick source</span>
</h2>
<p>
If you need to compile ImageMagick from source, you can try the following:

8
home/wiki/Dev/File/Setup/Windows.html
View File

@@ -42,7 +42,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="ImageMagick">ImageMagick</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Windows?action=edit&amp;section_key=ImageMagick" title="Edit section: ImageMagick" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="ImageMagick">ImageMagick</span>
</h2>
<p>
ImageMagick is used for image rendering. It is a free and open-source library, and is probably used by Wikipedia on its website.
@@ -62,7 +62,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Inkscape">Inkscape</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Windows?action=edit&amp;section_key=Inkscape" title="Edit section: Inkscape" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Inkscape">Inkscape</span>
</h2>
<p>
Inkscape is used for SVG rendering. Note that ImageMagick can be designated the SVG renderer, but it will fail to convert a small percentage of SVGs.<sup id="cite_ref-inkscape_0-0" class="reference"><a href="#cite_note-inkscape-0">[1]</a></sup>
@@ -85,7 +85,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Enable_download">Enable download</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Windows?action=edit&amp;section_key=Enable_download" title="Edit section: Enable_download" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Enable_download">Enable download</span>
</h2>
<ul>
<li>
@@ -96,7 +96,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Notes">Notes</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/File/Setup/Windows?action=edit&amp;section_key=Notes" title="Edit section: Notes" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Notes">Notes</span>
</h2>
<ol class="references">
<li id="cite_note-inkscape-0">

8
home/wiki/Dev/Parser/Embeddable.html
View File

@@ -39,13 +39,13 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Parser/Embeddable?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
XOWA can be embedded in other apps as a standalone parser.
</p>
<h2>
<span class="mw-headline" id="Features">Features</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Parser/Embeddable?action=edit&amp;section_key=Features" title="Edit section: Features" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Features">Features</span>
</h2>
<p>
The XOWA parser has a number of features:
@@ -174,7 +174,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Issues">Issues</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Parser/Embeddable?action=edit&amp;section_key=Issues" title="Edit section: Issues" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Issues">Issues</span>
</h2>
<p>
The XOWA parser is constantly changing as it needs to accomodate live changes to MediaWiki parser. Moreover, the embeddable feature is a work in progress. The following is a list of known limitations:
@@ -188,7 +188,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Example">Example</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Parser/Embeddable?action=edit&amp;section_key=Example" title="Edit section: Example" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Example">Example</span>
</h2>
<p>
The follow example demonstrates usage.

12
home/wiki/Dev/SWT.html
View File

@@ -50,7 +50,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=Overview" title="Edit section: Overview" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
The <a href="https://www.eclipse.org/swt/" rel="nofollow" class="external text">SWT library</a> is an open-source GUI library, used by the open-source Java IDE <a href="https://www.eclipse.org/eclipse/" rel="nofollow" class="external text">Eclipse</a>.
@@ -59,22 +59,22 @@
XOWA uses SWT in its GUI application across the 3 major operating systems: Windows, Linux, Mac OS X. This means that SWT handles everything visual: including buttons, text boxes, windows, and of course, the HTML browser.
</p>
<h2>
<span class="mw-headline" id="SWT_is_not_used_in_HTTP_Server_or_Android">SWT is not used in HTTP Server or Android</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=SWT_is_not_used_in_HTTP_Server_or_Android" title="Edit section: SWT_is_not_used_in_HTTP_Server_or_Android" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="SWT_is_not_used_in_HTTP_Server_or_Android">SWT is not used in HTTP Server or Android</span>
</h2>
<p>
If you are running XOWA as an HTTP server or are using the Android version, then SWT is not used.
</p>
<h2>
<span class="mw-headline" id="Packaging_details">Packaging details</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=Packaging_details" title="Edit section: Packaging_details" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Packaging_details">Packaging details</span>
</h2>
<h3>
<span class="mw-headline" id="Platform-specific_jar">Platform-specific jar</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=Platform-specific_jar" title="Edit section: Platform-specific_jar" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Platform-specific_jar">Platform-specific jar</span>
</h3>
<p>
SWT comes packaged in an operating system-specific jar called swt.jar. XOWA includes this at /xowa/operating_system_name/swt/swt.jar. For example, on Linux 64-bit, this file is at /xowa/linux_64/swt/swt.jar
</p>
<h3>
<span class="mw-headline" id="Annual_update">Annual update</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=Annual_update" title="Edit section: Annual_update" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Annual_update">Annual update</span>
</h3>
<p>
SWT does a major update annually in coordination with the Eclipse release. Typically, this occurs in June. There are also development snapshots that are released during the course of the year.
@@ -83,7 +83,7 @@
XOWA will always update SWT shortly after the major version release. Depending on changes, it may also update after development snapshots.
</p>
<h2>
<span class="mw-headline" id="SWT_version">SWT version</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/SWT?action=edit&amp;section_key=SWT_version" title="Edit section: SWT_version" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="SWT_version">SWT version</span>
</h2>
<p>
XOWA v0.0.0 through v2.6.4 had been using SWT 4.2.

22
home/wiki/Dev/Sqlite/Tips.html
View File

@@ -62,7 +62,7 @@
</ul>
</div>
<h3>
<span class="mw-headline" id="Avoid_LIKE">Avoid LIKE</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Avoid_LIKE" title="Edit section: Avoid_LIKE" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Avoid_LIKE">Avoid LIKE</span>
</h3>
<ul>
<li>
@@ -94,7 +94,7 @@ WHERE name LIKE 'a%';
The clause <code>name LIKE 'a%'</code> does not use the index <code>tbl1__name</code>.
</p>
<h3>
<span class="mw-headline" id="Alternative:_Use_comparison">= Alternative: Use comparison</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Alternative:_Use_comparison" title="Edit section: Alternative:_Use_comparison" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Alternative:_Use_comparison">= Alternative: Use comparison</span>
</h3>
<p>
If the like has a wildcard at the end, and the data is standardized to one case (all lowercase or all uppercase), use an equality instead:
@@ -108,7 +108,7 @@ WHERE name &gt;= 'a' AND name &lt; 'b';
This uses the index <code>tbl1__name</code> and returns the same data.
</p>
<h3>
<span class="mw-headline" id="Avoid_ORDER_BY">Avoid ORDER BY</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Avoid_ORDER_BY" title="Edit section: Avoid_ORDER_BY" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Avoid_ORDER_BY">Avoid ORDER BY</span>
</h3>
<p>
ORDER BY will do an expensive sort operation which may not use an index. This will come into play with multiple-table joins
@@ -124,13 +124,13 @@ ORDER BY t2.age
In most cases, SQLite will only apply one index. In this example, it will be the index for the JOIN. No index gets applied for the score column, even if one is available In some cases, SQLite will actually sort the result-set by the ORDER BY first, before it applies the WHERE.
</p>
<h4>
<span class="mw-headline" id="Alternative:_denormalize_the_table">Alternative: denormalize the table</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Alternative:_denormalize_the_table" title="Edit section: Alternative:_denormalize_the_table" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Alternative:_denormalize_the_table">Alternative: denormalize the table</span>
</h4>
<p>
Putting all the columns in one table and building an index across them.
</p>
<h4>
<span class="mw-headline" id="Alternative:_multiple_where_clauses">Alternative: multiple where clauses</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Alternative:_multiple_where_clauses" title="Edit section: Alternative:_multiple_where_clauses" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Alternative:_multiple_where_clauses">Alternative: multiple where clauses</span>
</h4>
<pre>
SELECT t1.id
@@ -145,7 +145,7 @@ WHERE t2.age &gt; 70 AND t2.age &lt;= 100
;
</pre>
<h3>
<span class="mw-headline" id="Beware_bulk_INSERTs_into_a_table_with_a_PRIMARY_KEY">Beware bulk INSERTs into a table with a PRIMARY KEY</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Beware_bulk_INSERTs_into_a_table_with_a_PRIMARY_KEY" title="Edit section: Beware_bulk_INSERTs_into_a_table_with_a_PRIMARY_KEY" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Beware_bulk_INSERTs_into_a_table_with_a_PRIMARY_KEY">Beware bulk INSERTs into a table with a PRIMARY KEY</span>
</h3>
<pre>
INSERT INTO
@@ -161,7 +161,7 @@ WHERE t2.age &gt; 100 AND t2.age &lt;= 130
Instead, insert into the table with an ORDER BY
</p>
<h3>
<span class="mw-headline" id="ATTACH">ATTACH</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=ATTACH" title="Edit section: ATTACH" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="ATTACH">ATTACH</span>
</h3>
<p>
ATTACH database does not affect performance. There is no difference between the following
@@ -180,19 +180,19 @@ FROM tbl1 t1
;
</pre>
<h2>
<span class="mw-headline" id="Get_a_Solid_State_Drive">Get a Solid State Drive</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Get_a_Solid_State_Drive" title="Edit section: Get_a_Solid_State_Drive" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Get_a_Solid_State_Drive">Get a Solid State Drive</span>
</h2>
<p>
SQLite does a lot of disk reading and writing
</p>
<h2>
<span class="mw-headline" id="Use_an_INDEX_for_your_SELECTs.2C_especially_JOINs">Use an INDEX for your SELECTs, especially JOINs</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Use_an_INDEX_for_your_SELECTs.2C_especially_JOINs" title="Edit section: Use_an_INDEX_for_your_SELECTs.2C_especially_JOINs" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Use_an_INDEX_for_your_SELECTs.2C_especially_JOINs">Use an INDEX for your SELECTs, especially JOINs</span>
</h2>
<h2>
<span class="mw-headline" id="Use_TRANSACTIONs_for_multiple_INSERT_.2F_UPDATE_.2F_DELETE">Use TRANSACTIONs for multiple INSERT / UPDATE / DELETE</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Use_TRANSACTIONs_for_multiple_INSERT_.2F_UPDATE_.2F_DELETE" title="Edit section: Use_TRANSACTIONs_for_multiple_INSERT_.2F_UPDATE_.2F_DELETE" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Use_TRANSACTIONs_for_multiple_INSERT_.2F_UPDATE_.2F_DELETE">Use TRANSACTIONs for multiple INSERT / UPDATE / DELETE</span>
</h2>
<h2>
<span class="mw-headline" id="Use_PRAGMA_page_size_4096">Use PRAGMA page_size 4096</span> <span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/wiki/Dev/Sqlite/Tips?action=edit&amp;section_key=Use_PRAGMA_page_size_4096" title="Edit section: Use_PRAGMA_page_size_4096" class="xowa-hover-off">edit</a><span class="mw-editsection-bracket">]</span></span>
<span class="mw-headline" id="Use_PRAGMA_page_size_4096">Use PRAGMA page_size 4096</span>
</h2>
</div>