/doc/English/userguide/userguide.html

http://txt2tags.googlecode.com/ · HTML · 3589 lines · 3457 code · 131 blank · 1 comment · 0 complexity · c0fe9b895ad72f0cb4c9dc464dd836c9 MD5 · raw file

Large files are truncated click here to view the full file

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
    2. 

  2. <!-- This document was generated from userguide.t2t -->
    3. 

  3. <HTML>
    4. 

  4. <HEAD>
    5. 

  5. <META NAME="generator" CONTENT="http://txt2tags.org">
    6. 

  6. <LINK REL="stylesheet" TYPE="text/css" HREF="userguide.css">
    7. 

  7. <TITLE>Txt2tags User Guide</TITLE>
    8. 

  8. </HEAD>
    9. 

  9. <BODY>
    10. 

  10. 

  11. <DIV CLASS="header" ID="header">
    12. 

  12. 

  13. 

  14. </DIV>
    15. 

  15. 

  16. <DIV CLASS="body" ID="body">
    17. 

  17. 

  18. <H1>About</H1>
    19. 

  19. 

  20. <P>
    21. 

  21. This is the <A HREF="http://txt2tags.org">txt2tags</A> User Guide, the
    22. 

  22. complete manual about the program.
    23. 

  23. </P>
    24. 

  24. 

  25. <UL>
    26. 

  26. <LI>User Guide official address:
    27. 

  27.   <A HREF="http://txt2tags.org/userguide">http://txt2tags.org/userguide</A>
    28. 

  28. <P></P>
    29. 

  29. <LI>User Guide PDF download:
    30. 

  30.   <A HREF="http://txt2tags.org/userguide/userguide.pdf">http://txt2tags.org/userguide/userguide.pdf</A>
    31. 

  31. </UL>
    32. 

  32. 

  33. <A NAME="intro"></A>
    34. 

  34. <H1>Part I - Introducing Txt2tags</H1>
    35. 

  35. 

  36. <A NAME="1st-questions"></A>
    37. 

  37. <H2>The First Questions You May Have</H2>
    38. 

  38. 

  39. <P>
    40. 

  40. This chapter is a txt2tags overview, that will introduce the program
    41. 

  41. purpose and features.
    42. 

  42. </P>
    43. 

  43. 

  44. <H3>What is it?</H3>
    45. 

  45. 

  46. <P>
    47. 

  47. Txt2tags is a text formatting and conversion tool.
    48. 

  48. </P>
    49. 

  49. 

  50. <DL>
    51. 

  51. <DT><B>A text formatting tool</B>: The txt2tags wiki-like syntax is easy to use and to remember. You can use it for every purpose, like storing your notes and formatting your documents.</DT><DD>
    52. 

  52. <P></P>
    53. 

  53. <DT><B>A conversion tool</B>: You can use the txt2tags python program to converts your txt2tags documents to several supported <A HREF="#targets">targets</A>. <I>(Further reference to the txt2tags python program will simply be labelled "txt2tags".)</I></DT><DD>
    54. 

  54. <P></P>
    55. 

  55. Amongs others, there are:
    56. 

  56. <P></P>
    57. 

  57. </DL>
    58. 

  58. 

  59. <UL>
    60. 

  60. <LI>popular Wiki markups, such as bbcode, wikipedia pages, markdown, restructuredtext and spip.
    61. 

  61. <P></P>
    62. 

  62. <LI>html variations: html transitional, xhtml, html5...
    63. 

  63. <P></P>
    64. 

  64. <LI>office documents: RTF, LaTeX documents, Open Document Spreadsheet, SQLite database (imported from tables)
    65. 

  65. <P></P>
    66. 

  66. <LI>plain text, including ASCII art variations.
    67. 

  67. </UL>
    68. 

  68. 

  69. <P>
    70. 

  70. <I>See the <A HREF="#targets">targets chapter</A> to discover the full list.</I>
    71. 

  71. </P>
    72. 

  72. 

  73. <DL>
    74. 

  74. <DT><B>And more</B>: Beyond those 2 aspects, which deals with defined features and syntax, txt2tags can also manipulate your document with <A HREF="#setting-preproc">powerful input and output filters</A>.</DT><DD>
    75. 

  75. </DL>
    76. 

  76. 

  77. <H3>Why should I use it?</H3>
    78. 

  78. 

  79. <P>
    80. 

  80. You'll find txt2tags really useful if you:
    81. 

  81. </P>
    82. 

  82. 

  83. <UL>
    84. 

  84. <LI>Need to publish documents in different formats
    85. 

  85. <LI>Need to maintain updated documents in different formats
    86. 

  86. <LI>Write technical documents or guides
    87. 

  87. <LI>Don't know how to write a document in a specific format
    88. 

  88. <LI>Don't have an editor for a specific format
    89. 

  89. <LI>Want to use a simple text editor to update your documents
    90. 

  90. </UL>
    91. 

  91. 

  92. <P>
    93. 

  93. And the main motivation is:
    94. 

  94. </P>
    95. 

  95. 

  96. <UL>
    97. 

  97. <LI>Save time, writing <B>contents</B> and forgetting about <B>formatting</B>
    98. 

  98. </UL>
    99. 

  99. 

  100. <H3>Why is it a good choice among other tools?</H3>
    101. 

  101. 

  102. <P>
    103. 

  103. Txt2tags has a very straight way of growing, following basic concepts.
    104. 

  104. These are the highlights:
    105. 

  105. </P>
    106. 

  106. 

  107. <TABLE>
    108. 

  108. <TR>
    109. 

  109. <TD><I>Source File Readable</I></TD>
    110. 

  110. <TD>Txt2tags marks are very simple, almost natural.</TD>
    111. 

  111. </TR>
    112. 

  112. <TR>
    113. 

  113. <TD><I>Target Document Readable</I></TD>
    114. 

  114. <TD>The target document is also readable, with indentation and spacing.</TD>
    115. 

  115. </TR>
    116. 

  116. <TR>
    117. 

  117. <TD><I>Consistent Marks</I></TD>
    118. 

  118. <TD>Txt2tags marks are simple symbols, designed to be unique enough to don't mix up with the document contents.</TD>
    119. 

  119. </TR>
    120. 

  120. <TR>
    121. 

  121. <TD><I>Consistent Rules</I></TD>
    122. 

  122. <TD>As the marks, the rules that applies to them are tied to each other, there are no "exceptions" or "special cases".</TD>
    123. 

  123. </TR>
    124. 

  124. <TR>
    125. 

  125. <TD><I>Simple Structures</I></TD>
    126. 

  126. <TD>All the supported formatting are <B>simple</B>, with no extra-options or complicated behavior modifiers. A mark is just a mark, with no options at all.</TD>
    127. 

  127. </TR>
    128. 

  128. <TR>
    129. 

  129. <TD><I>Easy to Learn</I></TD>
    130. 

  130. <TD>With simple marks and readable source, the txt2tags learning curve is user friendly.</TD>
    131. 

  131. </TR>
    132. 

  132. <TR>
    133. 

  133. <TD><I>Nice Examples</I></TD>
    134. 

  134. <TD>The <B>sample files</B> included on the package gives real life examples of documents written for txt2tags.</TD>
    135. 

  135. </TR>
    136. 

  136. <TR>
    137. 

  137. <TD><I>Valuable Tools</I></TD>
    138. 

  138. <TD>The <B>syntax files</B> included on the package help you to write documents with no syntax errors.</TD>
    139. 

  139. </TR>
    140. 

  140. <TR>
    141. 

  141. <TD><I>Three User Interfaces</I></TD>
    142. 

  142. <TD>There is a user friendly <B>Graphical interface</B>, a handy <B>Web interface</B> easy to install in intranets and a <B>Command Line interface</B> for power-users and scripting.</TD>
    143. 

  143. </TR>
    144. 

  144. <TR>
    145. 

  145. <TD><I>Scripting</I></TD>
    146. 

  146. <TD>With the full featured command line mode, an experienced user can <B>automatize</B> tasks and do <B>post-editing</B> on the converted files.</TD>
    147. 

  147. </TR>
    148. 

  148. <TR>
    149. 

  149. <TD><I>Download and Run / Multi-platform</I></TD>
    150. 

  150. <TD>Txt2tags is a single <B>Python script</B>. There is no need to compile it or download extra modules. So it runs nicely on *NIX, Linux, Windows and Macs.</TD>
    151. 

  151. </TR>
    152. 

  152. <TR>
    153. 

  153. <TD><I>Mature</I></TD>
    154. 

  154. <TD>First released in 2001, txt2tags is now a mature program with years of improvements and bug fixes, extensive documentation, translations and an loyal user base.</TD>
    155. 

  155. </TR>
    156. 

  156. </TABLE>
    157. 

  157. 

  158. <H3>Do I have to pay for it?</H3>
    159. 

  159. 

  160. <P>
    161. 

  161. Absolutely NO!
    162. 

  162. </P>
    163. 

  163. <P>
    164. 

  164. It's free, GPL licensed.
    165. 

  165. </P>
    166. 

  166. 

  167. <A NAME="structures"></A>
    168. 

  168. <H2>Supported Formatting Structures</H2>
    169. 

  169. 

  170. <P>
    171. 

  171. The following is a list of all the structures supported by txt2tags.
    172. 

  172. </P>
    173. 

  173. 

  174. <UL>
    175. 

  175. <LI>header (document title, author name, date)
    176. 

  176. <LI>section title (numbered or not)
    177. 

  177. <LI>paragraphs
    178. 

  178. <LI>font beautifiers
    179. 

  179.   <UL>
    180. 

  180.   <LI>bold
    181. 

  181.   <LI>italic
    182. 

  182.   <LI>underline
    183. 

  183.   <LI>strike
    184. 

  184.   </UL>
    185. 

  185. <LI>monospaced font (verbatim)
    186. 

  186.   <UL>
    187. 

  187.   <LI>monospaced inside paragraph
    188. 

  188.   <LI>monospaced line
    189. 

  189.   <LI>monospaced area (multiline)
    190. 

  190.   </UL>
    191. 

  191. <LI>quoted area
    192. 

  192. <LI>link
    193. 

  193.   <UL>
    194. 

  194.   <LI>URL/Internet links
    195. 

  195.   <LI>e-mail links
    196. 

  196.   <LI>local links
    197. 

  197.   <LI>named links
    198. 

  198.   </UL>
    199. 

  199. <LI>lists
    200. 

  200.   <UL>
    201. 

  201.   <LI>bulleted list
    202. 

  202.   <LI>numbered list
    203. 

  203.   <LI>definition list
    204. 

  204.   </UL>
    205. 

  205. <LI>horizontal separator line
    206. 

  206. <LI>image (with smart alignment)
    207. 

  207. <LI>table (with or without border, smart alignment, column span)
    208. 

  208. <LI>macros (with flexible formatting):
    209. 

  209.   <UL>
    210. 

  210.   <LI>current date
    211. 

  211.   <LI>file modification time
    212. 

  212.   <LI>input and output file name and path
    213. 

  213.   <LI>automatic table of contents
    214. 

  214.   </UL>
    215. 

  215. <LI>special mark for raw text (no marks parsed inside)
    216. 

  216. <LI>special mark for tagged text (no parsing, sent directly to output)
    217. 

  217. <LI>comments (for self notes, TODO, FIXME)
    218. 

  218. </UL>
    219. 

  219. 

  220. <A NAME="targets"></A>
    221. 

  221. <H2>Supported Targets</H2>
    222. 

  222. 

  223. <H3>Wiki</H3>
    224. 

  224. 

  225. <DL>
    226. 

  226. <DT><B>adoc</B></DT><DD>
    227. 

  227.   AsciiDoc document
    228. 

  228. <P></P>
    229. 

  229. <DT><B>bbcode</B></DT><DD>
    230. 

  230.   BBCode document
    231. 

  231. <P></P>
    232. 

  232. <DT><B>creole</B></DT><DD>
    233. 

  233.   Creole 1.0 document
    234. 

  234. <P></P>
    235. 

  235. <DT><B>DOKU</B></DT><DD>
    236. 

  236.   <A HREF="http://www.dokuwiki.org/dokuwiki">DokuWiki</A> is a standards
    237. 

  237.   compliant, simple to use Wiki, mainly aimed at creating documentation
    238. 

  238.   of any kind. It is targeted at developer teams, workgroups and small
    239. 

  239.   companies. It has a simple but powerful syntax which makes sure the
    240. 

  240.   data files remain readable outside the Wiki and eases the creation of
    241. 

  241.   structured texts. All data is stored in plain text files - no
    242. 

  242.   database is required.
    243. 

  243. </DL>
    244. 

  244. 

  245. <DL>
    246. 

  246. <DT><B>Foswiki / TWiki</B></DT><DD>
    247. 

  247.   <A HREF="http://foswiki.org/">Foswiki</A> or <A HREF="http://twiki.org">TWiki</A>, is a flexible, powerful, 
    248. 

  248.   and easy to use enterprise wiki and collaboration platform. 
    249. 

  249.   The structured wiki is typically used to run a project development 
    250. 

  250.   space, a document management system, a knowledge base, or any other 
    251. 

  251.   groupware tool, on an intranet or on the internet.
    252. 

  252. <P></P>
    253. 

  253. <DT><B>GWIKI</B></DT><DD>
    254. 

  254.   Now you can easily paste your project's current documentation into the
    255. 

  255.   <A HREF="http://code.google.com/">Google Code</A> Wiki.
    256. 

  256. <P></P>
    257. 

  257. <DT><B>md</B></DT><DD>
    258. 

  258.   Markdown document
    259. 

  259. <P></P>
    260. 

  260. <DT><B>MOIN</B></DT><DD>
    261. 

  261.   You don't know what <A HREF="http://moinmo.in/">MoinMoin</A> is?
    262. 

  262.   It is a <A HREF="http://www.c2.com/cgi/wiki">WikiWiki</A>!
    263. 

  263. <P></P>
    264. 

  264.   Moin syntax is kinda boring when you need to keep
    265. 

  265.   <CODE>{{{'''''adding braces and quotes'''''}}}</CODE>, so txt2tags comes with the
    266. 

  266.   simplified marks and unified solution: one source, multi targets.
    267. 

  267. <P></P>
    268. 

  268. <DT><B><A HREF="http://en.wikipedia.org/wiki/PmWiki">PMWIKI</A></B></DT><DD>
    269. 

  269.   <A HREF="http://www.pmwiki.org/">PmWiki</A> is a light and free wiki software written in PHP, and using no SQL database.
    270. 

  270. <P></P>
    271. 

  271. <DT><B>red</B> </DT><DD>
    272. 

  272.   Redmine Wiki page
    273. 

  273. <P></P>
    274. 

  274. <DT><B>rst</B></DT><DD>
    275. 

  275.   ReStructuredText document
    276. 

  276. <P></P>
    277. 

  277. <DT><B>spip</B></DT><DD>
    278. 

  278.   SPIP article
    279. 

  279. <P></P>
    280. 

  280. <DT><B>txt2t</B></DT><DD>
    281. 

  281.   Txt2tags document
    282. 

  282. <P></P>
    283. 

  283. <DT><B>WIKI</B></DT><DD>
    284. 

  284.   You've heard about the <A HREF="http://wikipedia.org">Wikipedia</A>, right? So you
    285. 

  285.   don't need to learn yet-another markup syntax. Just stick with txt2tags
    286. 

  286.   and let it convert your text to the Wikipedia format, called
    287. 

  287.   <A HREF="http://en.wikipedia.org/wiki/MediaWiki">MediaWiki</A>.
    288. 

  288. </DL>
    289. 

  289. 

  290. <H3>HTML</H3>
    291. 

  291. 

  292. <DL>
    293. 

  293. <DT><B>aapw</B></DT><DD>
    294. 

  294.   ASCII Art Presentation Web
    295. 

  295. <P></P>
    296. 

  296. <DT><B>aasw</B></DT><DD>
    297. 

  297.   ASCII Art Spreadsheet Web
    298. 

  298. <P></P>
    299. 

  299. <DT><B>aatw</B></DT><DD>
    300. 

  300.   ASCII Art Text Web
    301. 

  301. <P></P>
    302. 

  302. <DT><B><A HREF="http://en.wikipedia.org/wiki/HTML">HTML</A></B></DT><DD>
    303. 

  303.   You maybe know what HTML is. (hint: Internet)
    304. 

  304. <P></P>
    305. 

  305.   Txt2tags generates clean HTML documents, that look pretty and have
    306. 

  306.   its source readable. It DOES NOT use javascript, frames or other
    307. 

  307.   futile formatting techniques, that aren't required for simple, techie
    308. 

  308.   documents. But a separate CSS file can be used if wanted. Txt2tags
    309. 

  309.   generates "<I>HTML 4.0 Transitional</I>" code.
    310. 

  310. <P></P>
    311. 

  311.   Txt2tags HTML generated code is 100% approved by the <A HREF="http://validator.w3.org/">w3c validator</A>.
    312. 

  312. <P></P>
    313. 

  313. <DT><B>html5</B></DT><DD>
    314. 

  314.   HTML5 page
    315. 

  315. <P></P>
    316. 

  316. <DT><B>htmls</B></DT><DD>
    317. 

  317.   HTML Spreadsheet
    318. 

  318. <P></P>
    319. 

  319. <DT><B>wp</B></DT><DD>
    320. 

  320.   WordPress post
    321. 

  321. <P></P>
    322. 

  322. <DT><B><A HREF="http://en.wikipedia.org/wiki/XHTML">XHTML</A></B></DT><DD>
    323. 

  323.   It is the new generation of HTML, with more strict rules.
    324. 

  324.   This makes the code easier to parse and
    325. 

  325.   understand. For the general purpose, consider it HTML. Txt2tags
    326. 

  326.   generates "<I>XHTML 1.0 Transitional</I>" code.
    327. 

  327. <P></P>
    328. 

  328.   Txt2tags XHTML generated code is 100% approved by the <A HREF="http://validator.w3.org/">w3c validator</A>.
    329. 

  329. <P></P>
    330. 

  330. <DT><B>xhtmls</B></DT><DD>
    331. 

  331.   XHTML Strict page
    332. 

  332. </DL>
    333. 

  333. 

  334. <H3>Office</H3>
    335. 

  335. 

  336. <DL>
    337. 

  337. <DT><B>csv</B></DT><DD>
    338. 

  338.   CSV spreadsheet
    339. 

  339. <P></P>
    340. 

  340. <DT><B>db</B></DT><DD>
    341. 

  341.   SQLite database
    342. 

  342. <P></P>
    343. 

  343. <DT><B>dbk</B></DT><DD>
    344. 

  344.   DocBook document
    345. 

  345. <P></P>
    346. 

  346. <DT><B>LOUT</B></DT><DD>
    347. 

  347.   Very similar to LaTeX in power, but with an easier syntax using "@"
    348. 

  348.   instead "\" and avoiding the need of braces in common situations. Its
    349. 

  349.   approach of everything-is-an-object makes the tagging much saner.
    350. 

  350. <P></P>
    351. 

  351.   Txt2tags generates ready-to-use Lout files, which can be converted do
    352. 

  352.   PS or PDF files using the "lout" command.
    353. 

  353. <P></P>
    354. 

  354. <DT><B>MGP</B></DT><DD>
    355. 

  355.   <A HREF="http://en.wikipedia.org/wiki/MagicPoint">MagicPoint</A> is a very handy presentation tool
    356. 

  356.   (hint: Microsoft PowerPoint), that uses a tagged language to define all
    357. 

  357.   the screens. So you can do complex presentations in vi/emacs/notepad.
    358. 

  358. <P></P>
    359. 

  359.   Txt2tags generates a ready-to-use .mgp file, defining all the
    360. 

  360.   necessary headers for fonts and appearance definitions, as long as
    361. 

  361.   international characters support.
    362. 

  362. <P></P>
    363. 

  363.   Txt2tags creates "diet" .mgp files: they use the Type1 fonts, so you do not
    364. 

  364.   need to carry TrueType fonts files with your presentation. Also, the color
    365. 

  365.   definitions are simple, so even on a poor color palette system (such as
    366. 

  366.   <CODE>startx -- -bpp 8</CODE>), the presentation will look pretty!
    367. 

  367. <P></P>
    368. 

  368.   The key is: convert and use. No quick fixes or requirements needed.
    369. 

  369. <P></P>
    370. 

  370. <DT><B>ods</B></DT><DD>
    371. 

  371.   Open Document Spreadsheet
    372. 

  372. <P></P>
    373. 

  373. <DT><B>PM6</B></DT><DD>
    374. 

  374.   Adobe PageMaker 6.0 has its own tagged
    375. 

  375.   language. Styles, color table, beautifiers, and most of all the
    376. 

  376.   PageMaker mouse-clicking features are also available on its tagged language.
    377. 

  377.   You just need to access the "Import tagged text" menu item. Just for
    378. 

  378.   the records, it's an &lt;HTML "like"&gt; tag format.
    379. 

  379. <P></P>
    380. 

  380.   Txt2tags generates all the tags and already defines a extensive and
    381. 

  381.   working header, setting paragraph styles and formatting. This is the
    382. 

  382.   hard part.
    383. 

  383. <P></P>
    384. 

  384.   <B>Author's note:</B>
    385. 

  385.   My entire portuguese <A HREF="http://guia-er.sf.net">regular expression's book</A>
    386. 

  386.   was written in VI, then converted to PageMaker with txt2tags and went to
    387. 

  387.   the publisher. It works :)
    388. 

  388. <P></P>
    389. 

  389. <DT><B>rtf</B></DT><DD>
    390. 

  390.   RTF document
    391. 

  391. <P></P>
    392. 

  392. <DT><B><A HREF="http://en.wikipedia.org/wiki/SGML">SGML</A></B></DT><DD>
    393. 

  393.   It is a common document format which has powerful conversion applications
    394. 

  394.   (<A HREF="http://packages.debian.org/linuxdoc-tools">linuxdoc-tools</A>). From a
    395. 

  395.   single SGML file you can generate HTML, PDF, PostScript, Info, LaTeX, LyX, RTF
    396. 

  396.   and XML documents. The tools also does automatic TOC and break
    397. 

  397.   sections into subpages.
    398. 

  398. <P></P>
    399. 

  399.   Txt2tags generates SGML files in the LinuxDoc system type, ready to
    400. 

  400.   be converted with linuxdoc-tools without any extra catalog files or any
    401. 

  401.   SGML annoying requirements.
    402. 

  402. <P></P>
    403. 

  403. <DT><B><A HREF="http://en.wikipedia.org/wiki/LaTeX">LATEX</A></B></DT><DD>
    404. 

  404.   The preferred academic document format, it is more powerful than you
    405. 

  405.   ever wondered. Full books, complicated formulas and any complex text
    406. 

  406.   can be written in LaTeX. But prepare to loose your hair when you try
    407. 

  407.   to write the tags by hand...
    408. 

  408. <P></P>
    409. 

  409.   Txt2tags generates ready-to-use LaTeX files, doing all the complex
    410. 

  410.   escaping tricks and exceptions. The writer just need to worry about
    411. 

  411.   the text.
    412. 

  412. <P></P>
    413. 

  413. <DT><B>texs</B></DT><DD>
    414. 

  414.   LaTeX Spreadsheet
    415. 

  415. </DL>
    416. 

  416. 

  417. <H3>Text</H3>
    418. 

  418. 

  419. <DL>
    420. 

  420. <DT><B>aap</B></DT><DD>
    421. 

  421.   ASCII Art Presentation
    422. 

  422. <P></P>
    423. 

  423. <DT><B>aas</B></DT><DD>
    424. 

  424.   ASCII Art Spreadsheet
    425. 

  425. <P></P>
    426. 

  426. <DT><B>aat</B></DT><DD>
    427. 

  427.   ASCII Art Text
    428. 

  428. <P></P>
    429. 

  429. <DT><B>MAN</B></DT><DD>
    430. 

  430.   UNIX man pages resist over the years. Document formats come and go,
    431. 

  431.   and there they are, unbeatable.
    432. 

  432. <P></P>
    433. 

  433.   There are other tools to generate man documents, but txt2tags has
    434. 

  434.   one advantage: one source, multi targets. So the same man page
    435. 

  435.   contents can be converted to an HTML page, Wiki document and plain text.
    436. 

  436. <P></P>
    437. 

  437. <DT><B>TXT</B></DT><DD>
    438. 

  438.   TXT is text. Simple, pure, beautiful.
    439. 

  439. <P></P>
    440. 

  440.   Although txt2tags marks are very intuitive and discrete, you can remove
    441. 

  441.   them by converting the file to pure TXT.
    442. 

  442. <P></P>
    443. 

  443.   The titles are underlined, and the text is basically left as is on the
    444. 

  444.   source.
    445. 

  445. </DL>
    446. 

  446. 

  447. <P>
    448. 

  448. Tip: Use the <CODE>--targets</CODE> command line option to get a complete list of
    449. 

  449. all the available targets.
    450. 

  450. </P>
    451. 

  451. 

  452. <A NAME="struct-support"></A>
    453. 

  453. <H2>Status of Supported Structures by Target</H2>
    454. 

  454. 

  455. <TABLE ALIGN="center" BORDER="1">
    456. 

  456. <TR>
    457. 

  457. <TH>Structure</TH>
    458. 

  458. <TH>html</TH>
    459. 

  459. <TH>xhtml</TH>
    460. 

  460. <TH>sgml</TH>
    461. 

  461. <TH>dbk</TH>
    462. 

  462. <TH>tex</TH>
    463. 

  463. <TH>lout</TH>
    464. 

  464. <TH>man</TH>
    465. 

  465. <TH>mgp</TH>
    466. 

  466. <TH>creole</TH>
    467. 

  467. <TH>wiki</TH>
    468. 

  468. <TH>gwiki</TH>
    469. 

  469. <TH>pmw</TH>
    470. 

  470. <TH>doku</TH>
    471. 

  471. <TH>moin</TH>
    472. 

  472. <TH>pm6</TH>
    473. 

  473. <TH>adoc</TH>
    474. 

  474. <TH>art</TH>
    475. 

  475. <TH>txt</TH>
    476. 

  476. <TH>tml</TH>
    477. 

  477. </TR>
    478. 

  478. <TR>
    479. 

  479. <TD>headers</TD>
    480. 

  480. <TD ALIGN="center">Y</TD>
    481. 

  481. <TD ALIGN="center">Y</TD>
    482. 

  482. <TD ALIGN="center">Y</TD>
    483. 

  483. <TD ALIGN="center">Y</TD>
    484. 

  484. <TD ALIGN="center">Y</TD>
    485. 

  485. <TD ALIGN="center">Y</TD>
    486. 

  486. <TD ALIGN="center">Y</TD>
    487. 

  487. <TD ALIGN="center">Y</TD>
    488. 

  488. <TD ALIGN="center">-</TD>
    489. 

  489. <TD ALIGN="center">-</TD>
    490. 

  490. <TD ALIGN="center">-</TD>
    491. 

  491. <TD ALIGN="center">Y</TD>
    492. 

  492. <TD ALIGN="center">-</TD>
    493. 

  493. <TD ALIGN="center">-</TD>
    494. 

  494. <TD ALIGN="center">N</TD>
    495. 

  495. <TD ALIGN="center">-</TD>
    496. 

  496. <TD ALIGN="center">Y</TD>
    497. 

  497. <TD ALIGN="center">Y</TD>
    498. 

  498. <TD ALIGN="center">Y</TD>
    499. 

  499. </TR>
    500. 

  500. <TR>
    501. 

  501. <TD>section title</TD>
    502. 

  502. <TD ALIGN="center">Y</TD>
    503. 

  503. <TD ALIGN="center">Y</TD>
    504. 

  504. <TD ALIGN="center">Y</TD>
    505. 

  505. <TD ALIGN="center">Y</TD>
    506. 

  506. <TD ALIGN="center">Y</TD>
    507. 

  507. <TD ALIGN="center">Y</TD>
    508. 

  508. <TD ALIGN="center">Y</TD>
    509. 

  509. <TD ALIGN="center">Y</TD>
    510. 

  510. <TD ALIGN="center">Y</TD>
    511. 

  511. <TD ALIGN="center">Y</TD>
    512. 

  512. <TD ALIGN="center">Y</TD>
    513. 

  513. <TD ALIGN="center">Y</TD>
    514. 

  514. <TD ALIGN="center">Y</TD>
    515. 

  515. <TD ALIGN="center">Y</TD>
    516. 

  516. <TD ALIGN="center">Y</TD>
    517. 

  517. <TD ALIGN="center">Y</TD>
    518. 

  518. <TD ALIGN="center">Y</TD>
    519. 

  519. <TD ALIGN="center">Y</TD>
    520. 

  520. <TD ALIGN="center">Y</TD>
    521. 

  521. </TR>
    522. 

  522. <TR>
    523. 

  523. <TD>paragraphs</TD>
    524. 

  524. <TD ALIGN="center">Y</TD>
    525. 

  525. <TD ALIGN="center">Y</TD>
    526. 

  526. <TD ALIGN="center">Y</TD>
    527. 

  527. <TD ALIGN="center">Y</TD>
    528. 

  528. <TD ALIGN="center">Y</TD>
    529. 

  529. <TD ALIGN="center">Y</TD>
    530. 

  530. <TD ALIGN="center">Y</TD>
    531. 

  531. <TD ALIGN="center">Y</TD>
    532. 

  532. <TD ALIGN="center">Y</TD>
    533. 

  533. <TD ALIGN="center">Y</TD>
    534. 

  534. <TD ALIGN="center">Y</TD>
    535. 

  535. <TD ALIGN="center">Y</TD>
    536. 

  536. <TD ALIGN="center">Y</TD>
    537. 

  537. <TD ALIGN="center">Y</TD>
    538. 

  538. <TD ALIGN="center">Y</TD>
    539. 

  539. <TD ALIGN="center">Y</TD>
    540. 

  540. <TD ALIGN="center">Y</TD>
    541. 

  541. <TD ALIGN="center">Y</TD>
    542. 

  542. <TD ALIGN="center">Y</TD>
    543. 

  543. </TR>
    544. 

  544. <TR>
    545. 

  545. <TD>bold</TD>
    546. 

  546. <TD ALIGN="center">Y</TD>
    547. 

  547. <TD ALIGN="center">Y</TD>
    548. 

  548. <TD ALIGN="center">Y</TD>
    549. 

  549. <TD ALIGN="center">Y</TD>
    550. 

  550. <TD ALIGN="center">Y</TD>
    551. 

  551. <TD ALIGN="center">Y</TD>
    552. 

  552. <TD ALIGN="center">Y</TD>
    553. 

  553. <TD ALIGN="center">Y</TD>
    554. 

  554. <TD ALIGN="center">Y</TD>
    555. 

  555. <TD ALIGN="center">Y</TD>
    556. 

  556. <TD ALIGN="center">Y</TD>
    557. 

  557. <TD ALIGN="center">Y</TD>
    558. 

  558. <TD ALIGN="center">Y</TD>
    559. 

  559. <TD ALIGN="center">Y</TD>
    560. 

  560. <TD ALIGN="center">Y</TD>
    561. 

  561. <TD ALIGN="center">Y</TD>
    562. 

  562. <TD ALIGN="center">-</TD>
    563. 

  563. <TD ALIGN="center">-</TD>
    564. 

  564. <TD ALIGN="center">Y</TD>
    565. 

  565. </TR>
    566. 

  566. <TR>
    567. 

  567. <TD>italic</TD>
    568. 

  568. <TD ALIGN="center">Y</TD>
    569. 

  569. <TD ALIGN="center">Y</TD>
    570. 

  570. <TD ALIGN="center">Y</TD>
    571. 

  571. <TD ALIGN="center">Y</TD>
    572. 

  572. <TD ALIGN="center">Y</TD>
    573. 

  573. <TD ALIGN="center">Y</TD>
    574. 

  574. <TD ALIGN="center">Y</TD>
    575. 

  575. <TD ALIGN="center">Y</TD>
    576. 

  576. <TD ALIGN="center">Y</TD>
    577. 

  577. <TD ALIGN="center">Y</TD>
    578. 

  578. <TD ALIGN="center">Y</TD>
    579. 

  579. <TD ALIGN="center">Y</TD>
    580. 

  580. <TD ALIGN="center">Y</TD>
    581. 

  581. <TD ALIGN="center">Y</TD>
    582. 

  582. <TD ALIGN="center">Y</TD>
    583. 

  583. <TD ALIGN="center">Y</TD>
    584. 

  584. <TD ALIGN="center">-</TD>
    585. 

  585. <TD ALIGN="center">-</TD>
    586. 

  586. <TD ALIGN="center">Y</TD>
    587. 

  587. </TR>
    588. 

  588. <TR>
    589. 

  589. <TD>underline</TD>
    590. 

  590. <TD ALIGN="center">Y</TD>
    591. 

  591. <TD ALIGN="center">Y</TD>
    592. 

  592. <TD ALIGN="center">-</TD>
    593. 

  593. <TD ALIGN="center">Y</TD>
    594. 

  594. <TD ALIGN="center">Y</TD>
    595. 

  595. <TD ALIGN="center">Y</TD>
    596. 

  596. <TD ALIGN="center">-</TD>
    597. 

  597. <TD ALIGN="center">Y</TD>
    598. 

  598. <TD ALIGN="center">-</TD>
    599. 

  599. <TD ALIGN="center">Y</TD>
    600. 

  600. <TD ALIGN="center">-</TD>
    601. 

  601. <TD ALIGN="center">Y</TD>
    602. 

  602. <TD ALIGN="center">Y</TD>
    603. 

  603. <TD ALIGN="center">Y</TD>
    604. 

  604. <TD ALIGN="center">Y</TD>
    605. 

  605. <TD ALIGN="center">N</TD>
    606. 

  606. <TD ALIGN="center">-</TD>
    607. 

  607. <TD ALIGN="center">-</TD>
    608. 

  608. <TD ALIGN="center">Y</TD>
    609. 

  609. </TR>
    610. 

  610. <TR>
    611. 

  611. <TD>strike</TD>
    612. 

  612. <TD ALIGN="center">Y</TD>
    613. 

  613. <TD ALIGN="center">Y</TD>
    614. 

  614. <TD ALIGN="center">N</TD>
    615. 

  615. <TD ALIGN="center">N</TD>
    616. 

  616. <TD ALIGN="center">Y</TD>
    617. 

  617. <TD ALIGN="center">-</TD>
    618. 

  618. <TD ALIGN="center">-</TD>
    619. 

  619. <TD ALIGN="center">-</TD>
    620. 

  620. <TD ALIGN="center">-</TD>
    621. 

  621. <TD ALIGN="center">Y</TD>
    622. 

  622. <TD ALIGN="center">Y</TD>
    623. 

  623. <TD ALIGN="center">Y</TD>
    624. 

  624. <TD ALIGN="center">Y</TD>
    625. 

  625. <TD ALIGN="center">Y</TD>
    626. 

  626. <TD ALIGN="center">N</TD>
    627. 

  627. <TD ALIGN="center">N</TD>
    628. 

  628. <TD ALIGN="center">-</TD>
    629. 

  629. <TD ALIGN="center">-</TD>
    630. 

  630. <TD ALIGN="center">Y</TD>
    631. 

  631. </TR>
    632. 

  632. <TR>
    633. 

  633. <TD>monospaced font</TD>
    634. 

  634. <TD ALIGN="center">Y</TD>
    635. 

  635. <TD ALIGN="center">Y</TD>
    636. 

  636. <TD ALIGN="center">Y</TD>
    637. 

  637. <TD ALIGN="center">Y</TD>
    638. 

  638. <TD ALIGN="center">Y</TD>
    639. 

  639. <TD ALIGN="center">Y</TD>
    640. 

  640. <TD ALIGN="center">-</TD>
    641. 

  641. <TD ALIGN="center">Y</TD>
    642. 

  642. <TD ALIGN="center">-</TD>
    643. 

  643. <TD ALIGN="center">Y</TD>
    644. 

  644. <TD ALIGN="center">Y</TD>
    645. 

  645. <TD ALIGN="center">Y</TD>
    646. 

  646. <TD ALIGN="center">Y</TD>
    647. 

  647. <TD ALIGN="center">Y</TD>
    648. 

  648. <TD ALIGN="center">Y</TD>
    649. 

  649. <TD ALIGN="center">Y</TD>
    650. 

  650. <TD ALIGN="center">-</TD>
    651. 

  651. <TD ALIGN="center">-</TD>
    652. 

  652. <TD ALIGN="center">Y</TD>
    653. 

  653. </TR>
    654. 

  654. <TR>
    655. 

  655. <TD>verbatim line</TD>
    656. 

  656. <TD ALIGN="center">Y</TD>
    657. 

  657. <TD ALIGN="center">Y</TD>
    658. 

  658. <TD ALIGN="center">Y</TD>
    659. 

  659. <TD ALIGN="center">Y</TD>
    660. 

  660. <TD ALIGN="center">Y</TD>
    661. 

  661. <TD ALIGN="center">Y</TD>
    662. 

  662. <TD ALIGN="center">Y</TD>
    663. 

  663. <TD ALIGN="center">Y</TD>
    664. 

  664. <TD ALIGN="center">Y</TD>
    665. 

  665. <TD ALIGN="center">Y</TD>
    666. 

  666. <TD ALIGN="center">Y</TD>
    667. 

  667. <TD ALIGN="center">Y</TD>
    668. 

  668. <TD ALIGN="center">Y</TD>
    669. 

  669. <TD ALIGN="center">Y</TD>
    670. 

  670. <TD ALIGN="center">Y</TD>
    671. 

  671. <TD ALIGN="center">Y</TD>
    672. 

  672. <TD ALIGN="center">-</TD>
    673. 

  673. <TD ALIGN="center">-</TD>
    674. 

  674. <TD ALIGN="center">-</TD>
    675. 

  675. </TR>
    676. 

  676. <TR>
    677. 

  677. <TD>verbatim area</TD>
    678. 

  678. <TD ALIGN="center">Y</TD>
    679. 

  679. <TD ALIGN="center">Y</TD>
    680. 

  680. <TD ALIGN="center">Y</TD>
    681. 

  681. <TD ALIGN="center">Y</TD>
    682. 

  682. <TD ALIGN="center">Y</TD>
    683. 

  683. <TD ALIGN="center">Y</TD>
    684. 

  684. <TD ALIGN="center">Y</TD>
    685. 

  685. <TD ALIGN="center">Y</TD>
    686. 

  686. <TD ALIGN="center">Y</TD>
    687. 

  687. <TD ALIGN="center">Y</TD>
    688. 

  688. <TD ALIGN="center">Y</TD>
    689. 

  689. <TD ALIGN="center">Y</TD>
    690. 

  690. <TD ALIGN="center">Y</TD>
    691. 

  691. <TD ALIGN="center">Y</TD>
    692. 

  692. <TD ALIGN="center">Y</TD>
    693. 

  693. <TD ALIGN="center">Y</TD>
    694. 

  694. <TD ALIGN="center">-</TD>
    695. 

  695. <TD ALIGN="center">-</TD>
    696. 

  696. <TD ALIGN="center">Y</TD>
    697. 

  697. </TR>
    698. 

  698. <TR>
    699. 

  699. <TD>quoted area</TD>
    700. 

  700. <TD ALIGN="center">Y</TD>
    701. 

  701. <TD ALIGN="center">Y</TD>
    702. 

  702. <TD ALIGN="center">Y</TD>
    703. 

  703. <TD ALIGN="center">Y</TD>
    704. 

  704. <TD ALIGN="center">Y</TD>
    705. 

  705. <TD ALIGN="center">Y</TD>
    706. 

  706. <TD ALIGN="center">Y</TD>
    707. 

  707. <TD ALIGN="center">Y</TD>
    708. 

  708. <TD ALIGN="center">Y</TD>
    709. 

  709. <TD ALIGN="center">Y</TD>
    710. 

  710. <TD ALIGN="center">Y</TD>
    711. 

  711. <TD ALIGN="center">Y</TD>
    712. 

  712. <TD ALIGN="center">Y</TD>
    713. 

  713. <TD ALIGN="center">Y</TD>
    714. 

  714. <TD ALIGN="center">Y</TD>
    715. 

  715. <TD ALIGN="center">N</TD>
    716. 

  716. <TD ALIGN="center">Y</TD>
    717. 

  717. <TD ALIGN="center">Y</TD>
    718. 

  718. <TD ALIGN="center">-</TD>
    719. 

  719. </TR>
    720. 

  720. <TR>
    721. 

  721. <TD>internet links</TD>
    722. 

  722. <TD ALIGN="center">Y</TD>
    723. 

  723. <TD ALIGN="center">Y</TD>
    724. 

  724. <TD ALIGN="center">Y</TD>
    725. 

  725. <TD ALIGN="center">Y</TD>
    726. 

  726. <TD ALIGN="center">-</TD>
    727. 

  727. <TD ALIGN="center">-</TD>
    728. 

  728. <TD ALIGN="center">-</TD>
    729. 

  729. <TD ALIGN="center">-</TD>
    730. 

  730. <TD ALIGN="center">Y</TD>
    731. 

  731. <TD ALIGN="center">Y</TD>
    732. 

  732. <TD ALIGN="center">Y</TD>
    733. 

  733. <TD ALIGN="center">Y</TD>
    734. 

  734. <TD ALIGN="center">Y</TD>
    735. 

  735. <TD ALIGN="center">Y</TD>
    736. 

  736. <TD ALIGN="center">-</TD>
    737. 

  737. <TD ALIGN="center">Y</TD>
    738. 

  738. <TD ALIGN="center">-</TD>
    739. 

  739. <TD ALIGN="center">-</TD>
    740. 

  740. <TD ALIGN="center">Y</TD>
    741. 

  741. </TR>
    742. 

  742. <TR>
    743. 

  743. <TD>e-mail links</TD>
    744. 

  744. <TD ALIGN="center">Y</TD>
    745. 

  745. <TD ALIGN="center">Y</TD>
    746. 

  746. <TD ALIGN="center">Y</TD>
    747. 

  747. <TD ALIGN="center">Y</TD>
    748. 

  748. <TD ALIGN="center">-</TD>
    749. 

  749. <TD ALIGN="center">-</TD>
    750. 

  750. <TD ALIGN="center">-</TD>
    751. 

  751. <TD ALIGN="center">-</TD>
    752. 

  752. <TD ALIGN="center">Y</TD>
    753. 

  753. <TD ALIGN="center">Y</TD>
    754. 

  754. <TD ALIGN="center">Y</TD>
    755. 

  755. <TD ALIGN="center">Y</TD>
    756. 

  756. <TD ALIGN="center">Y</TD>
    757. 

  757. <TD ALIGN="center">Y</TD>
    758. 

  758. <TD ALIGN="center">-</TD>
    759. 

  759. <TD ALIGN="center">Y</TD>
    760. 

  760. <TD ALIGN="center">-</TD>
    761. 

  761. <TD ALIGN="center">-</TD>
    762. 

  762. <TD ALIGN="center">Y</TD>
    763. 

  763. </TR>
    764. 

  764. <TR>
    765. 

  765. <TD>local links</TD>
    766. 

  766. <TD ALIGN="center">Y</TD>
    767. 

  767. <TD ALIGN="center">Y</TD>
    768. 

  768. <TD ALIGN="center">Y</TD>
    769. 

  769. <TD ALIGN="center">Y</TD>
    770. 

  770. <TD ALIGN="center">N</TD>
    771. 

  771. <TD ALIGN="center">N</TD>
    772. 

  772. <TD ALIGN="center">-</TD>
    773. 

  773. <TD ALIGN="center">-</TD>
    774. 

  774. <TD ALIGN="center">N</TD>
    775. 

  775. <TD ALIGN="center">N</TD>
    776. 

  776. <TD ALIGN="center">N</TD>
    777. 

  777. <TD ALIGN="center">Y</TD>
    778. 

  778. <TD ALIGN="center">Y</TD>
    779. 

  779. <TD ALIGN="center">Y</TD>
    780. 

  780. <TD ALIGN="center">-</TD>
    781. 

  781. <TD ALIGN="center">N</TD>
    782. 

  782. <TD ALIGN="center">-</TD>
    783. 

  783. <TD ALIGN="center">-</TD>
    784. 

  784. <TD ALIGN="center">Y</TD>
    785. 

  785. </TR>
    786. 

  786. <TR>
    787. 

  787. <TD>named links</TD>
    788. 

  788. <TD ALIGN="center">Y</TD>
    789. 

  789. <TD ALIGN="center">Y</TD>
    790. 

  790. <TD ALIGN="center">Y</TD>
    791. 

  791. <TD ALIGN="center">Y</TD>
    792. 

  792. <TD ALIGN="center">-</TD>
    793. 

  793. <TD ALIGN="center">-</TD>
    794. 

  794. <TD ALIGN="center">-</TD>
    795. 

  795. <TD ALIGN="center">-</TD>
    796. 

  796. <TD ALIGN="center">Y</TD>
    797. 

  797. <TD ALIGN="center">Y</TD>
    798. 

  798. <TD ALIGN="center">Y</TD>
    799. 

  799. <TD ALIGN="center">Y</TD>
    800. 

  800. <TD ALIGN="center">Y</TD>
    801. 

  801. <TD ALIGN="center">Y</TD>
    802. 

  802. <TD ALIGN="center">-</TD>
    803. 

  803. <TD ALIGN="center">Y</TD>
    804. 

  804. <TD ALIGN="center">-</TD>
    805. 

  805. <TD ALIGN="center">-</TD>
    806. 

  806. <TD ALIGN="center">Y</TD>
    807. 

  807. </TR>
    808. 

  808. <TR>
    809. 

  809. <TD>bulleted list</TD>
    810. 

  810. <TD ALIGN="center">Y</TD>
    811. 

  811. <TD ALIGN="center">Y</TD>
    812. 

  812. <TD ALIGN="center">Y</TD>
    813. 

  813. <TD ALIGN="center">Y</TD>
    814. 

  814. <TD ALIGN="center">Y</TD>
    815. 

  815. <TD ALIGN="center">Y</TD>
    816. 

  816. <TD ALIGN="center">Y</TD>
    817. 

  817. <TD ALIGN="center">Y</TD>
    818. 

  818. <TD ALIGN="center">Y</TD>
    819. 

  819. <TD ALIGN="center">Y</TD>
    820. 

  820. <TD ALIGN="center">Y</TD>
    821. 

  821. <TD ALIGN="center">Y</TD>
    822. 

  822. <TD ALIGN="center">Y</TD>
    823. 

  823. <TD ALIGN="center">Y</TD>
    824. 

  824. <TD ALIGN="center">Y</TD>
    825. 

  825. <TD ALIGN="center">Y</TD>
    826. 

  826. <TD ALIGN="center">Y</TD>
    827. 

  827. <TD ALIGN="center">Y</TD>
    828. 

  828. <TD ALIGN="center">Y</TD>
    829. 

  829. </TR>
    830. 

  830. <TR>
    831. 

  831. <TD>numbered list</TD>
    832. 

  832. <TD ALIGN="center">Y</TD>
    833. 

  833. <TD ALIGN="center">Y</TD>
    834. 

  834. <TD ALIGN="center">Y</TD>
    835. 

  835. <TD ALIGN="center">Y</TD>
    836. 

  836. <TD ALIGN="center">Y</TD>
    837. 

  837. <TD ALIGN="center">Y</TD>
    838. 

  838. <TD ALIGN="center">Y</TD>
    839. 

  839. <TD ALIGN="center">Y</TD>
    840. 

  840. <TD ALIGN="center">Y</TD>
    841. 

  841. <TD ALIGN="center">Y</TD>
    842. 

  842. <TD ALIGN="center">Y</TD>
    843. 

  843. <TD ALIGN="center">Y</TD>
    844. 

  844. <TD ALIGN="center">Y</TD>
    845. 

  845. <TD ALIGN="center">Y</TD>
    846. 

  846. <TD ALIGN="center">Y</TD>
    847. 

  847. <TD ALIGN="center">Y</TD>
    848. 

  848. <TD ALIGN="center">Y</TD>
    849. 

  849. <TD ALIGN="center">Y</TD>
    850. 

  850. <TD ALIGN="center">Y</TD>
    851. 

  851. </TR>
    852. 

  852. <TR>
    853. 

  853. <TD>definition list</TD>
    854. 

  854. <TD ALIGN="center">Y</TD>
    855. 

  855. <TD ALIGN="center">Y</TD>
    856. 

  856. <TD ALIGN="center">Y</TD>
    857. 

  857. <TD ALIGN="center">Y</TD>
    858. 

  858. <TD ALIGN="center">Y</TD>
    859. 

  859. <TD ALIGN="center">Y</TD>
    860. 

  860. <TD ALIGN="center">Y</TD>
    861. 

  861. <TD ALIGN="center">N</TD>
    862. 

  862. <TD ALIGN="center">Y</TD>
    863. 

  863. <TD ALIGN="center">Y</TD>
    864. 

  864. <TD ALIGN="center">-</TD>
    865. 

  865. <TD ALIGN="center">Y</TD>
    866. 

  866. <TD ALIGN="center">-</TD>
    867. 

  867. <TD ALIGN="center">Y</TD>
    868. 

  868. <TD ALIGN="center">N</TD>
    869. 

  869. <TD ALIGN="center">N</TD>
    870. 

  870. <TD ALIGN="center">Y</TD>
    871. 

  871. <TD ALIGN="center">Y</TD>
    872. 

  872. <TD ALIGN="center">Y</TD>
    873. 

  873. </TR>
    874. 

  874. <TR>
    875. 

  875. <TD>horizontal line</TD>
    876. 

  876. <TD ALIGN="center">Y</TD>
    877. 

  877. <TD ALIGN="center">Y</TD>
    878. 

  878. <TD ALIGN="center">-</TD>
    879. 

  879. <TD ALIGN="center">N</TD>
    880. 

  880. <TD ALIGN="center">Y</TD>
    881. 

  881. <TD ALIGN="center">Y</TD>
    882. 

  882. <TD ALIGN="center">-</TD>
    883. 

  883. <TD ALIGN="center">Y</TD>
    884. 

  884. <TD ALIGN="center">Y</TD>
    885. 

  885. <TD ALIGN="center">Y</TD>
    886. 

  886. <TD ALIGN="center">-</TD>
    887. 

  887. <TD ALIGN="center">Y</TD>
    888. 

  888. <TD ALIGN="center">Y</TD>
    889. 

  889. <TD ALIGN="center">Y</TD>
    890. 

  890. <TD ALIGN="center">N</TD>
    891. 

  891. <TD ALIGN="center">N</TD>
    892. 

  892. <TD ALIGN="center">Y</TD>
    893. 

  893. <TD ALIGN="center">Y</TD>
    894. 

  894. <TD ALIGN="center">Y</TD>
    895. 

  895. </TR>
    896. 

  896. <TR>
    897. 

  897. <TD>image</TD>
    898. 

  898. <TD ALIGN="center">Y</TD>
    899. 

  899. <TD ALIGN="center">Y</TD>
    900. 

  900. <TD ALIGN="center">Y</TD>
    901. 

  901. <TD ALIGN="center">Y</TD>
    902. 

  902. <TD ALIGN="center">Y</TD>
    903. 

  903. <TD ALIGN="center">Y</TD>
    904. 

  904. <TD ALIGN="center">-</TD>
    905. 

  905. <TD ALIGN="center">Y</TD>
    906. 

  906. <TD ALIGN="center">Y</TD>
    907. 

  907. <TD ALIGN="center">Y</TD>
    908. 

  908. <TD ALIGN="center">Y</TD>
    909. 

  909. <TD ALIGN="center">Y</TD>
    910. 

  910. <TD ALIGN="center">Y</TD>
    911. 

  911. <TD ALIGN="center">Y</TD>
    912. 

  912. <TD ALIGN="center">N</TD>
    913. 

  913. <TD ALIGN="center">Y</TD>
    914. 

  914. <TD ALIGN="center">-</TD>
    915. 

  915. <TD ALIGN="center">-</TD>
    916. 

  916. <TD ALIGN="center">Y</TD>
    917. 

  917. </TR>
    918. 

  918. <TR>
    919. 

  919. <TD>table</TD>
    920. 

  920. <TD ALIGN="center">Y</TD>
    921. 

  921. <TD ALIGN="center">Y</TD>
    922. 

  922. <TD ALIGN="center">Y</TD>
    923. 

  923. <TD ALIGN="center">N</TD>
    924. 

  924. <TD ALIGN="center">Y</TD>
    925. 

  925. <TD ALIGN="center">N</TD>
    926. 

  926. <TD ALIGN="center">Y</TD>
    927. 

  927. <TD ALIGN="center">N</TD>
    928. 

  928. <TD ALIGN="center">Y</TD>
    929. 

  929. <TD ALIGN="center">Y</TD>
    930. 

  930. <TD ALIGN="center">Y</TD>
    931. 

  931. <TD ALIGN="center">Y</TD>
    932. 

  932. <TD ALIGN="center">Y</TD>
    933. 

  933. <TD ALIGN="center">Y</TD>
    934. 

  934. <TD ALIGN="center">N</TD>
    935. 

  935. <TD ALIGN="center">N</TD>
    936. 

  936. <TD ALIGN="center">N</TD>
    937. 

  937. <TD ALIGN="center">N</TD>
    938. 

  938. <TD ALIGN="center">Y</TD>
    939. 

  939. </TR>
    940. 

  940. <TR>
    941. 

  941. <TH>Extras</TH>
    942. 

  942. <TH>html</TH>
    943. 

  943. <TH>xhtml</TH>
    944. 

  944. <TH>sgml</TH>
    945. 

  945. <TH>dbk</TH>
    946. 

  946. <TH>tex</TH>
    947. 

  947. <TH>lout</TH>
    948. 

  948. <TH>man</TH>
    949. 

  949. <TH>mgp</TH>
    950. 

  950. <TH>creole</TH>
    951. 

  951. <TH>wiki</TH>
    952. 

  952. <TH>gwiki</TH>
    953. 

  953. <TH>pmw</TH>
    954. 

  954. <TH>doku</TH>
    955. 

  955. <TH>moin</TH>
    956. 

  956. <TH>pm6</TH>
    957. 

  957. <TH>adoc</TH>
    958. 

  958. <TH>art</TH>
    959. 

  959. <TH>txt</TH>
    960. 

  960. <TH>Y</TH>
    961. 

  961. </TR>
    962. 

  962. <TR>
    963. 

  963. <TD>image align</TD>
    964. 

  964. <TD ALIGN="center">Y</TD>
    965. 

  965. <TD ALIGN="center">Y</TD>
    966. 

  966. <TD ALIGN="center">N</TD>
    967. 

  967. <TD ALIGN="center">N</TD>
    968. 

  968. <TD ALIGN="center">N</TD>
    969. 

  969. <TD ALIGN="center">Y</TD>
    970. 

  970. <TD ALIGN="center">-</TD>
    971. 

  971. <TD ALIGN="center">Y</TD>
    972. 

  972. <TD ALIGN="center">N</TD>
    973. 

  973. <TD ALIGN="center">Y</TD>
    974. 

  974. <TD ALIGN="center">-</TD>
    975. 

  975. <TD ALIGN="center">N</TD>
    976. 

  976. <TD ALIGN="center">Y</TD>
    977. 

  977. <TD ALIGN="center">N</TD>
    978. 

  978. <TD ALIGN="center">N</TD>
    979. 

  979. <TD ALIGN="center">N</TD>
    980. 

  980. <TD ALIGN="center">-</TD>
    981. 

  981. <TD ALIGN="center">-</TD>
    982. 

  982. <TD ALIGN="center">Y</TD>
    983. 

  983. </TR>
    984. 

  984. <TR>
    985. 

  985. <TD>table cell align</TD>
    986. 

  986. <TD ALIGN="center">Y</TD>
    987. 

  987. <TD ALIGN="center">Y</TD>
    988. 

  988. <TD ALIGN="center">Y</TD>
    989. 

  989. <TD ALIGN="center">N</TD>
    990. 

  990. <TD ALIGN="center">Y</TD>
    991. 

  991. <TD ALIGN="center">N</TD>
    992. 

  992. <TD ALIGN="center">Y</TD>
    993. 

  993. <TD ALIGN="center">N</TD>
    994. 

  994. <TD ALIGN="center">N</TD>
    995. 

  995. <TD ALIGN="center">N</TD>
    996. 

  996. <TD ALIGN="center">-</TD>
    997. 

  997. <TD ALIGN="center">N</TD>
    998. 

  998. <TD ALIGN="center">-</TD>
    999. 

  999. <TD ALIGN="center">Y</TD>
    1000. 

  1000. <TD ALIGN="center">N</TD>
    1001. 

  1001. <TD ALIGN="center">N</TD>
    1002. 

  1002. <TD ALIGN="center">N</TD>
    1003. 

  1003. <TD ALIGN="center">N</TD>
    1004. 

  1004. <TD ALIGN="center">Y</TD>
    1005. 

  1005. </TR>
    1006. 

  1006. <TR>
    1007. 

  1007. <TD>table column span</TD>
    1008. 

  1008. <TD ALIGN="center">Y</TD>
    1009. 

  1009. <TD ALIGN="center">Y</TD>
    1010. 

  1010. <TD ALIGN="center">N</TD>
    1011. 

  1011. <TD ALIGN="center">N</TD>
    1012. 

  1012. <TD ALIGN="center">Y</TD>
    1013. 

  1013. <TD ALIGN="center">N</TD>
    1014. 

  1014. <TD ALIGN="center">N</TD>
    1015. 

  1015. <TD ALIGN="center">N</TD>
    1016. 

  1016. <TD ALIGN="center">N</TD>
    1017. 

  1017. <TD ALIGN="center">N</TD>
    1018. 

  1018. <TD ALIGN="center">-</TD>
    1019. 

  1019. <TD ALIGN="center">N</TD>
    1020. 

  1020. <TD ALIGN="center">-</TD>
    1021. 

  1021. <TD ALIGN="center">N</TD>
    1022. 

  1022. <TD ALIGN="center">N</TD>
    1023. 

  1023. <TD ALIGN="center">N</TD>
    1024. 

  1024. <TD ALIGN="center">N</TD>
    1025. 

  1025. <TD ALIGN="center">N</TD>
    1026. 

  1026. <TD ALIGN="center">Y</TD>
    1027. 

  1027. </TR>
    1028. 

  1028. </TABLE>
    1029. 

  1029. 

  1030. <TABLE ALIGN="center">
    1031. 

  1031. <TR>
    1032. 

  1032. <TH></TH>
    1033. 

  1033. <TH>Legend</TH>
    1034. 

  1034. </TR>
    1035. 

  1035. <TR>
    1036. 

  1036. <TD><B>Y</B></TD>
    1037. 

  1037. <TD><I>Supported</I></TD>
    1038. 

  1038. </TR>
    1039. 

  1039. <TR>
    1040. 

  1040. <TD><B>N</B></TD>
    1041. 

  1041. <TD><I>Not supported (may be in future releases)</I></TD>
    1042. 

  1042. </TR>
    1043. 

  1043. <TR>
    1044. 

  1044. <TD><B>-</B></TD>
    1045. 

  1045. <TD><I>Not supported (can't be done on this target)</I></TD>
    1046. 

  1046. </TR>
    1047. 

  1047. </TABLE>
    1048. 

  1048. 

  1049. <A NAME="interfaces"></A>
    1050. 

  1050. <H2>The Three User Interfaces: Gui, Web and Command Line</H2>
    1051. 

  1051. 

  1052. <P>
    1053. 

  1053. As different users have different needs and environments, txt2tags is
    1054. 

  1054. very flexible on how it runs.
    1055. 

  1055. </P>
    1056. 

  1056. <P>
    1057. 

  1057. There are three User Interfaces for the program, each one with its own
    1058. 

  1058. purpose and features.
    1059. 

  1059. </P>
    1060. 

  1060. 

  1061. <UL>
    1062. 

  1062. <LI><B>Gui</B>: Written in Tk, brings the windowing and clicking to txt2tags.
    1063. 

  1063. <LI><B>Web</B>: Written in PHP, allows users to run txt2tags on the browser,
    1064. 

  1064.            requiring no installation on the client side.
    1065. 

  1065. <LI><B>Command Line</B>: Written in Python, it's the program core. All
    1066. 

  1066.            features are available as command line options.
    1067. 

  1067. </UL>
    1068. 

  1068. 

  1069. <A NAME="gui"></A>
    1070. 

  1070. <H3>Graphical Interface</H3>
    1071. 

  1071. 

  1072. <P>
    1073. 

  1073. Since version 1.0, there is a nice Graphical Interface, that works on
    1074. 

  1074. Linux, Windows, Mac and others. Just call txt2tags with the <CODE>--gui</CODE>
    1075. 

  1075. option to open it.
    1076. 

  1076. </P>
    1077. 

  1077. <P>
    1078. 

  1078. The interface is pretty simple and intuitive:
    1079. 

  1079. </P>
    1080. 

  1080.                      <center><IMG ALIGN="middle" SRC="./gui.png" BORDER="0" ALT=""></center>  
    1081. 

  1081. 

  1082. <OL>
    1083. 

  1083. <LI>You locate the source .t2t file on the disk and its options are
    1084. 

  1084.   loaded.
    1085. 

  1085. <P></P>
    1086. 

  1086. <LI>If the target is still empty, you must choose one.
    1087. 

  1087. <P></P>
    1088. 

  1088. <LI>Then there are some options you may choose, but none of them are
    1089. 

  1089.   required.
    1090. 

  1090. <P></P>
    1091. 

  1091. <LI>Finally, press the "Convert!" button.
    1092. 

  1092. </OL>
    1093. 

  1093. 

  1094. <P>
    1095. 

  1095. A nice option is the "<I>Dump to screen</I>", so you can check
    1096. 

  1096. the resulting code on a separate window, no file is saved at all. When
    1097. 

  1097. the code is OK, you uncheck it and the file will be saved.
    1098. 

  1098. </P>
    1099. 

  1099. <P>
    1100. 

  1100. The default interface colors can be changed on the <A HREF="#rc">configuration file</A>,
    1101. 

  1101. using the <CODE>%!guicolors</CODE> settings. For example:
    1102. 

  1102. </P>
    1103. 

  1103. 

  1104. <PRE>
    1105. 

  1105. % set my own colors for the graphical interface (bg1, fg1, bg2, fg2)
    1106. 

  1106. %!guicolors: blue white brown yellow
    1107. 

  1107. </PRE>
    1108. 

  1108. 

  1109. <H3>Web Interface</H3>
    1110. 

  1110. 

  1111. <P>
    1112. 

  1112. The Web Interface is up and running on the Internet at
    1113. 

  1113. <A HREF="http://txt2tags.org/online.php">http://txt2tags.org/online.php</A>, so you can use and test the program
    1114. 

  1114. instantly, before download.
    1115. 

  1115. </P>
    1116. 

  1116.           <center><IMG ALIGN="middle" SRC="./web.png" BORDER="0" ALT=""></center>  
    1117. 

  1117. <P>
    1118. 

  1118. One can also put this interface on the local intranet avoiding to
    1119. 

  1119. install txt2tags in all machines.
    1120. 

  1120. </P>
    1121. 

  1121. 

  1122. <A NAME="cmdline"></A>
    1123. 

  1123. <H3>Command Line Interface</H3>
    1124. 

  1124. 

  1125. <P>
    1126. 

  1126. For command line power users, the --help should be enough:
    1127. 

  1127. </P>
    1128. 

  1128. 

  1129. <PRE>
    1130. 

  1130. Usage: txt2tags [OPTIONS] [infile.t2t ...]
    1131. 

  1131. 

  1132.       --targets       print a list of all the available targets and exit
    1133. 

  1133.   -t, --target=TYPE   set target document type. currently supported:
    1134. 

  1134.                       adoc, art, creole, dbk, doku, gwiki, html, lout, man,
    1135. 

  1135.                       mgp, moin, pm6, pmw, sgml, tex, txt, wiki, xhtml
    1136. 

  1136.   -i, --infile=FILE   set FILE as the input file name ('-' for STDIN)
    1137. 

  1137.   -o, --outfile=FILE  set FILE as the output file name ('-' for STDOUT)
    1138. 

  1138.       --encoding=ENC  set target file encoding (utf-8, iso-8859-1, etc)
    1139. 

  1139.       --toc           add an automatic Table of Contents to the output
    1140. 

  1140.       --toc-level=N   set maximum TOC level (depth) to N
    1141. 

  1141.       --toc-only      print the Table of Contents and exit
    1142. 

  1142.   -n, --enum-title    enumerate all titles as 1, 1.1, 1.1.1, etc
    1143. 

  1143.       --style=FILE    use FILE as the document style (like HTML CSS)
    1144. 

  1144.       --css-sugar     insert CSS-friendly tags for HTML/XHTML
    1145. 

  1145.       --css-inside    insert CSS file contents inside HTML/XHTML headers
    1146. 

  1146.   -H, --no-headers    suppress header and footer from the output
    1147. 

  1147.       --mask-email    hide email from spam robots. x@y.z turns &lt;x (a) y z&gt;
    1148. 

  1148.       --slides        format output as presentation slides (used by -t art)
    1149. 

  1149.       --width=N       set the output's width to N columns (used by -t art)
    1150. 

  1150.       --height=N      set the output's height to N rows (used by -t art)
    1151. 

  1151.   -C, --config-file=F read configuration from file F
    1152. 

  1152.       --gui           invoke Graphical Tk Interface
    1153. 

  1153.   -q, --quiet         quiet mode, suppress all output (except errors)
    1154. 

  1154.   -v, --verbose       print informative messages during conversion
    1155. 

  1155.   -h, --help          print this help information and exit
    1156. 

  1156.   -V, --version       print program version and exit
    1157. 

  1157.       --dump-config   print all the configuration found and exit
    1158. 

  1158.       --dump-source   print the document source, with includes expanded
    1159. 

  1159. 

  1160. Turn OFF options:
    1161. 

  1161.      --no-css-inside, --no-css-sugar, --no-dump-config, --no-dump-source,
    1162. 

  1162.      --no-encoding, --no-enum-title, --no-headers, --no-infile,
    1163. 

  1163.      --no-mask-email, --no-outfile, --no-quiet, --no-rc, --no-slides,
    1164. 

  1164.      --no-style, --no-targets, --no-toc, --no-toc-only
    1165. 

  1165. 

  1166. Example:
    1167. 

  1167.      txt2tags -t html --toc file.t2t
    1168. 

  1168. 

  1169. By default, converted output is saved to 'infile.&lt;target&gt;'.
    1170. 

  1170. Use --outfile to force an output file name.
    1171. 

  1171. If  input file is '-', reads from STDIN.
    1172. 

  1172. If output file is '-', dumps output to STDOUT.
    1173. 

  1173. </PRE>
    1174. 

  1174. 

  1175. <P>
    1176. 

  1176. Please read the txt2tags man page for detailed information about options and command line use.
    1177. 

  1177. </P>
    1178. 

  1178. <P>
    1179. 

  1179. Examples:
    1180. 

  1180. </P>
    1181. 

  1181. 

  1182. <TABLE>
    1183. 

  1183. <TR>
    1184. 

  1184. <TD><B>Convert to HTML</B></TD>
    1185. 

  1185. <TD><CODE>$ txt2tags -t html file.t2t</CODE></TD>
    1186. 

  1186. </TR>
    1187. 

  1187. <TR>
    1188. 

  1188. <TD><B>The same, using redirection</B></TD>
    1189. 

  1189. <TD><CODE>$ txt2tags -t html -o - file.t2t &gt; file.html</CODE></TD>
    1190. 

  1190. </TR>
    1191. 

  1191. <TR>
    1192. 

  1192. <TD></TD>
    1193. 

  1193. <TD>.</TD>
    1194. 

  1194. </TR>
    1195. 

  1195. <TR>
    1196. 

  1196. <TD><B>Including Table Of Contents</B></TD>
    1197. 

  1197. <TD><CODE>$ txt2tags -t html --toc file.t2t</CODE></TD>
    1198. 

  1198. </TR>
    1199. 

  1199. <TR>
    1200. 

  1200. <TD><B>And also, numbering titles</B></TD>
    1201. 

  1201. <TD><CODE>$ txt2tags -t html --toc --enum-title file.t2t</CODE></TD>
    1202. 

  1202. </TR>
    1203. 

  1203. <TR>
    1204. 

  1204. <TD></TD>
    1205. 

  1205. <TD>.</TD>
    1206. 

  1206. </TR>
    1207. 

  1207. <TR>
    1208. 

  1208. <TD><B>Contents quick view</B></TD>
    1209. 

  1209. <TD><CODE>$ txt2tags --toc-only file.t2t</CODE></TD>
    1210. 

  1210. </TR>
    1211. 

  1211. <TR>
    1212. 

  1212. <TD><B>Maybe enumerate them?</B></TD>
    1213. 

  1213. <TD><CODE>$ txt2tags --toc-only --enum-title file.t2t</CODE></TD>
    1214. 

  1214. </TR>
    1215. 

  1215. <TR>
    1216. 

  1216. <TD></TD>
    1217. 

  1217. <TD>.</TD>
    1218. 

  1218. </TR>
    1219. 

  1219. <TR>
    1220. 

  1220. <TD><B>One liners from STDIN</B></TD>
    1221. 

  1221. <TD><CODE>$ echo -e "\n**bold**" | txt2tags -t html --no-headers -</CODE></TD>
    1222. 

  1222. </TR>
    1223. 

  1223. <TR>
    1224. 

  1224. <TD><B>Testing Mask Email feature</B></TD>
    1225. 

  1225. <TD><CODE>$ echo -e "\njohn.wayne@farwest.com" | txt2tags -t txt --mask-email --no-headers -</CODE></TD>
    1226. 

  1226. </TR>
    1227. 

  1227. </TABLE>
    1228. 

  1228. 

  1229. <A NAME="install"></A>
    1230. 

  1230. <H1>Part II - Install</H1>
    1231. 

  1231. 

  1232. <P>
    1233. 

  1233. Just download the program and run it on your machine.
    1234. 

  1234. </P>
    1235. 

  1235. 

  1236. <A NAME="download-python"></A>
    1237. 

  1237. <H2>Download &amp; Install Python</H2>
    1238. 

  1238. 

  1239. <P>
    1240. 

  1240. First of all, you must download and install <A HREF="http://www.python.org">Python</A> on
    1241. 

  1241. your system. Txt2tags requires Python version 2.2 or newer.
    1242. 

  1242. </P>
    1243. 

  1243. <P>
    1244. 

  1244. Note that Python is already installed by default in Linux and Mac systems. If you're using those, you're done, just skip this step.
    1245. 

  1245. </P>
    1246. 

  1246. <P>
    1247. 

  1247. If you are not sure if you have Python or not, open a console (tty,
    1248. 

  1248. xterm, MSDOS, Terminal.app) and type <CODE>python</CODE>. If it is not installed, the system
    1249. 

  1249. will tell you.
    1250. 

  1250. </P>
    1251. 

  1251. 

  1252. <A NAME="download-txt2tags"></A>
    1253. 

  1253. <H2>Download txt2tags</H2>
    1254. 

  1254. 

  1255. <P>
    1256. 

  1256. The official location for txt2tags distribution is on the program
    1257. 

  1257. site, at <A HREF="http://txt2tags.org">http://txt2tags.org</A>. Just download and uncompress the package (.tgz file).
    1258. 

  1258. </P>
    1259. 

  1259. <P>
    1260. 

  1260. If you're in Linux, you can also use the automatic installer of your system. Some examples:
    1261. 

  1261. </P>
    1262. 

  1262. 

  1263. <UL>
    1264. 

  1264. <LI>yum install txt2tags
    1265. 

  1265. <LI>sudo apt-get install txt2tags
    1266. 

  1266. </UL>
    1267. 

  1267. 

  1268. <A NAME="install-txt2tags"></A>
    1269. 

  1269. <H2>Install txt2tags</H2>
    1270. 

  1270. 

  1271. <P>
    1272. 

  1272. As a single Python script, txt2tags needs no installation at all.
    1273. 

  1273. </P>
    1274. 

  1274. <P>
    1275. 

  1275. The only file needed to use the program is the txt2tags script. The
    1276. 

  1276. other files of the package are documentation, tools and sample files.
    1277. 

  1277. </P>
    1278. 

  1278. <P>
    1279. 

  1279. The fail-proof way to run txt2tags, is calling Python with it:
    1280. 

  1280. </P>
    1281. 

  1281. 

  1282. <PRE>
    1283. 

  1283. prompt$ python txt2tags
    1284. 

  1284. </PRE>
    1285. 

  1285. 

  1286. <P>
    1287. 

  1287. If you want to install txt2tags on the system as a stand alone
    1288. 

  1288. program, just copy the txt2tags script to a system PATH
    1289. 

  1289. directory and make sure the system knows how to run it.
    1290. 

  1290. </P>
    1291. 

  1291. 

  1292. <DL>
    1293. 

  1293. <DT><B>UNIX/Linux/Mac</B></DT><DD>
    1294. 

  1294.   Make the script executable (<CODE>chmod +x txt2tags</CODE>) and copy it to a
    1295. 

  1295.   $PATH directory (<CODE>cp txt2tags /usr/local/bin</CODE>)
    1296. 

  1296. <P></P>
    1297. 

  1297. <DT><B>Windows</B></DT><DD>
    1298. 

  1298.   Rename the script adding the .py extension
    1299. 

  1299.   and copy it to a system PATH directory, such as <CODE>C:\Windows\System32</CODE>.
    1300. 

  1300. </DL>
    1301. 

  1301. 

  1302. <P>
    1303. 

  1303. After that, you can create an icon on your desktop for it, if you want to
    1304. 

  1304. use the program's Graphical Interface.
    1305. 

  1305. </P>
    1306. 

  1306. 

  1307. <A NAME="editor-syntax"></A>
    1308. 

  1308. <H2>Install Text Editor Syntax Highlighting File (optional)</H2>
    1309. 

  1309. 

  1310. <P>
    1311. 

  1311. Txt2tags comes with handy syntax highlighting files to be used by the
    1312. 

  1312. following text editors:
    1313. 

  1313. </P>
    1314. 

  1314. 

  1315. <UL>
    1316. 

  1316. <LI>Vim
    1317. 

  1317. <LI>Emacs
    1318. 

  1318. <LI>Nano
    1319. 

  1319. <LI>Kate
    1320. 

  1320. <LI>Gedit
    1321. 

  1321. <LI>JOE
    1322. 

  1322. <LI>le
    1323. 

  1323. <LI>ne
    1324. 

  1324. <LI>TextMate
    1325. 

  1325. </UL>
    1326. 

  1326. 

  1327. <P>
    1328. 

  1328. This syntax highlighting files have all the txt2tags rules and marks
    1329. 

  1329. registered, helping the user to write error-free documents. Showing the
    1330. 

  1330. marks in colors, you see on-the-fly if you wrote it right.
    1331. 

  1331. </P>
    1332. 

  1332. 

  1333. <TABLE ALIGN="center">
    1334. 

  1334. <TR>
    1335. 

  1335. <TD ALIGN="center"><center><IMG ALIGN="middle" SRC="./vim.png" BORDER="0" ALT=""></center></TD>
    1336. 

  1336. </TR>
    1337. 

  1337. <TR>
    1338. 

  1338. <TD ALIGN="center">Sample file opened in Vim Editor</TD>
    1339. 

  1339. </TR>
    1340. 

  1340. </TABLE>
    1341. 

  1341. 

  1342. <P>
    1343. 

  1343. Each editor has a different install procedure for a syntax highlighting
    1344. 

  1344. file, please read the syntax file headers and the editor documentation.
    1345. 

  1345. </P>
    1346. 

  1346. 

  1347. <A NAME="your-1st-doc"></A>
    1348. 

  1348. <H1>Part III - Writing and Converting Your First Document</H1>
    1349. 

  1349. 

  1350. <H2>Check the Tools</H2>
    1351. 

  1351. 

  1352. <P>
    1353. 

  1353. To make the first conversion you will need three things: txt2tags, a
    1354. 

  1354. text editor and a web browser.
    1355. 

  1355. </P>
    1356. 

  1356. 

  1357. <OL>
    1358. 

  1358. <LI>Make sure txt2tags is installed and running on your system.
    1359. 

  1359. <P></P>
    1360. 

  1360.   <UL>
    1361. 

  1361.   <LI><B>Command Line Interface:</B> Call "txt2tags" on the command line and
    1362. 

  1362.     the program should give you a "Missing input file" message. If it is
    1363. 

  1363.     not working, try <CODE>python /path/to/txt2tags</CODE> or even
    1364. 

  1364.     <CODE>/path/to/python /path/to/txt2tags</CODE> if Python is not on your PATH.
    1365. 

  1365.   <P></P>
    1366. 

  1366.   <LI><B>Gui Interface:</B> Click on the program icon to launch the Gui
    1367. 

  1367.     Interface or call <CODE>txt2tags --gui</CODE>.
    1368. 

  1368.   <P></P>
    1369. 

  1369.   </UL>
    1370. 

  1370. <LI>Open the text editor your are comfortable with. It can be <B>any</B> text
    1371. 

  1371.   editor, from the good old VI to MS Word or OpenOffice.org. Create a
    1372. 

  1372.   brand new empty document to be your first txt2tags one and remember to
    1373. 

  1373.   save it as plain text.
    1374. 

  1374. <P></P>
    1375. 

  1375. <LI>Launch your favorite web browser to see the results of the conversion.
    1376. 

  1376. </OL>
    1377. 

  1377. 

  1378. <H2>Write the Document Header</H2>
    1379. 

  1379. 

  1380. <OL>
    1381. 

  1381. <LI>Go to the text editor and on the very first line type the document
    1382. 

  1382.   main title: <I>My First Document</I>
    1383. 

  1383. <LI>On the second line make a subtitle, inserting this text:
    1384. 

  1384.   <I>A txt2tags test</I>
    1385. 

  1385. <LI>Then, on the third line, put some time information:
    1386. 

  1386.   <I>Sunday, 2004</I>
    1387. 

  1387. </OL>
    1388. 

  1388. 

  1389. <P>
    1390. 

  1390. If everything went right, you should be seeing a three line document
    1391. 

  1391. with this contents:
    1392. 

  1392. </P>
    1393. 

  1393. 

  1394. <PRE>
    1395. 

  1395. My First Document
    1396. 

  1396. A txt2tags test
    1397. 

  1397. Sunday, 2004
    1398. 

  1398. </PRE>
    1399. 

  1399. 

  1400. <P>
    1401. 

  1401. This is just a part of the document, but we can already convert it and
    1402. 

  1402. check the results.
    1403. 

  1403. </P>
    1404. 

  1404. <P>
    1405. 

  1405. Now save this document with the name <CODE>test.txt</CODE>. Remember to save it
    1406. 

  1406. as plain text. Pay attention to which folder you are saving the file,
    1407. 

  1407. you will need to remember it soon.
    1408. 

  1408. </P>
    1409. 

  1409. 

  1410. <H2>The First Conversion - Gui Interface</H2>
    1411. 

  1411. 

  1412. <P>
    1413. 

  1413. If you are in the Command Line Interface, please skip this step and read
    1414. 

  1414. the next one.
    1415. 

  1415. </P>
    1416. 

  1416. <P>
    1417. 

  1417. If you are in the Gui Interface, follow this steps:
    1418. 

  1418. </P>
    1419. 

  1419.     <center><IMG ALIGN="middle" SRC="./firstdoc.png" BORDER="0" ALT=""></center> 
    1420. 

  1420. 

  1421. <OL>
    1422. 

  1422. <LI>Press the "Browse" button and choose the <CODE>test.txt</CODE> you just saved
    1423. 

  1423.   (remember the folder!).
    1424. 

  1424. <LI>Back to the first screen, select "HTML page" on the "Target document
    1425. 

  1425.   type" combo.
    1426. 

  1426. <LI>Press the "Convert!" button.
    1427. 

  1427. </OL>
    1428. 

  1428. 

  1429.    <center><IMG ALIGN="middle" SRC="./firstdoc-done.png" BORDER="0" ALT=""></center> 
    1430. 

  1430. <P>
    1431. 

  1431. A dialog box will appear, telling you that the file was converted
    1432. 

  1432. successfully. Note that the generated HTML page was saved on the same
    1433. 

  1433. folder as the text file, with the "html" extension.
    1434. 

  1434. </P>
    1435. 

  1435. 

  1436. <H2>The First Conversion - Command Line Interface</H2>
    1437. 

  1437. 

  1438. <P>
    1439. 

  1439. If you are in the Command Line Interface, move to the folder where the
    1440. 

  1440. file was saved and type this command:
    1441. 

  1441. </P>
    1442. 

  1442. 

  1443. <PRE>
    1444. 

  1444. txt2tags --target html test.txt
    1445. 

  1445. </PRE>
    1446. 

  1446. 

  1447. <P>
    1448. 

  1448. The option <CODE>--target</CODE> is followed
    1449. 

  1449. by the "html" string, which tells the program to what format your text
    1450. 

  1450. file will be converted. The last item is the text filename.
    1451. 

  1451. </P>
    1452. 

  1452. <P>
    1453. 

  1453. The results were saved to the <CODE>test.html</CODE>
    1454. 

  1454. file and then the program will show you the
    1455. 

  1455. "<I>txt2tags wrote test.html</I>" message.
    1456. 

  1456. If some error occurred, read the message carefully.
    1457. 

  1457. </P>
    1458. 

  1458. <P>
    1459. 

  1459. Here is a sample of how it will be shown on your screen:
    1460. 

  1460. </P>
    1461. 

  1461. 

  1462. <PRE>
    1463. 

  1463. prompt$ txt2tags --target html test.txt
    1464. 

  1464. txt2tags wrote test.html
    1465. 

  1465. prompt$
    1466. 

  1466. </PRE>
    1467. 

  1467. 

  1468. <H2>Check the Results</H2>
    1469. 

  1469. 

  1470. <P>
    1471. 

  1471. Open the <CODE>test.html</CODE> file on the web browser to check if everything
    1472. 

  1472. is ok.
    1473. 

  1473. </P>
    1474. 

  1474.    <center><IMG ALIGN="middle" SRC="./firstdoc-html.png" BORDER="0" ALT=""></center> 
    1475. 

  1475. <P>
    1476. 

  1476. Here it is! You just typed three simple lines of text and txt2tags made
    1477. 

  1477. all the work to set the HTML page heading information, text alignment,
    1478. 

  1478. sizes, spacing and appearance. See that the main title is also placed at the
    1479. 

  1479. browser title bar.
    1480. 

  1480. </P>
    1481. 

  1481. 	<BLOCKQUOTE>
    1482. 

  1482. 	You write text, txt2tags does the rest ;)
    1483. 

  1483. 	</BLOCKQUOTE>
    1484. 

  1484. <P>
    1485. 

  1485. Tip: You can also use CSS files on HTML pages generated by txt2tags, so the
    1486. 

  1486. page appearance is 100% configurable.
    1487. 

  1487. </P>
    1488. 

  1488. 

  1489. <H2>Writing the Document Body</H2>
    1490. 

  1490. 

  1491. <P>
    1492. 

  1492. Now back to the text editor, the next step is to type the document
    1493. 

  1493. contents. You can write plain text as you normally do on email messages.
    1494. 

  1494. You will see that txt2tags recognizes paragraphs and list of items
    1495. 

  1495. automatically, you don't have to "mark" them.
    1496. 

  1496. </P>
    1497. 

  1497. <P>
    1498. 

  1498. Then again: save it, convert and check the results. This is the
    1499. 

  1499. development cycle of a document in txt2tags. You just focus on the
    1500. 

  1500. document contents, finishing documents faster than other editors. No
    1501. 

  1501. mouse clicking, no menus, no windows, no distraction.
    1502. 

  1502. </P>
    1503. 

  1503. <P>
    1504. 

  1504. Considering the following contents for the <CODE>test.txt</CODE> file, which is
    1505. 

  1505. only plain text, compare the generated HTML page:
    1506. 

  1506. </P>
    1507. 

  1507. 

  1508. <PRE>
    1509. 

  1509. My First Document
    1510. 

  1510. A txt2tags test
    1511. 

  1511. Sunday, 2004
    1512. 

  1512. 

  1513. Well, let's try this txt2tags thing.
    1514. 

  1514. I don't know what to write.
    1515. 

    1516. 

  1516. Mmmmmm, I know what I need to do now:
    1517. 

  1517. - Take a shower
    1518. 

  1518. - Eat a pizza
    1519. 

  1519. - Sleep
    1520. 

  1520. </PRE>
    1521. 

  1521. 

  1522.    <center><IMG ALIGN="middle" SRC="./firstdoc-fullhtml.png" BORDER="0" ALT=""></center> 
    1523. 

  1523. <P>
    1524. 

  1524. You can write a full homepage with 0% of HTML knowledge. You don't need
    1525. 

  1525. to insert any tags. And more, the same text file can be converted to any
    1526. 

  1526. of the other txt2tags supported formats.
    1527. 

  1527. </P>
    1528. 

  1528. <P>
    1529. 

  1529. Besides plain text, txt2tags has some very simple marks, that you'll
    1530. 

  1530. use when you need some other formatting or structures like bold, italic,
    1531. 

  1531. title, images, table and other. As a quick sample,
    1532. 

  1532. <CODE>**stars for bold**</CODE> and <CODE>== equals for title ==</CODE>. You can learn the
    1533. 

  1533. marks on the <A HREF="http://txt2tags.org/markup.html">Txt2tags Markup Demo</A>.
    1534. 

  1534. </P>
    1535. 

  1535. 

  1536. <A NAME="concepts"></A>
    1537. 

  1537. <H1>Part IV - Mastering Txt2tags Concepts</H1>
    1538. 

  1538. 

  1539. <A NAME="areas"></A>
    1540. 

  1540. <H2>The .t2t document Areas</H2>
    1541. 

  1541. 

  1542. <P>
    1543. 

  1543. Txt2tags marked files are divided in 3 areas. Each area has its own
    1544. 

  1544. rules and purpose. They are:
    1545. 

  1545. </P>
    1546. 

  1546. 

  1547. <DL>
    1548. 

  1548. <DT><I>Header Area</I></DT><DD>
    1549. 

  1549.   Place for Document Title, Author, Version and Date information.
    1550. 

  1550. <DT><I>Config Area</I></DT><DD>
    1551. 

  1551.   Place for general Document Settings and Parser behavior modifiers.
    1552. 

  1552. <DT><I>Body Area</I></DT><DD>
    1553. 

  1553.   Place for the Document Content.
    1554. 

  1554. </DL>
    1555. 

  1555. 

  1556. <P>
    1557. 

  1557. All areas are optional. You can write a txt2tags document with just
    1558. 

  1558. headers (such as our first example), or a document with no headers or settings.
    1559. 

  1559. </P>
    1560. 

  1560. <P>
    1561. 

  1561. The areas are delimited by special rules, which will be seen in detail
    1562. 

  1562. on the next chapter. For now, this is a representation of the
    1563. 

  1563. areas on a document:
    1564. 

  1564. </P>
    1565. 

  1565. 

  1566. <PRE>
    1567. 

  1567.              ____________
    1568. 

  1568.             |            |
    1569. 

  1569.             |   HEADERS  |       1. First, the Headers
    1570. 

  1570.             |            |
    1571. 

  1571.             |   CONFIG   |       2. Then the Settings
    1572. 

  1572.             |            |
    1573. 

  1573.             |    BODY    |       3. And finally the Document Body,
    1574. 

  1574.             |            |
    1575. 

  1575.             |    ...     |          which goes until the end
    1576. 

  1576.             |    ...     |
    1577. 

  1577.             |____________|
    1578. 

  1578. 

  1579. </PRE>
    1580. 

  1580. 

  1581. <P>
    1582. 

  1582. In short, this is how the areas are defined:
    1583. 

  1583. </P>
    1584. 

  1584. 

  1585. <TABLE ALIGN="center">
    1586. 

  1586. <TR>
    1587. 

  1587. <TD ALIGN="center"><B>Headers</B></TD>
    1588. 

  1588. <TD>First 3 lines of the file, or the first line blank for No Headers.</TD>
    1589. 

  1589. </TR>
    1590. 

  1590. <TR>
    1591. 

  1591. <TD ALIGN="center"><B>Config</B></TD>
    1592. 

  1592. <TD>Begins right after the Header (4th or 2nd line) and ends when the <I>Body Area</I> starts.</TD>
    1593. 

  1593. </TR>
    1594. 

  1594. <TR>
    1595. 

  1595. <TD ALIGN="center"><B>Body</B></TD>
    1596. 

  1596. <TD>The first valid text line (not comment or setting) after the <I>Header Area</I>.</TD>
    1597. 

  1597. </TR>
    1598. 

  1598. </TABLE>
    1599. 

  1599. 

  1600. <H3>Full Example</H3>
    1601. 

  1601. 

  1602. <PRE>
    1603. 

  1603. My nice doc Title
    1604. 

  1604. Mr. John Doe
    1605. 

  1605. Last Updated: %%mtime(%c)
    1606. 

  1606. 

  1607. %!target  : html
    1608. 

  1608. %!style   : fancy.css
    1609. 

  1609. %!encoding: UTF-8
    1610. 

  1610. %!options : --toc --enum-title
    1611. 

  1611. 

  1612. Hi! This is my test document.
    1613. 

  1613. Its content will end here.
    1614. 

  1614. </PRE>
    1615. 

  1615. 

  1616. <A NAME="headers-area"></A>
    1617. 

  1617. <H2>Header Area</H2>
    1618. 

  1618. 

  1619. <P>
    1620. 

  1620. Location:
    1621. 

  1621. </P>
    1622. 

  1622. 

  1623. <UL>
    1624. 

  1624. <LI>Fixed position: <B>First 3 lines</B> of the file. Period.
    1625. 

  1625. <LI>Fixed position: <B>First line</B> of the file if it is blank. This
    1626. 

  1626.   means Empty Headers.
    1627. 

  1627. </UL>
    1628. 

  1628. 

  1629. <P>
    1630. 

  1630. The Header Area is the only one that has a fixed position, line
    1631. 

  1631. oriented. They are located at the first three lines of the source file.
    1632. 

  1632. </P>
    1633. 

  1633. <P>
    1634. 

  1634. These lines are content-free, with no static information type needed.
    1635. 

  1635. But the following is recommended:
    1636. 

  1636. </P>
    1637. 

  1637. 

  1638. <UL>
    1639. 

  1639. <LI><I>line 1</I>: document title
    1640. 

  1640. <LI><I>line 2</I>: author name and/or email
    1641. 

  1641. <LI><I>line 3</I>: document date and/or version
    1642. 

  1642.               (nice place for <CODE>%%date</CODE>)
    1643. 

  1643. </UL>
    1644. 

  1644. 

  1645. <P>
    1646. 

  1646. Keep in mind that the first 3 lines of the source document will be the
    1647. 

  1647. first 3 lines on the target document, separated and with high contrast
    1648. 

  1648. to the text body (i.e. big letters, bold). If paging is allowed, the
    1649. 

  1649. headers will be alone and centralized on the first page.
    1650. 

  1650. </P>
    1651. 

  1651. 

  1652. <H4>Less (or None) Header lines</H4>
    1653. 

  1653. 

  1654. <P>
    1655. 

  1655. Sometimes the user wants to specify less than three lines for headers,
    1656. 

  1656. giving just the document title and/or date information.
    1657. 

  1657. </P>
    1658. 

  1658. <P>
    1659. 

  1659. Just let the 2nd and/or the 3rd lines empty (blank) and this position
    1660. 

  1660. will not be placed at the target document. But keep in mind that even
    1661. 

  1661. blanks, these lines are still part of the headers, so the document body
    1662. 

  1662. must start <B>after</B> the 3rd line anyway.
    1663. 

  1663. </P>
    1664. 

  1664. <P>
    1665. 

  1665. The title is the only required header (the first line), but if you
    1666. 

  1666. leave it blank, you are saying that your document has <B>no headers</B>.
    1667. 

  1667. So the <I>Body Area</I> will begin right after, on the 2nd line.
    1668. 

  1668. </P>
    1669. 

  1669. <P>
    1670. 

  1670. No headers on the document is often useful if you want to specify your
    1671. 

  1671. own customized headers after converting. The command line option
    1672. 

  1672. <CODE>--no-headers</CODE> is usually required for this kind of operation.
    1673. 

  1673. </P>
    1674. 

  1674. 

  1675. <H4>Straight to the point</H4>
    1676. 

  1676. 

  1677. <P>
    1678. 

  1678. In short: <B>"Headers are just <U>positions</U>, not contents"</B>
    1679. 

  1679. </P>
    1680. 

  1680. <P>
    1681. 

  1681. Place one text on the first line, and it will appear on the target's
    1682. 

  1682. first line. The same for 2nd and 3rd header lines.
    1683. 

  1683. </P>
    1684. 

  1684. 

  1685. <A NAME="config-area"></A>
    1686. 

  1686. <H2>Config Area</H2>
    1687. 

  1687. 

  1688. <P>
    1689. 

  1689. Location:
    1690. 

  1690. </P>
    1691. 

  1691. 

  1692. <UL>
    1693. 

  1693. <LI>Begins right after the Header Area
    1694. 

  1694.   <UL>
    1695. 

  1695.   <LI>Begins on the <B>4th line</B> of the file if <B>Headers</B> were specified
    1696. 

  1696.   <LI>Begins on the <B>2nd line</B> of the file if <B>No Headers</B> were specified
    1697. 

  1697.   </UL>
    1698. 

  1698. <LI>Ends when the Body Area starts
    1699. 

  1699.   <UL>
    1700. 

  1700.   <LI>Ends by a non Setting, Blank or Comment line
    1701. 

  1701.   </UL>
    1702. 

  1702. </UL>
    1703. 

  1703. 

  1704. <P>
    1705. 

  1705. The Config Area is optional. An average user can write lots of txt2tags
    1706. 

  1706. files without even know it exists, but the experienced users will
    1707. 

  1707. enjoy the power and control it provides.
    1708. 

  1708. </P>
    1709. 

  1709. <P>
    1710. 

  1710. The Config Area is used to store document-specific settings, so you don't
    1711. 

  1711. have to type them on the command line when converting the document. For
    1712. 

  1712. example, you can set the default document target type and encoding.
    1713. 

  1713. </P>
    1714. 

  1714. <P>
    1715. 

  1715. Please read the <A HREF="#settings-overview">Settings section</A> for more
    1716. 

  1716. information about them.
    1717. 

  1717. </P>
    1718. 

  1718. 

  1719. <A NAME="body-area"></A>
    1720. 

  1720. <H2>Body Area</H2>
    1721. 

  1721. 

  1722. <P>
    1723. 

  1723. Location:
    1724. 

  1724. </P>
    1725. 

  1725. 

  1726. <UL>
    1727. 

  1727. <LI>Begins on the first valid text line of the file
    1728. 

  1728.   <UL>
    1729. 

  1729.   <LI>Headers, Settings and Comments are <B>not</B> valid text lines
    1730. 

  1730.   </UL>
    1731. 

  1731. <LI>Ends at the end of the file (EOF)
    1732. 

  1732. </UL>
    1733. 

  1733. 

  1734. <P>
    1735. 

  1735. The body is anything outside Headers and Config Areas.
    1736. 

  1736. </P>
    1737. 

  1737. <P>
    1738. 

  1738. The body holds the document contents and all formatting and structures
    1739. 

  1739. txt2tags can recognize. Inside the body you can also put comments for
    1740. 

  1740. <I>TODOs</I> and self notes.
    1741. 

  1741. </P>
    1742. 

  1742. <P>
    1743. 

  1743. You can use the <CODE>--no-headers</CODE> command line option to convert only the
    1744. 

  1744. document body, suppressing the headers. This is useful to set your own
    1745. 

  1745. headers on a separate file, then join the converted body.
    1746. 

  1746. </P>
    1747. 

  1747. 

  1748. <A NAME="settings-overview"></A>
    1749. 

  1749. <H2>Settings</H2>
    1750. 

  1750. 

  1751. <P>
    1752. 

  1752. Settings are special configurations placed at the source document's
    1753. 

  1753. Config Area that can affect the conversion process. Their syntax is:
    1754. 

  1754. </P>
    1755. 

  1755. 

  1756. <PRE>
    1757. 

  1757. %! keyword : value
    1758. 

  1758. </PRE>
    1759. 

  1759. 

  1760. <P>
    1761. 

  1761. List of valid keywords:
    1762. 

  1762. </P>
    1763. 

  1763. 

  1764. <TABLE ALIGN="center" BORDER="1">
    1765. 

  1765. <TR>
    1766. 

  1766. <TH>Keyword</TH>
    1767. 

  1767. <TH>Description</TH>
    1768. 

  1768. </TR>
    1769. 

  1769. <TR>
    1770. 

  1770. <TD ALIGN="center">Target</TD>
    1771. 

  1771. <TD>Set the default target to the document be converted to.</TD>
    1772. 

  1772. </TR>
    1773. 

  1773. <TR>
    1774. 

  1774. <TD ALIGN="center">Options</TD>
    1775. 

  1775. <TD>Set the default options to be used on the conversion. The format is the same as the command line options.</TD>
    1776. 

  1776. </TR>
    1777. 

  1777. <TR>
    1778. 

  1778. <TD ALIGN="center">Style</TD>
    1779. 

  1779. <TD>Set the document style. Used to define a CSS file for HTML/XHTML and to load a package in LaTeX.</TD>
    1780. 

  1780. </TR>
    1781. 

  1781. <TR>
    1782. 

  1782. <TD ALIGN="center">Encoding</TD>
    1783. 

  1783. <TD>Set the document Character Set. Used if the document contains accented letters or other not-ASCII characters.</TD>
    1784. 

  1784. </TR>
    1785. 

  1785. <TR>
    1786. 

  1786. <TD ALIGN="center">PreProc</TD>
    1787. 

  1787. <TD>Input filter. Sets "find and replace" rules to be applied on the Body Area of the source document.</TD>
    1788. 

  1788. </TR>
    1789. 

  1789. <TR>
    1790. 

  1790. <TD ALIGN="center">PostProc</TD>
    1791. 

  1791. <TD>Output filter. Sets "find and replace" rules to be applied on the converted document.</TD>
    1792. 

  1792. </TR>
    1793. 

  1793. </TABLE>
    1794. 

  1794. 

  1795. <P>
    1796. 

  1796. Example:
    1797. 

  1797. </P>
    1798. 

  1798. 

  1799. <PRE>
    1800. 

  1800. %!target  : html
    1801. 

  1801. %!options : --toc --toc-level 3
    1802. 

  1802. %!style   : fancy.css
    1803. 

  1803. %!encoding: UTF-8
    1804. 

  1804. %!preproc : "AMJ"        "Aurelio Marinho Jargas"
    1805. 

  1805. %!postproc: '&lt;BODY.*?&gt;'  '&lt;BODY bgcolor="yellow"&gt;'
    1806. 

  1806. </PRE>
    1807. 

  1807. 

  1808. <P>
    1809. 

  1809. Note that the spacing and capitalization of the keyword are ignored. So you can also do <CODE>%!Target:htm…
    1810.