1 This file describes how to use the scripts included in this archive.
2 Yes, it desperately needs updating and expansion.
4 corrtohtml.pl: translates the standard Project Aon correction report
5 format into HTML corresponding to the changes log used with the
8 corrtohtml.pl [correctionFile1 [correctionFile2 . . .]]
10 create-css.pl: used by gbtoxhtml.pl to create a CSS file for use by
13 [not used from the command line]
15 create-css-xhtml-single.pl: used by gbtoxhtml-single.pl to create a
16 CSS file for use by the single file version of the XHTML.
18 [not used from the command line]
20 create-pdacss.pl: used by gbtopdaxhtml.pl to create a CSS file for
21 use by the PDA version of the XHTML.
23 [not used from the command line]
25 frontfilter.pl: filters frontmatter files for links and common
28 frontfilter.pl frontmatterFile1 [frontmatterFile2 . . .]
30 gbfixencoding.pl: interactively fix encoding errors in gamebook XML
31 (requires ANSI escape sequences - tested on CYGWIN)
33 gbfixencoding.pl inputXML outputXML
35 gbfixquotes.pl: interactively encode quotation marks
36 (requires ANSI escape sequences - tested on CYGWIN)
38 gbfixquotes.pl inputXML outputXML
40 gblint.pl: find common errors in gamebook XML - does not validate XML
42 gblint.pl inputXML > errorList
43 -s LINES skip first LINES
46 gbtodot.pl: converts an XML file to DOT graph representation of the
49 gbtodot.pl inputXML outputDOT baseURL
51 gbtolatex.pl: creates a LaTeX file for conversion to PDF using
56 gbtopdaxhtml.pl: creates simplified XHTML for use by PDA utilities.
58 gbtopdaxhtml.pl bookCode
60 gbtopml.pl: creates PML version of the XML.
64 gbtoxhtml.pl: processes an XML file into XHTML.
68 gbtoxhtml-all.pl: creates all of the books in XHTML. Uses
73 gbtoxhtml-single.pl: creates a single XHTML file.
75 gbtoxhtml-single.pl bookCode
77 mergecorrhtml.pl: merges correction log HTML into a preexisting file.
79 mergecorrhtml.pl [options] inputHTML [correctionFiles]
81 -u include corrections with unspecified title
83 sortcorrhtml.pl: sorts correction log HTML into book order.
85 sortcorrhtml.pl [correctionFiles]
87 xmlize.pl: converts the proofread text format into a gamebook XML file.
89 xmlize.pl numberOfSections