CygwinPackages
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://membres.lycos.fr/thierrybo/cygwin
- 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:
- docbook-xml
- docbook-sgml (probably needed only for SGML)
- sgml-base (probably needed only for SGML)
- xml-base
- xml-char-ent
- openjade (includes onsgmls, for validating documents; probably needed only for SGML)
'''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:
- docbook-xsl
- libxml2
- libxslt
E.g: you can run this command on the command line (tested on AppVeyor-CI):
C:\cygwin64\setup-x86_64.exe -qgnNdO -l C:\cygwin64\var\cache\setup -R c:\cygwin64 -s http://cygwin.mirror.constant.com -P docbook-xml -P docbook-xsl -P libxml2 -P libxslt
For publishing DocBook SGML or XML documents using DSSSL, you'll also need to install the following:
- docbook-dsssl
Other useful packages:
- xhtml: XHTML DTDs
- tei-xml: the TEI DTD
- tei-xsl: XSLT stylesheets for TEI