Initialisation file syntax

The initialisation file contains further detailed options for customising Tex2RTF's behaviour. A file may be specified with the -macros command line switch, otherwise Tex2RTF looks for the file tex2rtf.ini in the working directory or input file directory.

The file may comprise macro (command) definitions or option settings.

The syntax for a macro definition is:

    \name [number of args] {...LaTeX code...}

For example:

    \crazy      [2]{{\bf #2} is crazy but #1 is not}
\something  [0]{}
\julian     [0]{Julian Smart}

The syntax for an option setting is:

    name = value

or

    name = "value"

For example:

    conversionMode = RTF
runTwice = true
titleFontSize = 12
authorFontSize = 10
footerRule = yes

Options expecting boolean values accept 1, 0, true, false, yes, no in any combination of upper or lower case.

End-of-line comments are allowed in an initialisation file, using the hash, semicolon or percent signs to denote the start of a comment, which runs until the end of the line.

Tex2RTF options

These are the allowable options in an initialisation file.

General options

 compatibility Set to true for maximum LaTeX compatibility, e.g. if tables crash RTF readers. Should be false (default) if the Tex2RTF guidelines are followed, e.g. use of \row command in tabular environment. conversionMode One of RTF, WinHelp, XLP (or wxHelp), and HTML. ignoreInput Adds the filename to the list of files ignored by the \input command. The only default filename in the list is psbox.tex. isInteractive If true, runs in interactive mode (the default). runTwice If true, runs the converter twice. ignoreBadRefs If true (or yes), ignores bad helpref references and simply writes the text in the first argument. Useful when a program such as HelpGen generates references to classes documented in another manual.

Presentation options

 authorFontSize Specifies the point size for the author and date (RTF only). chapterFontSize Specifies the point size for chapter headings (RTF only). documentFontSize One of 10, 11 and 12, to specify the main font size independently of the LaTeX document style command. sectionFontSize Specifies the point size for section headings (RTF only). subsectionFontSize Specifies the point size for subsection headings (RTF only). titleFontSize Specifies the point size for the title (RTF only). chapterName The string used when referencing chapters. The default is "chapter". sectionName The string used when referencing sections. The default is "section". subsectionName The string used when referencing subsections. The default is "subsection". subsubsectionName The string used when referencing subsubsections. The default is "subsubsection". indexName The string used for printing the index heading. The default is "Index". contentsName The string used for printing the contents heading. The default is "Contents". abstractName The string used for printing the abstract heading. The default is "Abstract". tablesName The string used for printing the list of tables heading. The default is "List of Tables". tableName The string used when referencing a table. The default is "table". figuresName The string used for printing the list of figures heading. The default is "List of Figures". figureName The string used when referencing a figure. The default is "figure". glossaryName The string used for printing the glossary heading. The default is "Glossary". referencesName The string used for printing the references heading. The default is "References".