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

blog_new_job_

Browse Source
This commit is contained in:
gnosygnu
2017-04-02 12:03:46 -04:00
parent 891ce4b0d2
commit 328c8aadbe
239 changed files with 2833 additions and 8418 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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<h3>
<span class="mw-headline" id="Setup_the_XOWA_app">Setup the XOWA app</span>
<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>
</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-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>
</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-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>
</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-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>
</h2>
<h3>
<span class="mw-headline" id="Environment">Environment</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h4>
<ul>
<li>
@@ -316,7 +316,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Coding_style">Coding style</span>
<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>
</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-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>
</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-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>
</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-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>
</h2>
<h3>
<span class="mw-headline" id="Download_the_wiki_dump">Download the wiki dump</span>
<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>
</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-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>
</h3>
<ul>
<li>
@@ -136,7 +136,7 @@
</dd>
</dl>
<h2>
<span class="mw-headline" id="Script">Script</span>
<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>
</h2>
<pre class='code'>
// do not show a "Press enter to continue" at the end of the script

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

@@ -116,7 +116,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span>
<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>
</h2>
<p>
The download-thumbs script downloads all thumbs for pages in a specific wiki. It works in the following way:
@@ -155,10 +155,10 @@
The script for simple wikipedia is listed below.
</p>
<h2>
<span class="mw-headline" id="Requirements">Requirements</span>
<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>
</h2>
<h3>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span>
<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>
</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 +167,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-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>
</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-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>
</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 +202,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-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>
</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 +211,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-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>
</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 +228,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="gfs">gfs</span>
<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>
</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 +263,16 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Terms">Terms</span>
<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>
</h2>
<h3>
<span class="mw-headline" id="lnki">lnki</span>
<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>
</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-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>
</h3>
<ul>
<li>
@@ -280,7 +280,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="xfer">xfer</span>
<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>
</h3>
<ul>
<li>
@@ -288,7 +288,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="fsdb">fsdb</span>
<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>
</h3>
<ul>
<li>
@@ -299,7 +299,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-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>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -493,7 +493,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-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>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -620,7 +620,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Change_log">Change log</span>
<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>
</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-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>
</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-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>
</h2>
<p>
Assuming you are on a Windows system with XOWA installed at <code>C:\xowa</code>

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

@@ -116,7 +116,7 @@
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span>
<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>
</h2>
<p>
The download-thumbs script downloads all thumbs for pages in a specific wiki. It works in the following way:
@@ -155,10 +155,10 @@
The script for simple wikipedia is listed below.
</p>
<h2>
<span class="mw-headline" id="Requirements">Requirements</span>
<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>
</h2>
<h3>
<span class="mw-headline" id="commons.wikimedia.org">commons.wikimedia.org</span>
<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>
</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 +167,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-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>
</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-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>
</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 +202,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-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>
</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 +211,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-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>
</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 +228,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="gfs">gfs</span>
<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>
</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 +263,16 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Terms">Terms</span>
<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>
</h2>
<h3>
<span class="mw-headline" id="lnki">lnki</span>
<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>
</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-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>
</h3>
<ul>
<li>
@@ -280,7 +280,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="xfer">xfer</span>
<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>
</h3>
<ul>
<li>
@@ -288,7 +288,7 @@
</li>
</ul>
<h3>
<span class="mw-headline" id="fsdb">fsdb</span>
<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>
</h3>
<ul>
<li>
@@ -299,7 +299,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-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>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -493,7 +493,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-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>
</h2>
<pre class='code'>
app.bldr.pause_at_end_('n');
@@ -620,7 +620,7 @@ app.bldr.cmds {
app.bldr.run;
</pre>
<h2>
<span class="mw-headline" id="Change_log">Change log</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<ul>
<li>
@@ -139,7 +139,7 @@ en.wikipedia.org
</dd>
</dl>
<h2>
<span class="mw-headline" id="Booleans">Booleans</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<ul>
<li>
@@ -84,13 +84,13 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Options">Options</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<h3>
<span class="mw-headline" id="Enable_images">Enable images</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<ul>
<li>
@@ -96,7 +96,7 @@
</li>
</ul>
<h2>
<span class="mw-headline" id="Notes">Notes</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<h3>
<span class="mw-headline" id="Platform-specific_jar">Platform-specific jar</span>
<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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</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-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>
</h2>
<h2>
<span class="mw-headline" id="Use_PRAGMA_page_size_4096">Use PRAGMA page_size 4096</span>
<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>
</h2>
</div>