Go to file
Geoff McLane a1da576946 Add some convenient bats to publish binaries 2015-06-04 18:01:29 +02:00
build Add some convenient bats to publish binaries 2015-06-04 18:01:29 +02:00
console add small 'sample' API use, optional build 2015-02-07 15:33:13 +01:00
documentation keep a recent gen'ed quickref.html in documentation 2015-06-02 17:15:05 +02:00
experimental new 2011-11-17 11:44:16 +09:00
include Small fix in platform.h, just for windows (WIN32) 2015-06-02 20:41:11 +02:00
src Issue #212 - Further fix to set MixedContent in some cases. 2015-06-04 13:12:05 +02:00
test add the new testinfo.txt file decription 2015-05-14 15:03:36 +02:00
.gitignore .gitignore cleanup 2015-02-14 13:55:39 +08:00
CMakeLists.txt Reverse option wording to reflect new default ON 2015-05-25 13:33:32 +02:00
LICENSE.md Changed license to markdown. 2015-02-13 10:35:14 +08:00
LICENSE.txt add txt and html, since md not supported by WiX (MSI) 2015-03-06 15:36:42 +01:00
README.html add txt and html, since md not supported by WiX (MSI) 2015-03-06 15:36:42 +01:00
README.md Fix README.md to show now both shared and static libraries are built 2015-05-25 13:24:50 +02:00
verhist.log Update verhist.log 2015-06-04 17:42:28 +02:00
version.txt Issue #212 - bump version for this additional change 2015-06-04 13:21:00 +02:00

README.md

HTML Tidy with HTML5 support

Prerequisites

  1. git - http://git-scm.com/book/en/v2/Getting-Started-Installing-Git

  2. cmake - http://www.cmake.org/download/

  3. appropriate build tools for the platform

CMake comes in two forms - command line and gui. Some installations only install one or the other, but sometimes both. The build commands below are only for the command line use.

Also the actual build tools vary for each platform. But that is one of the great features of cmake, it can generate variuous 'native' build files. Running cmake without any parameters will list the generators available on that platform. For sure one of the common ones is "Unix Makefiles", which needs autotools make installed, but many other generators are supported.

In windows cmake offers various versions of MSVC. Again below only the command line use of MSVC is shown, but the tidy solution (*.sln) file can be loaded into the MSVC IDE, and the building done in there.

Build the tidy library and command line tool

  1. cd build/cmake

  2. cmake ../.. [-DCMAKE_INSTALL_PREFIX=/path/for/install]

  3. Windows: cmake --build . --config Release
    Unix/OS X: make

  4. Install, if desired:
    Windows: cmake --build . --config Release --target INSTALL
    Unix/OS X: [sudo] make install

By default cmake sets the install path to /usr/local in unix. If you wanted the binary in say /usr/bin instead, then in 2. above use -DCMAKE_INSTALL_PREFIX=/usr

Also, in unix if you want to build the release library without any debug assert in the code then add -DCMAKE_BUILD_TYPE=Release in step 2. This adds a -DNDEBUG macro to the compile switches. This is normally added in windows build for the Release config.

In windows the default install is to C:\Program Files\tidy5, or C:/Program Files (x86)/tidy5, which is not very useful. After the build the tidy[n].exe is in the Release directory, and can be copied to any directory in your PATH environment variable, for global use.

If you do not need the tidy library built as a 'shared' (DLL) library, then in 2. add the command -DBUILD_SHARED_LIB:BOOL=OFF. This option is ON by default. The static library is always built and linked with the command line tool for convenience in windows, and so the binary can be run as part of the man page build without the shared library being installed in unix.

Prebuilt Binaries

An attempt is being made to publish pre-built binaries to http://www.htacg.org/binaries - This is still a work in progress, but getting there..

History

This repository should be considered canonical for HTML Tidy as of 2015-January-15.

; eof