123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580 |
- <!DOCTYPE html>
- <html dir="ltr">
- <head>
- <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
- <title>Options/HTML Tidy - XOWA</title>
- <link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
- <link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
- <style>
- .options_row_label {font-weight:bold; vertical-align:text-top; text-align:right; width:150px;}
- .options_table {border: 1px solid #AAAAAA; border-collapse: collapse; color: black; margin: 1em 0; background-color: #F9F9F9;}
- .options_table td {border: 1px solid #AAAAAA; padding: 0.2em;}
- .options_textbox {padding: 2px; border: 1px solid black;}
- .options_textbox_num {padding: 2px; border: 1px solid black; text-align:right;}
- .options_textarea {padding: 2px; border: 1px solid black;}
- .options_select {padding: 2px; border: 1px solid black;}
- .options_button {padding: 2px; border: 1px solid black; background: white; height: 22px; margin-left: 1px; vertical-align: top;}
- .options_checkbox {padding: 2px; border: 1px solid black;}
- .options_readonly {background-color:#F9F9F9;}
- </style>
- <style>
- .optionsButton
- {
- width: 100px;
- height: 40px;
- font-family: 'Segoe UI';
- font-size: 12px;
- margin-left: -5px;
- cursor: pointer;
- background-color: lightgray;
- text-align: center;
- }
- .optionsLink
- {
- color: black !important;
- text-decoration: none;
- }
- .optionsButton.active
- {
- width: 100px;
- height: 40px;
- font-family: 'Segoe UI';
- font-size: 12px;
- margin-left: -5px;
- cursor: pointer;
- background-color: dimgray;
- color: white !important;
- border: solid 1px dimgray;
- }
- .optionsButton.active a
- {
- color: white !important;
- }
- .tabs
- {
- width: 100%;
- margin-top: 10px;
- }
- .tab-links ul
- {
- margin-left: -40px;
- }
- .tab-links li
- {
- margin: 0px 0px 0px 0px;
- float: left;
- list-style: none;
- }
- .tab-links a
- {
- padding: 9px 15px 9px 15px;
- border-radius: 3px 3px 0px 0px;
- background: #f0f0f0;
- font-family: 'Segoe UI';
- font-size: 13px;
- color: black !important;
- text-decoration: none;
- border-radius: 3px;
- border-top: solid 1px gray;
- border-left: solid 1px gray;
- border-right: solid 1px gray;
- }
- .tab-links a:hover
- {
- background: #B0B0B0;
- text-decoration: none;
- }
- li.active a, li.active a:hover
- {
- background: #fff;
- color: #4c4c4c;
- font-weight: bold;
- }
- .tab-content
- {
- padding: 15px;
- border-radius: 3px;
- background: #fff;
- border-top: solid 1px gray;
- margin-top: 5px;
- min-height: 300px;
- }
- </style>
- <style>
- .options_row_label {font-weight:bold; vertical-align:text-top; text-align:right; width:150px;}
- .options_table {border: 1px solid #AAAAAA; border-collapse: collapse; color: black; margin: 1em 0; background-color: #F9F9F9;}
- .options_table td {border: 1px solid #AAAAAA; padding: 0.2em;}
- .options_textbox {padding: 2px; border: 1px solid black;}
- .options_textbox_num {padding: 2px; border: 1px solid black; text-align:right;}
- .options_textarea {padding: 2px; border: 1px solid black;}
- .options_select {padding: 2px; border: 1px solid black;}
- .options_button {padding: 2px; border: 1px solid black; background: white; height: 22px; margin-left: 1px; vertical-align: top;}
- .options_checkbox {padding: 2px; border: 1px solid black;}
- .options_readonly {background-color:#F9F9F9;}
- </style>
- <style>
- .optionsButton
- {
- width: 100px;
- height: 40px;
- font-family: 'Segoe UI';
- font-size: 12px;
- margin-left: -5px;
- cursor: pointer;
- background-color: lightgray;
- text-align: center;
- }
- .optionsLink
- {
- color: black !important;
- text-decoration: none;
- }
- .optionsButton.active
- {
- width: 100px;
- height: 40px;
- font-family: 'Segoe UI';
- font-size: 12px;
- margin-left: -5px;
- cursor: pointer;
- background-color: dimgray;
- color: white !important;
- border: solid 1px dimgray;
- }
- .optionsButton.active a
- {
- color: white !important;
- }
- .tabs
- {
- width: 100%;
- margin-top: 10px;
- }
- .tab-links ul
- {
- margin-left: -40px;
- }
- .tab-links li
- {
- margin: 0px 0px 0px 0px;
- float: left;
- list-style: none;
- }
- .tab-links a
- {
- padding: 9px 15px 9px 15px;
- border-radius: 3px 3px 0px 0px;
- background: #f0f0f0;
- font-family: 'Segoe UI';
- font-size: 13px;
- color: black !important;
- text-decoration: none;
- border-radius: 3px;
- border-top: solid 1px gray;
- border-left: solid 1px gray;
- border-right: solid 1px gray;
- }
- .tab-links a:hover
- {
- background: #B0B0B0;
- text-decoration: none;
- }
- li.active a, li.active a:hover
- {
- background: #fff;
- color: #4c4c4c;
- font-weight: bold;
- }
- .tab-content
- {
- padding: 15px;
- border-radius: 3px;
- background: #fff;
- border-top: solid 1px gray;
- margin-top: 5px;
- min-height: 300px;
- }
- </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>Options/HTML Tidy</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>
- <table>
- <tr>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Window'>Apps (basic)</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Security'>Apps (advanced)</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Import'>Wiki</a>
- </td>
- <td class='optionsButton active'>
- <a class='optionsLink' href='/wiki/Options/HTML'>HTML</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Content_apps'>External apps</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Search_suggest'>Modules</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Math'>Extensions</a>
- </td>
- <td class='optionsButton'>
- <a class='optionsLink' href='/wiki/Options/Dev'>Misc</a>
- </td>
- </tr>
- </table>
- </div>
- <div class="tabs">
- <div>
- <ul class='tab-links' style='margin-left:0px;'>
- <li class=''>
- <a href='/wiki/Options/HTML'>HTML</a>
- </li>
- <li class=''>
- <a href='/wiki/Options/Wiki_HTML'>Wiki HTML</a>
- </li>
- <li class='active'>
- <a href='/wiki/Options/HTML_Tidy'>HTML Tidy</a>
- </li>
- </ul>
- </div><br>
- <div class='tab-content'>
- <div id="toc" class="toc">
- <div id="toctitle">
- <h2>
- Contents
- </h2>
- </div>
- <ul>
- <li class="toclevel-1 tocsection-1">
- <a href="#General"><span class="tocnumber">1</span> <span class="toctext">General</span></a>
- </li>
- <li class="toclevel-1 tocsection-2">
- <a href="#Engine:_tidy_binary"><span class="tocnumber">2</span> <span class="toctext">Engine: tidy binary</span></a>
- </li>
- <li class="toclevel-1 tocsection-3">
- <a href="#Notes"><span class="tocnumber">3</span> <span class="toctext">Notes</span></a>
- </li>
- </ul>
- </div>
- <div style='float:right; margin-right:10px; margin-top:5px;'>
- <p>
- <a href="xowa-cmd:app.user.prefs.save();" accesskey='s'><img src='file:///C:/xowa/bin/any/xowa/file/app.window/save.png' width="16" height="16">Save</a>
- </p>
- </div><br>
-
- <p>
- HTML Tidy is a software library whose purpose is to fix invalid HTML. It is enabled on all Wikimedia wikis. Without HTML Tidy, a small percentage of pages will render incorrectly (broken tables; extended bold; horizontal scroll bar; misplaced images), etc. See <a href="http://xowa.org/wiki/home/page/Diagnostics/HTML_Tidy.html" id="xolnki_2" title="Diagnostics/HTML Tidy" class="xowa-visited">Diagnostics/HTML_Tidy</a> for examples.
- </p>
- <p>
- For more info about XOWA's customized JTidy jar, see <a href="http://xowa.org/wiki/home/page/App/Xtn/Mediawiki/Tidy/JTidy.html" id="xolnki_3" title="App/Xtn/Mediawiki/Tidy/JTidy">App/Xtn/Mediawiki/Tidy/JTidy</a>
- </p>
- <h2>
- <span class="mw-headline" id="General">General</span>
- </h2>
- <table class='options_table'>
- <tr>
- <td class='options_row_label'>
- Enabled: <sup id="cite_ref-enabled_0-0" class="reference"><a href="#cite_note-enabled-0">[1]</a></sup>
- </td>
- <td>
- <input xowa_prop="app.html.tidy.enabled" type="checkbox" class='options_checkbox' id='xowa_prop_0' checked='checked'>
- </td>
- </tr>
- <tr>
- <td class='options_row_label'>
- Tidy engine: <sup id="cite_ref-engine_type_1-0" class="reference"><a href="#cite_note-engine_type-1">[2]</a></sup>
- </td>
- <td>
- <select xowa_prop="app.html.tidy.engine_type" xowa_prop_list="app.html.tidy.engine_type_list" class="options_textbox" size='2' id='xowa_prop_1'>
- <option value='tidy'>
- tidy
- </option>
- <option value='jtidy' selected='selected'>
- jtidy
- </option>
- </select>
- </td>
- </tr>
- </table>
- <h2>
- <span class="mw-headline" id="Engine:_tidy_binary">Engine: tidy binary</span>
- </h2>
- <table class="metadata plainlinks ambox ambox-delete" style="">
- <tr>
- <td class="mbox-empty-cell">
- </td>
- <td class="mbox-text" style="">
- <p>
- <span class="mbox-text-span">Linux / Mac OS X users:</span>
- </p>
- <ul>
- <li>
- <span class="mbox-text-span">If you choose to use the tidy binary, please download the appropriate one for your platform from <a href="http://tidy.sourceforge.net/" rel="nofollow" class="external free">http://tidy.sourceforge.net/</a></span>
- </li>
- <li>
- <span class="mbox-text-span">If you enable tidy and XOWA shows no HTML, you will need to disable tidy through a text editor: /xowa/user/anonymous/app/data/cfg/xowa_user_cfg.gfs</span>
- </li>
- </ul>
- </td>
- </tr>
- </table>
- <table class='options_table'>
- <tr>
- <td class='options_row_label'>
- tidy library:
- <p>
- <sup id="cite_ref-2" class="reference"><a href="#cite_note-2">[3]</a></sup>
- </p>
- </td>
- <td>
- <input xowa_prop="app.html.tidy.lib.cmd" class="options_textbox" style="width: 380px; margin-bottom:2px;" type="xowa_io" id='xowa_prop_2' value='C:\xowa\bin\windows_64\tidy\tidy'><button id='xowa_prop_2_io' class='options_button' onclick='xowa_io_select("file", "xowa_prop_2", "Please select a file.");'>...</button>
- <p>
- <input xowa_prop="app.html.tidy.lib.args" class="options_textbox" style="width: 380px;" id='xowa_prop_3' value='-utf8 --force-output y --quiet y --tidy-mark n --doctype '' --wrap 0 --indent y --quote-nbsp y --literal-attributes y --wrap-attributes n --fix-uri n --fix-backslash n --enclose-block-text y -o "~{target}" "~{source}"'><sup id="cite_ref-engine_tidy_3-0" class="reference"><a href="#cite_note-engine_tidy-3">[4]</a></sup>
- </p>
- </td>
- </tr>
- </table>
- <h2>
- <span class="mw-headline" id="Notes">Notes</span>
- </h2>
- <ol class="references">
- <li id="cite_note-enabled-0">
- <span class="mw-cite-backlink"><a href="#cite_ref-enabled_0-0">^</a></span> <span class="reference-text">Choose if HTML tidy is enabled (default is <code>checked</code>)</span>
- </li>
- <li id="cite_note-engine_type-1">
- <span class="mw-cite-backlink"><a href="#cite_ref-engine_type_1-0">^</a></span> <span class="reference-text">Choose an HTML tidy engine (default is <code>jtidy</code>)</span>
- <ul>
- <li>
- <span class="reference-text"><b><a href="http://tidy.sourceforge.net/" rel="nofollow" class="external text">tidy</a></b>: The same library that is used by WMF wikis. Choose <code>tidy</code> if you want to run the official tidy library that WM uses. Note that you must download the binary if you are on Linux / Mac OS X.</span>
- </li>
- <li>
- <span class="reference-text"><b><a href="http://jtidy.sourceforge.net/" rel="nofollow" class="external text">jtidy</a></b>: A Java implementation of the tidy library. Choose <code>jtidy</code> if you don't want to install a platform specific binary. Note that JTidy is not a 100% implementation of tidy, though it appears to be quite close (at about 95%).</span>
- </li>
- </ul>
- </li>
- <li id="cite_note-2">
- <span class="mw-cite-backlink"><a href="#cite_ref-2">^</a></span> <span class="reference-text">Path to the tidy binary . Recommended: <a href="http://tidy.sourceforge.net" rel="nofollow" class="external text">tidy</a></span>
- </li>
- <li id="cite_note-engine_tidy-3">
- <span class="mw-cite-backlink"><a href="#cite_ref-engine_tidy_3-0">^</a></span> <span class="reference-text">XOWA defaults to the following tidy arguments:</span>
- <pre style='overflow:auto;'>
- <span class="reference-text">-utf8 --force-output y --quiet y --tidy-mark n --doctype '''' --wrap 0 --indent y --quote-nbsp y --literal-attributes y --wrap-attributes n --fix-url n --fix-backslash n --enclose-block-text y -o "~{target}" "~{source}"
- </span>
- </pre>
- <dl>
- <dt>
- <span class="reference-text">-utf8</span>
- </dt>
- <dd>
- <span class="reference-text">default is ascii</span>
- </dd>
- <dt>
- <span class="reference-text">--force-output y</span>
- </dt>
- <dd>
- <span class="reference-text">always generate output; do not fail on error</span>
- </dd>
- <dt>
- <span class="reference-text">--quiet y</span>
- </dt>
- <dd>
- <span class="reference-text">suppress command-line header</span>
- </dd>
- <dt>
- <span class="reference-text">--tidy-mark n</span>
- </dt>
- <dd>
- <span class="reference-text">do not add tidy watermark</span>
- </dd>
- <dt>
- <span class="reference-text">--doctype ''''</span>
- </dt>
- <dd>
- <span class="reference-text">default is auto (TRANSITIONAL); causes weird quirks with short text lines on some wikis (tr.wikibooks.org)</span>
- </dd>
- <dt>
- <span class="reference-text">--wrap 0</span>
- </dt>
- <dd>
- <span class="reference-text">default is 80; do not limit lines to 80 chars</span>
- </dd>
- <dt>
- <span class="reference-text">--indent y</span>
- </dt>
- <dd>
- <span class="reference-text">indent block levels</span>
- </dd>
- <dt>
- <span class="reference-text">--quote-nbsp y</span>
- </dt>
- <dd>
- <span class="reference-text">preserve nbsp as entities; do not convert to Unicode character 160</span>
- </dd>
- <dt>
- <span class="reference-text">--literal-attributes y</span>
- </dt>
- <dd>
- <span class="reference-text">do not alter whitespace chars in attributes</span>
- </dd>
- <dt>
- <span class="reference-text">--wrap-attributes n</span>
- </dt>
- <dd>
- <span class="reference-text">do not line-wrap attribute values</span>
- </dd>
- <dt>
- <span class="reference-text">--fix-url n</span>
- </dt>
- <dd>
- <span class="reference-text">do not escape invalid chars in uris</span>
- </dd>
- <dt>
- <span class="reference-text">--fix-backslash n</span>
- </dt>
- <dd>
- <span class="reference-text">do not change \ to / in URLs</span>
- </dd>
- <dt>
- <span class="reference-text">--enclose-block-text y</span>
- </dt>
- <dd>
- <span class="reference-text">always enclose text in element with <p></span>
- </dd>
- <dt>
- <span class="reference-text">-o ~{target}</span>
- </dt>
- <dd>
- <span class="reference-text">target file</span>
- </dd>
- <dt>
- <span class="reference-text">~{source}</span>
- </dt>
- <dd>
- <span class="reference-text">source file</span>
- </dd>
- </dl>
- </li>
- </ol>
- </div>
- </div>
-
- </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(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" 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'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>
|