The XOWA viewer is an add-on for the Firefox browser. It allows Firefox to show XOWA pages by using an "xowa:" protocol (instead of "http:"). For example, navigating to <code>xowa:simple.wikipedia.org/wiki/Earth</code> will retrieve the HTML from XOWA but show it in Firefox.
As of Firefox version 43, unsigned addons are no longer supported. See <ahref="https://support.mozilla.org/en-US/kb/add-on-signing-in-firefox"rel="nofollow"class="external free">https://support.mozilla.org/en-US/kb/add-on-signing-in-firefox</a> The XOWA Firefox Addon should be signed in the future, but in the meantime, you can use the open-source alternative Pale Moon as a substitute:
</p>
<ul>
<li>
Download Pale Moon from here: <ahref="http://www.fosshub.com/Pale-Moon.html"rel="nofollow"class="external free">http://www.fosshub.com/Pale-Moon.html</a>
</li>
<li>
Using File -> Open File, open the XPI from /xowa/bin/any/firefox/xowa_viewer/default/xowa_viewer.xpi
</li>
<li>
Set the jar location for "extensions.xowa_viewer.xowa_app" in about:config. See <ahref="#Config"id="xolnki_2">Config</a> below
The Add-on installs an XOWA toolbar button called "XOWA Home". Users can enable it by doing the following:
</p>
<ul>
<li>
Right-click on any toolbar in Firefox
</li>
<li>
Choose "Customize"
</li>
<li>
Find the "XOWA Home" button and drag it to the toolbar
</li>
</ul>
<h2>
<spanclass="mw-headline"id="Features_and_Limitations">Features and Limitations</span>
</h2>
<p>
The XOWA viewer is a work in progress. XOWA needs to make changes to communicate with Firefox over TCP (right now it communicates directly with the embedded browser)
</p>
<p>
The following is a high-level list of supported features:
</p>
<ul>
<li>
On the Firefox Menu Bar, Tools -> XOWA home will navigate to home/wiki/Main_Page
</li>
<li>
Navigate to a url by typing in the url with an xowa protocol. For example, <code>xowa:simple.wikipedia.org/wiki/Earth</code>
</li>
<li>
Click on any link, and it will open the page in Firefox
</li>
<li>
The following javascript libraries will work:
<ul>
<li>
MathJax
</li>
<li>
Reference tooltips
</li>
<li>
Sortable / collapsible
</li>
<li>
Timeline
</li>
<li>
Search-suggest
</li>
<li>
Wikidata JSON formatter
</li>
</ul>
</li>
<li>
Close the browser and the XOWA server will shut down.
</li>
</ul>
<p>
The following is a high-level list of current limitations (Note that these will be addressed in future builds):
</p>
<ul>
<li>
xowa-cmd links will not work. This includes links to Read, Edit, View HTML, Exit, and Bookmark this page. This requires support for the "xowa-cmd:" protocol
</li>
<li>
The following javascript related items will not work. They require support for calling Javascript in Firefox from XOWA.
<ul>
<li>
Options pages
</li>
<li>
Wiki import
</li>
</ul>
</li>
</ul>
<h2>
<spanclass="mw-headline"id="Config">Config</span>
</h2>
<p>
The addon has several options that can be configured.
</p>
<ul>
<li>
Navigate to about:config
</li>
<li>
Search for "extensions.xowa"
</li>
<li>
The most important item is "extensions.xowa_viewer.xowa_app". This needs to point to your local xowa.jar.
<ul>
<li>
On Windows, it may be C:\xowa\xowa_windows.jar
</li>
<li>
On Linux, it may be /home/user/your_user_name/xowa/xowa_linux.jar
</li>
<li>
On Mac OS X, it may be /Users/your_user_name/xowa/xowa_macosx.jar
The source code is available under the Mozilla Public License at <ahref="https://github.com/piotrex/XOWA-Addon"rel="nofollow"class="external text">gitub</a>.
</p>
<p>
It is also contained in the Addon itself. You can unzip the .xpi and examine any of the underlying files. The code is in javascript and there are no binary dependencies.
Go to <ahref="https://github.com/piotrex/XOWA-Addon"rel="nofollow"class="external free">https://github.com/piotrex/XOWA-Addon</a> and choose Download Zip
</li>
<li>
Extract the zip file
</li>
<li>
Navigate to the extension directory and add all its files / directories (chrome, content, install.rdf, etc.) to a new zip file called "xowa_viewer.zip". (You can use 7-zip or your favorite compression program)
<li><ahref="//gnosygnu.github.io/xowa/wiki/home/page/App/Setup/System_requirements.html"title='Get XOWA's system requirements'>Requirements</a></li>
<li><ahref="//gnosygnu.github.io/xowa/wiki/home/page/App/Setup/Installation.html"title='Get instructions for installing XOWA'>Installation</a></li>
<li><ahref="//gnosygnu.github.io/xowa/wiki/home/page/App/Import/Simple_Wikipedia.html"title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><ahref="//gnosygnu.github.io/xowa/wiki/home/page/App/Import/English_Wikipedia.html"title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><ahref="//gnosygnu.github.io/xowa/wiki/home/page/App/Import/Other_wikis.html"title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
<li><ahref="http://dumps.wikimedia.org/backup-index.html"title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><ahref="https://archive.org/search.php?query=xowa"title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><ahref="http://en.wikipedia.org"title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<divclass="portal"id='xowa-portal-donate'>
<h3>Donate</h3>
<divclass="body">
<ul>
<li><ahref="https://archive.org/donate/index.php"title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
