wml::fmt::text

Langue: en

Autres versions - même langue

Version: 2010-05-17 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

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 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 "<text>" tag (in lowercase letters) and in "wml_fmt_text" arguments, as shown in examples above.
"NOTYPO"
By default, font commands are added to headings to highlight them. This attribute prevents alteration of txt2html output.
"OPTIONS=str"
This attribute performs two actions: select txt2html filter instead of txt2html, and str arguments are 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), txt2html(3)