Added missing tags to OpenJade instructions; added FTP download location and added UnZip as a required dependency to DocBook XML DTD

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2504 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy 2004-07-27 18:53:51 +00:00
parent cb6de2e78e
commit f14e196d6c
3 changed files with 46 additions and 28 deletions

View File

@ -20,8 +20,10 @@ who wrote what.</para>
<listitem><para>July 27th, 2004 [randy]: Added FTP download location to
OpenSP; changed FTP download location and removed redundant sed command
in DocBook-DTD-3.1 instructions; added UnZip as an optional dependency and
changed sed commands to in-place edits on DocBook-DTD instructions.</para>
in DocBook-DTD-3.1 instructions; added UnZip as a required dependency and
changed sed commands to in-place edits in DocBook-DTD instructions; added
missing tags to OpenJade instructions; added FTP download location and
added UnZip as a required dependency to DocBook XML DTD.</para>
</listitem>
<listitem><para>July 27th, 2004 [randy]: Added pkgconfig as an optional

View File

@ -46,7 +46,8 @@ url="&openjade-download-ftp;"/></para></listitem>
<sect2>
<title>Installation of <application>OpenJade</application></title>
<para>Install <application>OpenJade</application> by running the following commands:</para>
<para>Install <application>OpenJade</application> by running the following
commands:</para>
<screen><userinput><command>./configure --prefix=/usr --enable-http --disable-static \
--enable-default-catalog=/etc/sgml/catalog \
@ -80,10 +81,11 @@ for <acronym>HTTP</acronym>.</para>
<para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This
switch sets the path to the centralized catalog.</para>
<para><option>--enable-default-search-path</option>: This switch
<para><parameter>--enable-default-search-path</parameter>: This switch
sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
<para><parameter>--datadir=/usr/share/sgml/openjade-&openjade-version;</parameter>: This switch puts data files in
<para><parameter>--datadir=/usr/share/sgml/openjade-&openjade-version;</parameter>:
This switch puts data files in
<filename>/usr/share/sgml/openjade-&openjade-version;</filename> instead of
<filename class="directory">/usr/share</filename>.</para>
@ -91,8 +93,8 @@ sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
ln -sf libogrove.so /usr/lib/libgrove.so
ln -sf libospgrove.so /usr/lib/libspgrove.so
ln -sf libostyle.so /usr/lib/libstyle.so</command></screen>
These commands create the Jade equivalents of OpenJade executables and
libraries.</para>
These commands create the <application>Jade</application> equivalents of
<application>OpenJade</application> executables and libraries.</para>
</sect2>
@ -104,6 +106,7 @@ libraries.</para>
<screen><userinput><command>echo "SYSTEM \"http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd\" \
\"/usr/share/xml/docbook/xml-dtd-&DocBook-version;/docbookx.dtd\"" &gt;&gt; \
/usr/share/sgml/openjade-&openjade-version;/catalog</command></userinput></screen>
<para>This configuration is only necessary if you intend to use
<application>OpenJade</application> to process the
<acronym>BLFS</acronym> <acronym>XML</acronym> files through
@ -117,15 +120,16 @@ libraries.</para>
<title>Contents</title>
<para>The <application>OpenJade</application> package contains
<command>openjade</command>.</para>
<command>openjade</command> and the <application>OpenJade</application>
libraries.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>openjade</title>
<para><command>openjade</command> is a <acronym>DSSSL</acronym> engine used for transformations.</para></sect3>
<para><command>openjade</command> is a <acronym>DSSSL</acronym> engine used for
transformations.</para></sect3>
</sect2>

View File

@ -4,7 +4,7 @@
%general-entities;
<!ENTITY DocBook-download-http "http://www.docbook.org/xml/4.3/docbook-xml-&DocBook-version;.zip">
<!ENTITY DocBook-download-ftp " ">
<!ENTITY DocBook-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/docbook-xml-&DocBook-version;.zip">
<!ENTITY DocBook-size "97 KB">
<!ENTITY DocBook-buildsize "482 KB">
<!ENTITY DocBook-time "0.01 SBU">
@ -15,12 +15,15 @@
<title>DocBook XML DTD-&DocBook-version;</title>
<sect2>
<title>Introduction to <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application></title>
<title>Introduction to <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
<para>The <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application>-&DocBook-version; package contains document type definitions for
verification of <acronym>XML</acronym> data files against the DocBook rule
set. These are useful for structuring books and software documentation
to a standard allowing you to utilize transformations already written for that standard.</para>
<para>The <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application>-&DocBook-version; package contains
document type definitions for verification of <acronym>XML</acronym> data
files against the DocBook rule set. These are useful for structuring books
and software documentation to a standard allowing you to utilize
transformations already written for that standard.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
@ -31,17 +34,22 @@ to a standard allowing you to utilize transformations already written for that s
<listitem><para>Estimated build time: &DocBook-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title><application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> &DocBook-version; dependencies</title>
<sect3><title><application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> &DocBook-version; dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="libxml2"/></para></sect4>
<para><xref linkend="libxml2"/> and <xref linkend="unzip"/></para></sect4>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application></title>
<title>Installation of <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
<para>Install <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> by running the following commands:</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../use-unzip.xml"/>
<para>Install <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> by running the following commands:</para>
<screen><userinput><command>install -d /usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
cp -af docbook.cat *.dtd ent/ *.mod /usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
@ -105,10 +113,12 @@ xmlcatalog --noout --add "delegateURI" \
</sect2>
<sect2>
<title>Configuring <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application></title>
<title>Configuring <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
<sect3><title>Config files</title>
<para><filename>/etc/xml/catalog</filename>, <filename>/etc/xml/docbook</filename></para>
<para><filename>/etc/xml/catalog</filename>,
<filename>/etc/xml/docbook</filename></para>
</sect3>
<sect3><title>Configuration Information</title>
@ -147,21 +157,23 @@ xmlcatalog --noout --add "rewriteURI" \
<sect2>
<title>Contents</title>
<para>The <application>DocBook <acronym>XML</acronym> <acronym>DTD</acronym></application> package contains <filename>DTD</filename> files,
<filename>MOD</filename> files and <filename>ENT</filename> files.</para>
<para>The <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> package contains <filename>DTD</filename>
files, <filename>MOD</filename> files and <filename>ENT</filename> files.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>DTD files</title>
<para><filename>DTD</filename> files contain a document type definition which defines the
element types and the attribute lists that can be used in the
<para><filename>DTD</filename> files contain a document type definition which
defines the element types and the attribute lists that can be used in the
corresponding <filename>XML</filename> files.</para></sect3>
<sect3><title>MOD files</title>
<para><filename>MOD</filename> files contain components of the document type definition that are
sourced into the <filename>DTD</filename> files.</para></sect3>
<para><filename>MOD</filename> files contain components of the document type
definition that are sourced into the <filename>DTD</filename> files.</para>
</sect3>
<sect3><title>ENT files</title>
<para><filename>ENT</filename> files contain lists of named character entities