mpv/DOCS/xml
nicolas 56b270ce90 sync
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@10375 b3059339-0415-0410-9bf9-f77b7e298cf2
2003-07-05 09:45:08 +00:00
..
en sync with HTML 2003-07-05 09:42:35 +00:00
es Translation updates by Andoni Zubimendi <andoni@lpsat.net>. 2003-06-24 17:36:00 +00:00
fr sync 2003-07-05 09:45:08 +00:00
ru Set id="index" option 2003-06-30 19:30:36 +00:00
xsl
.cvsignore XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some 2003-06-18 17:37:36 +00:00
BUGS
Makefile XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some 2003-06-18 17:37:36 +00:00
Makefile.inc XML autoconfiguration by Dmitry Baryshkov <lumag@qnc.ru> with some 2003-06-18 17:37:36 +00:00
README Add support for the Saxon XSLT Processor. 2003-04-30 16:41:14 +00:00
README.maintainers typos 2003-04-21 00:06:41 +00:00
configure Set id="index" option 2003-06-30 19:30:36 +00:00
default.css
html-common.xsl Generate more links for Site navigation Bar. 2003-05-20 07:11:33 +00:00
ldp.dsl

README

Tools required for building the documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* DocBook 4.1.2 or later
* The DocBook XML DTD (also known as DocBk XML)
* DocBook XSL stylesheets -- version 1.50.0 or later is recommended.

I am not quite sure which tools work, but I used the following
ones successfully, so they are required:

* xmllint (part of libxml2) is used for validation.
* xsltproc (part of libxslt1) is used for transforming XML files into HTML
  files.  Version 1.0.18 or later is recommended.

Also it's possible to use the Saxon XSLT Processor. Russian translator
used it (version 6.4.4) for a while. To enable it change USE_SAXON to 1 in
the Makefile.


Building the documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~

1) Before trying to build the documentation, run

	make test

   to see if everything is set up properly.  If something goes wrong,
   check the Configuration section of the toplevel Makefile and adjust
   the variables.


2) Now simply run

	make all

   to build the documentation.


A few words about SGML catalog files
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

As far as I know, the document type declaration in XML files requires
both a public and a system identifier.  For example:

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
	"/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd">

where

	"-//OASIS//DTD DocBook XML V4.1.2//EN"

is the public, and

	"/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd"

is the system identifier.

The problem is that the system identifier is most probably system-dependent.
To avoid the need to manually fix the system identifiers before building the
documentation, I've decided to use SGML catalogs.  If you have your catalogs
set up correctly, xmllint and xsltproc will use them to find the DTDs
based on the public identifiers.

Note that this works only if public identifiers override system identifiers
(i.e. the catalog file must contain 'OVERRIDE YES').  (I had no problem with
these on my system, since the Debian people took care of everything. ;-))


--
Andras Mohari