man wml::fmt::text (Fonctions bibliothèques) - Plain ASCII with Special Formatting Semantic

NAME

wml::fmt::text - Plain ASCII with Special Formatting Semantic

SYNOPSIS

 #use wml::fmt::text

 <: print &wml_fmt_text({ FILE => $file, OPTIONS => '--xhtml', ...}); :>

 <text notypo>
 FOO
 ===

 1. bar
 2. quux
    a. baz
    b. foo
 ...
 </text>

DESCRIPTION

The usage is simple: Surround the text with the CW<text> container tag and then just write plain ASCII text inside it. The corresponding HTML code is created via wml_aux_txt2html(3), a filter which gives the ASCII text nice formatting semantic which control the HTML result.

If OPTIONS field is specified, a newer txt2html(1) filter is called instead of wml_aux_txt2html, which is dead upstream. This allows for instance generation of XGTML markup.

The core conversion function is wml_fmt_text() which also can be used by other include files.

ATTRIBUTES

These attributes can be used both in the CW<text> tag (in lowercase letters) and in CWwml_fmt_text arguments, as shown in examples above. By default, font commands are added to headings to highlight them. This attribute prevents alteration of wml_aux_txt2html output. This attribute performs two actions: select txt2html filter instead of wml_aux_txt2html, and str arguments are passed litterally on the command line of txt2html.

AUTHOR

 Ralf S. Engelschall
 rse@engelschall.com
 www.engelschall.com

REQUIRES

 Internal: P1, P2, P3, wml_aux_txt2html (WML)
 External: --

SEEALSO