Clone this wiki locally
To work with DocBook on Microsoft Windows, it's highly recommended that you first install the Cygwin environment, which enables you to use many standard UNIX utilities (including a lot of GNU software) and other useful applications and resources on Windows, and maintain it all in the form of easy-to-install-and-update packages (similar to RPMs and Debian packages).
Jon Foster and Markus Hoenicka have put together specific XML/SGML packages for Cygwin. Currently, to install the packages, you first need to enter:
Last known two mirrors (2004-01-06, Gerrit P. Haase):
- http://anfaenger.de/cygwin in the '''User URL''' part the '''Choose a Download Site''' dialog box that comes up when you run the Cygwin '''setup.exe''' application.
'''NOTE:''' The docbook-x packages at these sites are outdated, please update as soon as possible to more recent versions, get the sources at the sourceforge docbook site http://docbook.sf.net/.
To get a working DocBook XML/SGML authoring enviroment set up, at a minimum you need to install the following packages:
- openjade (includes onsgmls, for validating documents)
'''Note:''' ''You will probably also want to install Emacs and the PSGML editing mode for Emacs. These are not packaged for Cygwin, but Markus Hoenicka has written a great step-by-step tutorial on setting up an Emacs/PSGML-based XML/SGML authoring and publishing system on Microsoft Windows -- including a specific version of the tutorial written for Cygwin users. Use that tutorial in combination with the Cygwin packages to get a working DocBook setup.''
For publishing DocBook XML documents using XSLT, you'll also need to install the following:
For publishing DocBook SGML or XML documents using DSSSL, you'll also need to install the following:
Other useful packages:
- xhtml: XHTML DTDs
- tei-xml: the TEI DTD
- tei-xsl: XSLT stylesheets for TEI