1.The common base for most styles

Indicates an important region of text. You can enter this tag via Insert→Content tag→Strong.

Emphasizes a region of text like in “the real thing”. This tag corresponds to the menu entry Insert→Content tag→Emphasize.

For definitions like “a gnu is a horny beast”. This tag corresponds to Insert→Content tag→Definition.

A sequence of literal characters like the ae ligature æ. You can get this tag via Insert→Content tag→Sample.

The name of a particular thing or concept like the Linux system. This tag is obtained using Insert→Content tag→Name.

The name of a person like Joris. This tag corresponds to Insert→Content tag→Person.

A bibliographic citation like a book or magazine. Example: Melville's Moby Dick. This tag, which is obtained using Insert→Content tag→Cite, should not be confused with cite. The latter tag is also used for citations, but where the argument refers to an entry in a database with bibliographic references.

An abbreviation. Example: I work at the C.N.R.S. An abbreviation is created using Insert→Content tag→Abbreviation or the ⌥A keyboard shortcut.

An acronym is an abbreviation formed from the first letter of each word in a name or a phrase, such as HTML or IBM. In particular, the letters are not separated by dots. You may enter an acronym using Insert→Content tag→Acronym.

Verbatim text like output from a computer program. Example: the program said hello. You may enter verbatim text via Insert→Content tag→Verbatim. The tag may also be used as an environment for multi-paragraph text.

Text which should be entered on a keyboard. Example: please type return. This tag corresponds to the menu entry Insert→Content tag→Keyboard.

Code of a computer program like in “cout << 1+1; yields 2”. This is entered using Insert→Content tag→Code. For longer pieces of code, you should use the code environment.

Variables in a computer program like in cp src-file dest-file. This tag corresponds to the menu entry Insert→Content tag→Variable.

This tag is used for mathematics inside regular text. Example: the formula is well-known.

This is a tag which can be used inside mathematics for specifying that an operator should be considered on itself, without any arguments. Example: the operation is a function from to . This tag may become depreciated.

This is a physical tag for typewriter phase. It is used for compatibility with HTML, but we do not recommend its use.

These logical size tags should be used by preference when typesetting parts of your document in a larger or smaller font. Environments like footnotes or captions of tables may also be based on logical size tags. Document styles from professional publishers often assign very precise font settings to each of the logical size tags. By default, the size tags are rendered as follows:

Described above.

Similar to code*, but for pieces of code of several lines.

Environment for short (one paragraph) quotations.

Environment for long (multi-paragraph) quotations.

Environment for poetry.

This is a physical tag for centering one or several lines of text. It is used for compatibility with HTML, but we do not recommend its use.

Centered tables.

Left aligned tables with a border of standard 1ln width.

Centered tables with a border of standard 1ln width.

These macros can be used to adjust the vertical extents of the body to those of the character 'x'. In the case of smash-top and smash-bottom, only the top resp. bottom are changed.

These macros can be used to increase the vertical extents of the body to those of the largest character in the current font. In the case of inflate-top and inflate-bottom, only the top resp. bottom are changed. This kind of adjustments may for instance be used in order to ensure that matrices with simple textual contents always have the same size:

In fact, for a more uniform appearance, swelling is activated by default inside matrices.

This primitive is similar to resize, except that the new size of the content is always larger than the original size.

The TeXmacs logo.

The current version of TeXmacs (2.1.4).

A macro which may be used to indicate that your document was written using TeXmacs.

The TeX logo.

The LaTeX logo.

A horizontal rule like the one you see below:

This tag takes as much space as the typeset argument content would take, but content is not displayed. For instance, <phantom|phantom> yields “”.

For overlined text, which can be wrapped across several lines.

For underlined text, which can be wrapped across several lines.

The summary is displayed and the body ignored: the macro corresponds to the folded presentation of a piece of content associated to a short title or abstract. The second argument can be made visible using Insert→Switch→Unfold.

Unfolded presentation of a piece of content body associated to a short title or abstract summary. The second argument can be made invisible using Insert→Switch→Fold.

Content which admits a finite number of alternative representation among which the user can switch using the function keys F9, F10, F11 and F12. This may for instance be used in interactive presentations. The argument current correspond to the currently visible presentation and alternative to the set of alternatives.

For binomial coefficients, like .

Alternative name for binom, but depreciated.

A macro which switches to scriptsize text when you are not in display style. This macro is mainly used by developers. For instance, the binom macro uses it.

For matrices .

For determinants .

For choice lists .

The tag before each item depends on the nesting depth.

Uses for the tag.

Uses for the tag.

Uses for the tag.

The kind of number before each item depends on the nesting depth.

Number the items by 1, 2, 3, etc.

Number the items by i, ii, iii, etc.

Number the items by I, II, III, etc.

Number the items by a), b), c), etc.

Number the items by A), B), C), etc.

The environment for default descriptive lists (usually description-compact).

Align the left hand sides of the items in the list and put their descriptions shortly behind it.

Similar to description-compact, but use a — to separate each item from its description.

Align the left hand sides of the descriptions, while aligning the items to the right.

Put the items and their descriptions on distinct lines.

This block environment is used to render the body of the list. Usually, the macro indents the body and puts some vertical space around it.

This inline macro is used to render the item-text in a right-aligned way. As a consequence, text after such items will appear in a left-aligned way.

This inline macro is used to render the item-text in a left-aligned way. As a consequence, text after such items may be indented by the width of the item-text (except when the text is rendered on a different paragraph).

Each argument ref-i 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 corresponding references. The citations are displayed as question marks if you did not generate the bibliography. Once you've added a bibliography file, pressing ⇥ inside the arguments will auto-complete with the cite-keys in your file.

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

A bibliographic reference ref like cite and nocite, but with some additional information info, like a chapter or a page number.

Macro for rendering a citation ref at the place where the citation is made using cite. The content may be a single reference, like “TM98”, or a list of references, like “Euler1, Gauss2”.

Similar to render-cite, but for detailed citations made with cite-detail.

At the moment, bibliographies are generated by BibTeX and imported into TeXmacs. The produced bibliography is a list of bibliographic items with are based on special LaTeX-specific macros (bibitem, block, protect, etc.). These macros are all defined internally in TeXmacs and eventually boil down to calls of the render-bibitem, which behaves in a similar way as item*, and which may be redefined by the user.

The transform-bibitem is used to “decorate” the content. For instance, transform-bibitem may put angular brackets and a space around content.

The individual “bibitems” are enclosed in a bib-list, which behaves in a similar way as the description environment, except that we provide an extra parameter largest which contains a good indication about the largest width of an item in the list.

Create an important entry in the table of contents. The macro toc-main-1 is intended to be used only for very important entries, such as parts of a book; it usually has to be added manually. The macro toc-main-2 is intended to be used for chapter or sections. Important entries are usually displayed in a strong font.

Add a normal entry to the table of contents, of different levels of importance. Usually, toc-normal-1 corresponds to sections, toc-normal-2 to subsections and toc-normal-3 to subsubsections.

Add an unimportant entry to the table of contents, like a paragraph. Since such entries are not very important, some styles may simply ignore the toc-small-1 and toc-small-2 tags.

Used for rendering table of contents entries created using toc-main-1 resp. toc-main-2.

Used for rendering table of contents entries created using toc-normal-1, toc-normal-2, toc-normal-3, toc-small-1 resp. toc-small-2.

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

Insert primary as a primary entry in the index.

Insert secondary in the index as a subentry of primary.

Similar to subindex but for subsubentries ternary.

Insert complex entries into the index. This feature is documented in detail in the section about index generation.

Adds entry to the index, by sorting it according to key.

Macro for rendering an entry in the index on page(s) where. The macro index-1 corresponds to principal entries, the macro index-2 to secondary entries, and so on.

Similar to index-1 until index-5, but without the page number(s).

Macro for producing the dots between an index entry and the corresponding page number(s).

Insert entry into the glossary.

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

A function for inserting a glossary entry with its explanation.

Insert a glossary entry without a page number.

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

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

Macro for producing the dots between a glossary entry and the corresponding page number(s).

Low level tags for flushing to the right in the definition of environments. One usually should use wide-normal or wide-centered instead.

These tags are used to make the body span over the entire paragraph width. The text is left-aligned in the case of wide-normal and centered in the case of wide-centered. Making a body span over the entire paragraph width does not change the rendering on paper, but it facilitates the editing on the document. Indeed, on the one hand, the box which indicates that you are inside the environment will span over the entire paragraph width. On the other hand, when clicking sufficiently close to the text inside this box, it becomes easier to position your cursor at the start or at the end inside the environment. You may check this by clicking on one of the texts below:

>Some text inside a wide-normal environment.<

>Some text inside a wide-centered environment.<

These tags are variants of <wide-normal|body> and <wide-centered|body>, which put some vertical white space space-above and space-below above and below the body.

These tags are used to make the body span over the entire paragraph width and to put a horizontal rule above and/or below it. The widths of the rules are given by top-border and bot-border and the separation between the rules by top-sep and bot-sep. The standard width and separation (used by wide-std-bothlined, padded-std-bothlined and wide-std-underlined) are 1ln and 1sep. The padded variants specify additional spaces space-above and space-below above and below the rules. As an example, <wide-std-underlined|left<htab|5mm>right> yields:

Wide underlined environments are typically used for page headers. Wide environments which are both overlined and underlined are typically used for abstracts or floating figures and tables.

These tags put the body inside a frame box which spans over the whole paragraph. The user may specify a border-width, horizontal and vertical separations hsep and vsep between the border and the text, and colors border-color and body-color for the border and the background. For instance, <wide-std-framed-colored|brown|pastel green|Hi there!> yields

These environments may be used in order to increase the current left and/or right indentation by the amounts left-amount and/or right-amount.

This environment allows to set the margin first-margin for the first lines of paragraphs in the body, as well as the margin other-margin for the other lines. This environment is for instance useful for glossaries, indexes, etc., in which case other-margin is often larger than first-margin. Notice that this environment enables indentation for the first line of body.

A macro for permanently changing the header. Notice that certain tags in the style file, like sectional tags, may override such manual changes.

A macro for permanently changing the footer. Again, certain tags in the style file may override such manual changes.

Remove all headers and footers from this page.

Remove the header of this page and set the footer to the current page number (centered). This macro is often called for title pages or at the start of new chapters.

This macro should be used in order to “localize” some English text to the current language. For instance, <with|language|french|<localize|Theorem>> yields Théorème.

This macro applies the macro fun to each of the entries in a tuple (or the children of an arbitrary TeXmacs tag) and returns the result as a tuple. For instance, <map|<macro|x|<em|x>>|<tuple|1|2|3>> yields (the quote only appears when rendering the result, not when performing further computations with it).

Defines a new counter with name x. The counter is stored in the numerical environment variable x-nr and in addition, the following macros are defined:

For the purpose of customization, the new-counter macro also defines the following macros:

Create a new counter group with name g. This results in the creation of the following macros:

Defines a new counter x and add it to the counter group g. For counters in groups, the macros display-x and counter-x are replaced with the corresponding macros display-in-g and counter-in-g for their groups. Nevertheless, two new macros ind-display-x and ind-counter-x are defined which may take over the roles of display-x and counter-x in the case when the group consists of individual counters.

Use a common counter for the group (which is stored in the environment variable g-nr).

Use an individual counter for each member of the group (this is the default).

The name of the algorithm and its body, which includes its possible specification.

The real body of the algorithm.

For indenting part of an algorithm.

Environment for marking a session. All macros below are only for use inside sessions.

An input field with a prompt and the actual input.

An output field.

Fields with ordinary text. These may for instance be used for comments and explanations.

This macro is used inside output fields for displaying error messages.