source: general/genutils/tidy.xml@ 0124b3a

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY tidy-download-http "http://tidy.sourceforge.net/src/tidy_src_&tidy-version;.tgz">
  <!ENTITY tidy-download-ftp  " ">
  <!ENTITY tidy-md5sum        "8baf0d61bcaf7f488c7fde0b26268509">
  <!ENTITY tidy-size          "254 KB">
  <!ENTITY tidy-buildsize     "10.1 MB">
  <!ENTITY tidy-time          "0.2 SBU">

  <!ENTITY tidy-docs-version  "050502">
  <!ENTITY tidy-docs-download "http://tidy.sourceforge.net/docs/tidy_docs_&tidy-docs-version;.tgz">
  <!ENTITY tidy-docs-md5sum   "54488c25347b9fee5c544a13ab5324ee">
  <!ENTITY tidy-docs-size     "150 KB">
]>

<sect1 id="html-tidy" xreflabel="HTML Tidy-&tidy-version;">
  <?dbhtml filename="tidy.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>HTML Tidy-&tidy-version;</title>

  <indexterm zone="html-tidy">
    <primary sortas="a-HTML-Tidy">HTML Tidy</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to HTML Tidy</title>

    <para>The <application>HTML Tidy</application> package contains a 
    command line tool and libraries used to read HTML, XHTML and XML 
    files and write cleaned up markup. It detects and corrects many common coding 
    errors and strives to produce visually equivalent markup that is both 
    W3C compliant and compatible with most browsers.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&tidy-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&tidy-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &tidy-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &tidy-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &tidy-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &tidy-time;</para>
      </listitem>
    </itemizedlist>

    <note>
      <para><application>HTML Tidy</application> is 
      updated very frequently by its maintainers, and the source package listed 
      above may not be available at the listed URL due to the 
      release of a newer version. The most current source package can be always be 
      downloaded from <ulink url="http://tidy.sourceforge.net/src/"/>. If this 
      version is newer than the version listed above, the following instructions 
      should work, but have not yet been tested by BLFS. If you'd rather download 
      the version listed above, you can find it at 
      <ulink url="http://tidy.sourceforge.net/src/old/"/>.</para>
    </note>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>

    <bridgehead renderas="sect4">Documentation</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
       <para>Documentation: <ulink url="&tidy-docs-download;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &tidy-docs-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &tidy-docs-size;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect4">Patches</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Required patch: <ulink 
        url="&patch-root;/tidy-&tidy-version;-prevent_PRE_newlines-1.patch"/></para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">HTML Tidy Dependencies</bridgehead>

    <bridgehead renderas="sect4">Recommended (To Build the Man Page and Quick 
    Reference Docs)</bridgehead>
    <para><xref linkend="libxslt"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para><ulink url="http://dmalloc.com/">Dmalloc</ulink></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of HTML Tidy</title>

    <para>The <application>HTML Tidy</application> documentation 
    is contained in a separate tarball. Unpack both the source and docs tarballs
    before starting the build.</para>

    <para>Install <application>HTML Tidy</application> by 
    running the following commands:</para>

<screen><userinput>patch -Np1 -i ../tidy-&tidy-version;-prevent_PRE_newlines-1.patch &amp;&amp;
sh build/gnuauto/setup.sh &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

    <para>If you have the dependencies shown above to build the man page and
    HTML documentation, issue the following commands as an unprivileged 
    user:</para>

<screen><userinput>cd htmldoc &amp;&amp;
tidy -xml-help >tidy-help.xml &amp;&amp;
tidy -xml-config >tidy-config.xml &amp;&amp;
xsltproc --xinclude --nonet --stringparam base.dir . \
    tidy1.xsl tidy-help.xml >tidy.1 &amp;&amp;
xsltproc --xinclude --nonet --stringparam base.dir . \
    quickref-html.xsl tidy-config.xml >quickref.html &amp;&amp;
cd ..</userinput></screen>

    <para>If you built the man page and the Quick Reference HTML file, install 
    the man page by issuing the following command as the 
    <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>install -v -m644 htmldoc/tidy.1 /usr/share/man/man1</userinput></screen>

    <para>Now finish the installation by installing the pre-built 
    documentation as the <systemitem class="username">root</systemitem> 
    user:</para>

<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/tidy &amp;&amp;
cp -v -R htmldoc/* /usr/share/doc/tidy</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sh build/gnuauto/setup.sh</command>: This command prepares 
    the source tree for building using the GNU <quote>Auto</quote> tools.</para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring HTML Tidy</title>

    <sect3>
      <title>Config Files</title>

      <para>The absolute path of the file specified in 
      <envar>$HTML_TIDY</envar>.</para>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para>The default configuration options can be set in the file defined in 
      <envar>$HTML_TIDY</envar>. Additional configuration options can be passed to 
      <command>tidy</command> via command line parameters or the 
      <option>-config &lt;file&gt;</option> parameter.</para>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
    <segtitle>Installed Programs</segtitle>
    <segtitle>Installed Library</segtitle>
    <segtitle>Installed Directory</segtitle>
    <seglistitem>
    <seg>tab2space and tidy</seg>
    <seg>libtidy.[so,a]</seg>
    <seg>/usr/share/doc/tidy</seg>
    </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="tab2space">
        <term><command>tab2space</command></term>
        <listitem>
          <para>is a utility to expand tabs and ensure consistent line 
          endings.</para>
          <indexterm zone="html-tidy tab2space">
            <primary sortas="b-tab2space">tab2space</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tidy">
        <term><command>tidy</command></term>
        <listitem>
          <para>validates, corrects, and pretty-prints HTML files.</para>
          <indexterm zone="html-tidy tidy">
            <primary sortas="b-tidy">tidy</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libtidy">
        <term><filename class='libraryfile'>libtidy.[so,a]</filename></term>
        <listitem>
          <para>libraries provide the <application>HTML Tidy</application> API 
          functions to <command>tidy</command> and can also be called by other 
          programs.</para>
          <indexterm zone="html-tidy libtidy">
            <primary sortas="c-libtidy">libtidy.[so,a]</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>