X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=README.md;h=eadb3a6e19b8b1bc6b0fd2a62914f7233aabb2a7;hp=f2c7b151101483914c339c12764b9ce3ba0f8bf8;hb=HEAD;hpb=875432824cf8768a740afbbb8b3be8619ac176e4 diff --git a/README.md b/README.md index f2c7b15..eadb3a6 100644 --- a/README.md +++ b/README.md @@ -53,44 +53,19 @@ guide from a command prompt, like this: make html -For building the PDF version, you need a reasonably recent installation of -TeX Live. Release 2014 will do. You will also need the Emerald font -package from https://www.ctan.org/tex-archive/fonts/emerald/. This cannot -be installed with `tlmgr`, nor does it seem to be packaged by the usual -Linux or BSD distributions. Scripts for installing and uninstalling -Emerald are provided in the `tools` directory. When you're ready, type +For building the PDF version, you need a reasonably recent installation +of TeX Live. Release 2014 will do. You will also need the iftex +package, which may or may not be automatically installed. For Debian +and Debian-derived systems, the "texlive-generic-extra" package will +take care of this. + +You will also need the Emerald font package from +https://www.ctan.org/tex-archive/fonts/emerald/. This cannot be +installed with `tlmgr`, nor does it seem to be packaged by the usual +Linux or BSD distributions. Scripts for installing and uninstalling +Emerald are provided in the `tools` directory. When you're ready, type this: make latexpdf Other formats are available; just type `make` for more details. - -Conversion strategy -------------------- - -The first three editions of the IBG were created with -[Adobe FrameMaker](http://www.adobe.com/products/framemaker.html). And the -FrameMaker source files have kindly been supplied by Roger Firth to make -this update, which opened up the possibility of creating an auto-converter. - -But unfortunately, what with FrameMaker being proprietary, there isn't much -out there apart from FrameMaker itself that can read them. I was hoping -that conversion using [Mif2Go](http://mif2go.com) might be a possibility, -but it turns out that that's just a plugin for FrameMaker. I guess I could -get a trial FrameMaker license, try to set up the plugin and get it to -autoconvert to some usable format, but it all looks far too messy. But on -the plus side, the supplied GIF images are totally usable. - -So, it's back to my original plan: use the PDF file. Here's the first -(major) part of the work: - -* Dump the text out of the PDF file -* Convert all the 3rd edition text to Sphinx format -* Get the online version to look good - -After that comes the 4th edition changes, hopefully in collaboration with -others. Also, in parallel with that, other niceties: - -* Add a glossary -* Add an index -* Prepare a new PDF version, via the Sphinx LaTeX converter