2002-01-04 18:28:17 +00:00
|
|
|
Current requirements for building the docs :
|
|
|
|
|
--------------------------------------------
|
|
|
|
|
|
|
|
|
|
libxslt >= 1.0.6
|
|
|
|
|
libxml2 >= 2.4.12
|
|
|
|
|
|
2002-01-14 14:04:14 +00:00
|
|
|
|
2002-01-04 18:28:17 +00:00
|
|
|
These are not included with RH72. They are in debian. GDE has good rpms.
|
|
|
|
|
|
2002-01-14 14:04:14 +00:00
|
|
|
To build pdf's from xslt stuff, you need xmltex and (on redhat)
|
|
|
|
|
passivetex. They are not known to have been built on either redhat or
|
|
|
|
|
debian yet though.
|
|
|
|
|
|
2002-01-04 18:28:17 +00:00
|
|
|
Wingo's new comments on the doc building :
|
|
|
|
|
------------------------------------------
|
|
|
|
|
* Well he should add them soon here since he overhauled it. And did a good
|
|
|
|
|
job on it too ;)
|
|
|
|
|
|
2001-12-13 16:19:28 +00:00
|
|
|
Thomas's new comments on the doc building :
|
|
|
|
|
-------------------------------------------
|
|
|
|
|
* originally the manual was written with DocBook 3.0 in mind, which
|
|
|
|
|
supported the graphic tag. That is now deprecated, so I changed it to
|
|
|
|
|
the new mediaobject tag set.
|
|
|
|
|
|
|
|
|
|
* eps files in images/ should be generated from the makefile. You need to
|
|
|
|
|
have fig2dev installed for that.
|
|
|
|
|
|
2006-02-01 22:43:17 +00:00
|
|
|
Ensonic's comments on the doc build system :
|
|
|
|
|
--------------------------------------------
|
2006-03-10 19:03:13 +00:00
|
|
|
In case you like to share files between the manual and the pwg - it's
|
|
|
|
|
not trivial.
|
2006-02-01 22:43:17 +00:00
|
|
|
Before anything is done, the build-system copies all xml files into the build
|
|
|
|
|
subdir and this breaks including shared docs via entities.
|
2001-12-13 16:19:28 +00:00
|
|
|
|
|
|
|
|
Wtay's original comments :
|
|
|
|
|
--------------------------
|
|
|
|
|
|
2000-08-16 21:38:57 +00:00
|
|
|
For now use:
|
|
|
|
|
|
|
|
|
|
db2html gstreamer-manual
|
|
|
|
|
|
2000-10-12 08:43:03 +00:00
|
|
|
(On debian, db2html is in the cygnus-stylesheets package)
|
|
|
|
|
|
2000-08-16 21:38:57 +00:00
|
|
|
You will need the png support for docbook (see GNOME documentation project)
|
|
|
|
|
|
|
|
|
|
convert the fig images to png with:
|
|
|
|
|
|
|
|
|
|
fig2dev -L png -s 16 fig/<input file>.fig images/<input file>.png
|
|
|
|
|
|
|
|
|
|
Put a link in the gstreamer-manual directory with
|
|
|
|
|
|
|
|
|
|
ln -s ../images gstreamer-manual/images
|
|
|
|
|
|
|
|
|
|
point your browser to gstreamer-manual/gstreamer.html
|
|
|
|
|
|
|
|
|
|
Fix typing errors and correct bad english.
|
|
|
|
|
Let me know about the stuff that needs some more explanation.
|
|
|
|
|
Let me know about the structure of the document.
|
