From dc35c090b1bf089de566b54ae80a8529dc1ef82f Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Tue, 8 Jan 2002 12:52:22 +0000 Subject: [PATCH] added a DocBook section docbook.html Daniel * doc/site.xsl doc/*.html: added a DocBook section docbook.html Daniel --- ChangeLog | 4 ++ doc/API.html | 1 + doc/FAQ.html | 1 + doc/bugs.html | 1 + doc/contribs.html | 1 + doc/docbook.html | 110 ++++++++++++++++++++++++++++++++++++++++++++ doc/docs.html | 1 + doc/downloads.html | 1 + doc/extensions.html | 1 + doc/help.html | 1 + doc/index.html | 1 + doc/internals.html | 1 + doc/intro.html | 1 + doc/news.html | 1 + doc/site.xsl | 3 ++ doc/xslt.html | 46 ++++++++++++++++++ doc/xsltproc2.html | 1 + 17 files changed, 176 insertions(+) create mode 100644 doc/docbook.html diff --git a/ChangeLog b/ChangeLog index a5291d06..13d202c2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Tue Jan 8 13:51:08 CET 2002 Daniel Veillard + + * doc/site.xsl doc/*.html: added a DocBook section docbook.html + Tue Jan 8 12:51:15 CET 2002 Daniel Veillard * doc/*.html: updated gdome2 homepage diff --git a/doc/API.html b/doc/API.html index b5d19242..2dd24e37 100644 --- a/doc/API.html +++ b/doc/API.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/FAQ.html b/doc/FAQ.html index 1ee762eb..c5620ae6 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/bugs.html b/doc/bugs.html index fa236d19..a16e996b 100644 --- a/doc/bugs.html +++ b/doc/bugs.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/contribs.html b/doc/contribs.html index 4fdf87ea..86f4d538 100644 --- a/doc/contribs.html +++ b/doc/contribs.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/docbook.html b/doc/docbook.html new file mode 100644 index 00000000..e47fee71 --- /dev/null +++ b/doc/docbook.html @@ -0,0 +1,110 @@ + + + + + +DocBook + + + + + +
    +Gnome LogoRed Hat Logo +
    +

    The XSLT C library for Gnome

    +

    DocBook

    +
    +
    + + +
    + + + +
    Main Menu
    + + + +
    Related links
    +
    +

    +DocBook is an +XML/SGML vocabulary particularly well suited to books and papers about +computer hardware and software.

    +

    xsltproc and libxslt are not specifically dependant on DocBook, but since +a lot of people use xsltproc and libxml2 for DocBook formatting, here are a +few pointers and informations which may be helpful:

    + +

    Do not use the --docbook option of xsltproc to process XML DocBook +documents, this option is only intended to provide some (limited) support of +the SGML version of DocBook.

    +

    Points which are not DocBook specific but still worth mentionning +again:

    +
      +
    • if you think DocBook processing time is too slow, make sure you have + XML Catalogs pointing to a local installation of the DTD of DocBook. + Check the XML Catalog page + to understand more on this subject.
      • +
    • before processing a new document, use the command +

      xmllint --valid --noout path_to_document

      +

      to make sure that your input is valid DocBook. And fixes the errors + before processing further. Note that XSLT processing may work correctly + with some forms of validity errors left, but in general it can give + troubles on output.

      +
      • +
    +

    Daniel Veillard

    +
    + + diff --git a/doc/docs.html b/doc/docs.html index 5a2a5978..13ce4f85 100644 --- a/doc/docs.html +++ b/doc/docs.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/downloads.html b/doc/downloads.html index b2540327..1044b310 100644 --- a/doc/downloads.html +++ b/doc/downloads.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/extensions.html b/doc/extensions.html index d67e6974..0e5c4d0c 100644 --- a/doc/extensions.html +++ b/doc/extensions.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/help.html b/doc/help.html index 5ab1c1ed..fdfca330 100644 --- a/doc/help.html +++ b/doc/help.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/index.html b/doc/index.html index a1030c3c..4faf52b8 100644 --- a/doc/index.html +++ b/doc/index.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/internals.html b/doc/internals.html index 72e5ca30..46325129 100644 --- a/doc/internals.html +++ b/doc/internals.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/intro.html b/doc/intro.html index 0fd3433a..91863691 100644 --- a/doc/intro.html +++ b/doc/intro.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/news.html b/doc/news.html index eb301300..c4b395d4 100644 --- a/doc/news.html +++ b/doc/news.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions
    • diff --git a/doc/site.xsl b/doc/site.xsl index 453685a7..8d7dc437 100644 --- a/doc/site.xsl +++ b/doc/site.xsl @@ -43,6 +43,9 @@ internals.html + + docbook.html + FAQ.html diff --git a/doc/xslt.html b/doc/xslt.html index 38e17c57..981876cd 100644 --- a/doc/xslt.html +++ b/doc/xslt.html @@ -534,6 +534,52 @@ Usage: xsltproc [options] stylesheet file [file ...] --profile or --norman : dump profiling informations orchis:~ -> +

    DocBook

    + +

    DocBook is an +XML/SGML vocabulary particularly well suited to books and papers about +computer hardware and software.

    + +

    xsltproc and libxslt are not specifically dependant on DocBook, but since +a lot of people use xsltproc and libxml2 for DocBook formatting, here are a +few pointers and informations which may be helpful:

    + + +

    Do not use the --docbook option of xsltproc to process XML DocBook +documents, this option is only intended to provide some (limited) support of +the SGML version of DocBook.

    + +

    Points which are not DocBook specific but still worth mentionning +again:

    +
      +
    • if you think DocBook processing time is too slow, make sure you have + XML Catalogs pointing to a local installation of the DTD of DocBook. + Check the XML Catalog page + to understand more on this subject.
      • +
    • before processing a new document, use the command +

      xmllint --valid --noout path_to_document

      +

      to make sure that your input is valid DocBook. And fixes the errors + before processing further. Note that XSLT processing may work correctly + with some forms of validity errors left, but in general it can give + troubles on output.

      +
      • +
    +

    The programming API

    Okay this section is clearly incomplete. But integrating libxslt into your diff --git a/doc/xsltproc2.html b/doc/xsltproc2.html index c365cb6a..a1599b30 100644 --- a/doc/xsltproc2.html +++ b/doc/xsltproc2.html @@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }

  • FAQ
  • News
  • The xsltproc tool
    • +
  • DocBook
  • The programming API
  • Library internals
  • Writing extensions