NAME¶
yodlmacros - Macros for the Yodl converters
SYNOPSIS¶
This manual page lists the standard macros of the Yodl package.
DESCRIPTION¶
The following list shows the macros defined by the Yodl converters define and
which can be used in Yodl documents. Refer to the Yodl user guide, distributed
with the Yodl package, for a full description.
NOTE: Starting with Yodl version 3.00.0 Yodl’s default file
inclusion behavior has changed. The current working directory no longer
remains fixed at the directory in which Yodl is called, but is volatile,
changing to the directory in which a yodl-file is located. This has the
advantage that Yodl’s file inclusion behavior now matches the way
C’s #include directive operates; it has the disadvantage that it
may break some current documents. Conversion, however is simple but can be
avoided altogether if Yodl’s -L (--legacy-include) option is used. This
affects the (l)includefile, includeverbatim, notransinclude and verbinclude
macros (see below).
The following list shows all macros of the package in alphabetical order.
- abstract(text)
- Defines an abstract for an article or report document. Abstracts are not
implemented for books or manpages. Must appear before starting the
document with the article or report macro.
- addntosymbol(symbol)(n)(text)
- Adds text n times to symbol. The value n may also be the name of a defined
counter (which itself will not be modified).
- affiliation(site)
- Defines an affiliation, to appear in the document titlepage below the
author field. Must appear before starting the document with
article, report or book. The affiliation is only printed when the author
field is not empty.
- AfourEnlarged()
- Enlarges the usable height of A4 paper by 2 cm.: the top margin is reduced
by 2 cm. This macro should be called in the preamble. The macro is
available only for LaTeX conversions.
- appendix()
- Starts appendices
- article(title)(author)(date)
- Starts an article. The top-level sectioning command is (n)sect. In HTML
conversions only one output file is written.
- bf(text)
- Sets text in boldface.
- bind(text)
- Generate a binding character after text.
- book(title)(author)(date)
- Starts a book document. The top-level sectioning command is (n)chapter,
(n)part being optional. In HTML output files are created for each
chapter.
- cell(contents)
- Sets a table cell, i.e., one element in a row. With the man/ms converters
multiple blanks between cell() macro calls are merged into a single blank
character.
- cells(nColumns)(contents)
- Set a table cell over nColumns columns. In html, LaTeX and xml formats the
information in the combined cells will be centered. With man/ms
conversions the cells() macro simply calls the cell() macro, but here the
setmanalign() macro can be used to determine the alignment of multiple
cells.
- cellsline(from)(count)
- Sets a horizontal line starting at column number from over count columns
in a row. If from is less then the number of columns already added to a
row then it is ignored. This macro must be embedded in a row macro
defining a table row. To put a line across the table’s full width
use rowline. To set horizontal lines across columns 1 until 2 and columns
4 until 5 table of a table use:
row(cellsline(1)(2)cellsline(4)(2))
Combining cellsline and cell or cells calls in one row produces undefined
results.
- center(text)
- Sets text centered, when the output format permits. Use nl() in the text
to break lines.
- chapter(title)
- Starts a new chapter in books or reports.
- cindex()
- Generate an index entry for index c.
- cite(1)
- Sets a citation or quotation
- clearpage()
- Starts a new page, when the output format permits. Under HTML a horizontal
line is drawn.
- code(text)
- Sets text in code font, and prevents it from being expanded. For
unbalanced parameter lists, use CHAR(40) to get ( and CHAR(41) to get
).
- columnline(from)(to)
- Sets a horizontal line over some columns in a row. Note that columnline
defines a row by itself, consisting of just a horizontal line spanning
some of its columns, rather than the table’s full width, like
rowline. The two arguments represent column numbers. It is the
responsibility of the author to make sure that the from and to values are
sensible. I.e.,
1 <= from <= to <= ncolumns
Note: this macro cannot be used if multiple lines must be set in one
row. In those cases the macro colsline should be used.
- def(macroname)(nrofargs)(redefinition)
- Defines macroname as a macro, having nrofargs arguments, and expanding to
redefinition. This macro is a shorthand for DEFINEMACRO. An error occurs
when the macro is already defined. Use redef() to unconditionally define
or redefine a macro.
- description(list)
- Sets list as a description list. Use dit(item) to indicate items in the
list.
- dit(itemname)
- Starts an item named itemname in a descriptive list. The list is either
enclosed by startdit() and enddit(), or is an argument to
description().
- eit()
- Indicates an item in an enumerated list. The eit() macro should be an
argument in enumerate().
- ellipsis()
- Sets ellipsis (...).
- em(text)
- Sets text as emphasized, usually italics.
- email(address)
- In HTML, this macro sets the address in a <a
href="mailto=.."> locator. In other output formats, the
address is sent to the output. The email macro is a special case of
url.
- endcenter()
- DEPRECATED. Use center().
- enddit()
- DEPRECATED. Use description().
- endeit()
- DEPRECATED. Use enumeration().
- endit()
- DEPRECATED. Use itemization().
- endmenu()
- DEPRECATED. Use menu().
- endtable()
- DEPRECATED. Use table().
- enumerate(list)
- DEPRECATED. Use enumeration().
- enumeration(list)
- enumeration() starts an enumerated list. Use eit() in the list to indicate
items in the list.
- euro()
- Sets the euro currency symbol in latex, html, (and possibly sgml and xml).
In all other conversions EUR which is the official textual abbreviation
(cf. http://ec.europa.eu/euro/entry.html) is written. Note that LaTeX may
require latexpackage()(eurosym).
- fig(label)
- This macro is a shorthand for figure ref(label) and just makes the typing
shorter, as in see fig(schematic) for .. See getfigurestring() and
setfigurestring() for the figure text.
- figure(file)(caption)(label)
- Sets the picture in file as a figure in the current document, using the
descriptive text caption. The label is defined as a placeholder for the
figure number and can be used in a corresponding ref statement. Note that
the file must be the filename without extension: By default, Yodl will
supply .gif when in HTML mode, or .ps when in LaTeX mode. Figures in other
modes may not (yet) haven been implemented.
- file(text)
- Sets text as filename, usually boldface.
- findex()
- Generate an index entry for index f.
- footnote(text)
- Sets text as a footnote, or in parentheses when the output format does not
allow footnotes.
- gagmacrowarning(name name ...)
- Prevents the yodl program from printing cannot expand possible user
macro. E.g., if you have in your document the file(s) are .. then
you might want to put before that: gagmacrowarning(file). Calls
NOUSERMACRO.
- getaffilstring()
- Expands to the string that defines the name of Affiliation
Information, by default AFFILIATION INFORMATION. Can be
redefined for national language support by setaffilstring(). Currently, it
is relevant only for txt.
- getauthorstring()
- Expands to the string that defines the name of Author Information,
by default AUTHOR INFORMATION. Can be redefined for national
language support by setauthorstring(). Currently, it is relevant only for
txt.
- getchapterstring()
- Expands to the string that defines a `chapter’ entry, by default
Chapter. Can be redefined for national language support by
setchapterstring().
- getdatestring()
- Expands to the string that defines the name of Date Information, by
default DATE INFORMATION. Can be redefined for national language
support by setdatestring(). Currently, it is relevant only for txt.
- getfigurestring()
- Returns the string that defines a `figure’ text, in captions or in
the fig() macro. The string can be redefined using the setfiguretext()
macro.
- getpartstring()
- Expands to the string that defines a `part’ entry, by default
Part. Can be redefined for national language support by
setpartstring().
- gettitlestring()
- Expands to the string that defines the name of Title Information,
by default TITLE INFORMATION. Can be redefined for national
language support by settitlestring(). Currently, it is relevant only for
txt.
- gettocstring()
- Expands to the string that defines the name of the table of contents, by
default Table of Contents. Can be redefined for national language
support by settocstring().
- htmlbodyopt(option)(value)
- Adds option="value" to the options of the <body ...> tag
in HTML files. Useful options are, e.g., fgcolor and bgcolor, whose values
are expressed as #rrggbb, where rr are two hexadecimal digits of the red
component, gg two hexadecimal digits of the green component, and bb two
hexadecimal digits of the blue component.
- htmlcommand(cmd)
- Writes cmd to the output when converting to html. The cmd is not further
expanded by Yodl.
- htmlheadopt(option)
- Adds the literal text option to the current information in the head
section of an HTML document. Option may (or: should) contain plain html
text. A commonly occurring head option is link, defining, e.g., a style
sheet. Since that option is frequently used, it has received a dedicated
macro: htmlstylesheet. Like htmlbodyopt this macro should be placed in the
document’s preamble.
- htmlnewfile()
- In HTML output, starts a new file. All other formats are not affected.
Note that you must take your own provisions to access the new file; say
via links. Also, it’s safe to start a new file just befoore opening
a new section, since sections are accessible from the clickable table of
contents. The HTML converter normally only starts new files prior to a
chapter definition.
- htmlstylesheet(url)
- Adds a <link rel="stylesheet" type="text/css"
...> element to the head section of an HTML document, using url in its
href field. The argument url is not expanded, and should be plain HTML
text, without surrounding quotes. The macro htmlheadopt can also be used
to put information in the head-section of an HTML document, but
htmlheadopt is of a much more general nature. Like htmlbodyopt this macro
should be placed in the document’s preamble.
- htmltag(tagname)(start)
- Sets tagname as a HTML tag, enclosed by < and >. When start is zero,
the tagname is prefixed with /.
- ifnewparagraph(truelist)(falselist)
- The macro ifnewparagraph should be called from the PARAGRAPH macro, if
defined. It will insert truelist if a new paragraph is inserted, otherwise
falselist is inserted (e.g., following two consecutive calls of
PARAGRAPH). This macro can be used to prevent the output of multiple blank
lines.
- includefile(file)
- Includes file. The default extension .yo is supplied if necessary.
- NOTE: Starting with Yodl version 3.00.0 Yodl’s default file
inclusion behavior has changed. The current working directory no longer
remains fixed at the directory in which Yodl is called, but is volatile,
changing to the directory in which a yodl-file is located. This has the
advantage that Yodl’s file inclusion behavior now matches the way
C’s #include directive operates; it has the disadvantage
that it may break some current documents. Conversion, however is simple
but can be avoided altogether if Yodl’s -L (--legacy-include)
option is used.
- Furthermore, the includefile macro no longer defines a label. To define a
label just before the file’s inclusion use lincludefile.
- includeverbatim(file)
- Include file into the output. No processing is done, file should be in
preformatted form, e.g.:
whenhtml(includeverbatim(foo.html))
- NOTE: Starting with Yodl version 3.00.0 Yodl’s default file
inclusion behavior has changed. The current working directory no longer
remains fixed at the directory in which Yodl is called, but is volatile,
changing to the directory in which a yodl-file is located. This has the
advantage that Yodl’s file inclusion behavior now matches the way
C’s #include directive operates; it has the disadvantage
that it may break some current documents. Conversion, however is simple
but can be avoided altogether if Yodl’s -L (--legacy-include)
option is used.
- it()
- Indicates an item in an itemized list. The list is either surrounded by
startit() and endit(), or it is an argument to itemize().
- itemization(list)
- Sets list as an itemizationd list. Use it() to indicate items in the
list.
- itemize(list)
- DEPRECATED. Use itemization().
- kindex()
- Generate an index entry for index k.
- label(labelname)
- Defines labelname as an anchor for a link command, or to stand for the
last numbering of a section or figure in a ref command.
- langle()
- Character <
- languagedutch()
- Defines the Dutch-language specific headers. Active this macro via
setlanguage(dutch).
- languageenglish()
- Defines the English-language specific headers. Active this macro via
setlanguage(english).
- languageportugese()
- Defines the Portugese-language specific headers. Active this macro via
setlanguage(portugese).
- LaTeX()
- The LaTeX symbol.
- latexaddlayout(arg)
- This macro is provided to add Yodl-interpreted text to your own LaTeX
layout commands. The command is terminated with an end-of-line. See also
the macro latexlayoutcmds()
- latexcommand(cmd)
- Writes cmd plus a white space to the output when converting to LaTeX. The
cmd is not further expanded by Yodl.
- latexdocumentclass(class)
- Forces the LaTeX \documentclass{...} setting to class. Normally the class
is defined by the macros article, report or book. This macro is an escape
route incase you need to specify your own document class for LaTeX. This
option is a modifier and must appear before the article,
report or book macros.
- latexlayoutcmds(NOTRANSs)
- This macro is provided in case you want to put your own LaTeX layout
commands into LaTeX output. The NOTRANSs are pasted right after the
\documentclass stanza. The default is, of course, no local LaTeX commands.
Note that this macro does not overrule my favorite LaTeX layout.
Use nosloppyhfuzz() and standardlayout() to disable my favorite LaTeX
layout.
- latexoptions(options)
- Set latex options: documentclass[options]. This command must appear
before the document type is stated by article, report, etc..
- latexpackage(options)(name)
- Include latex package(s), a useful package is, e.g., epsf. This command
must appear before the document type is stated by article, report,
etc..
- lchapter(label)(title)
- Starts a new chapter in books or reports, setting a label at the beginning
of the chapter.
- letter(language)(date)(subject)(opening)(salutation)(author)
- Starts a letter written in the indicated language. The date of the letter
is set to `date’, the subject of the letter will be
`subject’. The letter starts with `opening’. It is based on
the `letter.cls’ document class definition. The macro is available
for LaTeX only. Preamble command suggestions:
- o
- latexoptions(11pt)
- o
- a4enlarged()
- o
- letterreplyto(name)(address)(postalcode/city)
- o
- letterfootitem(phone)(number), maybe e-mail too.
- o
- letteradmin(yourdate)(yourref)
- o
- letterto(addressitem). Use a separate letterto() macro call for each new
line of the address.
- letteraddenda(type)(value)
- Adds an addendum at the end of a letter. `type’ should be
`bijlagen’, `cc’ or `ps’.
- letteradmin(yourdate)(yourref)
- Puts `yourletterfrom’ and `yourreference’ elements in the
letter. If left empty, two dashes are inserted.
- letterfootitem(name)(value)
- Puts a footer at the bottom of letter-pages. Up to three will usually fit.
LaTeX only.
- letterreplyto(name)(address)(zip city)
- Defines the `reply to’ address in LaTeX or txt-letters.
- letterto(element)
- Adds `element’ as an additional line to the address in LaTeX
letters.
- link(description)(labelname)
- In HTML output a clickable link with the text description is created that
points to the place where labelname is defined using the label macro.
Using link is similar to url, except that a hyperlink is set pointing to a
location in the same document. For output formats other than HTML, only
the description appears.
- lref(description)(labelname)
- This macro is a combination of the ref and link macros. In HTML output a
clickable link with the text description and the label value is created
that points to the place where labelname is defined using the label macro.
For output formats other than HTML, only the description and the label
value appears.
- lsect(label)(title)
- Starts a new section, setting a label at the beginning of the
section.
- lsubsect(label)(title)
- Starts a new subsection. Other sectioning commands are subsubsect and
subsubsubsect. A label is added just before the subsection.
- lsubsubsect(label)(title)
- Starts a sub-subsection, a label is added just before the section
- lsubsubsubsect(label)(title)
- Starts a sub-sub-sub section. This level of sectioning is not numbered, in
contrast to `higher’ sectionings. A label is added just before the
subsubsubection.
- lurl(locator)
- An url described by its Locator. For small urls with readable
addresses.
- mailto(address)
- Defines the default mailto address for HTML output. Must appear
before the document type is stated by article, report, etc..
- makeindex()
- Make index for latex.
- mancommand(cmd)
- Writes cmd to the output when converting to man. The cmd is not further
expanded by Yodl.
- manpage(title)(section)(date)(source)(manual)
- Starts a manual page document. The section argument must be a number,
stating to which section the manpage belongs to. Most often used are
commands (1), file formats (5) and macro packages (7). The sectioning
commands in a manpage are not (n)sect etc., but manpage...(). The
first section must be the manpagename, the last section must
be the manpageauthor. The standard manpage for section 1 contains the
following sections (in the given order): manpagename, manpagesynopsis,
manpagedescription, manpageoptions, manpagefiles, manpageseealso,
manpagediagnostics, manpagebugs, manpageauthor. Optional extra sections
can be added with manpagesection. Standard manpageframes for several
manpagesections are provided in /usr/local/share/yodl/manframes.
- manpageauthor()
- Starts the AUTHOR entry in a manpage document. Must be the last section of
a manpage.
- manpagebugs()
- Starts the BUGS entry in a manpage document.
- manpagedescription()
- Starts the DESCRIPTION entry in a manpage document.
- manpagediagnostics()
- Starts the DIAGNOSTICS entry in a manpage document.
- manpagefiles()
- Starts the FILES entry in a manpage document.
- manpagename(name)(short description)
- Starts the NAME entry in a manpage document. The short description is used
by, e.g., the whatis database.
- manpageoptions()
- Starts the OPTIONS entry in a manpage document.
- manpagesection(SECTIONNAME)
- Inserts a non-required section named SECTIONNAME in a manpage document.
This macro can be used to augment `standard’ manual pages with
extra sections, e.g., EXAMPLES. Note that the name of the extra
section should appear in upper case, which is consistent with the normal
typesetting of manual pages.
- manpageseealso()
- Starts the SEE ALSO entry in a manpage document.
- manpagesynopsis()
- Starts the SYNOPSIS entry in a manpage document.
- mbox()
- Unbreakable box in LaTeX. Other formats may have different opitions on our
unbreakable boxex.
- menu(list)
- DEPRECATED.
- metaC(text)
- Put a line comment in the output.
- metaCOMMENT(text)
- Write format-specific comment to the output.
- mit()
- DEPRECATED.
- mscommand(cmd)
- Writes cmd to the output when converting to ms. The cmd is not further
expanded by Yodl.
- nchapter(title)
- Starts a chapter (in a book or report) without generating a number before
the title and without placing an entry for the chapter in the table of
contents.
- nemail(name)(address)
- Named email. A more consistent naming for url, lurl, email and nemail
would be nice.
- nl()
- Forces a newline; i.e., breaks the current line in two.
- node(previous)(this)(next)(up)
- DEPRECATED Defines a node with name this, and links to nodes
previous, next and (up), for the node command.
- nodeprefix(text)
- Prepend text to node names, e.g.
nodeprefix(LilyPond) sect(Overview)
Currently used in texinfo descriptions only.
- nodeprefix(text)
- Prepend text to node names, e.g.
nodeprefix(LilyPond) sect(Overview)
Currently used in texinfo descriptions only.
- nodetext(text)
- Use text as description for the next node, e.g.
nodetext(The GNU Music Typesetter)chapter(LilyPond)
Currently used in texinfo descriptions only.
- nop(text)
- Expand to text, to avoid spaces before macros e.g.: a. Although a+sups(2)
should have the same effect.
- nosloppyhfuzz()
- By default, LaTeX output contains commands that cause it to shut up about
hboxes that are less than 4pt overfull. When nosloppyhfuzz() appears
before stating the document type, LaTeX complaints are
`vanilla’.
- notableofcontents()
- Prevents the generation of a table of contents. This is default in, e.g.,
manpage and plainhtml documents. When present, this option must
appear before stating the document type with article, report etc..
- notitleclearpage()
- Prevents the generation of a clearpage() instruction after the typesetting
of title information. This instruction is default in all non article
documents. When present, must appear before stating the document
type with article, book or report.
- notocclearpage()
- With the LaTeX convertor, no clearpage() instruction is inserted
immediately beyond the document’s table of contents. The
clearpage() instruction is default in all but the article document type.
When present, must appear before stating the document type with
article, book or report. With other convertors than the LaTeX convertor,
it is ignored.)
- notransinclude(filename)
- Reads filename and inserts it literally in the text not subject to macro
expansion or character translation. No information is written either
before or after the file’s contents, not even a newline.
- NOTE: Starting with Yodl version 3.00.0 Yodl’s default file
inclusion behavior has changed. The current working directory no longer
remains fixed at the directory in which Yodl is called, but is volatile,
changing to the directory in which a yodl-file is located. This has the
advantage that Yodl’s file inclusion behavior now matches the way
C’s #include directive operates; it has the disadvantage
that it may break some current documents. Conversion, however is simple
but can be avoided altogether if Yodl’s -L (--legacy-include)
option is used.
- noxlatin()
- When used in the preamble, the LaTeX converter disables the inclusion of
the file xlatin1.tex. Normally this file gets included in the LateX output
files to ensure the conversion of high ASCII characters (like e) to
LaTeX-understandable codes. (The file xlatin1.tex comes with the YODL
distribution.)
- nparagraph(title)
- Starts a non-numbered paragraph (duh, corresponds to subparagraph in
latex).
- npart(title)
- Starts a part in a book document, but without numbering it and without
entering the title of the part in the table of contents.
- nsect(title)
- Starts a section, but does not generate a number before the title nor an
entry in the table of contents. Further sectioning commands are nsubsect,
nsubsubsect and nsubsubsubsect.
- nsubsect(title)
- Starts a non-numbered subsection.
- nsubsubsect(title)
- Starts a non-numbered sub-sub section.
- nsubsubsect(title)
- Starts a non-numbered sub-subsection.
- paragraph(title)
- Starts a parapgraph. This level of sectioning is not numbered, in contrast
to `higher’ sectionings (duh, corresponds to subparagraph in
latex).
- part(title)
- Starts a new part in a book document.
- pindex()
- Generate an index entry for index p.
- plainhtml(title)
- Starts a document for only a plain HTML conversion. Not available in other
output formats. Similar to article, except that an author- and date field
are not needed.
- printindex()
- Make index for texinfo (?).
- quote(text)
- Sets the text as a quotation. Usually, the text is indented, depending on
the output format.
- rangle()
- Inserts the right angle character (>).
- redef(macro)(nrofargs)(redefinition)
- Defines macro macro to expand to redefinition. Similar to def, but any
pre-existing definition is overruled. Use ARG x in the redefinition
part to indicate where the arguments should be pasted. E.g., ARG1 places
the first argument, ARG2 the second argument, etc...
- redefinemacro(macro)(nrofargs)(redefinition)
- Defines macro macro to expand to redefinition. Similar to def, but any
pre-existing definition is overruled. Use ARG x in the redefinition
part to indicate where the arguments should be pasted. E.g., ARG1 places
the first argument, ARG2 the second argument, etc... This commands is
actually calling redef().
- ref(labelname)
- Sets the reference for labelname. Use label to define a label.
- report(title)(author)(date)
- Starts a report type document. The top-level sectioning command in a
report is chapter.
- roffcmd(dotcmd)(sameline)(secondline)(thirdline)
- Sets a t/nroff command that starts with a dot, on its own line. The
arguments are: dotcmd - the command itself, e.g., .IP; sameline - when not
empty, set following the dotcmd on the same line; secondline - when not
empty, set on the next line; thirdline - when not empty, set on the third
line. Note that dotcmd and thirdline are not further expanded by YODL, the
other arguments are.
- row(contents)
- The argument contents may contain a man-page alignment specification (only
one specification can be entered per row), using setmanalign(). If
omitted, the standard alignment is used. Furthermore it contains the
contents of the elements of the row, using cell() or cells() macros. If
cells() is used, setmanalign() should have been used too. In this macro
call only the cell(), cells() and setmanalign() macros should be called.
Any other macro call may produce unexpected results.
- The row macro defines a counter XXcellnr that can be inspected and is
incremented by predefined macros adding columns to a row. The counter is
initially 0. Predefined macros adding columns to a row add the number of
columns they add to the row inserting the contents of those columns. These
macros rely on the correct value of this counter and any user-defined
macros adding columns to table rows should correctly update XXcellnr.
- rowline()
- Sets a horizontal line over the full width of the table. See also
columnline(). Use rowline() instead of a row() macro call to obtain a
horizontal line-separator.
- sc(text)
- Set text in small caps (or tt).
- sect(title)
- Starts a new section.
- setaffilstring(name)
- Defines name as the `affiliation information’ string, by default
AFFILIATION INFORMATION. E.g., after setaffilstring(AFILIACION),
YODL outputs this Spanish string to describe the affiliation information.
Currently, it is relevant only for txt.
- setauthorstring(name)
- Defines name as the `Author information’ string, by default
AUTHOR INFORMATION. E.g., after setauthorstring(AUTOR), YODL
outputs this portuguese string to describe the author information.
Currently, it is relevant only for txt.
- setchapterstring(name)
- Defines name as the `chapter’ string, by default Chapter.
E.g., after setchapterstring(Hoofdstuk), YODL gains some measure of
national language support for Dutch. Note that LaTeX support has its own
NLS, this macro doesn’t affect the way LaTeX output looks.
- setdatestring(name)
- Defines name as the `date information’ string, by default DATE
INFORMATION. E.g., after setdatestring(DATA), YODL outputs this
portuguese string to describe the date information. Currently, it is
relevant only for txt.
- setfigureext(name)
- Defines the name as the `figure’ extension. The extension should
include the period, if used. E.g., use setfigureext(.ps) if the extensions
of the figure-images should end in .ps
- setfigurestring(name)
- Defines the name as the `figure’ text, used e.g. in figure
captions. E.g., after setfigurestring(Figuur), Yodl uses Dutch names for
figures.
- sethtmlfigureext(ext)
- Defines the filename extension for HTML figures, defaults to .jpg. Note
that a leading dot must be included in ext. The new extension takes effect
starting with the following usage of the figure macro. It is only active
in html, but otherwise acts identically as setfigureext().
- setincludepath(name)
- Sets a new value of the include-path specification used when opening .yo
files. A warning is issued when the path specification does not include a
.: element. Note that the local directory may still be an element of the
new include path, as the local directory may be the only or the last
element of the specification. For these eventualities the new path
specification is not checked.
- setlanguage(name)
- Installs the headers specific to a language. The argument must be the name
of a language, whose headers have been set by a corresponding
languageXXX() call. For example: languagedutch(). The language macros
should set the names of the headers of the following elements: table of
contents, affiliation, author, chapter, date, figure, part and title
- setlatexalign(alignment)
- This macro defines the table alignment used when setting tables in LaTeX.
Use as many l (for left-alignment), r (for right alignment), and c (for
centered-alignment) characters as there are columns in the table. See also
table()
- setlatexfigureext(ext)
- Defines the filename extension for encapsulated PostScript figures in
LaTeX, defaults to .ps. The dot must be included in t new extension ext.
The new extension takes effect starting with a following usage of the
figure macro. It is only active in LaTeX, but otherwise acts identically
as setfigureext().
- setlatexverbchar(char)
- Set the char used to quote LaTeX \verb sequences
- setmanalign(alignment)
- This macro defines the table alignment used when setting tables used in
man-pages (see tbl(1)). Use as many l (for left-alignment), r (for
right alignment), and c (for centered-alignment) characters as there are
columns in the table. Furthermore, s can be used to indicate that the
column to its left is combined (spans into) the current column. Use this
specification when cells spanning multiple columns are defined. Each row
in a table which must be convertable to a manpage may contain a separate
setmanalign() call. Note that neither rowline nor columnline requires
setmanalign() specifications, as these macros define rows by themselves.
It is the responsibility of the author to ensure that the number of
alignment characters is equal to the number of columns of the table.
- setpartstring(name)
- Defines name as the `part’ string, by default Part. E.g.,
after setpartstring(Teil), Yodl identifies parts in the German way. Note
that LaTeX output does its own national language support; this macro
doesn’t affect the way LaTeX output looks.
- setrofftab(x)
- Sets the character separating items in a line of input data of a roff
(manpage) table. By default it is set to ~. This separator is used
internally, and needs only be changed (into some unique character) if the
table elements themselves contain ~ characters.
- setrofftableoptions(optionlist)
- Set the options for tbl table, default: none. Multiple options should be
separated by blanks, by default no option is used. From the tbl(1)
manpage, the following options are selected for consideration:
- o
- center Centers the table (default is left-justified)
- o
- expand Makes the table as wide as the current line length
- o
- box Encloses the table in a box
- o
- allbox Encloses each item of the table in a box Note that starting with
Yodl V 2.00 no default option is used anymore. See also setrofftab() which
is used to set the character separating items in a line of input
data.
- settitlestring(name)
- Defines name as the `title information’ string, by default TITLE
INFORMATION. E.g., after settitlestring(TITEL), YODL outputs this
Dutch string to describe the title information. Currently, it is relevant
only for txt.
- settocstring(name)
- Defines name as the `table of contents’ string, by default Table
of Contents. E.g., after settocstring(Inhalt), YODL identifies
the table of contents in the German way. Note that LaTeX output does its
own national language support; this macro doesn’t affect the way
LaTeX output looks.
- sgmlcommand(cmd)
- Writes cmd to the output when converting to sgml. The cmd is not further
expanded by Yodl.
- sgmltag(tag)(onoff)
- Similar to htmltag, but used in the SGML converter.
- sloppyhfuzz(points)
- By default, LaTeX output contains commands that cause it to shut up about
hboxes that are less than 4pt overfull. When sloppyhfuzz() appears before
stating the document type, LaTeX complaints occur only if hboxes are
overfull by more than points.
- standardlayout()
- Enables the default LaTeX layout. When this macro is absent, then the
first lines of paragraphs are not indented and the space between
paragraphs is somewhat larger. The standardlayout() directive must appear
before stating the document type as article, report, etc..
- startcenter()
- DEPRECATED. center() should be used.
- startdit()
- DEPRECATED. Use description().
- starteit()
- DEPRECATED. Use enumeration().
- startit()
- DEPRECATED. Use itemization().
- startmenu()
- DEPRECATED. Use menu().
- starttable()
- DEPRECATED. Use table().
- subs(text)
- Sets text in subscript in supporting formats
- subsect(title)
- Starts a new subsection. Other sectioning commands are subsubsect and
subsubsubsect.
- subsubsect(title)
- Starts a sub-subsection.
- subsubsubsect(title)
- Starts a sub-sub-sub-subsection. This level of sectioning is not numbered,
in contrast to `higher’ sectionings.
- sups(text)
- Sets text in superscript in supporting formats
- table(nColumns)(alignment)(Contents)
- The table()-macro defines a table. Its first argument specifies the number
of columns in the table. Its second argument specifies the (standard)
alignment of the information within the cells as used by LaTeX or man/ms.
Use l for left-alignment, c for centered-alignment and r for right
alignment. Its third argument defines the contents of the table which are
the rows, each containing column-specifications and optionally man/ms
alignment definitions for this row.
- See also the specialized setmanalign() macro.
- tcell(text)
- Roff helper to set a table textcell, i.e., a paragraph. For LaTeX special
table formatting p{} should be used.
- telycommand(cmd)
- Writes cmd to the output when converting to tely. The cmd is not further
expanded by Yodl.
- TeX()
- The TeX symbol.
- texinfocommand(cmd)
- Writes cmd to the output when converting to texinfo. The cmd is not
further expanded by Yodl.
- tindex()
- Generate an index entry for index t.
- titleclearpage()
- Forces the generation of a clearpage() directive following the title of a
document. This is already the default in books and reports, but can be
overruled with notitleclearpage(). When present, must appear in the
preamble; i.e., before the document type is stated with article,
book or report.
- tocclearpage()
- With the LaTeX convertor, a clearpage() directive if inserted, immediately
following the document’s table of contents. This is already the
default in all but the article document type, but it can be overruled by
notocclearpage(). When present, it must appear in the preamble;
i.e., before the document type is stated with article, book or report.
With other convertors than the LaTeX convertor, it is ignored.
- tt(text)
- Sets text in teletype font, and prevents it from being expanded. For
unbalanced parameter lists, use CHAR(40) to get ( and CHAR(41) to get
).
- txtcommand(cmd)
- Writes cmd to the output when converting to txt. The cmd is not further
expanded by Yodl.
- url(description)(locator)
- In LaTeX documents the description is sent to the output. For HTML, a link
is created with the descriptive text description and pointing to locator.
The locator should be the full URL, including service; e.g,
http://www.icce.rug.nl, but excluding the double quotes that are necessary
in plain HTML. Use the macro link to create links within the same
document. For other formats, something like description [locator]
will appear.
- verb(text)
- Sets text in verbatim mode: not subject to macro expansion or character
table expansion. The text appears literally on the output, usually in a
teletype font (that depends on the output format). This macro is for
larger chunks, e.g., listings. For unbalanced parameter lists, use
CHAR(40) to get ( and CHAR(41) to get ).
- verbinclude(filename)
- Reads filename and inserts it literally in the text, set in verbatim mode.
not subject to macro expansion.The text appears literally on the output,
usually in a teletype font (that depends on the output format). This macro
is an alternative to verb(...), when the text to set in verbatim mode is
better kept in a separate file.
- NOTE: Starting with Yodl version 3.00.0 Yodl’s default file
inclusion behavior has changed. The current working directory no longer
remains fixed at the directory in which Yodl is called, but is volatile,
changing to the directory in which a yodl-file is located. This has the
advantage that Yodl’s file inclusion behavior now matches the way
C’s #include directive operates; it has the disadvantage
that it may break some current documents. Conversion, however is simple
but can be avoided altogether if Yodl’s -L (--legacy-include)
option is used.
- verbpipe(command)(text)
- Pipe text through command, but don’t expand the output.
- vindex()
- Generate an index entry for index v.
- whenhtml(text)
- Sends text to the output when in HTML conversion mode. The text is further
expanded if necessary.
- whenlatex(text)
- Sends text to the output when in LATEX conversion mode. The text is
further expanded if necessary.
- whenman(text)
- Sends text to the output when in MAN conversion mode. The text is further
expanded if necessary.
- whenms(text)
- Sends text to the output when in MS conversion mode. The text is further
expanded if necessary.
- whensgml(text)
- Sends text to the output when in SGML conversion mode. The text is further
expanded if necessary.
- whentely(text)
- Sends text to the output when in TELY conversion mode. The text is further
expanded if necessary.
- whentexinfo(text)
- Sends text to the output when in TEXINFO conversion mode. The text is
further expanded if necessary.
- whentxt(text)
- Sends text to the output when in TXT conversion mode. The text is further
expanded if necessary.
- whenxml(text)
- Sends text to the output when in XML conversion mode. The text is further
expanded if necessary.
- xit(itemname)
- Starts an xml menu item where the file to which the menu refers to is the
argument of the xit() macro. It should be used as argument to xmlmenu(),
which has a 3rd argument: the default path prefixed to the xit()
elements.
- This macro is only available within the xml-conversion mode. The argument
must be a full filename, including .xml extension, if applicable.
- No .xml extension indicates a subdirectory, containing another
sub-menu.
- xmlcommand(cmd)
- Writes cmd to the output when converting to xml. The cmd is not further
expanded by Yodl.
- xmlmenu(order)(title)(menulist)
- Starts an xmlmenu. Use itemization() to define the items. Only available
in xml conversion. The menutitle appears in the menu as the heading of the
menu. The menulist is a series of xit() elements, containing the name of
the file to which the menu refers as their argument (including a final /).
Prefixed to evert every xit()-element is the value of XXdocumentbase.
- Order is the the `order’ of the menu. If omitted, no order is
defined.
- xmlnewfile()
- In XML output, starts a new file. All other formats are not affected. Note
that you must take your own provisions to access the new file; say via
links. Also, it’s safe to start a new file just befoore opening a
new section, since sections are accessible from the clickable table of
contents. The XML converter normally only starts new files prior to a
chapter definition.
- xmlsetdocumentbase(name)
- Defines name as the XML document base. No default. Only interpreted with
xml conversions. It is used with the figure and xmlmenu macros.
- xmltag(tag)(onoff)
- Similar to htmltag, but used in the XML converter.
OPTIONS¶
No options are relevant in respect to the macros.
FILES¶
The files in
tmp/wip/macros define the converter’s macro packages.
The scripts
yodl2tex,
yodl2html,
yodl2man etc. perform
the conversions.
SEE ALSO¶
yodlstriproff(1),
yodl(1),
yodlbuiltins(7),
yodlconverters(1),
yodlletter(7),
yodlmanpage(7),
yodlpost(1),
yodlverbinsert(1).
BUGS¶
-
AUTHOR¶
Frank B. Brokken (f.b.brokken@rug.nl),