App path: Enter a path to program. Note that "..." will allow you to choose a file from your system.<supid="cite_ref-ref_app_path_0-0"class="reference"><ahref="#cite_note-ref_app_path-0">[1]</a></sup>
</li>
<li>
App args: Enter args for program. <supid="cite_ref-ref_app_args_1-0"class="reference"><ahref="#cite_note-ref_app_args-1">[2]</a></sup>
<spanclass="mw-cite-backlink"><ahref="#cite_ref-ref_app_path_0-0">^</a></span><spanclass="reference-text">For app path, enter one of the following</span>
<ul>
<li>
<spanclass="reference-text">An absolute path. Note that you <b>must</b> enter quotes if your path has spaces. For example:</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">On Linux / Mac OS X: <code>/usr/bin/vlc</code></span>
<spanclass="reference-text">This will expand to <code>C:\xowa\bin\windows\vlc\vlc</code></span>
</dd>
</dl>
</dd>
<dd>
<spanclass="reference-text">Note that relative paths display their expanded form (<code>/xowa/bin/linux/</code>), not their literal form (<code>~{<>bin_plat_dir<>}</code>)</span>
</dd>
<dd>
<spanclass="reference-text">i.e.: if you enter <code>~{<>bin_plat_dir<>}</code> and press save, the text box will show <code>/xowa/bin/linux/</code>, even though the value is saved as <code>~{<>bin_plat_dir<>}</code></span>
</dd>
</dl>
<ul>
<li>
<spanclass="reference-text">A binary name, if the binary's directory is defined in your PATH</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">EX: On a Windows system with a PATH including <code>"C:\Program Files\VLC"</code>, a value of <code>vlc</code> is sufficient.</span>
<spanclass="reference-text">For Linux / Mac OS X systems, the default values may not apply. Please change as necessary on your system</span>
</li>
</ul>
<ul>
<li>
<spanclass="reference-text">For Windows systems, the default path is defined as <code>cmd</code> and the arg is <code>/c start "~{file}"</code>. This attempts to launch the file with the default application defined for the file.</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">If this does not work properly, please specify the app path</span>
</dd>
</dl>
</li>
<liid="cite_note-ref_app_args-1">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-ref_app_args_1-0">^</a></span><spanclass="reference-text">For app args, note the following</span>
<ul>
<li>
<spanclass="reference-text">A web browser takes one argument of <code>~{url}</code> which expands to the url in the external link</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">EX: For <ahref="https://sourceforge.net/projects/xowa/files/"rel="nofollow"class="external free">https://sourceforge.net/projects/xowa/files/</a> the <code>~{url}</code> will be <code>https://sourceforge.net/projects/xowa/files/</code></span>
</dd>
</dl>
<ul>
<li>
<spanclass="reference-text">Other content applications take one argument of <code>~{file}</code> which expands to the local path for the file</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">EX: The image [[File:A.png]] will produce a <code>~{file}</code> of <code>/xowa/file/en.wikipedia.org/orig/7/0/1/c/A.png</code></span>
</dd>
</dl>
<ul>
<li>
<spanclass="reference-text">Customized arguments can be passed depending on the application</span>
</li>
</ul>
<dl>
<dd>
<spanclass="reference-text">EX: VLC takes an argument <code>--no-loop</code> which explicitly instructs VLC not to automatically replay the file. (Clicking on a pronunciation example would cause the short 1 second word to be repeated over and over again).</span>
</dd>
<dd>
<spanclass="reference-text">To pass this argument, change the args to <code>--no-loop "~{file}"</code></span>
</dd>
</dl>
</li>
<liid="cite_note-2">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-2">^</a></span><spanclass="reference-text">Launches when clicking on external links . Recommended: <ahref="http://www.mozilla.org/en-US"rel="nofollow"class="external text">Mozilla Firefox</a></span>
</li>
<liid="cite_note-3">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-3">^</a></span><spanclass="reference-text">Launches when clicking on video or audio links . Recommended: <ahref="http://www.videolan.org/vlc/index.html"rel="nofollow"class="external text">VLC</a></span>
</li>
<liid="cite_note-4">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-4">^</a></span><spanclass="reference-text">Launches when clicking on images in Wikimedia Commons . Recommended: <ahref="http://www.gimp.org"rel="nofollow"class="external text">GIMP</a></span>
</li>
<liid="cite_note-5">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-5">^</a></span><spanclass="reference-text">Launches when clicking on pdf files . Recommended: <ahref="http://projects.gnome.org/evince"rel="nofollow"class="external text">Evince</a></span>
</li>
<liid="cite_note-6">
<spanclass="mw-cite-backlink"><ahref="#cite_ref-6">^</a></span><spanclass="reference-text">Launches when clicking on djvu files . Recommended: <ahref="http://djvu.sourceforge.net"rel="nofollow"class="external text">DjVuLibre</a></span>
<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/ -->
