Chapter 3. Required software

The method described in this document requires a well-configured Linux system, armed with a heavy machinery of various software packages:

• LyX (3) (of course!), see Section 3.1. You MUST use the 1.2.0 version of LyX, offered in Section 3.1! Newer versions will NOT work, unless you tweak the sed scripts of this package.

• DocBook (5) , see Section 3.2.

• sgmltools (4) , see Section 3.3 (currently not needed).

• Openjade, pdfjadetex and jadetex see Section 3.4.

• TeX and LaTeX (6) , see Section 3.5.

• sed, runsed and awk, see Section 3.8.

• thumbpdf, see Section 3.7.

• dvips, ghostscript and ImageMagik, see Section 3.6.

• Lynx, the text browser, see Section 3.9. Lynx will be used to convert the HTML output in plain text, thus giving us the TXT version of our document.

• HTMLtidy, see Section 3.10

• RefDB, if you want to use bibliographies with entries taken from a bibliography server and formatted automatically according to the author guidelines of the Journal you are submitting your paper, see Section 3.11.

• Perl, for the Index generation through the collateindex.pl script (see Section 7.1.11).

• coolthumbs, if you want antialiased thumbnails in PDF.

In the following, I will describe the required software in more detail. Of course, I cannot cover all details. See the documentation that comes with each tool and, for an alternative description, the Apendix (5) of DocBook: The definitive Guide.

Version-specific tweaks!

The method I will describe (more precisely, the sed script that corrects LyX' SGML output) is tailored to LyX 1.2.0-91, a rather dated version I use from a SuSE RPM. If you have a newer version of LyX, you will almost certainly have to tweak sedscr, since SGML output has been corrected in the newer 1.3.x versions. But the important thing is the method, not the version-specific tweaks, which you should be able to figure out yourself with a firm knowledge of sed, regular expressions and the help of this guide!

Currently, you should stick to the rather dated 1.2.0 version from one of the RPMs in Section 3.1, for reasons discussed in LyX 1.3.4 not suitable for Mathematics work in DocBook.

I have not investigated the portability of the method across operating systems. I have developed and tested it on a (rather dated) SuSE Linux 7.3 system and, more recently, on a SuSE Linux 9.0 system. Portability to other operating systems is dependent on the availability of the software needed and the scripting facilities offered. Any porting efforts are welcome.