Customizing the global rendering of titles

Depending on the kind of attributes, complex titles often use several rendering styles in a simultaneous version. More precisely, a title usually consists of the following parts:

Similarly, individual authors may also contain a main part, which is rendered as part of the title, and an additional part, which is rendered as a footnote. Moreover, the layout often changes if the paper has more than one author.

The TeXmacs mechanism for rendering titles therefore relies on several macros which extract the information corresponding to each of the above parts. This process may also involve some sorting, like putting the authors before the date or vice versa. At a second stage, each extracted part of the title is passed to the appropriate rendering macro. The following macros are used for extracting title information:

<doc-data-main|data-1||data-n>

<doc-data-main*|data-1||data-n>

This macro only keeps and sorts the data which should be displayed in the main title. The doc-data-main* variant is used in the case when the document has more than one author.

<doc-data-note|data-1||data-n>

This macro only keeps and sorts the data which should be displayed as a footnote.

<doc-data-abstract|data-1||data-n>

This macro only keeps and sorts the data which should be displayed in the abstract.

<doc-data-hidden|data-1||data-n>

This macro only keeps and sorts the data which might or should not be displayed at all.

In a similar fashion, the following macros are used for extracting author information:

<doc-author-main|<doc-author-data|data-1||data-n>>

This macro only keeps and sorts the data which should be displayed inside the main title.

<doc-author-note|data-1||data-n>

This macro only keeps and sorts the data which should be displayed as a footnote.

It should be noticed that each of the above macros should return a document tag with the selected data as its children. For instance,

<\doc-author-main|

<author-address|Somewhere in Africa>

|

<author-name|The big GNU>

|

<author-note|Very hairy indeed!>

>

should typically return

<\document|

<author-address|Somewhere in Africa>

|

<author-name|The big GNU>

>

The only exception to this rule is doc-data-hidden which should return a concat tag instead.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".