This file is indexed.

/usr/share/doc/docbook-website/examples/website.xml is in docbook-website 2.5.0.0-8.

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
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<!DOCTYPE webpage SYSTEM "../schema/dtd/website.dtd" [
<!NOTATION XML SYSTEM "xml">
<!ENTITY test1a SYSTEM "test1a.xml" NDATA XML>
<!ENTITY test3 SYSTEM "test3.xml" NDATA XML>
<!ENTITY about.xml SYSTEM "about.xml" NDATA XML>
]>
<webpage id="home">
<config param="desc" value="The Test Home Page"/>
<config param="rcsdate" value="$Date: 2003/01/16 15:05:46 $"/>
<config param="footer" value="about.html" altval="About..."/>
<head>
<title>Welcome to Website</title>
<summary>Introduction</summary>
<keywords>Norman Walsh, DSSSL, SGML, XML, DocBook, Website</keywords>
</head>

<para> This small, somewhat contrived website demonstrates the
Website document type. Website provides a system for building static
Websites from XML content.</para>

<para>A <ulink url="txtindex.html">text-only</ulink> version is also
available, demonstrating how multiple presentations can be derived from
the same sources.</para>

<webtoc/>

<section><title>What is a Website?</title>

<para>A website is a collection of pages organized, for the purposes of
navigation, into one or more hierarchies. In Website, each page is a
separate XML document authored according to the Website DTD, a customization
of <ulink url="http://www.oasis-open.org/docbook/">DocBook</ulink>.</para>

<para>Website imposes the following additional constraints:</para>

<itemizedlist>
<listitem><para>Each <sgmltag>webpage</sgmltag> must have an ID and
the IDs must be unique across the entire website.</para>
</listitem>
<listitem><para>No page can occur in more than one location in the
navigational hierarchy of the website. Note, however, that you can have
pages, such as the <olink targetdocent="about.xml">about page</olink>,
that don't appear in the navigational hierarchy at all.</para>
</listitem>
</itemizedlist>
</section>

<section><title>Requirements</title>

<para>In order to build a website with Website, you must have:</para>

<itemizedlist>
<listitem><para>The
<ulink url="http://www.oasis-open.org/docbook/xml/4.1.2/">DocBook XML
V4.1.2</ulink> DTD.
</para></listitem>
<listitem><para>An XSLT processor.
</para></listitem>
<listitem><para>The <ulink url="http://nwalsh.com/docbook/xsl/">DocBook
XSL Stylesheets</ulink>.</para>
</listitem>
<listitem><para>The Website DTD and stylesheets.
</para></listitem>
</itemizedlist>

</section>

<section><title>Changes from Website 1.x</title>

<para>I've completely redesigned the way the Website doctype works for
V2. In version 1, all of the pages in a website were part of a single,
monolithic XML document.</para>

<para>Making all of the pages part of a single document had a number
of drawbacks:</para>

<orderedlist>
<listitem><para>It wasn't convenient to update only part of a website
(only the pages that had been changed, for example).
</para></listitem>
<listitem><para>For very large websites, there were memory issues associated
with parsing and formatting the whole thing.
</para></listitem>
<listitem><para>There was no practical way to publish the XML content of
a site.
</para></listitem>
<listitem><para>It was difficult to share pages across different web sites.
</para></listitem>
<listitem><para>It was very tedious to setup a system that allowed
the same content to be published
with different navigational hierarchies.
</para></listitem>
</orderedlist>

<para>Website overcomes all of these difficulties.</para>

<para>In fairness, the old style had some advantages:</para>

<orderedlist>
<listitem><para>There was only a single source document to maintain.
</para></listitem>
<listitem><para>Navigation was derived automatically from the structure
of the source document.
</para></listitem>
<listitem><para>Link checking was cheap and easy.
</para></listitem>
</orderedlist>
</section>

<section id="whatsnew">
<title>What's New</title>
<variablelist>
<varlistentry><term>20 Mar 2001</term>
<listitem>
<para>Reworked using the Website paradigm.</para>
</listitem>
</varlistentry>
</variablelist>
</section>

</webpage>

<!--
Local variables:
mode: docbook
End:
-->