continue process of cleaning up build instructions
This commit is contained in:
Geoff McLane
parent
f6f807be1a
commit
c08894195e
143
README.html
143
README.html
|
|
@ -1,44 +1,125 @@
|
||||||
<!doctype html>
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
<head>
|
<head>
|
||||||
<meta charset=utf8>
|
<meta charset="utf8">
|
||||||
<title>About tidy-html5</title>
|
<title>
|
||||||
|
About tidy-html5
|
||||||
|
</title>
|
||||||
|
<meta name="author"
|
||||||
|
content="geoff mclane">
|
||||||
<style>
|
<style>
|
||||||
|
body { margin: 1cm 1cm 1cm 1cm; }
|
||||||
li span.note { display: block; }
|
li span.note { display: block; }
|
||||||
</style>
|
</style>
|
||||||
</head>
|
</head>
|
||||||
|
<body>
|
||||||
|
<h1>
|
||||||
|
HTML Tidy for HTML5
|
||||||
|
</h1>
|
||||||
|
|
||||||
<h1>HTML Tidy for HTML5 (experimental)</h1>
|
<p>
|
||||||
<p>This repo is an experimental fork of the code from
|
This repo is an experimental fork of the code from <a href="http://tidy.sourceforge.net"
|
||||||
<a href="http://tidy.sourceforge.net">tidy.sourceforge.net</a>.
|
target="_blank">tidy.sourceforge.net</a>. This source code in this version supports
|
||||||
This source code in this version supports processing of HTML5 documents.
|
processing of HTML5 documents.
|
||||||
The changes for HTML5 support started from a
|
</p>
|
||||||
<a href="http://lists.w3.org/Archives/Public/www-archive/2011Nov/0007.html">patch developed by Björn Höhrmann</a>.</p>
|
|
||||||
|
|
||||||
<p>For more information, see
|
<p>
|
||||||
<a href="http://w3c.github.com/tidy-html5/">w3c.github.com/tidy-html5</a>
|
The changes for HTML5 support started from a <a href=
|
||||||
|
"http://lists.w3.org/Archives/Public/www-archive/2011Nov/0007.html"
|
||||||
|
target="_blank">patch developed by Björn Höhrmann</a>. A copy of this patch is also
|
||||||
|
maintained on this site, but naturally a LOT more has been changed in this fork.
|
||||||
|
</p>
|
||||||
|
|
||||||
<h2>Building the tidy command-line tool</h2>
|
<p>
|
||||||
<p>For Linux/BSD/OSX platforms, you can build and install the
|
For more information, also see <a href="http://w3c.github.com/tidy-html5/"
|
||||||
<code>tidy</code> command-line tool from the source code using the
|
target="_blank">w3c.github.com/tidy-html5</a>
|
||||||
following steps.</p>
|
</p>
|
||||||
|
|
||||||
<ol>
|
<h2>
|
||||||
<li><code>make -C build/gmake/</code></li>
|
Building tidy with cmake
|
||||||
<li><code>make install -C build/gmake/</code></li>
|
</h2>
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>Note that you will either need to run <code>make install</code> as root,
|
<p>
|
||||||
or with <code>sudo make install</code>.</p>
|
For all platforms, you can build and install the <code>tidy</code> command-line tool from the
|
||||||
|
source code using the following steps.
|
||||||
|
</p>
|
||||||
|
|
||||||
<h2>Building the libtidy shared library</h2>
|
<ul>
|
||||||
<p>For Linux/BSD/OSX platforms, you can build and install the
|
<li>
|
||||||
<code>tidylib</code> shared library (for use in building other
|
<code>cd build/cmake</code>
|
||||||
applications) from the source code using the following steps.</p>
|
</li>
|
||||||
|
|
||||||
<ol>
|
<li>
|
||||||
<li>sh build/gnuauto/setup.sh && ./configure && make</li>
|
<strong>Configuration and Generation</strong>
|
||||||
<li>make install</li>
|
</li>
|
||||||
</ol>
|
|
||||||
|
|
||||||
<p>Note that you will either need to run <code>make install</code> as root,
|
<li>
|
||||||
or with <code>sudo make install</code>.</p>
|
<code>cmake ../.. [-G "generator of choice"] [-DCMAKE_INSTALL_PREFIX=/install/path]</code>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>
|
||||||
|
<strong>Building - Compile and Link</strong>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Unix: <code>make</code>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Windows: <code>cmake --build . --config Release</code>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>
|
||||||
|
<strong>Install</strong>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Unix: <code>[sudo] make install</code>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Windows: <code>cmake --build . --config Release --target INSTALL</code>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Alternatively the CMake GUI can be used. CMake options can be read from their <a href=
|
||||||
|
"http://www.cmake.org/"
|
||||||
|
target="_blank">site</a>, and/or running # cmake --help to get help, and view the
|
||||||
|
'generators' supported on your platform.
|
||||||
|
<br>
|
||||||
|
The build/cmake folder contains sample windows (batch) and unix (sh) scripts which can be
|
||||||
|
adjusted to suit your choices.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
This document has been tidied using tidy5.exe, using a configuration file, tidy5.cfg containing
|
||||||
|
-
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
tidy-mark: no
|
||||||
|
indent: yes
|
||||||
|
break-before-br: yes
|
||||||
|
indent-attributes: yes
|
||||||
|
vertical-space: yes
|
||||||
|
indent-spaces: 1
|
||||||
|
indent-cdata: no
|
||||||
|
wrap-asp: no
|
||||||
|
wrap-attributes: no
|
||||||
|
wrap-jste: no
|
||||||
|
wrap-php: no
|
||||||
|
wrap-script-literals: no
|
||||||
|
wrap-sections: no
|
||||||
|
tab-size: 4
|
||||||
|
show-info: no
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
Using the following command
|
||||||
|
<br>
|
||||||
|
tidy5 -o README5.html -config tidy5.cfg README.html
|
||||||
|
<br>
|
||||||
|
then after checking README.html is deleted, and README5.html renamed to README.html
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p align="right">
|
||||||
|
README.html 20141205
|
||||||
|
</p>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue