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

'v3.4.2.6'

Browse Source
This commit is contained in:
gnosygnu
2016-04-15 16:19:00 -04:00
parent 574451bd93
commit cc5b49c7c4
225 changed files with 111023 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

198
App/Setup/Flash_card.html Normal file
View File

@@ -0,0 +1,198 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/Flash card - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/Flash card</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
XOWA is designed to be portable. It can be stored on a flash memory card, and run from other machines. In theory you can take the same flash memory card and run it from Windows, Linux, and Mac OS X.
</p>
<p>
XOWA can be installed to a flash memory card simply by copying the entire root directory to it. For example, if you've set up XOWA on <code>C:\xowa</code> and your flash memory card is on <code>X:</code> then just copy <code>C:\xowa</code> to <code>X:\xowa</code>
</p>
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Standalone_JRE"><span class="tocnumber">1</span> <span class="toctext">Standalone JRE</span></a>
<ul>
<li class="toclevel-2 tocsection-2">
<a href="#Setup"><span class="tocnumber">1.1</span> <span class="toctext">Setup</span></a>
</li>
<li class="toclevel-2 tocsection-3">
<a href="#Limitations"><span class="tocnumber">1.2</span> <span class="toctext">Limitations</span></a>
</li>
<li class="toclevel-2 tocsection-4">
<a href="#Developer_notes"><span class="tocnumber">1.3</span> <span class="toctext">Developer notes</span></a>
</li>
</ul>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Standalone_JRE">Standalone JRE</span>
</h2>
<p>
XOWA can use a standalone JRE for Windows machines. This allows zero-install launches of XOWA from an flash-memory card on any Windows machine - regardless of whether or not Java is installed.
</p>
<h3>
<span class="mw-headline" id="Setup">Setup</span>
</h3>
<p>
The standalone JRE can be set up in the following way:
</p>
<ul>
<li>
Find the Java JRE. For example, on Windows, C:\Program Files\Java\
</li>
<li>
Copy the folder to XOWA's bin directory for your OS. For example, if you're on Windows 64-bit and your XOWA is set up on an external drive at <code>X:\xowa</code>, copy it to <code>X:\xowa\bin\windows_64\java\jre</code>. When you're done you should have a file called <code>X:\xowa\bin\windows_64\java\jre\bin\java.exe</code> as well as many others
</li>
<li>
Plug the external drive into a Windows machine without Java installed
</li>
<li>
Double-click xowa_64.exe. XOWA will launch using the copied JRE
</li>
</ul>
<p>
If you want the same flash-drive to work on Windows 32-bit machine, then you need to do the following
</p>
<ul>
<li>
Download a 32-bit JRE
</li>
<li>
Copy the folder to XOWA's bin directory: <code>X:\xowa\bin\windows\java\jre</code>
</li>
</ul>
<h3>
<span class="mw-headline" id="Limitations">Limitations</span>
</h3>
<ul>
<li>
There currently is no similar process for Linux distributions. Note that various Linux distributions would have different binaries, and setting up distro-specific JREs does not seem useful (Debian JRE; Redhat JRE; openSUSE JRE, etc).
</li>
<li>
There also is no similar process for Mac OS X. I'm working on a standalone .dmg file for OS X, and when it is done, I will include standalone JRE support.
</li>
</ul>
<h3>
<span class="mw-headline" id="Developer_notes">Developer notes</span>
</h3>
<ul>
<li>
The embedded JRE uses functionality within the exe which in turn was built by launch4j. There is no specific code in XOWA to handle this function. Any issues with standalone JRE functionality will probably be resolvable at the launch4j level.
</li>
</ul>
<p>
<br>
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

223
App/Setup/Installation.html Normal file
View File

@@ -0,0 +1,223 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/Installation - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/Installation</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Download_and_unzip_XOWA"><span class="tocnumber">1</span> <span class="toctext">Download and unzip XOWA</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Run_XOWA"><span class="tocnumber">2</span> <span class="toctext">Run XOWA</span></a>
</li>
<li class="toclevel-1 tocsection-3">
<a href="#XOWA_folder"><span class="tocnumber">3</span> <span class="toctext">XOWA folder</span></a>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Download_and_unzip_XOWA">Download and unzip XOWA</span>
</h2>
<ul>
<li>
Download a package for your operating system from <a href="https://github.com/gnosygnu/xowa/releases/" rel="nofollow" class="external free">https://github.com/gnosygnu/xowa/releases/</a> For example, if you're using Windows, you would download <code>xowa_app_windows_v3.1.1.1.zip</code>.
</li>
<li>
Unzip to a folder. See the XOWA Folder section below for possible choices.
</li>
<li>
When finished, you will have a file called <code>readme.txt</code> as well as many other files and directories.
</li>
</ul>
<h2>
<span class="mw-headline" id="Run_XOWA">Run XOWA</span>
</h2>
<ul>
<li>
On <b>Windows</b>, double-click <code>C:\xowa\xowa.exe</code>
</li>
<li>
On <b>Linux</b>, open a terminal and run <code>sh /home/Your_Name/xowa/xowa_linux.sh</code>
</li>
</ul>
<dl>
<dd>
Note that the shell script is a wrapper for <code>java -Xmx256m -jar /home/Your_Name/xowa/xowa_linux.jar</code>
</dd>
</dl>
<ul>
<li>
On <b>OS X</b>, open a terminal and run <code>sh /Users/Your_Name/xowa/xowa_macosx.sh</code>
</li>
</ul>
<dl>
<dd>
Note that the shell script is a wrapper for <code>java -Xmx256m -d32 -XstartOnFirstThread -jar /Users/Your_Name/xowa/xowa_macosx.jar</code>
</dd>
</dl>
<h2>
<span class="mw-headline" id="XOWA_folder">XOWA folder</span>
</h2>
<p>
XOWA works from one folder. For the purpose of the instructions throughout this wiki, this folder will be referred to as <code>/xowa/</code>.
</p>
<p>
The table below lists recommended locations by operating system. Note that these are just recommendations: you can use any other folder on your hard drive (or on a flash memory card).
</p>
<table class='wikitable'>
<tr>
<th>
operating system
</th>
<th>
folder
</th>
<th>
path of xowa jar
</th>
</tr>
<tr>
<td>
Windows
</td>
<td>
C:\xowa\
</td>
<td>
C:\xowa\xowa_windows.jar
</td>
</tr>
<tr>
<td>
Linux
</td>
<td>
/home/Your_Name/xowa/
</td>
<td>
/home/Your_Name/xowa/xowa_linux.jar
</td>
</tr>
<tr>
<td>
OS X
</td>
<td>
/Users/Your_Name/xowa/
</td>
<td>
/Users/Your_Name/xowa/xowa_macosx.jar
</td>
</tr>
</table>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

176
App/Setup/Installation/Notes.html Normal file
View File

@@ -0,0 +1,176 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/Installation/Notes - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/Installation/Notes</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Operating_System_dependent_files">Operating System dependent files</span>
</h2>
<p>
The following two files are operating-system dependent files:
</p>
<ul>
<li>
On <b>Windows</b>, <b>C:\xowa\xowa_windows.jar</b> and <b>C:\xowa\bin\windows\swt\swt.jar</b>
</li>
<li>
On <b>Linux</b>, <b>/xowa/xowa_linux.jar</b> and <b>/xowa/bin/linux/swt/swt.jar</b>
</li>
<li>
On <b>OS X</b>, <b>/xowa/xowa_macosx.jar</b> and <b>/xowa/bin/macosx/swt/swt.jar</b>
</li>
</ul>
<h2>
<span class="mw-headline" id="XUL_Runner">XUL Runner</span>
</h2>
<p>
XUL Runner is included in the xowa_app_packages. However, if you need to download it separately, please do the following:
</p>
<ul>
<li>
Navigate to the <a href="http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/10.0.4esr/runtimes/" rel="nofollow" class="external free">http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/10.0.4esr/runtimes/</a>
</li>
<li>
Download the proper operating system package
<ul>
<li>
On <b>Windows</b>, download <b>xulrunner-10.0.4esr.en-US.win32.zip</b> and unzip the files to <b>C:\xowa\bin\windows\xulrunner</b>
</li>
<li>
On <b>Linux</b>, download <b>xulrunner-10.0.4esr.en-US.linux-i686.tar.bz2</b> and unzip the files to <b>/home/your_user_name/xowa/bin/linux/xulrunner</b>
</li>
<li>
On <b>OS X</b>, download <b>xulrunner-10.0.4esr.en-US.mac-pkg.dmg</b>
</li>
</ul>
</li>
</ul>
<dl>
<dd>
<dl>
<dd>
<dl>
<dd>
Unzip the .dmg file. There will be a lot of nested packages. You will be looking for a folder called 10.0.4
<dl>
<dd>
For reference's sake, I used 7-zip on a Windows machine. This was the final path: C:\xulrunner-10.0.4esr.en-US.mac-pkg\XULRunner\xulrunner-10.0.4esr.en-US.mac.pkg\Contents\Archive.pax\Archive\XUL.framework\Versions\10.0.4
</dd>
</dl>
</dd>
<dd>
Take the 10.0.4 folder and move it to <b>/Users/your_user_name/xowa/bin/macosx/xulrunner</b>
</dd>
</dl>
</dd>
</dl>
</dd>
</dl>
<p>
<br>
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

142
App/Setup/Installation/Self_extracting_exe.html Normal file
View File

@@ -0,0 +1,142 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/Installation/Self extracting exe - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/Installation/Self extracting exe</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
XOWA currently uses a self-extracting exe for its windows upgrade package. This page documents the steps to generate the package.
</p>
<ul>
<li>
Download 7-zip from <a href="http://www.7-zip.org/" rel="nofollow" class="external free">http://www.7-zip.org/</a>
</li>
<li>
Download the 7-zip sfx module from <a href="http://7zsfx.info/en/" rel="nofollow" class="external free">http://7zsfx.info/en/</a> XOWA uses version 1.5 (build 2712) from <a href="http://7zsfx.info/files/7zsd_150_2712.7z" rel="nofollow" class="external free">http://7zsfx.info/files/7zsd_150_2712.7z</a>
</li>
<li>
Generate the 7-zip .7z archive (xowa_upgrade.7z)
</li>
<li>
Create a UTF-8 text file (config.txt) and enter the following
</li>
</ul>
<pre>
;!@Install@!UTF-8!
Title="XOWA"
InstallPath="."
OverwriteMode="0"
;!@InstallEnd@!
</pre>
<ul>
<li>
Run the following command to merge the two files into an exe:
</li>
</ul>
<p>
<code>copy /b 7zsd.sfx + config.txt + xowa_upgrade.7z xowa_upgrade.exe</code>
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

205
App/Setup/System_requirements.html Normal file
View File

@@ -0,0 +1,205 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/System requirements - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
<style>
.console {font-family: monospace; color: #EEEEEE ; background-color: black ; border: medium solid black;}
.code
,.path
,.url {font-family: monospace; color: black ; background-color: #f9f9f9 ; border: medium solid #f9f9f9;}
.bold {font-weight: 900;}
</style>
<style>
.console {font-family: monospace; color: #EEEEEE ; background-color: black ; border: medium solid black;}
.code
,.path
,.url {font-family: monospace; color: black ; background-color: #f9f9f9 ; border: medium solid #f9f9f9;}
.bold {font-weight: 900;}
</style>
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/System requirements</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Hardware"><span class="tocnumber">1</span> <span class="toctext">Hardware</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Software"><span class="tocnumber">2</span> <span class="toctext">Software</span></a>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Hardware">Hardware</span>
</h2>
<ul>
<li>
CPU: 1.0 GHz minimum; 2.0 GHz recommended
</li>
<li>
Memory: 512 MB minimum; 2 GB recommended
</li>
<li>
Storage: varies per wiki. As a rough guideline, multiply the dump file by 2.
<ul>
<li>
For example, for English Wikipedia, the dump size is 12 GB.
<ul>
<li>
The XOWA wiki will be about 25 GB
</li>
<li>
The import process will need about 2 GB in temp files.
</li>
<li>
You should have at least 30 GB available for the text only version. The image version will require at least another 70 GB.
</li>
</ul>
</li>
</ul>
</li>
</ul>
<h2>
<span class="mw-headline" id="Software">Software</span>
</h2>
<ul>
<li>
Operating System
<ul>
<li>
Windows 32 bit / 64 bit
</li>
<li>
Linux 32 bit / 64 bit
</li>
<li>
Mac OS X 32 bit / 64 bit
</li>
<li>
Raspberry PI (ARM)
</li>
<li>
Android
</li>
</ul>
</li>
<li>
Java 1.7+
<ul>
<li>
If Java is not installed on your machine, you can get it from <a href="http://www.java.com/en/download/manual.jsp" rel="nofollow" class="external free">http://www.java.com/en/download/manual.jsp</a>
</li>
<li>
On Debian Linux systems you can do <span class='console'>sudo apt-get install openjdk-7-jre</span>
</li>
</ul>
</li>
</ul>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

314
App/Setup/Upgrading.html Normal file
View File

@@ -0,0 +1,314 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Setup/Upgrading - XOWA</title>
<link rel="shortcut icon" href="http://xowa.org/xowa_logo.png" />
<link rel="stylesheet" href="http://xowa.org/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Setup/Upgrading</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
This article describes the process in upgrading your XOWA program from one release to another.
</p>
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Background"><span class="tocnumber">1</span> <span class="toctext">Background</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Upgrade_by_an_xowa_upgrade_package"><span class="tocnumber">2</span> <span class="toctext">Upgrade by an xowa_upgrade package</span></a>
<ul>
<li class="toclevel-2 tocsection-3">
<a href="#Upgrade_process"><span class="tocnumber">2.1</span> <span class="toctext">Upgrade process</span></a>
</li>
<li class="toclevel-2 tocsection-4">
<a href="#Upgrade_shelf-life_of_4_weeks"><span class="tocnumber">2.2</span> <span class="toctext">Upgrade shelf-life of 4 weeks</span></a>
</li>
<li class="toclevel-2 tocsection-5">
<a href="#Upgrade_issues_should_fallback_to_xowa_app_packages"><span class="tocnumber">2.3</span> <span class="toctext">Upgrade issues should fallback to xowa_app packages</span></a>
</li>
</ul>
</li>
<li class="toclevel-1 tocsection-6">
<a href="#Upgrade_by_an_xowa_app_package"><span class="tocnumber">3</span> <span class="toctext">Upgrade by an xowa_app package</span></a>
</li>
<li class="toclevel-1 tocsection-7">
<a href="#Upgrade_by_an_xowa_app_package_and_regenerating_the_XOWA_root_directory"><span class="tocnumber">4</span> <span class="toctext">Upgrade by an xowa_app package and regenerating the XOWA root directory</span></a>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Background">Background</span>
</h2>
<p>
XOWA has a rapid release cycle, with a new version coming out every week. For more details, see <a href="http://xowa.org/wiki/home/page/Help/Release_schedule.html" id="xolnki_2" title="Help/Release schedule" class="xowa-visited">Help/Release_schedule</a>.
</p>
<p>
XOWA releases frequently for a few reasons:
</p>
<ul>
<li>
<b>MediaWiki updates frequently</b>: English Wikipedia and all the other Wikimedia wikis use a <a href="https://www.mediawiki.org/wiki/Version_lifecycle" rel="nofollow" class="external text">continuous integration model</a>. These releases tend to come out very quickly with releases as often as every week. See <a href="https://www.mediawiki.org/wiki/News" rel="nofollow" class="external free">https://www.mediawiki.org/wiki/News</a> for an example of the release schedule
</li>
<li>
<b>XOWA is still young</b>: XOWA was only released in 2012-12-31. Although a lot of features have been added since then, there are still a lot of features to be added.
</li>
<li>
<b>Frequent release philosophy</b>: I personally prefer having frequent releases as opposed to larger infrequent releases. The former is more manageable, and keeps overall development nimble.
</li>
</ul>
<h2>
<span class="mw-headline" id="Upgrade_by_an_xowa_upgrade_package">Upgrade by an xowa_upgrade package</span>
</h2>
<p>
<code>xowa_upgrade</code> packages are produced with every release.
</p>
<h3>
<span class="mw-headline" id="Upgrade_process">Upgrade process</span>
</h3>
<p>
To upgrade, do the following:
</p>
<p>
<b>Windows</b>
</p>
<ul>
<li>
Download the "xowa_upgrade" exe for your operating system. For example, if you're on Windows with a 64-bit JVM and upgrading to v2.8.2, you would download xowa_upgrade_windows_64_v2.8.2.1.exe
</li>
<li>
Place the .exe in your xowa root directory. For example, if you're running XOWA by using <code>C:\xowa\xowa_64.exe</code>, then place xowa_upgrade_windows_64_v2.8.2.1.exe in <code>C:\xowa</code> so that the file name is <code>C:\xowa\xowa_upgrade_windows_64_v2.8.2.1.exe</code>
</li>
<li>
Double-click the "xowa_upgrade.exe". The upgrade is a self-extracting 7-zip exe and will unzip all files and place them in the correct locations. Among other things, you'll have a new xowa.jar file. For example, <code>C:\xowa\xowa_windows_64.jar</code> should show a recent date.
</li>
</ul>
<p>
<b>Linux / Mac OS X</b>
</p>
<ul>
<li>
Download the "xowa_upgrade" zip for your operating system
</li>
<li>
Place the .zip in your xowa root directory. For example, if you're running Mac OS X by using <code>/Users/your_user_name/xowa/xowa_macosx_64.sh</code>, then place xowa_upgrade_macosx_64_v2.8.2.1.zip in <code>/Users/your_user_name/xowa/</code> so that the file name is <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1.zip</code>
</li>
<li>
Extract the files. Note that depending on your unzip program, the file may be placed in a new sub-directory. For example, on Mac OS X, the files will be unzipped to a new folder called <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1/</code>
</li>
<li>
Move the files from the extracted folder to the XOWA root folder. Overwrite any files in the process. For example, on Mac OS X, there will be a new file called <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1/xowa_macosx_64.jar</code>. This should be moved to <code>/Users/your_user_name/xowa/xowa_macosx_64.jar</code> and overwrite the existing version.
</li>
</ul>
<h3>
<span class="mw-headline" id="Upgrade_shelf-life_of_4_weeks">Upgrade shelf-life of 4 weeks</span>
</h3>
<p>
A given upgrade will only work if your release is within the past 4 weeks. For example:
</p>
<ul>
<li>
You start off with the v2.1.3 application.
</li>
<li>
v2.1.4 is released. You can use the v2.1.4 upgrade since your v2.1.3 release is 1 week old
</li>
<li>
v2.2.1 is released and you haven't upgraded anything. You can use the v2.2.1 upgrade since your v2.1.3 release is 2 weeks old.
</li>
<li>
v2.2.2 is released and you haven't upgraded anything. You can use the v2.2.2 upgrade since your v2.1.3 release is 3 weeks old.
</li>
<li>
v2.2.3 is released and you haven't upgraded anything. You can use the v2.2.3 upgrade since your v2.1.3 release is 4 weeks old.
</li>
<li>
v2.2.4 is released and you haven't upgraded anything. You can not use the v2.2.4 upgrade since your v2.1.3 release is 5 weeks old. You must get a new application package
</li>
</ul>
<p>
Once you upgrade, the 4-week window resets. You can perpetually upgrade XOWA in this fashion. For example:
</p>
<ul>
<li>
You start off with the v2.1.3 application.
</li>
<li>
You upgrade when v2.2.3 is released. Your release will now be v2.2.3
</li>
<li>
You upgrade again when v2.3.3 is released. Your release will now be v2.3.3
</li>
<li>
You upgrade again when v2.4.1 is released. Your release will now be v2.4.1
</li>
<li>
And so on...
</li>
</ul>
<h3>
<span class="mw-headline" id="Upgrade_issues_should_fallback_to_xowa_app_packages">Upgrade issues should fallback to xowa_app packages</span>
</h3>
<p>
If you have problems after using an xowa_upgrade package, try upgrading using an xowa_app package. I personally test xowa_app packages on both Windows and Linux for every release and these will always work. In addition, due to the nature of the build script, the application package is always guaranteed to have the latest changes.
</p>
<h2>
<span class="mw-headline" id="Upgrade_by_an_xowa_app_package">Upgrade by an xowa_app package</span>
</h2>
<p>
You can also upgrade by downloading an xowa_app package and unzipping everything in the xowa root directory. For example:
</p>
<ul>
<li>
Download the "xowa_app" zip for your operating system
</li>
<li>
Place the .zip in your xowa root directory. For example, if you're running on Windows 64-bit by using <code>C:\xowa\windows_64.exe</code>, then place xowa_app_windows_64_v2.8.2.1.zip in <code>C:\xowa\windows_64\</code> so that the file name is <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1.zip</code>
</li>
<li>
Extract the files. Note that depending on your unzip program, the file may be placed in a new sub-directory. For example, on Windows 64-bit, the files will be unzipped to a new folder called <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1\</code>
</li>
<li>
Move the files from the extracted folder to the XOWA root folder. Overwrite any files in the process. For example, on Windows 64-bit, there will be a new file called <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1\xowa_windows_64.jar</code>. This should be moved to <code>C:\xowa\windows_64\xowa_windows_64.jar</code> and overwrite the existing version.
</li>
</ul>
<p>
Note that you can always just upgrade using the <code>xowa_app</code> package. The <code>xowa_upgrade</code> packages are provided because they are generally 5 to 10 times smaller than the application packages.
</p>
<h2>
<span class="mw-headline" id="Upgrade_by_an_xowa_app_package_and_regenerating_the_XOWA_root_directory">Upgrade by an xowa_app package and regenerating the XOWA root directory</span>
</h2>
<p>
You can also do an upgrade by renaming your existing XOWA root directory and unzipping a new app package in the same directory. For example, assuming a Windows system with XOWA in <code>C:\xowa</code>
</p>
<ul>
<li>
Rename the <code>C:\xowa</code> folder to <code>C:\xowa-old</code>
</li>
<li>
Download an app package and unzip it to <code>C:\xowa</code>
</li>
<li>
Move the following directories from <code>C:\xowa-old</code> to <code>C:\xowa</code>
<ul>
<li>
<code>C:\xowa-old\wiki</code> to <code>C:\xowa\wiki</code>
</li>
<li>
<code>C:\xowa-old\file</code> to <code>C:\xowa\file</code>
</li>
<li>
<code>C:\xowa-old\user</code> to <code>C:\xowa\user</code>
</li>
</ul>
</li>
</ul>
<p>
This approach is more manual, but is meant as an alternate approach. It's also useful for moving XOWA from one drive to another.
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(http://xowa.org/xowa_logo.png);" href="index.html" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/wiki/home/page/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-stargin'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/wiki/home/page/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/wiki/home/page/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/wiki/home/page/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="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/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>