This file is indexed.

/usr/share/doc/lire/dev-manual/ch20.html is in lire-devel-doc 2:2.1.1-2.1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 20. Website Maintenance</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Lire Developer's Manual"><link rel="up" href="pt04.html" title="Part IV. Lire Developers' Conventions"><link rel="prev" href="ch19s08.html" title="Advertising The Release"><link rel="next" href="ch21.html" title="Chapter 21. Writing Documentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 20. Website Maintenance</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch19s08.html">Prev</a> </td><th width="60%" align="center">Part IV. <span class="application">Lire</span> Developers' Conventions</th><td width="20%" align="right"> <a accesskey="n" href="ch21.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 20. Website Maintenance"><div class="titlepage"><div><div><h2 class="title"><a name="chap:web-maintenance"></a>Chapter 20. Website Maintenance</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch20.html#id419334">Documentation on the LogReport Website</a></span></dt><dd><dl><dt><span class="section"><a href="ch20.html#id419370">Publishing the DTD's</a></span></dt></dl></dd></dl></div><p>We give hints on how to upgrade the website: installing stuff from
      current CVS on <a class="ulink" href="http://logreport.org/" target="_top">http://logreport.org</a>.</p><p>Commits to the CVS tree of the website are automatically propagated
      to hibou. For more information on the markup language of the website, see
      <a class="ulink" href="http://logreport.org/doc/wjml/" target="_top">the WJML
      documentation</a>.</p><div class="section" title="Documentation on the LogReport Website"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id419334"></a>Documentation on the LogReport Website</h2></div></div></div><p>Be sure the links to stuff under 
          <code class="filename">/pub/current</code> are still
          alive. E.g. the files <code class="filename">TODO</code>, 
          <code class="filename">dev-manual.html</code> and 
          <code class="filename">user-manual.html</code> are linked to.
        </p><div class="section" title="Publishing the DTD's"><div class="titlepage"><div><div><h3 class="title"><a name="id419370"></a>Publishing the DTD's</h3></div></div></div><p>
            The DTD's are published as HTML on the website by using
            <code class="filename">hibou:/usr/local/src/dtdparse/dtdparse-2.0b2-LogReportPatched.tar.gz</code>,
            which is a patched version of Norman Walsh's dtdparse utility.
            Before the utility is run, make sure that the DocBook DTD is not 
            included in the parsing process, because the DocBook DTD should 
            not be published.
            This is done by changing the line:
            </p><pre class="programlisting">
&lt;!ENTITY % load.docbookx     "INCLUDE"                               &gt;
</pre><p>
            into:
            </p><pre class="programlisting">
&lt;!ENTITY % load.docbookx     "IGNORE"                               &gt;
</pre><p>
          </p><p>
            The webpages are then generated with:
            </p><pre class="programlisting">
perl ~/dtdparse-2.0b2-patched/dtdparse.pl --title "XML Lire Report Markup Language" --output lire.xml lire.dtd
perl ~/dtdparse-2.0b2-patched/dtdformat.pl --html lire.xml
            </pre><p>
            The resulting <code class="filename">lire</code> 
            directory can
            be tar-ed, gziped and unpacked again on hibou in the directory
            <code class="filename">/var/www/logreport.org/pub/docs/dtd/</code>.
          </p><p>
              The other two DTD's are HTML-ized similarly, but remember
              to change the title when running <span class="command"><strong>dtdparse.pl</strong></span>.
          </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch19s08.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt04.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch21.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Advertising The Release </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 21. Writing Documentation</td></tr></table></div></body></html>