mirror of
https://github.com/samba-team/samba.git
synced 2024-12-22 13:34:15 +03:00
0208d5f64b
We did not check we could actually build the HTML of the Samba Developers guide and HTML of the manpages previously. Signed-off-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: David Disseldorp <ddiss@samba.org> Autobuild-User(master): Andrew Bartlett <abartlet@samba.org> Autobuild-Date(master): Wed Jun 10 07:11:59 UTC 2020 on sn-devel-184
108 lines
3.0 KiB
Plaintext
108 lines
3.0 KiB
Plaintext
!==
|
|
!== docbook.txt for Samba 3.0
|
|
!==
|
|
!== Author: David Bannon, D.Bannon@latrobe.edu.au November, 2000
|
|
!== Updates: Gerald (Jerry) Carter, jerry@samba.org, Feb. 2001
|
|
!== Updates: Jelmer Vernooij, jelmer@samba.org, Aug, 2002
|
|
!== Updates: Jelmer Vernooij, jelmer@samba.org, Jun, 2003
|
|
!== Updates: Jelmer Vernooij, jelmer@samba.org, May, 2004
|
|
!== Updates: Jelmer Vernooij, jelmer@samba.org, May, 2005
|
|
|
|
Quick start
|
|
-----------
|
|
|
|
Run:
|
|
|
|
$ make all
|
|
|
|
or to see what is possible:
|
|
|
|
$ make help
|
|
|
|
What are DocBook documents doing in the Samba Distribution ?
|
|
-----------------------------------------------------------
|
|
|
|
We have converted all samba docs to XML/DocBook V4.2
|
|
in order to make them easier to maintain and produce a nicer looking
|
|
product.
|
|
|
|
This short note (strange isn't it how it always starts out as a short note
|
|
and becomes a long one ?) will explain very briefly how and why we have
|
|
done this.
|
|
|
|
|
|
The format
|
|
----------
|
|
|
|
If you are new to xml, regard an xml file as 'source code'. You don't
|
|
read it directly, but use it to create other formats (like the html
|
|
included in ../htmldocs).
|
|
|
|
Docbook is a particular XML style, particularly suited to producing
|
|
technical manuals.
|
|
|
|
For more information on DocBook tags and format, see "DocBook: The
|
|
Definitive Guide" by Walsh and Muellner, (c) O'Reilly Publishing.
|
|
This book covers DocBook V4.2 and is available on-line
|
|
at http://www.docbook.org/
|
|
|
|
The Output
|
|
----------
|
|
The current Samba Subversion tree contains the XML/DocBook source files.
|
|
|
|
A regularly generated version can be found at https://www.samba.org/samba/docs/.
|
|
|
|
The Tools
|
|
---------
|
|
|
|
To generate the docs, you need to have the following packages installed:
|
|
|
|
* GNU Make
|
|
* GNU autoconf
|
|
* xsltproc
|
|
|
|
For generating PDF and PostScript (thru LaTeX):
|
|
* dblatex (from http://dblatex.sf.net/)
|
|
|
|
For generating PDF (thru FO):
|
|
* fop (http://xml.apache.org/fop/)
|
|
|
|
For generating ASCII:
|
|
* html2text
|
|
|
|
For generating texi files:
|
|
* docbook2x-texi
|
|
* makeinfo
|
|
|
|
For validating:
|
|
* xmllint
|
|
|
|
This directory now contains a ./configure script and Makefile to
|
|
support the automated building of man pages (including HTML versions), and
|
|
the building of the Samba-HOWTO-Collection and the
|
|
Samba Developers Guide (HTML,TeX,PDF,PS,Text versions).
|
|
|
|
The configure script detects which of the required utilities are installed
|
|
and builds as much docs as it can using these tools.
|
|
|
|
Help! Building the docs generates a lot of HTTP traffic...
|
|
----------------------------------------------------------
|
|
|
|
To be able to build the docs without an internet connection (or faster with
|
|
a slow internet connection), you need to set up "catalogs".
|
|
|
|
For the Pearson DTD, add something like:
|
|
|
|
<public publicId="-//Pearson//DTD Books//DE" uri="file:///home/jelmer/Xml_dtd_1.1/pearson.dtd"/>
|
|
|
|
For the Samba DTD's, add something like:
|
|
<rewriteURI uriStartString="http://www.samba.org/samba/DTD" rewritePrefix="file:///home/jelmer/samba-web/DTD"/>
|
|
|
|
catalog entries for the other DTD's and XSL scripts should be present on your
|
|
system already.
|
|
|
|
Windows Help files
|
|
----------
|
|
|
|
http://htmlhelp.berlios.de/howto/mshh4wine.php
|