/test/art/ok/toc.aat

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