/doc/English/rules.html

http://txt2tags.googlecode.com/ · HTML · 1757 lines · 1708 code · 46 blank · 3 comment · 0 complexity · b075cb8077777e6fe2a3cd7d3638590d MD5 · raw file 

    

  1. <?xml version="1.0"
    2. 

  2. ?>
    3. 

  3. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    4. 

  4. <html xmlns="http://www.w3.org/1999/xhtml">
    5. 

  5. <head>
    6. 

  6. <title>Txt2tags Markup Rules</title>
    7. 

  7. <meta name="generator" content="http://txt2tags.org" />
    8. 

  8. 

  9. <!-- Included /a/pessoal/sourceforge.net/txt2tags/src/doc/English/rules/rules.css -->
    10. 

  10. <style type="text/css">
    11. 

  11. body {
    12. 

  12. 	margin:2em;
    13. 

  13. }
    14. 

  14. a {
    15. 

  15. 	font-weight:bold;
    16. 

  16. 	text-decoration:none;
    17. 

  17. }
    18. 

  18. a:hover {
    19. 

  19. 	text-decoration:underline;
    20. 

  20. }
    21. 

  21. .toc {
    22. 

  22. 	margin-left:2em;
    23. 

  23. }
    24. 

  24. .section {
    25. 

  25. 	margin-top:2em;
    26. 

  26. 	margin-bottom:1em;
    27. 

  27. 	border:1px solid black;
    28. 

  28. 	text-align:center;
    29. 

  29. 	background-color:#ddd;
    30. 

  30. }
    31. 

  31. table {
    32. 

  32. 	empty-cells:hide;
    33. 

  33. }	
    34. 

  34. td {
    35. 

  35. 	padding:4px;
    36. 

  36. }
    37. 

  37. </style>
    38. 

  38. 

  39. </head>
    40. 

  40. <body>
    41. 

  41. 

  42. <div class="header" id="header">
    43. 

  43. <h1>Txt2tags Markup Rules</h1>
    44. 

  44. </div>
    45. 

  45. 

  46. <div class="body" id="body">
    47. 

  47. <p>
    48. 

  48. This document describes all the details about each txt2tags mark.
    49. 

  49. The target audience are <b>experienced</b> users. You may find it
    50. 

  50. useful if you want to master the marks or solve a specific problem
    51. 

  51. about a mark.
    52. 

  52. </p>
    53. 

  53. <p>
    54. 

  54. If you are new to txt2tags or just want to know which are the
    55. 

  55. available marks, please read the <a href="markup.html">Markup Demo</a>.
    56. 

  56. </p>
    57. 

  57. <p>
    58. 

  58. Note 1: This document is generated directly from the txt2tags
    59. 

  59. test-suite. All the rules mentioned here are 100% in sync with the
    60. 

  60. current program code.
    61. 

  61. </p>
    62. 

  62. <p>
    63. 

  63. Note 2: A good practice is to consult <a href="rules.t2t">the sources</a> when
    64. 

  64. reading, to see how the texts were made.
    65. 

  65. </p>
    66. 

  66. <p>
    67. 

  67. Table of Contents:
    68. 

  68. </p>
    69. 

  69. <div class="toc" id="toc">
    70. 

  70.   <ul>
    71. 

  71.   <li><a href="#paragraph">Paragraph</a>
    72. 

  72.     <ul>
    73. 

  73.     <li><a href="#toc2">Syntax: Lines grouped together</a>
    74. 

  74.     </li>
    75. 

  75.     <li><a href="#toc3">Syntax: Leading and trailing spaces are ignored</a>
    76. 

  76.     </li>
    77. 

  77.     <li><a href="#toc4">Syntax: A comment don't close a paragraph</a>
    78. 

  78.     </li>
    79. 

  79.     <li><a href="#toc5">Closing: EOF closes the open paragraph</a>
    80. 

  80.     </li>
    81. 

  81.     </ul>
    82. 

  82.   </li>
    83. 

  83.   <li><a href="#comment">Comment</a>
    84. 

  84.     <ul>
    85. 

  85.     <li><a href="#toc7">Syntax: The % character at the line beginning (column 1)</a>
    86. 

  86.     </li>
    87. 

  87.     <li><a href="#toc8">Syntax: Area (block)</a>
    88. 

  88.     </li>
    89. 

  89.     <li><a href="#toc9">Syntax: Area (block) with trailing spaces</a>
    90. 

  90.     </li>
    91. 

  91.     <li><a href="#toc10">Invalid: The % in any other position</a>
    92. 

  92.     </li>
    93. 

  93.     </ul>
    94. 

  94.   </li>
    95. 

  95.   <li><a href="#line">Line</a>
    96. 

  96.     <ul>
    97. 

  97.     <li><a href="#toc12">Syntax: At least 20 chars of - = _</a>
    98. 

  98.     </li>
    99. 

  99.     <li><a href="#toc13">Syntax: Any kind of mixing is allowed</a>
    100. 

  100.     </li>
    101. 

  101.     <li><a href="#toc14">Syntax: Leading and/or trailing spaces are allowed</a>
    102. 

  102.     </li>
    103. 

  103.     <li><a href="#toc15">Invalid: Less than 20 chars (but strike matches)</a>
    104. 

  104.     </li>
    105. 

  105.     <li><a href="#toc16">Invalid: Strange chars (but strike matches)</a>
    106. 

  106.     </li>
    107. 

  107.     </ul>
    108. 

  108.   </li>
    109. 

  109.   <li><a href="#inline">Inline</a>
    110. 

  110.     <ul>
    111. 

  111.     <li><a href="#toc18">Syntax: Marks are greedy and must be "glued" with contents</a>
    112. 

  112.     </li>
    113. 

  113.     <li><a href="#toc19">Syntax: Repetition is greedy</a>
    114. 

  114.     </li>
    115. 

  115.     <li><a href="#toc20">Invalid: No contents</a>
    116. 

  116.     </li>
    117. 

  117.     <li><a href="#toc21">Invalid: Contents not "glued" with marks</a>
    118. 

  118.     </li>
    119. 

  119.     </ul>
    120. 

  120.   </li>
    121. 

  121.   <li><a href="#link">Link</a>
    122. 

  122.     <ul>
    123. 

  123.     <li><a href="#toc23">Syntax: E-mail</a>
    124. 

  124.     </li>
    125. 

  125.     <li><a href="#toc24">Syntax: E-mail with form data</a>
    126. 

  126.     </li>
    127. 

  127.     <li><a href="#toc25">Syntax: URL</a>
    128. 

  128.     </li>
    129. 

  129.     <li><a href="#toc26">Syntax: URL with anchor</a>
    130. 

  130.     </li>
    131. 

  131.     <li><a href="#toc27">Syntax: URL with form data</a>
    132. 

  132.     </li>
    133. 

  133.     <li><a href="#toc28">Syntax: URL with form data and anchor</a>
    134. 

  134.     </li>
    135. 

  135.     <li><a href="#toc29">Syntax: URL with login data</a>
    136. 

  136.     </li>
    137. 

  137.     <li><a href="#toc30">Syntax: URL with login, form and anchor</a>
    138. 

  138.     </li>
    139. 

  139.     <li><a href="#toc31">Syntax: URL with label</a>
    140. 

  140.     </li>
    141. 

  141.     <li><a href="#toc32">Syntax: URL with label (trailing spaces are discarded, leading are maintained)</a>
    142. 

  142.     </li>
    143. 

  143.     <li><a href="#toc33">Syntax: URL with label, stressing</a>
    144. 

  144.     </li>
    145. 

  145.     <li><a href="#toc34">Syntax: Link with label for local files</a>
    146. 

  146.     </li>
    147. 

  147.     <li><a href="#toc35">Syntax: Another link as a label</a>
    148. 

  148.     </li>
    149. 

  149.     <li><a href="#toc36">Syntax: URL with funny chars</a>
    150. 

  150.     </li>
    151. 

  151.     <li><a href="#toc37">Test: Various per line</a>
    152. 

  152.     </li>
    153. 

  153.     <li><a href="#toc38">Feature: Guessed link, adding protocol automatically</a>
    154. 

  154.     </li>
    155. 

  155.     <li><a href="#toc39">Invalid: Trailing space on link</a>
    156. 

  156.     </li>
    157. 

  157.     <li><a href="#toc40">Invalid: Label with ] char (use postproc)</a>
    158. 

  158.     </li>
    159. 

  159.     </ul>
    160. 

  160.   </li>
    161. 

  161.   <li><a href="#image">Image</a>
    162. 

  162.     <ul>
    163. 

  163.     <li><a href="#toc42">Syntax: Image name inside brackets: [img]</a>
    164. 

  164.     </li>
    165. 

  165.     <li><a href="#toc43">Syntax: Image pointing to a link: [[img] link]</a>
    166. 

  166.     </li>
    167. 

  167.     <li><a href="#toc44">Align: Image position is preserved when inside paragraph</a>
    168. 

  168.     </li>
    169. 

  169.     <li><a href="#toc45">Align: Image alone with spaces around is aligned</a>
    170. 

  170.     </li>
    171. 

  171.     <li><a href="#toc46">Test: Two glued images with no spaces (left &amp; right)</a>
    172. 

  172.     </li>
    173. 

  173.     <li><a href="#toc47">Test: Various per line</a>
    174. 

  174.     </li>
    175. 

  175.     <li><a href="#toc48">Invalid: Spaces inside are not allowed</a>
    176. 

  176.     </li>
    177. 

  177.     </ul>
    178. 

  178.   </li>
    179. 

  179.   <li><a href="#macro">Macro</a>
    180. 

  180.     <ul>
    181. 

  181.     <li><a href="#toc50">Syntax: Macro without formatting string</a>
    182. 

  182.     </li>
    183. 

  183.     <li><a href="#toc51">Syntax: Macro name is case insensitive</a>
    184. 

  184.     </li>
    185. 

  185.     <li><a href="#toc52">Syntax: Macro with formatting string</a>
    186. 

  186.     </li>
    187. 

  187.     <li><a href="#toc53">Syntax: Leading and trailing spaces are preserved</a>
    188. 

  188.     </li>
    189. 

  189.     <li><a href="#toc54">Test: Expansion of the percent char</a>
    190. 

  190.     </li>
    191. 

  191.     <li><a href="#toc55">Test: Various per line, glued</a>
    192. 

  192.     </li>
    193. 

  193.     <li><a href="#toc56">Test: Path formatters</a>
    194. 

  194.     </li>
    195. 

  195.     </ul>
    196. 

  196.   </li>
    197. 

  197.   <li><a href="#numtitle">Numbered Title</a>
    198. 

  198.   </li>
    199. 

  199.   <li><a href="#title">Title</a>
    200. 

  200.     <ul>
    201. 

  201.     <li><a href="#toc59">Syntax: Balanced equal signs (from 1 to 5)</a>
    202. 

  202.     </li>
    203. 

  203.     </ul>
    204. 

  204.   </li>
    205. 

  205. 

  206.     <ul>
    207. 

  207. 

  208.     </li>
    209. 

  209.     <li><a href="#toc62">Label: Between brackets, alphanumeric [A-Za-z0-9_-]</a>
    210. 

  210.     </li>
    211. 

  211.     </ul>
    212. 

  212.   </li>
    213. 

  213. 

  214.     <ul>
    215. 

  215. 

  216.     </li>
    217. 

  217.     <li><a href="#toc65">Syntax: Spaces around and/or inside are allowed (and ignored)</a>
    218. 

  218.     </li>
    219. 

  219.     <li><a href="#toc66">Invalid: Unbalanced equal signs</a>
    220. 

  220.     </li>
    221. 

  221.     <li><a href="#toc67">Invalid: Level deeper than 5</a>
    222. 

  222.     </li>
    223. 

  223.     <li><a href="#toc68">Invalid: Space between title and label</a>
    224. 

  224.     </li>
    225. 

  225.     <li><a href="#toc69">Invalid: Space inside label</a>
    226. 

  226.     </li>
    227. 

  227.     <li><a href="#toc70">Invalid: Strange chars inside label</a>
    228. 

  228.     </li>
    229. 

  229.     </ul>
    230. 

  230.   </li>
    231. 

  231.   <li><a href="#quote">Quote</a>
    232. 

  232.     <ul>
    233. 

  233.     <li><a href="#toc72">Syntax: TAB defines quote</a>
    234. 

  234.     </li>
    235. 

  235.     <li><a href="#toc73">Nesting: Creating deeper quotes</a>
    236. 

  236.     </li>
    237. 

  237.     <li><a href="#toc74">Nesting: Reverse nesting works</a>
    238. 

  238.     </li>
    239. 

  239.     <li><a href="#toc75">Nesting: Random count</a>
    240. 

  240.     </li>
    241. 

  241.     <li><a href="#toc76">Nesting: When not supported</a>
    242. 

  242.     </li>
    243. 

  243.     <li><a href="#toc77">Syntax: Spaces after TAB</a>
    244. 

  244.     </li>
    245. 

  245.     <li><a href="#toc78">Invalid: Spaces before TAB</a>
    246. 

  246.     </li>
    247. 

  247.     <li><a href="#toc79">Invalid: Paragraphs inside</a>
    248. 

  248.     </li>
    249. 

  249.     <li><a href="#toc80">Closing: EOF closes the open block</a>
    250. 

  250.     </li>
    251. 

  251.     </ul>
    252. 

  252.   </li>
    253. 

  253.   <li><a href="#raw">Raw</a>
    254. 

  254.   </li>
    255. 

  255.   <li><a href="#tagged">Tagged</a>
    256. 

  256.   </li>
    257. 

  257.   <li><a href="#verbatim">Verbatim</a>
    258. 

  258.     <ul>
    259. 

  259.     <li><a href="#toc84">Syntax: A single line</a>
    260. 

  260.     </li>
    261. 

  261.     <li><a href="#toc85">Syntax: A single line with leading spaces</a>
    262. 

  262.     </li>
    263. 

  263.     <li><a href="#toc86">Syntax: Area (block)</a>
    264. 

  264.     </li>
    265. 

  265.     <li><a href="#toc87">Syntax: Area (block) with trailing spaces</a>
    266. 

  266.     </li>
    267. 

  267.     <li><a href="#toc88">Invalid: No space between mark and contents</a>
    268. 

  268.     </li>
    269. 

  269.     <li><a href="#toc89">Invalid: Leading spaces on block marks</a>
    270. 

  270.     </li>
    271. 

  271.     <li><a href="#toc90">Closing: EOF closes the open block</a>
    272. 

  272.     </li>
    273. 

  273.     </ul>
    274. 

  274.   </li>
    275. 

  275.   <li><a href="#deflist">Definition List</a>
    276. 

  276.   </li>
    277. 

  277.   <li><a href="#numlist">Numbered List</a>
    278. 

  278.   </li>
    279. 

  279.   <li><a href="#list">List</a>
    280. 

  280.     <ul>
    281. 

  281.     <li><a href="#toc94">Items: Prefixed by hyphen</a>
    282. 

  282.     </li>
    283. 

  283.     <li><a href="#toc95">Items: Free leading spacing (indentation)</a>
    284. 

  284.     </li>
    285. 

  285.     <li><a href="#toc96">Items: Vertical spacing between items</a>
    286. 

  286.     </li>
    287. 

  287.     <li><a href="#toc97">Items: Exactly ONE space after the hyphen</a>
    288. 

  288.     </li>
    289. 

  289.     <li><a href="#toc98">Items: Catchy cases</a>
    290. 

  290.     </li>
    291. 

  291.     <li><a href="#toc99">Nesting: Creating sublists</a>
    292. 

  292.     </li>
    293. 

  293.     <li><a href="#toc100">Nesting: Free leading spacing (indentation)</a>
    294. 

  294.     </li>
    295. 

  295.     <li><a href="#toc101">Nesting: Maximum depth</a>
    296. 

  296.     </li>
    297. 

  297.     <li><a href="#toc102">Nesting: Reverse doesn't work</a>
    298. 

  298.     </li>
    299. 

  299.     <li><a href="#toc103">Nesting: Going deeper and back</a>
    300. 

  300.     </li>
    301. 

  301.     <li><a href="#toc104">Nesting: Vertical spacing between lists</a>
    302. 

  302.     </li>
    303. 

  303.     <li><a href="#toc105">Nesting: Messing up</a>
    304. 

  304.     </li>
    305. 

  305.     <li><a href="#toc106">Closing: Two (not so) empty lines</a>
    306. 

  306.     </li>
    307. 

  307.     <li><a href="#toc107">Closing: Empty item closes current (sub)list</a>
    308. 

  308.     </li>
    309. 

  309.     <li><a href="#toc108">Closing: EOF closes the lists</a>
    310. 

  310.     </li>
    311. 

  311.     </ul>
    312. 

  312.   </li>
    313. 

  313.   <li><a href="#table">Table</a>
    314. 

  314.     <ul>
    315. 

  315.     <li><a href="#toc110">Syntax: Lines starting with a pipe |</a>
    316. 

  316.     </li>
    317. 

  317.     <li><a href="#toc111">Syntax: Extra pipes separate cells</a>
    318. 

  318.     </li>
    319. 

  319.     <li><a href="#toc112">Syntax: With a trailing pipe, make border</a>
    320. 

  320.     </li>
    321. 

  321.     <li><a href="#toc113">Syntax: Table lines starting with double pipe are heading</a>
    322. 

  322.     </li>
    323. 

  323.     <li><a href="#toc114">Align: Spaces before the leading pipe centralize the table</a>
    324. 

  324.     </li>
    325. 

  325.     <li><a href="#toc115">Align: Spaces inside the cell denote its alignment</a>
    326. 

  326.     </li>
    327. 

  327.     <li><a href="#toc116">Span: Column span is defined by extra pipes at cell closing</a>
    328. 

  328.     </li>
    329. 

  329.     <li><a href="#toc117">Test: Empty cells are placed as expected</a>
    330. 

  330.     </li>
    331. 

  331.     <li><a href="#toc118">Test: Lines with different number of cells</a>
    332. 

  332.     </li>
    333. 

  333.     <li><a href="#toc119">Test: Empty cells + Span + Messy cell number = Fun!</a>
    334. 

  334.     </li>
    335. 

  335.     <li><a href="#toc120">Test: Lots of cells at the same line</a>
    336. 

  336.     </li>
    337. 

  337.     <li><a href="#toc121">Test: Empty lines</a>
    338. 

  338.     </li>
    339. 

  339.     <li><a href="#toc122">Invalid: There must be at least one space around the pipe</a>
    340. 

  340.     </li>
    341. 

  341.     <li><a href="#toc123">Invalid: You must use spaces, not TABs</a>
    342. 

  342.     </li>
    343. 

  343.     </ul>
    344. 

  344.   </li>
    345. 

  345.   </ul>
    346. 

  346. 

  347. </div>
    348. 

  348. <p></p>
    349. 

  349. <hr class="light" />
    350. 

  350. <p></p>
    351. 

  351. <a id="paragraph" name="paragraph"></a>
    352. 

  352. <h1 class="section">Paragraph</h1>
    353. 

  353. <a id="toc2" name="toc2"></a>
    354. 

  354. <h2>Syntax: Lines grouped together</h2>
    355. 

  355. <p>
    356. 

  356. A paragraph is composed by one or more lines.
    357. 

  357. A blank line (or a table, or a list) ends the
    358. 

  358. current paragraph.
    359. 

  359. </p>
    360. 

  360. <a id="toc3" name="toc3"></a>
    361. 

  361. <h2>Syntax: Leading and trailing spaces are ignored</h2>
    362. 

  362. <p>
    363. 

  363.    Leading and trailing spaces are ignored.   
    364. 

  364. </p>
    365. 

  365. <a id="toc4" name="toc4"></a>
    366. 

  366. <h2>Syntax: A comment don't close a paragraph</h2>
    367. 

  367. <p>
    368. 

  368. A comment line can be placed inside a paragraph.
    369. 

  369. It will not affect it.
    370. 

  370. </p>
    371. 

  371. <a id="toc5" name="toc5"></a>
    372. 

  372. <h2>Closing: EOF closes the open paragraph</h2>
    373. 

  373. <p>
    374. 

  374. The end of the file (EOF) closes the
    375. 

  375. currently open paragraph.
    376. 

  376. </p>
    377. 

  377. <a id="comment" name="comment"></a>
    378. 

  378. <h1 class="section">Comment</h1>
    379. 

  379. <a id="toc7" name="toc7"></a>
    380. 

  380. <h2>Syntax: The % character at the line beginning (column 1)</h2>
    381. 

  381. <a id="toc8" name="toc8"></a>
    382. 

  382. <h2>Syntax: Area (block)</h2>
    383. 

  383. <a id="toc9" name="toc9"></a>
    384. 

  384. <h2>Syntax: Area (block) with trailing spaces</h2>
    385. 

  385. <a id="toc10" name="toc10"></a>
    386. 

  386. <h2>Invalid: The % in any other position</h2>
    387. 

  387. <p>
    388. 

  388.  % not on the line beginning (at column 2)
    389. 

  389. </p>
    390. 

  390. <p>
    391. 

  391. some text     % half line comments are not allowed
    392. 

  392. </p>
    393. 

  393. <a id="line" name="line"></a>
    394. 

  394. <h1 class="section">Line</h1>
    395. 

  395. <a id="toc12" name="toc12"></a>
    396. 

  396. <h2>Syntax: At least 20 chars of - = _</h2>
    397. 

  397. <hr class="light" />
    398. 

  398. <hr class="heavy" />
    399. 

  399. <hr class="light" />
    400. 

  400. <a id="toc13" name="toc13"></a>
    401. 

  401. <h2>Syntax: Any kind of mixing is allowed</h2>
    402. 

  402. <p>
    403. 

  403. Free mixing is allowed to make the line,
    404. 

  404. but the first char is the identifier for
    405. 

  405. the difference between separator ( - _ )
    406. 

  406. and strong ( = ) lines.
    407. 

  407. </p>
    408. 

  408. <hr class="heavy" />
    409. 

  409. <hr class="light" />
    410. 

  410. <hr class="heavy" />
    411. 

  411. <hr class="heavy" />
    412. 

  412. <hr class="light" />
    413. 

  413. <a id="toc14" name="toc14"></a>
    414. 

  414. <h2>Syntax: Leading and/or trailing spaces are allowed</h2>
    415. 

  415. <hr class="light" />
    416. 

  416. <hr class="light" />
    417. 

  417. <hr class="light" />
    418. 

  418. <a id="toc15" name="toc15"></a>
    419. 

  419. <h2>Invalid: Less than 20 chars (but strike matches)</h2>
    420. 

  420. <p>
    421. 

  421. <s>-----</s>
    422. 

  422. </p>
    423. 

  423. <a id="toc16" name="toc16"></a>
    424. 

  424. <h2>Invalid: Strange chars (but strike matches)</h2>
    425. 

  425. <p>
    426. 

  426. <s>-----</s> <s>------</s>
    427. 

  427. </p>
    428. 

  428. <p>
    429. 

  429. <s>-----</s>+<s>------</s>
    430. 

  430. </p>
    431. 

  431. <p>
    432. 

  432. ( <s>----------------</s> )
    433. 

  433. </p>
    434. 

  434. <a id="inline" name="inline"></a>
    435. 

  435. <h1 class="section">Inline</h1>
    436. 

  436. <a id="toc18" name="toc18"></a>
    437. 

  437. <h2>Syntax: Marks are greedy and must be "glued" with contents</h2>
    438. 

  438. <p>
    439. 

  439. GLUED: The contents must be glued with the marks, no spaces
    440. 

  440. between them. Right after the opening mark there must be a
    441. 

  441. non-blank character, as well as right before the closing mark.
    442. 

  442. </p>
    443. 

  443. <p>
    444. 

  444. GREEDY: If the contents boundary character is the same as
    445. 

  445. the mark character, it is considered contents, not mark.
    446. 

  446. So ****bold**** turns to &lt;B&gt;**bold**&lt;/B&gt; in HTML.
    447. 

  447. </p>
    448. 

  448. <p>
    449. 

  449. { <b>b</b>        }{ <i>i</i>        }{ <u>u</u>        }{ <s>s</s>        }{ <code>m</code>        }{ r       }{ t }<br />
    450. 

  450. { <b>bo</b>       }{ <i>it</i>       }{ <u>un</u>       }{ <s>st</s>       }{ <code>mo</code>       }{ ra      }{ tg }<br />
    451. 

  451. { <b>bold</b>     }{ <i>ital</i>     }{ <u>undr</u>     }{ <s>strk</s>     }{ <code>mono</code>     }{ raw     }{ tggd }<br />
    452. 

  452. { <b>bo ld</b>    }{ <i>it al</i>    }{ <u>un dr</u>    }{ <s>st rk</s>    }{ <code>mo no</code>    }{ r aw    }{ tg gd }<br />
    453. 

  453. { <b>bo * ld</b>  }{ <i>it / al</i>  }{ <u>un _ dr</u>  }{ <s>st - rk</s>  }{ <code>mo ` no</code>  }{ r " aw  }{ tg ' gd }<br />
    454. 

  454. { <b>bo **ld</b>  }{ <i>it //al</i>  }{ <u>un __dr</u>  }{ <s>st --rk</s>  }{ <code>mo ``no</code>  }{ r ""aw  }{ tg ''gd }<br />
    455. 

  455. { <b>bo ** ld</b> }{ <i>it // al</i> }{ <u>un __ dr</u> }{ <s>st -- rk</s> }{ <code>mo `` no</code> }{ r "" aw }{ tg '' gd }<br />
    456. 

  456. { <b>**bold**</b> }{ <i>//ital//</i> }{ <u>__undr__</u> }{ <s>--strk--</s> }{ <code>``mono``</code> }{ ""raw"" }{ ''tggd'' }<br />
    457. 

  457. { <b>*bold*</b>   }{ <i>/ital/</i>   }{ <u>_undr_</u>   }{ <s>-strk-</s>   }{ <code>`mono`</code>   }{ "raw"   }{ 'tggd' }<br />
    458. 

  458. </p>
    459. 

  459. <a id="toc19" name="toc19"></a>
    460. 

  460. <h2>Syntax: Repetition is greedy</h2>
    461. 

  461. <p>
    462. 

  462. When the mark character is repeated many times,
    463. 

  463. the contents are expanded to the largest possible.
    464. 

  464. Thats why they are greedy, the outer marks are
    465. 

  465. the ones used.
    466. 

  466. </p>
    467. 

  467. <p>
    468. 

  468. {  <b>*</b>       }{  <i>/</i>       }{  <u>_</u>       }{  <s>-</s>       }{  <code>`</code>       }{ "       }{ ' }<br />
    469. 

  469. {  <b>**</b>      }{  <i>//</i>      }{  <u>__</u>      }{  <s>--</s>      }{  <code>``</code>      }{ ""      }{ '' }<br />
    470. 

  470. {  <b>***</b>     }{  <i>///</i>     }{  <u>___</u>     }{  <s>---</s>     }{  <code>```</code>     }{ """     }{ ''' }<br />
    471. 

  471. {  <b>****</b>    }{  <i>////</i>    }{  <u>____</u>    }{  <s>----</s>    }{  <code>````</code>    }{ """"    }{ '''' }<br />
    472. 

  472. {  <b>*****</b>   }{  <i>/////</i>   }{  <u>_____</u>   }{  <s>-----</s>   }{  <code>`````</code>   }{ """""   }{ ''''' }<br />
    473. 

  473. {  <b>******</b>  }{  <i>//////</i>  }{  <u>______</u>  }{  <s>------</s>  }{  <code>``````</code>  }{ """"""  }{ '''''' }<br />
    474. 

  474. </p>
    475. 

  475. <a id="toc20" name="toc20"></a>
    476. 

  476. <h2>Invalid: No contents</h2>
    477. 

  477. <p>
    478. 

  478. {     ****     }{     ////     }{     ____     }{     ----     }{     ````     }{    """"     }{    '''' }<br />
    479. 

  479. {     ** **    }{     // //    }{     __ __    }{     -- --    }{     `` ``    }{    "" ""    }{    '' '' }<br />
    480. 

  480. </p>
    481. 

  481. <a id="toc21" name="toc21"></a>
    482. 

  482. <h2>Invalid: Contents not "glued" with marks</h2>
    483. 

  483. <p>
    484. 

  484. Spaces between the marks and the contents in any side
    485. 

  485. invalidate the mark.
    486. 

  486. </p>
    487. 

  487. <p>
    488. 

  488. {  ** bold**   }{  // ital//   }{  __ undr__   }{  -- strk--   }{  `` mono``   }{ "" raw""    }{ '' tggd'' }<br />
    489. 

  489. {  **bold **   }{  //ital //   }{  __undr __   }{  --strk --   }{  ``mono ``   }{ ""raw ""    }{ ''tggd '' }<br />
    490. 

  490. {  ** bold **  }{  // ital //  }{  __ undr __  }{  -- strk --  }{  `` mono ``  }{ "" raw ""   }{ '' tggd '' }<br />
    491. 

  491. </p>
    492. 

  492. <a id="link" name="link"></a>
    493. 

  493. <h1 class="section">Link</h1>
    494. 

  494. <a id="toc23" name="toc23"></a>
    495. 

  495. <h2>Syntax: E-mail</h2>
    496. 

  496. <p>
    497. 

  497. <a href="mailto:user@domain.com">user@domain.com</a><br />
    498. 

  498. <a href="mailto:user@domain.com">user@domain.com</a>.<br />
    499. 

  499. <a href="mailto:user@domain.com">user@domain.com</a>. any text.<br />
    500. 

  500. any text: <a href="mailto:user@domain.com">user@domain.com</a>. any text.<br />
    501. 

  501. <a href="mailto:user@domain.com">label</a><br />
    502. 

  502. </p>
    503. 

  503. <a id="toc24" name="toc24"></a>
    504. 

  504. <h2>Syntax: E-mail with form data</h2>
    505. 

  505. <p>
    506. 

  506. <a href="mailto:user@domain.com?subject=bla">user@domain.com?subject=bla</a><br />
    507. 

  507. <a href="mailto:user@domain.com?subject=bla.">user@domain.com?subject=bla.</a><br />
    508. 

  508. <a href="mailto:user@domain.com?subject=bla,">user@domain.com?subject=bla,</a><br />
    509. 

  509. <a href="mailto:user@domain.com?subject=bla&amp;cc=otheruser@domain.com">user@domain.com?subject=bla&amp;cc=otheruser@domain.com</a><br />
    510. 

  510. <a href="mailto:user@domain.com?subject=bla&amp;cc=otheruser@domain.com.">user@domain.com?subject=bla&amp;cc=otheruser@domain.com.</a><br />
    511. 

  511. <a href="mailto:user@domain.com?subject=bla&amp;cc=otheruser@domain.com,">user@domain.com?subject=bla&amp;cc=otheruser@domain.com,</a><br />
    512. 

  512. <a href="mailto:user@domain.com?subject=bla&amp;cc=otheruser@domain.com">label</a>.<br />
    513. 

  513. <a href="mailto:user@domain.com?subject=bla&amp;cc=otheruser@domain.com.">label</a>.<br />
    514. 

  514. </p>
    515. 

  515. <a id="toc25" name="toc25"></a>
    516. 

  516. <h2>Syntax: URL</h2>
    517. 

  517. <p>
    518. 

  518. <a href="http://www.domain.com">http://www.domain.com</a><br />
    519. 

  519. <a href="http://www.domain.com/dir/">http://www.domain.com/dir/</a><br />
    520. 

  520. <a href="http://www.domain.com/dir///">http://www.domain.com/dir///</a><br />
    521. 

  521. <a href="http://www.domain.com">http://www.domain.com</a>.<br />
    522. 

  522. <a href="http://www.domain.com">http://www.domain.com</a>,<br />
    523. 

  523. <a href="http://www.domain.com">http://www.domain.com</a>. any text.<br />
    524. 

  524. <a href="http://www.domain.com">http://www.domain.com</a>, any text.<br />
    525. 

  525. <a href="http://www.domain.com/dir/">http://www.domain.com/dir/</a>. any text.<br />
    526. 

  526. any text: <a href="http://www.domain.com">http://www.domain.com</a>. any text.<br />
    527. 

  527. any text: <a href="http://www.domain.com/dir/">http://www.domain.com/dir/</a>. any text.<br />
    528. 

  528. any text: <a href="http://www.domain.com/dir/index.html">http://www.domain.com/dir/index.html</a>. any text.<br />
    529. 

  529. any text: <a href="http://www.domain.com/dir/index.html">http://www.domain.com/dir/index.html</a>, any text.<br />
    530. 

  530. </p>
    531. 

  531. <a id="toc26" name="toc26"></a>
    532. 

  532. <h2>Syntax: URL with anchor</h2>
    533. 

  533. <p>
    534. 

  534. <a href="http://www.domain.com/dir/#anchor">http://www.domain.com/dir/#anchor</a><br />
    535. 

  535. <a href="http://www.domain.com/dir/index.html#anchor">http://www.domain.com/dir/index.html#anchor</a><br />
    536. 

  536. <a href="http://www.domain.com/dir/index.html#anchor.">http://www.domain.com/dir/index.html#anchor.</a><br />
    537. 

  537. <a href="http://www.domain.com/dir/#anchor.">http://www.domain.com/dir/#anchor.</a> any text.<br />
    538. 

  538. <a href="http://www.domain.com/dir/index.html#anchor.">http://www.domain.com/dir/index.html#anchor.</a> any text.<br />
    539. 

  539. any text: <a href="http://www.domain.com/dir/#anchor.">http://www.domain.com/dir/#anchor.</a> any text.<br />
    540. 

  540. any text: <a href="http://www.domain.com/dir/index.html#anchor.">http://www.domain.com/dir/index.html#anchor.</a> any text.<br />
    541. 

  541. </p>
    542. 

  542. <a id="toc27" name="toc27"></a>
    543. 

  543. <h2>Syntax: URL with form data</h2>
    544. 

  544. <p>
    545. 

  545. <a href="http://domain.com?a=a@a.a&amp;b=a+b+c.">http://domain.com?a=a@a.a&amp;b=a+b+c.</a><br />
    546. 

  546. <a href="http://domain.com?a=a@a.a&amp;b=a+b+c,">http://domain.com?a=a@a.a&amp;b=a+b+c,</a><br />
    547. 

  547. <a href="http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.">http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.</a><br />
    548. 

  548. <a href="http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@.">http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@.</a><br />
    549. 

  549. </p>
    550. 

  550. <a id="toc28" name="toc28"></a>
    551. 

  551. <h2>Syntax: URL with form data and anchor</h2>
    552. 

  552. <p>
    553. 

  553. <a href="http://domain.com?a=a@a.a&amp;b=a+b+c.#anchor">http://domain.com?a=a@a.a&amp;b=a+b+c.#anchor</a><br />
    554. 

  554. <a href="http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.#anchor">http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.#anchor</a><br />
    555. 

  555. <a href="http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@.#anchor">http://domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@.#anchor</a><br />
    556. 

  556. </p>
    557. 

  557. <a id="toc29" name="toc29"></a>
    558. 

  558. <h2>Syntax: URL with login data</h2>
    559. 

  559. <p>
    560. 

  560. <a href="http://user:password@domain.com/bla.html">http://user:password@domain.com/bla.html</a>.<br />
    561. 

  561. <a href="http://user:password@domain.com/dir/">http://user:password@domain.com/dir/</a>.<br />
    562. 

  562. <a href="http://user:password@domain.com">http://user:password@domain.com</a>.<br />
    563. 

  563. <a href="http://user:@domain.com">http://user:@domain.com</a>.<br />
    564. 

  564. <a href="http://user@domain.com">http://user@domain.com</a>.<br />
    565. 

  565. </p>
    566. 

  566. <a id="toc30" name="toc30"></a>
    567. 

  567. <h2>Syntax: URL with login, form and anchor</h2>
    568. 

  568. <p>
    569. 

  569. <a href="http://user:password@domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.#anchor">http://user:password@domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.#anchor</a><br />
    570. 

  570. <a href="http://user:password@domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@#anchor">http://user:password@domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c@#anchor</a><br />
    571. 

  571. </p>
    572. 

  572. <a id="toc31" name="toc31"></a>
    573. 

  573. <h2>Syntax: URL with label</h2>
    574. 

  574. <p>
    575. 

  575. <a href="http://www.domain.com">label</a><br />
    576. 

  576. </p>
    577. 

  577. <a id="toc32" name="toc32"></a>
    578. 

  578. <h2>Syntax: URL with label (trailing spaces are discarded, leading are maintained)</h2>
    579. 

  579. <p>
    580. 

  580. <a href="http://www.domain.com">  label</a><br />
    581. 

  581. <a href="http://www.domain.com">label</a><br />
    582. 

  582. </p>
    583. 

  583. <a id="toc33" name="toc33"></a>
    584. 

  584. <h2>Syntax: URL with label, stressing</h2>
    585. 

  585. <p>
    586. 

  586. <a href="http://www.domain.com/dir/index.html#anchor.">anchor</a><br />
    587. 

  587. <a href="http://user:password@domain.com/bla.html">login</a><br />
    588. 

  588. <a href="http://www.domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.">form</a><br />
    589. 

  589. <a href="http://www.domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.#anchor">form &amp; anchor</a><br />
    590. 

  590. <a href="http://user:password@domain.com/bla.cgi?a=a@a.a&amp;b=a+b+c.">login &amp; form</a><br />
    591. 

  591. </p>
    592. 

  592. <a id="toc34" name="toc34"></a>
    593. 

  593. <h2>Syntax: Link with label for local files</h2>
    594. 

  594. <p>
    595. 

  595. <a href="..">local link up</a><br />
    596. 

  596. <a href="bla.html">local link file</a><br />
    597. 

  597. <a href="#anchor">local link anchor</a><br />
    598. 

  598. <a href="bla.html#anchor">local link file/anchor</a><br />
    599. 

  599. <a href="bla.html#anchor.">local link file/anchor</a><br />
    600. 

  600. <a href="abc.gif">local link img</a><br />
    601. 

  601. </p>
    602. 

  602. <a id="toc35" name="toc35"></a>
    603. 

  603. <h2>Syntax: Another link as a label</h2>
    604. 

  604. <p>
    605. 

  605. <a href="http://www.domain.com">www.fake.com</a><br />
    606. 

  606. </p>
    607. 

  607. <a id="toc36" name="toc36"></a>
    608. 

  608. <h2>Syntax: URL with funny chars</h2>
    609. 

  609. <p>
    610. 

  610. <a href="http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm">http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm</a><br />
    611. 

  611. <a href="http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-">http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-</a><br />
    612. 

  612. <a href="http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-#anchor_-1%.">http://domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-#anchor_-1%.</a><br />
    613. 

  613. <a href="http://foo._user-9:pass!#$%&amp;*()+word@domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-#anchor_-1%.">http://foo._user-9:pass!#$%&amp;*()+word@domain.com:8080/~user/_st-r@a=n$g,e/index%20new.htm?a=/%22&amp;b=+.@*_-#anchor_-1%.</a><br />
    614. 

  614. </p>
    615. 

  615. <a id="toc37" name="toc37"></a>
    616. 

  616. <h2>Test: Various per line</h2>
    617. 

  617. <p>
    618. 

  618. <a href="http://L1.com">http://L1.com</a> ! <a href="mailto:L2@www.com">L2@www.com</a> ! <a href="http://www.com">L3</a> ! <a href="mailto:w@ww.com">L4</a> ! <a href="http://www.L5.com">www.L5.com</a><br />
    619. 

  619. </p>
    620. 

  620. <a id="toc38" name="toc38"></a>
    621. 

  621. <h2>Feature: Guessed link, adding protocol automatically</h2>
    622. 

  622. <p>
    623. 

  623. <a href="http://www.domain.com">www.domain.com</a><br />
    624. 

  624. <a href="http://www2.domain.com">www2.domain.com</a><br />
    625. 

  625. <a href="ftp://ftp.domain.com">ftp.domain.com</a><br />
    626. 

  626. <a href="http://WWW.DOMAIN.COM">WWW.DOMAIN.COM</a><br />
    627. 

  627. <a href="ftp://FTP.DOMAIN.COM">FTP.DOMAIN.COM</a><br />
    628. 

  628. <a href="http://www.domain.com">label</a><br />
    629. 

  629. <a href="ftp://ftp.domain.com">label</a><br />
    630. 

  630. <a href="http://WWW.DOMAIN.COM">label</a><br />
    631. 

  631. <a href="ftp://FTP.DOMAIN.COM">label</a><br />
    632. 

  632. </p>
    633. 

  633. <a id="toc39" name="toc39"></a>
    634. 

  634. <h2>Invalid: Trailing space on link</h2>
    635. 

  635. <p>
    636. 

  636. [label <a href="http://www.domain.com">www.domain.com</a> ]
    637. 

  637. </p>
    638. 

  638. <a id="toc40" name="toc40"></a>
    639. 

  639. <h2>Invalid: Label with ] char (use postproc)</h2>
    640. 

  640. <p>
    641. 

  641. [label] <a href="http://www.domain.com">www.domain.com</a>]
    642. 

  642. </p>
    643. 

  643. <a id="image" name="image"></a>
    644. 

  644. <h1 class="section">Image</h1>
    645. 

  645. <a id="toc42" name="toc42"></a>
    646. 

  646. <h2>Syntax: Image name inside brackets: [img]</h2>
    647. 

  647. <p>
    648. 

  648. <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/>
    649. 

  649. </p>
    650. 

  650. <a id="toc43" name="toc43"></a>
    651. 

  651. <h2>Syntax: Image pointing to a link: [[img] link]</h2>
    652. 

  652. <p>
    653. 

  653. <a href="http://txt2tags.org"><img align="middle" src="../img/t2tpowered.png" border="0" alt=""/></a><br />
    654. 

  654. </p>
    655. 

  655. <a id="toc44" name="toc44"></a>
    656. 

  656. <h2>Align: Image position is preserved when inside paragraph</h2>
    657. 

  657. <p>
    658. 

  658. <img align="left" src="../img/t2tpowered.png" border="0" alt=""/> Image at the line beginning.
    659. 

  659. </p>
    660. 

  660. <p>
    661. 

  661. Image in the middle <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/> of the line.
    662. 

  662. </p>
    663. 

  663. <p>
    664. 

  664. Image at the line end. <img align="right" src="../img/t2tpowered.png" border="0" alt=""/>
    665. 

  665. </p>
    666. 

  666. <a id="toc45" name="toc45"></a>
    667. 

  667. <h2>Align: Image alone with spaces around is aligned</h2>
    668. 

  668. <p>
    669. 

  669. <img align="left" src="../img/t2tpowered.png" border="0" alt=""/>   
    670. 

  670.                 <center><img align="middle" src="../img/t2tpowered.png" border="0" alt=""/></center>  
    671. 

  671.                                     <img align="right" src="../img/t2tpowered.png" border="0" alt=""/>
    672. 

  672. </p>
    673. 

  673. <a id="toc46" name="toc46"></a>
    674. 

  674. <h2>Test: Two glued images with no spaces (left &amp; right)</h2>
    675. 

  675. <p>
    676. 

  676. <img align="left" src="../img/t2tpowered.png" border="0" alt=""/><img align="right" src="../img/t2tpowered.png" border="0" alt=""/>
    677. 

  677. </p>
    678. 

  678. <a id="toc47" name="toc47"></a>
    679. 

  679. <h2>Test: Various per line</h2>
    680. 

  680. <p>
    681. 

  681. Images <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/> mixed <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/> with <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/> text.
    682. 

  682. </p>
    683. 

  683. <p>
    684. 

  684. Images glued together: <img align="middle" src="../img/t2tpowered.png" border="0" alt=""/><img align="middle" src="../img/t2tpowered.png" border="0" alt=""/><img align="middle" src="../img/t2tpowered.png" border="0" alt=""/>.
    685. 

  685. </p>
    686. 

  686. <a id="toc48" name="toc48"></a>
    687. 

  687. <h2>Invalid: Spaces inside are not allowed</h2>
    688. 

  688. <p>
    689. 

  689. [../img/t2tpowered.png ]
    690. 

  690. </p>
    691. 

  691. <p>
    692. 

  692. [ ../img/t2tpowered.png]
    693. 

  693. </p>
    694. 

  694. <p>
    695. 

  695. [ ../img/t2tpowered.png ]
    696. 

  696. </p>
    697. 

  697. <a id="macro" name="macro"></a>
    698. 

  698. <h1 class="section">Macro</h1>
    699. 

  699. <a id="toc50" name="toc50"></a>
    700. 

  700. <h2>Syntax: Macro without formatting string</h2>
    701. 

  701. <p>
    702. 

  702. Date    : 20081027 - 20081027<br />
    703. 

  703. Mtime   : 20081027 - 20081027<br />
    704. 

  704. Infile  : rules.t2t - rules.t2t<br />
    705. 

  705. Outfile : rules.html - rules.html<br />
    706. 

  706. </p>
    707. 

  707. <a id="toc51" name="toc51"></a>
    708. 

  708. <h2>Syntax: Macro name is case insensitive</h2>
    709. 

  709. <p>
    710. 

  710. Date    : 20081027<br />
    711. 

  711. Mtime   : 20081027<br />
    712. 

  712. Infile  : rules.t2t<br />
    713. 

  713. Outfile : rules.html<br />
    714. 

  714. </p>
    715. 

  715. <a id="toc52" name="toc52"></a>
    716. 

  716. <h2>Syntax: Macro with formatting string</h2>
    717. 

  717. <p>
    718. 

  718. Date    : txt 20 txt<br />
    719. 

  719. Mtime   : txt 20 txt<br />
    720. 

  720. Infile  : txt t2t txt<br />
    721. 

  721. Outfile : txt html txt<br />
    722. 

  722. </p>
    723. 

  723. <a id="toc53" name="toc53"></a>
    724. 

  724. <h2>Syntax: Leading and trailing spaces are preserved</h2>
    725. 

  725. <p>
    726. 

  726. Date    : ( txt ) - ( 20 )<br />
    727. 

  727. Mtime   : ( txt ) - ( 20 )<br />
    728. 

  728. Infile  : ( txt ) - ( t2t )<br />
    729. 

  729. Outfile : ( txt ) - ( html )<br />
    730. 

  730. </p>
    731. 

  731. <a id="toc54" name="toc54"></a>
    732. 

  732. <h2>Test: Expansion of the percent char</h2>
    733. 

  733. <p>
    734. 

  734. Date    : % - % - %% - %%<br />
    735. 

  735. Mtime   : % - % - %% - %%<br />
    736. 

  736. Infile  : % - % - %% - %%<br />
    737. 

  737. Outfile : % - % - %% - %%<br />
    738. 

  738. </p>
    739. 

  739. <a id="toc55" name="toc55"></a>
    740. 

  740. <h2>Test: Various per line, glued</h2>
    741. 

  741. <p>
    742. 

  742. Date    : 202008102720081027<br />
    743. 

  743. Mtime   : 202008102720081027<br />
    744. 

  744. Infile  : t2trules.t2trules.t2t<br />
    745. 

  745. Outfile : htmlrules.htmlrules.html<br />
    746. 

  746. </p>
    747. 

  747. <a id="toc56" name="toc56"></a>
    748. 

  748. <h2>Test: Path formatters</h2>
    749. 

  749. <p>
    750. 

  750. Path    : /a/pessoal/sourceforge.net/txt2tags/src/doc/English/rules/rules.t2t<br />
    751. 

  751. Path    : /a/pessoal/sourceforge.net/txt2tags/src/doc/English/rules.html<br />
    752. 

  752. Dirname : /a/pessoal/sourceforge.net/txt2tags/src/doc/English/rules, rules<br />
    753. 

  753. Dirname : /a/pessoal/sourceforge.net/txt2tags/src/doc/English, English<br />
    754. 

  754. File    : rules + t2t = rules.t2t<br />
    755. 

  755. File    : rules + html = rules.html<br />
    756. 

  756. </p>
    757. 

  757. <a id="numtitle" name="numtitle"></a>
    758. 

  758. <h1 class="section">Numbered Title</h1>
    759. 

  759. <p>
    760. 

  760. See <a href="#title">Title</a>, the same rules apply.
    761. 

  761. </p>
    762. 

  762. <a id="title" name="title"></a>
    763. 

  763. <h1 class="section">Title</h1>
    764. 

  764. <a id="toc59" name="toc59"></a>
    765. 

  765. <h2>Syntax: Balanced equal signs (from 1 to 5)</h2>
    766. 

  766. <a id="toc60" name="toc60"></a>
    767. 

  767. <h1>Title Level 1</h1>
    768. 

  768. <a id="toc61" name="toc61"></a>
    769. 

  769. <h2>Title Level 2</h2>
    770. 

  770. <h3>Title Level 3</h3>
    771. 

  771. <h4>Title Level 4</h4>
    772. 

  772. <h5>Title Level 5</h5>
    773. 

  773. <a id="toc62" name="toc62"></a>
    774. 

  774. <h2>Label: Between brackets, alphanumeric [A-Za-z0-9_-]</h2>
    775. 

  775. <a id="lab_el-1" name="lab_el-1"></a>
    776. 

  776. <h1>Title Level 1</h1>
    777. 

  777. <a id="lab_el-2" name="lab_el-2"></a>
    778. 

  778. <h2>Title Level 2</h2>
    779. 

  779. <a id="lab_el-3" name="lab_el-3"></a>
    780. 

  780. <h3>Title Level 3</h3>
    781. 

  781. <a id="lab_el-4" name="lab_el-4"></a>
    782. 

  782. <h4>Title Level 4</h4>
    783. 

  783. <a id="lab_el-5" name="lab_el-5"></a>
    784. 

  784. <h5>Title Level 5</h5>
    785. 

  785. <a id="toc65" name="toc65"></a>
    786. 

  786. <h2>Syntax: Spaces around and/or inside are allowed (and ignored)</h2>
    787. 

  787. <h3>Title Level 3</h3>
    788. 

  788. <h3>Title Level 3</h3>
    789. 

  789. <h3>Title Level 3</h3>
    790. 

  790. <h3>Title Level 3</h3>
    791. 

  791. <h3>Title Level 3</h3>
    792. 

  792. <a id="lab_el-9" name="lab_el-9"></a>
    793. 

  793. <h3>Title Level 3</h3>
    794. 

  794. <a id="toc66" name="toc66"></a>
    795. 

  795. <h2>Invalid: Unbalanced equal signs</h2>
    796. 

  796. <p>
    797. 

  797.       =Not Title
    798. 

  798. </p>
    799. 

  799. <p>
    800. 

  800.      ==Not Title=
    801. 

  801. </p>
    802. 

  802. <p>
    803. 

  803.     ===Not Title====
    804. 

  804. </p>
    805. 

  805. <a id="toc67" name="toc67"></a>
    806. 

  806. <h2>Invalid: Level deeper than 5</h2>
    807. 

  807. <p>
    808. 

  808.  ======Not Title 6======
    809. 

  809. </p>
    810. 

  810. <p>
    811. 

  811. =======Not Title 7=======
    812. 

  812. </p>
    813. 

  813. <a id="toc68" name="toc68"></a>
    814. 

  814. <h2>Invalid: Space between title and label</h2>
    815. 

  815. <p>
    816. 

  816. =Not Title= [label1]
    817. 

  817. </p>
    818. 

  818. <a id="toc69" name="toc69"></a>
    819. 

  819. <h2>Invalid: Space inside label</h2>
    820. 

  820. <p>
    821. 

  821. =Not Title=[ label ]
    822. 

  822. </p>
    823. 

  823. <a id="toc70" name="toc70"></a>
    824. 

  824. <h2>Invalid: Strange chars inside label</h2>
    825. 

  825. <p>
    826. 

  826. =Not Title=[la/bel]
    827. 

  827. </p>
    828. 

  828. <a id="quote" name="quote"></a>
    829. 

  829. <h1 class="section">Quote</h1>
    830. 

  830. <a id="toc72" name="toc72"></a>
    831. 

  831. <h2>Syntax: TAB defines quote</h2>
    832. 

  832. 	<blockquote>
    833. 

  833. 	To quote a paragraph, just prefix it by a TAB
    834. 

  834. 	character. All the lines of the paragraph must
    835. 

  835. 	begin with a TAB.
    836. 

  836. 	</blockquote>
    837. 

  837. <p>
    838. 

  838. Any non-tabbed line closes the quote block.
    839. 

  839. </p>
    840. 

  840. <a id="toc73" name="toc73"></a>
    841. 

  841. <h2>Nesting: Creating deeper quotes</h2>
    842. 

  842. 	<blockquote>
    843. 

  843. 	The number of leading TABs identifies the quote
    844. 

  844. 	block depth. This is quote level 1.
    845. 

  845. 		<blockquote>
    846. 

  846. 		With two TABs, we are on the quote
    847. 

  847. 		level 2.
    848. 

  848. 			<blockquote>
    849. 

  849. 			The more TABs, more deep is
    850. 

  850. 			the quote level.
    851. 

  851. 				<blockquote>
    852. 

  852. 				There isn't a limit.
    853. 

  853. 				</blockquote>
    854. 

  854. 			</blockquote>
    855. 

  855. 		</blockquote>
    856. 

  856. 	</blockquote>
    857. 

  857. <p></p>
    858. 

  858. <a id="toc74" name="toc74"></a>
    859. 

  859. <h2>Nesting: Reverse nesting works</h2>
    860. 

  860. 	<blockquote>
    861. 

  861. 		<blockquote>
    862. 

  862. 			<blockquote>
    863. 

  863. 				<blockquote>
    864. 

  864. 				This quote starts at
    865. 

  865. 				level 4.
    866. 

  866. 				</blockquote>
    867. 

  867. 			Then its depth is decreased.
    868. 

  868. 			</blockquote>
    869. 

  869. 		Counting down, one by one.
    870. 

  870. 		</blockquote>
    871. 

  871. 	Until the level 1.
    872. 

  872. 	</blockquote>
    873. 

  873. <p></p>
    874. 

  874. <a id="toc75" name="toc75"></a>
    875. 

  875. <h2>Nesting: Random count</h2>
    876. 

  876. 	<blockquote>
    877. 

  877. 		<blockquote>
    878. 

  878. 			<blockquote>
    879. 

  879. 			Unlike lists, any quote block is
    880. 

  880. 			independent, not part of a tree.
    881. 

  881. 			</blockquote>
    882. 

  882. 		</blockquote>
    883. 

  883. 	The TAB count don't need to be incremental
    884. 

  884. 	by one.
    885. 

  885. 		<blockquote>
    886. 

  886. 			<blockquote>
    887. 

  887. 				<blockquote>
    888. 

  888. 				The nesting don't need
    889. 

  889. 				to follow any rule.
    890. 

  890. 				</blockquote>
    891. 

  891. 			</blockquote>
    892. 

  892. 		Quotes can be opened and closed
    893. 

  893. 		in any way.
    894. 

  894. 			<blockquote>
    895. 

  895. 				<blockquote>
    896. 

  896. 					<blockquote>
    897. 

  897. 					You choose.
    898. 

  898. 					</blockquote>
    899. 

  899. 				</blockquote>
    900. 

  900. 			</blockquote>
    901. 

  901. 		</blockquote>
    902. 

  902. 	</blockquote>
    903. 

  903. <p></p>
    904. 

  904. <a id="toc76" name="toc76"></a>
    905. 

  905. <h2>Nesting: When not supported</h2>
    906. 

  906. 	<blockquote>
    907. 

  907. 	Some targets (as sgml) don't support the
    908. 

  908. 	nesting of quotes. There is only one quote
    909. 

  909. 	level.
    910. 

  910. 		<blockquote>
    911. 

  911. 		In this case, no matter how much
    912. 

  912. 		TABs are used to define the quote
    913. 

  913. 		block, it always will be level 1.
    914. 

  914. 		</blockquote>
    915. 

  915. 	</blockquote>
    916. 

  916. <p></p>
    917. 

  917. <a id="toc77" name="toc77"></a>
    918. 

  918. <h2>Syntax: Spaces after TAB</h2>
    919. 

  919. 	<blockquote>
    920. 

  920. 	  Spaces AFTER the TAB character are allowed.
    921. 

  921. 	  But be careful, it can be confusing.
    922. 

  922. 	</blockquote>
    923. 

  923. <p></p>
    924. 

  924. <a id="toc78" name="toc78"></a>
    925. 

  925. <h2>Invalid: Spaces before TAB</h2>
    926. 

  926. <p>
    927. 

  927.   	Spaces BEFORE the TAB character
    928. 

  928.   	invalidate the mark. It's not quote.
    929. 

  929. </p>
    930. 

  930. <a id="toc79" name="toc79"></a>
    931. 

  931. <h2>Invalid: Paragraphs inside</h2>
    932. 

  932. 	<blockquote>
    933. 

  933. 	Paragraph breaks inside a quote aren't
    934. 

  934. 	possible.
    935. 

  935. 	</blockquote>
    936. 

  936. <p></p>
    937. 

  937. 	<blockquote>
    938. 

  938. 	This sample are two separated quoted
    939. 

  939. 	paragraphs, not a quote block with
    940. 

  940. 	two paragraphs inside.
    941. 

  941. 	</blockquote>
    942. 

  942. <p></p>
    943. 

  943. <a id="toc80" name="toc80"></a>
    944. 

  944. <h2>Closing: EOF closes the open block</h2>
    945. 

  945. 	<blockquote>
    946. 

  946. 	The end of the file (EOF) closes the
    947. 

  947. 	currently open quote block.
    948. 

  948. 	</blockquote>
    949. 

  949. <p></p>
    950. 

  950. <a id="raw" name="raw"></a>
    951. 

  951. <h1 class="section">Raw</h1>
    952. 

  952. <p>
    953. 

  953. See <a href="#verbatim">Verbatim</a>, the same rules apply.
    954. 

  954. </p>
    955. 

  955. <a id="tagged" name="tagged"></a>
    956. 

  956. <h1 class="section">Tagged</h1>
    957. 

  957. <p>
    958. 

  958. See <a href="#verbatim">Verbatim</a>, the same rules apply.
    959. 

  959. </p>
    960. 

  960. <a id="verbatim" name="verbatim"></a>
    961. 

  961. <h1 class="section">Verbatim</h1>
    962. 

  962. <a id="toc84" name="toc84"></a>
    963. 

  963. <h2>Syntax: A single line</h2>
    964. 

  964. <pre>
    965. 

  965. A verbatim line.
    966. 

  966. </pre>
    967. 

  967. <p></p>
    968. 

  968. <a id="toc85" name="toc85"></a>
    969. 

  969. <h2>Syntax: A single line with leading spaces</h2>
    970. 

  970. <pre>
    971. 

  971.   Another verbatim line, with leading spaces.
    972. 

  972. </pre>
    973. 

  973. <p></p>
    974. 

  974. <a id="toc86" name="toc86"></a>
    975. 

  975. <h2>Syntax: Area (block)</h2>
    976. 

  976. <pre>
    977. 

  977. A verbatim area delimited
    978. 

  978.        by lines with marks.
    979. 

  979. </pre>
    980. 

  980. <p></p>
    981. 

  981. <a id="toc87" name="toc87"></a>
    982. 

  982. <h2>Syntax: Area (block) with trailing spaces</h2>
    983. 

  983. <pre>
    984. 

  984. Trailing spaces and TABs after the area marks
    985. 

  985. are allowed, but not encouraged nor documented.
    986. 

  986. </pre>
    987. 

  987. <p></p>
    988. 

  988. <a id="toc88" name="toc88"></a>
    989. 

  989. <h2>Invalid: No space between mark and contents</h2>
    990. 

  990. <p>
    991. 

  991. ```Not a verbatim line, need one space after mark.
    992. 

  992. </p>
    993. 

  993. <a id="toc89" name="toc89"></a>
    994. 

  994. <h2>Invalid: Leading spaces on block marks</h2>
    995. 

  995. <p>
    996. 

  996.   ```
    997. 

  997.   Not a verbatim area.
    998. 

  998.   The marks must be at the line beginning,
    999. 

  999.   no leading spaces.
    1000. 

  1000.   ```
    1001. 

  1001. </p>
    1002. 

  1002. <a id="toc90" name="toc90"></a>
    1003. 

  1003. <h2>Closing: EOF closes the open block</h2>
    1004. 

  1004. <pre>
    1005. 

  1005. The end of the file (EOF) closes
    1006. 

  1006. the currently open verbatim area.
    1007. 

  1007. </pre>
    1008. 

  1008. <p></p>
    1009. 

  1009. <a id="deflist" name="deflist"></a>
    1010. 

  1010. <h1 class="section">Definition List</h1>
    1011. 

  1011. <p>
    1012. 

  1012. See <a href="#list">List</a>, the same rules apply.
    1013. 

  1013. </p>
    1014. 

  1014. <a id="numlist" name="numlist"></a>
    1015. 

  1015. <h1 class="section">Numbered List</h1>
    1016. 

  1016. <p>
    1017. 

  1017. See <a href="#list">List</a>, the same rules apply.
    1018. 

  1018. </p>
    1019. 

  1019. <a id="list" name="list"></a>
    1020. 

  1020. <h1 class="section">List</h1>
    1021. 

  1021. <a id="toc94" name="toc94"></a>
    1022. 

  1022. <h2>Items: Prefixed by hyphen</h2>
    1023. 

  1023. <ul>
    1024. 

  1024. <li>Use the hyphen to prefix list items.
    1025. 

  1025. </li>
    1026. 

  1026. <li>There must be one space after the hyphen.
    1027. 

  1027. </li>
    1028. 

  1028. <li>The list is closed by two consecutive blank lines.
    1029. 

  1029. </li>
    1030. 

  1030. </ul>
    1031. 

    1032. 

  1032. <a id="toc95" name="toc95"></a>
    1033. 

  1033. <h2>Items: Free leading spacing (indentation)</h2>
    1034. 

  1034.      <ul>
    1035. 

  1035.      <li>The list can be indented on the source document.
    1036. 

  1036.      </li>
    1037. 

  1037.      <li>You can use any number of spaces.
    1038. 

  1038.      </li>
    1039. 

  1039.      <li>The result will be the same.
    1040. 

  1040.      </li>
    1041. 

  1041.      </ul>
    1042. 

    1043. 

  1043. <a id="toc96" name="toc96"></a>
    1044. 

  1044. <h2>Items: Vertical spacing between items</h2>
    1045. 

  1045. <ul>
    1046. 

  1046. <li>Let one blank line between the list items.
    1047. 

  1047. <p></p>
    1048. 

  1048. </li>
    1049. 

  1049. <li>It will be maintained on the conversion.
    1050. 

  1050. <p></p>
    1051. 

  1051. </li>
    1052. 

  1052. <li>Some targets don't support this behavior.
    1053. 

  1053. <p></p>
    1054. 

  1054. </li>
    1055. 

  1055. <li>This one was separated by a line with blanks.
    1056. 

  1056.   You can also put a blank line inside
    1057. 

  1057. <p></p>
    1058. 

  1058.   the item contents and it will be preserved.
    1059. 

  1059. </li>
    1060. 

  1060. </ul>
    1061. 

    1062. 

  1062. <a id="toc97" name="toc97"></a>
    1063. 

  1063. <h2>Items: Exactly ONE space after the hyphen</h2>
    1064. 

  1064. <p>
    1065. 

  1065. -This is not a list (no space)
    1066. 

  1066. </p>
    1067. 

  1067. <p>
    1068. 

  1068. -    This is not a list (more than one space)
    1069. 

  1069. </p>
    1070. 

  1070. <p>
    1071. 

  1071. -	This is not a list (a TAB instead the space)
    1072. 

  1072. </p>
    1073. 

  1073. <a id="toc98" name="toc98"></a>
    1074. 

  1074. <h2>Items: Catchy cases</h2>
    1075. 

  1075. <ul>
    1076. 

  1076. <li>- This is a list
    1077. 

  1077. </li>
    1078. 

  1078. <li>+ This is a list
    1079. 

  1079. </li>
    1080. 

  1080. <li>: This is a list
    1081. 

  1081. </li>
    1082. 

  1082. </ul>
    1083. 

    1084. 

  1084. <a id="toc99" name="toc99"></a>
    1085. 

  1085. <h2>Nesting: Creating sublists</h2>
    1086. 

  1086. <ul>
    1087. 

  1087. <li>This is the "mother" list first item.
    1088. 

  1088. </li>
    1089. 

  1089. <li>Here is the second, but inside this item,
    1090. 

  1090.   <ul>
    1091. 

  1091.   <li>there is a sublist, with its own items.
    1092. 

  1092.   </li>
    1093. 

  1093.   <li>Note that the items of the same sublist
    1094. 

  1094.   </li>
    1095. 

  1095.   <li>must have the same indentation.
    1096. 

  1096.     <ul>
    1097. 

  1097.     <li>And this can go on, opening sublists.
    1098. 

  1098.       <ul>
    1099. 

  1099.       <li>Just add leading spaces before the
    1100. 

  1100.       </li>
    1101. 

  1101.       <li>hyphen and sublists will be opened.
    1102. 

  1102.       </li>
    1103. 

  1103.       <li>The two blank lines closes them all.
    1104. 

  1104.       </li>
    1105. 

  1105.       </ul>
    1106. 

  1106.     </li>
    1107. 

  1107.     </ul>
    1108. 

  1108.   </li>
    1109. 

  1109.   </ul>
    1110. 

  1110. </li>
    1111. 

  1111. </ul>
    1112. 

    1113. 

  1113. <a id="toc100" name="toc100"></a>
    1114. 

  1114. <h2>Nesting: Free leading spacing (indentation)</h2>
    1115. 

  1115. <ul>
    1116. 

  1116. <li>When nesting lists, the additional spaces are free.
    1117. 

  1117.  <ul>
    1118. 

  1118.  <li>You can add just one,
    1119. 

  1119.         <ul>
    1120. 

  1120.         <li>or many.
    1121. 

  1121.           <ul>
    1122. 

  1122.           <li>What matters is to put more than the previous.
    1123. 

  1123.           </li>
    1124. 

  1124.           <li>But remember that the other items of the same list
    1125. 

  1125.           </li>
    1126. 

  1126.           <li>must use the same indentation.
    1127. 

  1127.           </li>
    1128. 

  1128.           </ul>
    1129. 

  1129.         </li>
    1130. 

  1130.         </ul>
    1131. 

  1131.  </li>
    1132. 

  1132.  </ul>
    1133. 

  1133. </li>
    1134. 

  1134. </ul>
    1135. 

    1136. 

  1136. <a id="toc101" name="toc101"></a>
    1137. 

  1137. <h2>Nesting: Maximum depth</h2>
    1138. 

  1138. <ul>
    1139. 

  1139. <li>There is not a depth limit,
    1140. 

  1140.   <ul>
    1141. 

  1141.   <li>you can go deeper and deeper.
    1142. 

  1142.     <ul>
    1143. 

  1143.     <li>But some targets may have restrictions.
    1144. 

  1144.       <ul>
    1145. 

  1145.       <li>The LaTeX maximum is here, 4 levels.
    1146. 

  1146.         <ul>
    1147. 

  1147.         <li>This one and the following sublists
    1148. 

  1148.           <ul>
    1149. 

  1149.           <li>are moved up to the level 4
    1150. 

  1150.             <ul>
    1151. 

  1151.             <li>when converting to LaTeX.
    1152. 

  1152.               <ul>
    1153. 

  1153.               <li>On the other targets,
    1154. 

  1154.                 <ul>
    1155. 

  1155.                 <li>it is just fine
    1156. 

  1156.                   <ul>
    1157. 

  1157.                   <li>to have a very deep list.
    1158. 

  1158.                   </li>
    1159. 

  1159.                   </ul>
    1160. 

  1160.                 </li>
    1161. 

  1161.                 </ul>
    1162. 

  1162.               </li>
    1163. 

  1163.               </ul>
    1164. 

  1164.             </li>
    1165. 

  1165.             </ul>
    1166. 

  1166.           </li>
    1167. 

  1167.           </ul>
    1168. 

  1168.         </li>
    1169. 

  1169.         </ul>
    1170. 

  1170.       </li>
    1171. 

  1171.       </ul>
    1172. 

  1172.     </li>
    1173. 

  1173.     </ul>
    1174. 

  1174.   </li>
    1175. 

  1175.   </ul>
    1176. 

  1176. </li>
    1177. 

  1177. </ul>
    1178. 

    1179. 

  1179. <a id="toc102" name="toc102"></a>
    1180. 

  1180. <h2>Nesting: Reverse doesn't work</h2>
    1181. 

  1181.         <ul>
    1182. 

  1182.         <li>Reverse nesting doesn't work.
    1183. 

  1183.         </li>
    1184. 

  1184.         </ul>
    1185. 

    1186. 

  1186.       <ul>
    1187. 

  1187.       <li>Because a sublist *must* have a mother list.
    1188. 

  1188.       </li>
    1189. 

  1189.       </ul>
    1190. 

    1191. 

  1191.     <ul>
    1192. 

  1192.     <li>It's the list concept, not a txt2tags limitation.
    1193. 

  1193.     </li>
    1194. 

  1194.     </ul>
    1195. 

    1196. 

  1196.   <ul>
    1197. 

  1197.   <li>All this sublists will be bumped to mother lists.
    1198. 

  1198.   </li>
    1199. 

  1199.   </ul>
    1200. 

    1201. 

  1201. <ul>
    1202. 

  1202. <li>At level 1, like this one.
    1203. 

  1203. </li>
    1204. 

  1204. </ul>
    1205. 

    1206. 

  1206. <a id="toc103" name="toc103"></a>
    1207. 

  1207. <h2>Nesting: Going deeper and back</h2>
    1208. 

  1208. <p>
    1209. 

  1209. When nesting back to an upper level, the previous sublist
    1210. 

  1210. is automatically closed.
    1211. 

  1211. </p>
    1212. 

  1212. <ul>
    1213. 

  1213. <li>Level 1
    1214. 

  1214.   <ul>
    1215. 

  1215.   <li>Level 2
    1216. 

  1216.     <ul>
    1217. 

  1217.     <li>Level 3
    1218. 

  1218.       <ul>
    1219. 

  1219.       <li>Level 4
    1220. 

  1220.       </li>
    1221. 

  1221.       </ul>
    1222. 

  1222.     </li>
    1223. 

  1223.     <li>Level 3 -- (closed Level 4)
    1224. 

  1224.     </li>
    1225. 

  1225.     </ul>
    1226. 

  1226.   </li>
    1227. 

  1227.   <li>Level 2 -- (closed Level 3)
    1228. 

  1228.   </li>
    1229. 

  1229.   </ul>
    1230. 

  1230. </li>
    1231. 

  1231. <li>Level 1 -- (closed Level 2)
    1232. 

  1232. </li>
    1233. 

  1233. </ul>
    1234. 

    1235. 

  1235. <p>
    1236. 

  1236. More than one list can be closed when nesting back.
    1237. 

  1237. </p>
    1238. 

  1238. <ul>
    1239. 

  1239. <li>Level 1
    1240. 

  1240.   <ul>
    1241. 

  1241.   <li>Level 2
    1242. 

  1242.     <ul>
    1243. 

  1243.     <li>Level 3
    1244. 

  1244.       <ul>
    1245. 

  1245.       <li>Level 4
    1246. 

  1246.       </li>
    1247. 

  1247.       </ul>
    1248. 

  1248.     </li>
    1249. 

  1249.     </ul>
    1250. 

  1250.   </li>
    1251. 

  1251.   </ul>
    1252. 

  1252. </li>
    1253. 

  1253. <li>Level 1 -- (closed Level 4, Level 3 and Level 2)
    1254. 

  1254. </li>
    1255. 

  1255. </ul>
    1256. 

    1257. 

  1257. <a id="toc104" name="toc104"></a>
    1258. 

  1258. <h2>Nesting: Vertical spacing between lists</h2>
    1259. 

  1259. <ul>
    1260. 

  1260. <li>Level 1
    1261. 

  1261. <p></p>
    1262. 

  1262.   <ul>
    1263. 

  1263.   <li>Level 2 -- blank BEFORE and AFTER (in)
    1264. 

  1264.   <p></p>
    1265. 

  1265.     <ul>
    1266. 

  1266.     <li>Level 3
    1267. 

  1267.       <ul>
    1268. 

  1268.       <li>Level 4
    1269. 

  1269.       </li>
    1270. 

  1270.       </ul>
    1271. 

  1271.     </li>
    1272. 

  1272.     <li>Level 3
    1273. 

  1273.     <p></p>
    1274. 

  1274.     </li>
    1275. 

  1275.     </ul>
    1276. 

  1276.   </li>
    1277. 

  1277.   <li>Level 2 -- blank BEFORE and AFTER (out)
    1278. 

  1278.   <p></p>
    1279. 

  1279.   </li>
    1280. 

  1280.   </ul>
    1281. 

  1281. </li>
    1282. 

  1282. <li>Level 1
    1283. 

  1283. <p></p>
    1284. 

  1284.   <ul>
    1285. 

  1285.   <li>Level 2 -- blank BEFORE (spaces) and AFTER (TAB)
    1286. 

  1286.   <p></p>
    1287. 

  1287.     <ul>
    1288. 

  1288.     <li>Level 3
    1289. 

  1289.     </li>
    1290. 

  1290.     </ul>
    1291. 

  1291.   </li>
    1292. 

  1292.   </ul>
    1293. 

  1293. </li>
    1294. 

  1294. </ul>
    1295. 

    1296. 

  1296. <a id="toc105" name="toc105"></a>
    1297. 

  1297. <h2>Nesting: Messing up</h2>
    1298. 

  1298. <p>
    1299. 

  1299. Be careful when going back on the nesting,
    1300. 

  1300. it must be on a valid level! If not, it will
    1301. 

  1301. be bumped up to the previous valid level.
    1302. 

  1302. </p>
    1303. 

  1303. <ul>
    1304. 

  1304. <li>Level 1
    1305. 

  1305.     <ul>
    1306. 

  1306.     <li>Level 2
    1307. 

  1307.         <ul>
    1308. 

  1308.         <li>Level 3
    1309. 

  1309.             <ul>
    1310. 

  1310.             <li>Level 4
    1311. 

  1311.             </li>
    1312. 

  1312.             </ul>
    1313. 

  1313.         </li>
    1314. 

  1314.         <li>Level 3.5 ???
    1315. 

  1315.         </li>
    1316. 

  1316.         <li>Level 3
    1317. 

  1317.         </li>
    1318. 

  1318.         </ul>
    1319. 

  1319.     </li>
    1320. 

  1320.     <li>Level 2.5 ???
    1321. 

  1321.     </li>
    1322. 

  1322.     <li>Level 2
    1323. 

  1323.     </li>
    1324. 

  1324.     </ul>
    1325. 

  1325. </li>
    1326. 

  1326. <li>Level 1.5 ???
    1327. 

  1327. </li>
    1328. 

  1328. <li>Level 1
    1329. 

  1329. </li>
    1330. 

  1330. </ul>
    1331. 

    1332. 

  1332. <a id="toc106" name="toc106"></a>
    1333. 

  1333. <h2>Closing: Two (not so) empty lines</h2>
    1334. 

  1334. <ul>
    1335. 

  1335. <li>This list is closed by a line with spaces and other with TABs
    1336. 

  1336. </li>
    1337. 

  1337. </ul>
    1338. 

    1339. 

  1339. <ul>
    1340. 

  1340. <li>This list is NOT closed by two comment lines
    1341. 

  1341. </li>
    1342. 

  1342. <li>This list is closed by a line with spaces and TAB,
    1343. 

  1343. </li>
    1344. 

  1344. <li>then a comment line, then an empty line.
    1345. 

  1345. </li>
    1346. 

  1346. </ul>
    1347. 

    1348. 

  1348. <a id="toc107" name="toc107"></a>
    1349. 

  1349. <h2>Closing: Empty item closes current (sub)list</h2>
    1350. 

  1350. <p>
    1351. 

  1351. The two blank lines closes ALL the lists.
    1352. 

  1352. To close just the current, use an empty item.
    1353. 

  1353. </p>
    1354. 

  1354. <ul>
    1355. 

  1355. <li>Level 1
    1356. 

  1356.   <ul>
    1357. 

  1357.   <li>Level 2
    1358. 

  1358.     <ul>
    1359. 

  1359.     <li>Level 3
    1360. 

  1360.     </li>
    1361. 

  1361.     </ul>
    1362. 

  1362.     Level 2
    1363. 

  1363.   </li>
    1364. 

  1364.   </ul>
    1365. 

  1365.   Level 1
    1366. 

  1366. </li>
    1367. 

  1367. </ul>
    1368. 

    1369. 

  1369. <p></p>
    1370. 

  1370. <p>
    1371. 

  1371. The empty item can have trailing blanks.
    1372. 

  1372. </p>
    1373. 

  1373. <ul>
    1374. 

  1374. <li>Empty item with trailing spaces.
    1375. 

  1375. </li>
    1376. 

  1376. </ul>
    1377. 

    1378. 

  1378. <p></p>
    1379. 

  1379. <ul>
    1380. 

  1380. <li>Empty item with trailing TAB.
    1381. 

  1381. </li>
    1382. 

  1382. </ul>
    1383. 

    1384. 

  1384. <p></p>
    1385. 

  1385. <a id="toc108" name="toc108"></a>
    1386. 

  1386. <h2>Closing: EOF closes the lists</h2>
    1387. 

  1387. <ul>
    1388. 

  1388. <li>If the end of the file (EOF) is hit,
    1389. 

  1389.   <ul>
    1390. 

  1390.   <li>all the currently opened list are closed,
    1391. 

  1391.     <ul>
    1392. 

  1392.     <li>just like when using the two blank lines.
    1393. 

  1393.     </li>
    1394. 

  1394.     </ul>
    1395. 

  1395.   </li>
    1396. 

  1396.   </ul>
    1397. 

  1397. </li>
    1398. 

  1398. </ul>
    1399. 

    1400. 

  1400. <a id="table" name="table"></a>
    1401. 

  1401. <h1 class="section">Table</h1>
    1402. 

  1402. <a id="toc110" name="toc110"></a>
    1403. 

  1403. <h2>Syntax: Lines starting with a pipe |</h2>
    1404. 

  1404. <table>
    1405. 

  1405. <tr>
    1406. 

  1406. <td>Cell 1</td>
    1407. 

  1407. </tr>
    1408. 

  1408. </table>
    1409. 

    1410. 

  1410. <a id="toc111" name="toc111"></a>
    1411. 

  1411. <h2>Syntax: Extra pipes separate cells</h2>
    1412. 

  1412. <table>
    1413. 

  1413. <tr>
    1414. 

  1414. <td>Cell 1</td>
    1415. 

  1415. <td>Cell 2</td>
    1416. 

  1416. <td>Cell 3</td>
    1417. 

  1417. </tr>
    1418. 

  1418. </table>
    1419. 

    1420. 

  1420. <a id="toc112" name="toc112"></a>
    1421. 

  1421. <h2>Syntax: With a trailing pipe, make border</h2>
    1422. 

  1422. <table border="1">
    1423. 

  1423. <tr>
    1424. 

  1424. <td>Cell 1</td>
    1425. 

  1425. <td>Cell 2</td>
    1426. 

  1426. <td>Cell 3</td>
    1427. 

  1427. </tr>
    1428. 

  1428. </table>
    1429. 

    1430. 

  1430. <a id="toc113" name="toc113"></a>
    1431. 

  1431. <h2>Syntax: Table lines starting with double pipe are heading</h2>
    1432. 

  1432. <table border="1">
    1433. 

  1433. <tr>
    1434. 

  1434. <th>Cell 1</th>
    1435. 

  1435. <th>Cell 2</th>
    1436. 

  1436. <th>Cell 3</th>
    1437. 

  1437. </tr>
    1438. 

  1438. </table>
    1439. 

    1440. 

  1440. <a id="toc114" name="toc114"></a>
    1441. 

  1441. <h2>Align: Spaces before the leading pipe centralize the table</h2>
    1442. 

  1442. <table align="center" border="1">
    1443. 

  1443. <tr>
    1444. 

  1444. <td>Cell 1</td>
    1445. 

  1445. <td>Cell 2</td>
    1446. 

  1446. <td>Cell 3</td>
    1447. 

  1447. </tr>
    1448. 

  1448. </table>
    1449. 

    1450. 

  1450. <a id="toc115" name="toc115"></a>
    1451. 

  1451. <h2>Align: Spaces inside the cell denote its alignment</h2>
    1452. 

  1452. <table align="center" border="1">
    1453. 

  1453. <tr>
    1454. 

  1454. <th>Heading</th>
    1455. 

  1455. <th>Heading</th>
    1456. 

  1456. <th>Heading</th>
    1457. 

  1457. </tr>
    1458. 

  1458. <tr>
    1459. 

  1459. <td>&lt;-</td>
    1460. 

  1460. <td align="center">--</td>
    1461. 

  1461. <td align="right">-&gt;</td>
    1462. 

  1462. </tr>
    1463. 

  1463. <tr>
    1464. 

  1464. <td align="center">--</td>
    1465. 

  1465. <td align="center">--</td>
    1466. 

  1466. <td align="center">--</td>
    1467. 

  1467. </tr>
    1468. 

  1468. <tr>
    1469. 

  1469. <td align="right">-&gt;</td>
    1470. 

  1470. <td align="center">--</td>
    1471. 

  1471. <td>&lt;-</td>
    1472. 

  1472. </tr>
    1473. 

  1473. </table>
    1474. 

    1475. 

  1475. <a id="toc116" name="toc116"></a>
    1476. 

  1476. <h2>Span: Column span is defined by extra pipes at cell closing</h2>
    1477. 

  1477. <table align="center" border="1">
    1478. 

  1478. <tr>
    1479. 

  1479. <th>1</th>
    1480. 

  1480. <th>2</th>
    1481. 

  1481. <th colspan="2">3+4</th>
    1482. 

  1482. </tr>
    1483. 

  1483. <tr>
    1484. 

  1484. <td align="center">1</td>
    1485. 

  1485. <td align="center">2</td>
    1486. 

  1486. <td align="center">3</td>
    1487. 

  1487. <td align="center">4</td>
    1488. 

  1488. </tr>
    1489. 

  1489. <tr>
    1490. 

  1490. <td align="center" colspan="3">1+2+3</td>
    1491. 

  1491. <td align="center">4</td>
    1492. 

  1492. </tr>
    1493. 

  1493. <tr>
    1494. 

  1494. <td align="center">1</td>
    1495. 

  1495. <td align="center" colspan="2">2+3</td>
    1496. 

  1496. <td align="center">4</td>
    1497. 

  1497. </tr>
    1498. 

  1498. <tr>
    1499. 

  1499. <td align="center" colspan="4">1+2+3+4</td>
    1500. 

  1500. </tr>
    1501. 

  1501. </table>
    1502. 

    1503. 

  1503. <a id="toc117" name="toc117"></a>
    1504. 

  1504. <h2>Test: Empty cells are placed as expected</h2>
    1505. 

  1505. <table align="center" border="1">
    1506. 

  1506. <tr>
    1507. 

  1507. <td>0</td>
    1508. 

  1508. <td>1</td>
    1509. 

  1509. <td>2</td>
    1510. 

  1510. <td></td>
    1511. 

  1511. </tr>
    1512. 

  1512. <tr>
    1513. 

  1513. <td>4</td>
    1514. 

  1514. <td>5</td>
    1515. 

  1515. <td></td>
    1516. 

  1516. <td>7</td>
    1517. 

  1517. </tr>
    1518. 

  1518. <tr>
    1519. 

  1519. <td>8</td>
    1520. 

  1520. <td></td>
    1521. 

  1521. <td>A</td>
    1522. 

  1522. <td>B</td>
    1523. 

  1523. </tr>
    1524. 

  1524. <tr>
    1525. 

  1525. <td></td>
    1526. 

  1526. <td>D</td>
    1527. 

  1527. <td>E</td>
    1528. 

  1528. <td>F</td>
    1529. 

  1529. </tr>
    1530. 

  1530. </table>
    1531. 

    1532. 

  1532. <a id="toc118" name="toc118"></a>
    1533. 

  1533. <h2>Test: Lines with different number of cells</h2>
    1534. 

  1534. <table align="center" border="1">
    1535. 

  1535. <tr>
    1536. 

  1536. <td>1</td>
    1537. 

  1537. </tr>
    1538. 

  1538. <tr>
    1539. 

  1539. <td>1</td>
    1540. 

  1540. <td>2</td>
    1541. 

  1541. </tr>
    1542. 

  1542. <tr>
    1543. 

  1543. <td>1</td>
    1544. 

  1544. <td>2</td>
    1545. 

  1545. <td>3</td>
    1546. 

  1546. </tr>
    1547. 

  1547. <tr>
    1548. 

  1548. <td>1</td>
    1549. 

  1549. <td>2</td>
    1550. 

  1550. <td>3</td>
    1551. 

  1551. <td>4</td>
    1552. 

  1552. </tr>
    1553. 

  1553. <tr>
    1554. 

  1554. <td>1</td>
    1555. 

  1555. <td>2</td>
    1556. 

  1556. <td>3</td>
    1557. 

  1557. <td>4</td>
    1558. 

  1558. <td>5</td>
    1559. 

  1559. </tr>
    1560. 

  1560. </table>
    1561. 

    1562. 

  1562. <a id="toc119" name="toc119"></a>
    1563. 

  1563. <h2>Test: Empty cells + Span + Messy cell number = Fun!</h2>
    1564. 

  1564. <table align="center" border="1">
    1565. 

  1565. <tr>
    1566. 

  1566. <td align="right">Jan</td>
    1567. 

  1567. </tr>
    1568. 

  1568. <tr>
    1569. 

  1569. <td align="right" colspan="2">Fev</td>
    1570. 

  1570. </tr>
    1571. 

  1571. <tr>
    1572. 

  1572. <td align="right" colspan="3">Mar</td>
    1573. 

  1573. </tr>
    1574. 

  1574. <tr>
    1575. 

  1575. <td align="right" colspan="4">Apr</td>
    1576. 

  1576. </tr>
    1577. 

  1577. <tr>
    1578. 

  1578. <td align="right" colspan="5">May</td>
    1579. 

  1579. </tr>
    1580. 

  1580. <tr>
    1581. 

  1581. <td align="center">20%</td>
    1582. 

  1582. <td align="center">40%</td>
    1583. 

  1583. <td align="center">60%</td>
    1584. 

  1584. <td align="center">80%</td>
    1585. 

  1585. <td align="center">100%</td>
    1586. 

  1586. </tr>
    1587. 

  1587. </table>
    1588. 

    1589. 

  1589. <table align="center" border="1">
    1590. 

  1590. <tr>
    1591. 

  1591. <td></td>
    1592. 

  1592. <td></td>
    1593. 

  1593. <td align="center">/</td>
    1594. 

  1594. <td></td>
    1595. 

  1595. <td></td>
    1596. 

  1596. </tr>
    1597. 

  1597. <tr>
    1598. 

  1598. <td></td>
    1599. 

  1599. <td align="center" colspan="3">/ / / / /</td>
    1600. 

  1600. <td></td>
    1601. 

  1601. </tr>
    1602. 

  1602. <tr>
    1603. 

  1603. <td align="center" colspan="5">/ / / / / / / / /</td>
    1604. 

  1604. </tr>
    1605. 

  1605. <tr>
    1606. 

  1606. <td></td>
    1607. 

  1607. <td align="center">o</td>
    1608. 

  1608. <td></td>
    1609. 

  1609. <td align="center">o</td>
    1610. 

  1610. <td></td>
    1611. 

  1611. </tr>
    1612. 

  1612. <tr>
    1613. 

  1613. <td></td>
    1614. 

  1614. <td></td>
    1615. 

  1615. <td align="right">.</td>
    1616. 

  1616. <td></td>
    1617. 

  1617. <td></td>
    1618. 

  1618. </tr>
    1619. 

  1619. <tr>
    1620. 

  1620. <td></td>
    1621. 

  1621. <td align="center" colspan="3">= = = =</td>
    1622. 

  1622. <td></td>
    1623. 

  1623. </tr>
    1624. 

  1624. </table>
    1625. 

    1626. 

  1626. <table align="center" border="1">
    1627. 

  1627. <tr>
    1628. 

  1628. <td>01</td>
    1629. 

  1629. <td>02</td>
    1630. 

  1630. <td></td>
    1631. 

  1631. <td></td>
    1632. 

  1632. <td>05</td>
    1633. 

  1633. <td></td>
    1634. 

  1634. <td>07</td>
    1635. 

  1635. <td></td>
    1636. 

  1636. </tr>
    1637. 

  1637. <tr>
    1638. 

  1638. <td></td>
    1639. 

  1639. <td></td>
    1640. 

  1640. <td>11</td>
    1641. 

  1641. <td></td>
    1642. 

  1642. <td>13</td>
    1643. 

  1643. <td></td>
    1644. 

  1644. <td></td>
    1645. 

  1645. <td>16</td>
    1646. 

  1646. </tr>
    1647. 

  1647. <tr>
    1648. 

  1648. <td>17</td>
    1649. 

  1649. <td></td>
    1650. 

  1650. <td>19</td>
    1651. 

  1651. <td>20</td>
    1652. 

  1652. <td></td>
    1653. 

  1653. <td></td>
    1654. 

  1654. <td>23</td>
    1655. 

  1655. <td></td>
    1656. 

  1656. </tr>
    1657. 

  1657. <tr>
    1658. 

  1658. <td>25</td>
    1659. 

  1659. <td>26</td>
    1660. 

  1660. <td></td>
    1661. 

  1661. <td></td>
    1662. 

  1662. <td>29</td>
    1663. 

  1663. <td>30</td>
    1664. 

  1664. <td></td>
    1665. 

  1665. <td>32</td>
    1666. 

  1666. </tr>
    1667. 

  1667. <tr>
    1668. 

  1668. <td></td>
    1669. 

  1669. <td></td>
    1670. 

  1670. <td>35</td>
    1671. 

  1671. <td></td>
    1672. 

  1672. <td>37</td>
    1673. 

  1673. <td></td>
    1674. 

  1674. <td>39</td>
    1675. 

  1675. <td>40</td>
    1676. 

  1676. </tr>
    1677. 

  1677. </table>
    1678. 

    1679. 

  1679. <a id="toc120" name="toc120"></a>
    1680. 

  1680. <h2>Test: Lots of cells at the same line</h2>
    1681. 

  1681. <table border="1">
    1682. 

  1682. <tr>
    1683. 

  1683. <td>0</td>
    1684. 

  1684. <td>1</td>
    1685. 

  1685. <td>2</td>
    1686. 

  1686. <td>3</td>
    1687. 

  1687. <td>4</td>
    1688. 

  1688. <td>5</td>
    1689. 

  1689. <td>6</td>
    1690. 

  1690. <td>7</td>
    1691. 

  1691. <td>8</td>
    1692. 

  1692. <td>9</td>
    1693. 

  1693. <td>A</td>
    1694. 

  1694. <td>B</td>
    1695. 

  1695. <td>C</td>
    1696. 

  1696. <td>D</td>
    1697. 

  1697. <td>E</td>
    1698. 

  1698. <td>F</td>
    1699. 

  1699. <td>0</td>
    1700. 

  1700. <td>1</td>
    1701. 

  1701. <td>2</td>
    1702. 

  1702. <td>3</td>
    1703. 

  1703. <td>4</td>
    1704. 

  1704. <td>5</td>
    1705. 

  1705. <td>6</td>
    1706. 

  1706. <td>7</td>
    1707. 

  1707. <td>8</td>
    1708. 

  1708. <td>9</td>
    1709. 

  1709. <td>A</td>
    1710. 

  1710. <td>B</td>
    1711. 

  1711. <td>C</td>
    1712. 

  1712. <td>D</td>
    1713. 

  1713. <td>E</td>
    1714. 

  1714. <td>F</td>
    1715. 

  1715. </tr>
    1716. 

  1716. </table>
    1717. 

    1718. 

  1718. <a id="toc121" name="toc121"></a>
    1719. 

  1719. <h2>Test: Empty lines</h2>
    1720. 

  1720. <table border="1">
    1721. 

  1721. <tr>
    1722. 

  1722. <td></td>
    1723. 

  1723. </tr>
    1724. 

  1724. <tr>
    1725. 

  1725. <td></td>
    1726. 

  1726. </tr>
    1727. 

  1727. <tr>
    1728. 

  1728. <td></td>
    1729. 

  1729. </tr>
    1730. 

  1730. </table>
    1731. 

    1732. 

  1732. <a id="toc122" name="toc122"></a>
    1733. 

  1733. <h2>Invalid: There must be at least one space around the pipe</h2>
    1734. 

  1734. <p>
    1735. 

  1735. |this|is|not|a|table|
    1736. 

  1736. </p>
    1737. 

  1737. <p>
    1738. 

  1738. |this| is| not| a| table|
    1739. 

  1739. </p>
    1740. 

  1740. <p>
    1741. 

  1741. |this |is |not |a |table |
    1742. 

  1742. </p>
    1743. 

  1743. <a id="toc123" name="toc123"></a>
    1744. 

  1744. <h2>Invalid: You must use spaces, not TABs</h2>
    1745. 

  1745. <p>
    1746. 

  1746. |	this	|	is	|	not	|	a	|	table	|
    1747. 

  1747. </p>
    1748. 

  1748. <hr class="light" />
    1749. 

  1749. <p></p>
    1750. 

  1750. <p>
    1751. 

  1751. The End.
    1752. 

  1752. </p>
    1753. 

  1753. </div>
    1754. 

    1755. 

  1755. <!-- xhtml code generated by txt2tags (http://txt2tags.org) -->
    1756. 

  1756. <!-- cmdline: txt2tags /a/pessoal/sourceforge.net/txt2tags/src/doc/English/rules/rules.t2t -->
    1757. 

  1757. </body></html>
    1758.