/test/art/sample.t2t

  1TXT2TAGS SAMPLE for Ascii Art Text
  2Aurelio Jargas
  32010-10-10
  4
  5%!encoding: utf-8
  6
  7Before the Introduction.
  8
  9It's fine !
 10
 11                  =  Introduction  =
 12
 13Welcome to the txt2tags sample file.
 14
 15Here you have examples and a brief explanation of all
 16marks.
 17
 18The first 3 lines of the this file are used as headers,
 19on the following format:
 20```
 21line1: document title
 22line2: author name, email
 23line3: date, version
 24```
 25
 26Lines with balanced equal signs = around are titles.
 27
 28% a secret comment!
 29%TODO link to program site http://txt2tags.org
 30
 31
 32              =  Fonts and Beautifiers  =
 33
 34We have two sets of fonts:
 35
 36The NORMAL type that can be improved with beautifiers.
 37
 38The TYPEWRITER type that uses monospaced font for
 39pre-formatted text.
 40
 41We will now enter on a subtitle...
 42
 43
 44                  ==  Beautifiers  ==
 45
 46The text marks for beautifiers are simple, just as you
 47type on a plain text email message.
 48
 49We use double *, /, - and _ to represent **bold**,
 50//italic//, --strike-- and __underline__.
 51
 52The **//bold italic//** style is also supported as a
 53combination.
 54
 55
 56              ==  Pre-Formatted Text  ==
 57
 58We can put a code sample or other pre-formatted text:
 59```
 60  here    is     pre-formatted
 61//marks// are  **not**  ``interpreted``
 62```
 63
 64And also, it's easy to put a one line pre-formatted
 65text:
 66``` prompt$ ls /etc
 67
 68Or use ``pre-formatted`` inside sentences.
 69
 70
 71                ==  More Cosmetics  ==
 72
 73Special entities like email (duh@somewhere.com) and
 74URL (http://www.duh.com) are detected automagically,
 75as long as the horizontal line:
 76
 77--------------------------------------------------------
 78^ thin or large v
 79========================================================
 80
 81You can also specify an [explicit link http://duh.org]
 82with label.
 83
 84And remember,
 85	A TAB in front of the line does a quotation.
 86		More TABs, more depth (if allowed).
 87Nice.
 88
 89
 90                      =  Lists  =
 91
 92A list of items is natural, just putting a **dash** or
 93a **plus** at the beginning of the line.
 94
 95
 96                  ==  Plain List  ==
 97
 98The dash is the default list identifier. For sublists,
 99just add **spaces** at the beginning of the line. More
100spaces, more sublists.
101
102- earth
103  - america
104    - south america
105      - brazil
106        - how deep can i go?
107  - europe
108    - lots of countries
109- mars
110  - who knows?
111
112
113The list ends with **two** consecutive blank lines.
114
115
116                 ==  Numbered List  ==
117
118The same rules as the plain list, just a different
119identifier (plus).
120
121+ one
122+ two
123+ three
124  - mixed lists!
125  - what a mess
126    + counting again
127    + ...
128+ four
129
130
131                ==  Definition List  ==
132
133The definition list identifier is a colon, followed by
134the term. The term contents is placed on the next line.
135
136: orange
137  a yellow fruit
138: apple
139  a green or red fruit
140: other fruits
141  - wee!
142  - mixing lists
143    + again!
144    + and again!
145
146
147                     =  Tables  =
148
149Use pipes to compose table rows and cells.
150Double pipe at the line beginning starts a heading row.
151Natural spaces specify each cell alignment.
152
153 || heading 1 |  heading 2  |  heading 3 |
154  | cell 1.1  |  cell 1.2   |   cell 1.3 |
155  | cell 2.1  |  cell 2.2   |   cell 2.3 |
156
157Without the last pipe, no border:
158
159 || heading 1 |  heading 2  |  heading 3
160  | cell 1.1  |  cell 1.2   |   cell 1.3
161  | cell 2.1  |  cell 2.2   |   cell 2.3
162
163
164                =  Special Entities  =
165
166Because things were too simple.
167
168
169                    ==  Images  ==
170
171The image mark is as simple as it can be: ``[filename]``.
172
173                      [img/photo.jpg]  
174
175- The filename must end in PNG, JPG, GIF, or similar.
176- No spaces inside the brackets!
177
178
179                     ==  Other  ==
180
181The handy ``%%date`` macro expands to the current date.
182
183That's all for now.