Skip to content

CygwinPackages

Shlomi Fish edited this page Oct 15, 2020 · 3 revisions

Cygwin's Logo

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):

'''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

Precompiled Libxml/xsltproc Windows version (these are not needed if you use the Cygwin versions)

Precompiled Windows version of libxml and xsltproc

Clone this wiki locally