SGML for Windows NT: Setting up a free SGML/XML editing and publishing system on Windows/Cygwin | ||
---|---|---|
Prev | Chapter 8. OpenJade and onsgmls | Next |
Extract the files
Change to the root directory / of your Cygwin installation. Extract the OpenJade/OpenSP tarball with the command:
/# tar -xzf /your/path/to/cygwin1.1.8-openjade1.3p-sp1.4.tar.gz |
This will install the binaries and accessory files in your /usr/local hierarchy.
Adjust PATH
On a fresh Cygwin installation, the OpenJade/OpenSP binaries should be in your path anyway. If you are in doubt, type type -a openjade in bash. If you get a "not found" error message, edit either /etc/profile, ~/.profile, or ~/.bashrc and include a line like:
export PATH=/usr/bin:/usr/local/bin:$PATH |
Create SGML_CATALOG_FILES
Create a SGML_CATALOG_FILES system environment variable. This variable tells the SP applications where to look for catalog files. These catalog files are used to resolve public identifiers to local filenames. In the Environment tab of the system dialog enter SGML_CATALOG_FILES as a new variable name in the upper pane. The value of this variable is a semicolon-separated list of catalog files. Now there is only one catalog to be included, which is provided by the Jade package. The current directory should be included as well (assuming that the catalog file is called catalog, which is often the case) as well as the SP catalog file. If you put the catalog file of the current directory on the first position of the list, you can easily override any system catalogs by simply providing a catalog file in your document's directory. You will later modify this variable, when you install the HTML and DocBook DTDs. Be aware that this variable is not a list of directories that contain catalog files, but rather a list of the paths of individual catalog files. Set the initial value of the environment variable e.g. as follows:
.\catalog;C:\cygwin\usr\local\lib\sgml\dtd\dsssl\catalog |
Individual users can add private catalog files by defining a user environment variable SGML_CATALOG_FILES which holds the full paths of these catalog files (don't forget to include "%SGML_CATALOG_FILES%" in the user's lists).
The SGML_CATALOG_FILES environment variable in the system settings is necessary to keep non-Cygwin applications happy. This includes PSGML in NTEmacs. But as we use the Cygwin versions of OpenJade and OpenSP, we'll have to provide the same paths in the Unix notation. To this end, insert the following code into your /etc/profile:
# set environment for SGML tools SGML_CATALOG_FILES=./catalog:/usr/local/lib/sgml/dtd/dsssl/catalog export SGML_CATALOG_FILES |