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 "<text>" container tag and then just write plain ASCII
       text inside it. The corresponding HTML code is created via 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 txt2html, which is dead
       upstream.  This allows for instance generation of XHTML 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 "<text>" tag (in lowercase letters) and in "wml_fmt_text"'s
       arguments, as shown in the examples above.

       "NOTYPO"
           By  default,  font  commands  are  added  to  headings  to  highlight  them.  This attribute prevents
           alteration of txt2html's output.

       "OPTIONS=str"
           This attribute performs two actions: select txt2html as a filter instead of txt2html,  and  make  str
           arguments be passed literally on the command line of txt2html.

AUTHOR

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

REQUIRES

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

SEE ALSO

       txt2html(1)

EN Tools                                           2020-11-29                                  wml::fmt::text(3)