Automatic content generation

The std-automatic d.t.d. specifies for the automatic generation of auxiliary content like tables of contents and bibliographies, as well as for the presentation of such auxiliary content. The following tags are used for bibliographies:

cite

A function with an arbitrary number of arguments. Each argument is a citation corresponding to an item in a BiB-TeX file. The citations are displayed in the same way as they are referenced in the bibliography and they also provide hyperlinks to the correspoding references. The citations are displayed as question marks if you did not generate the bibliography.

nocite*

Similar as cite , but the citations are not displayed in the main text.

cite-detail

A function with two arguments. The first one corresponds to a BiB-TeX item and the second one to some additional information like a chapter or a page number.

bibitem*

A function which specifies how to display an item in the bibliography.

The following tags are used for compiling tables of contents:

toc-main-1

A function with one argument for creating primordial entry in the table of contents. This function can for instance be used when a book consists of several parts.

toc-main-2

A function with one argument for creating a main entry in the table of contents. This function is usually used for chapters.

toc-normal-1

A function with one argument for creating a normal entry in the table of contents. This function is often used for sections.

toc-normal-2

Similar as toc-normal-2 for less important entries like subsections.

toc-normal-3

Similar as toc-normal-3 for even less important entries like subsubsections.

toc-small-1

Used for not very important entries such as paragraphs (may be ignored).

toc-small-2

Used for even less important entries such as subparagraphs.

toc-dots

The separation between an entry in the table of contents and the corresponding page number. By default, we use horizontal dots.

The following tags are used for indices:

index

A function with one argument x , which inserts x in the index as a principal entry.

subindex

A function with two arguments x and y , which inserts y in the index as a subentry of x .

subsubindex

A function with three arguments x , y and z , which inserts z in the index as a subentry of y , which is itself a subentry of x .

index-complex

A function with four arguments key , how , range , entry , which is documented in the section about index generation .

index-line

This function takes a key argument, which tells how to sort the entry, and the actual entry . No page number is generated.

index-1

Macro with an index entry and a page number, which is used for rendering a principal index entry in the index.

index-1*

Similar to index-1 , but without the page number.

index-n

(with n between 1 and 5): macro with an index entry and a page number, which is used for rendering an index entry of level n .

index-n*

Similar to index-n , but without the page number.

index-dots

The macro which produces the dots between an index entry and the corresponding page number(s).

The following tags are used for glossaries:

glossary

A function which inserts its only argument into the glossary.

glossary-dup

For creating an additional page number for an entry which was already inserted before.

glossary-explain

A function for inserting a glossary entry with its explanation.

glossary-line

Insert a glossary entry without a page number.

glossary-1

Macro for rendering a glossary entry and its corresponding page number.

glossary-2

Macro for rendering a glossary entry, its explanation, and its page number.

glossary-dots

The macro which produces the dots between a glossary entry and the corresponding page number(s).