Dev/Design/Site config

Sample files

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:

• Copy the "-sample.csv" file
• Replace the "-sample" to the name of the wiki. For example, for nethackwiki.com, rename the file to "extensiontags-nethackwiki.com.csv". For English Wikipedia, use "extensiontags-en.wikipedia.org.csv"
• Import the wiki. XOWA will use the data in the file when creating the wiki

This data gets stored in the main ".xowa" database in the xowa_cfg table. For example, run the following SQL: SELECT * FROM xowa_cfg WHERE cfg_key = 'extensiontags';

The remainder of this article documents the purpose of each file.

extensiontags

The "extensiontags" file lists active extensions. For example, to enable only <ref> and <references>, use the following two lines:

ref
references

All other extension tags will be disabled. For example, <math> will show up as just <math> LaTeX source instead of being replaced with graphical equations

The main purpose of this functionality is to disable extensions in some wikis. For example, the <do> extension is only active in the Wikivoyage wiki. Otherwise, English Wikipedia has an article called Type system which will render incorrectly with the following fragment:

<code>if <complex test> then <do something> else <generate type error></code>

interwikimap

The "interwikimap" file lists active interwiki prefixes. For example, to enable only the interwiki prefix for commons, use the following:

commons|https://commons.wikimedia.org/wiki/~{0}

This will convert [[commons:Earth]] to a link to https://commons.wikipedia.org/wiki/Earth