Miscellaneous physical markup

<group|content>
(atomic entity)

Typeset the content, which must be line content, as an atomic line item. Hyphenation within the group and special spacing handling on its borders are disabled.

<float|type|where|body>
(floating page insertion)

Floating insertions are page items which are typeset “out of band”, they are associated to two boxes: the anchor box marks the structural position of the float, the floating box contains the typeset body operand. This facility is used by footnotes and floating blocks.

The first and second operands are evaluated, but for clarity the first operand appears as a literal string in the examples. Since the body is typeset out of band, it may be block content even if the float occurs in line context.

<float|footnote||body> produces a footnote insertion, this should only be used within the footnote macro and is considered style markup. The floating box of a footnote is typeset at the end of the the page containing the anchor box.

<float|float|where|body> produces a floating block, this is considered physical markup. The position of the floating box is chosen by the page breaker, which uses this extra freedom to minimize the page breaking penalty.

The where operand must evaluate to a string which may contain the following characters:

t
Allow the floating box at page top.
b
Allow the floating box at page bottom.
h
Allow the floating box “here”, in the middle of the page near the anchor box.
f
Force the floating box within the same page as the anchor box.

<specific|medium|body>
(medium-specific content)

This primitive marks body for output only on the specified medium. The following values of medium are supported:

texmacs
The body is typeset as usual line content.
latex
The body, which must be a string, is not visible from within TeXmacs, but it will be included in a verbatim way when the document is exported to LaTeX.
html
Similar to the latex medium, but for HTML exports.
screen
The body is only typeset when the document is visualized on a screen. This may be useful to provide additional visual information to the user during the editing phase which should disappear when printing out. A similar tag which may be used for this purpose is flag.
printer
This medium is complementary to screen, when the body should only be visible when printing out, but not when the document is displayed on the screen.

<raw-data|data>
(binary content)

In some contexts you need to embed uneditable data inside a document, most of the time this is uneditable binary data. The raw-data primitive makes it impossible to view or modify its subtree from within the editor.

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".