'''TXT2TAGS SAMPLE'''

''Aurelio Jargas''



= Introduction =

Welcome to the txt2tags sample file.

Here you have examples and a brief explanation of all
marks.

The first 3 lines of the this file are used as headers,
on the following format:

{{{
line1: document title
line2: author name, email
line3: date, version
}}}

Lines with balanced equal signs = around are titles.

= Fonts and Beautifiers =

We have two sets of fonts:

The NORMAL type that can be improved with beautifiers.

The TYPEWRITER type that uses monospaced font for
pre-formatted text.

We will now enter on a subtitle...

== Beautifiers ==

The text marks for beautifiers are simple, just as you
type on a plain text email message.

We use double *, /, - and _ to represent '''bold''',
''italic'', --(strike)-- and __underline__.

The '''''bold italic''''' style is also supported as a
combination.

== Pre-Formatted Text ==

We can put a code sample or other pre-formatted text:

{{{
  here    is     pre-formatted
//marks// are  **not**  ``interpreted``
}}}

And also, it's easy to put a one line pre-formatted
text:

{{{
prompt$ ls /etc
}}}

Or use {{{pre-formatted}}} inside sentences.

== More Cosmetics ==

Special entities like email (duh@somewhere.com) and
URL ([[http://www.duh.com]]) are detected automagically,
as well as horizontal lines:

----
--------

You can also specify an [[http://duh.org|explicit link]]
with label.

And remember,

  A TAB in front of the line does a quotation.
    More TABs, more depth (if allowed).

Nice.

= Lists =

A list of items is natural, just putting a '''dash''' or
a '''plus''' at the beginning of the line.

== Plain List ==

The dash is the default list identifier. For sublists,
just add '''spaces''' at the beginning of the line. More
spaces, more sublists.

 * earth
   * america
     * south america
       * brazil
         * how deep can i go?
   * europe
     * lots of countries
 * mars
   * who knows?

The list ends with '''two''' consecutive blank lines.

== Numbered List ==

The same rules as the plain list, just a different
identifier (plus).

 1. one
 2. two
 3. three
   * mixed lists!
   * what a mess
     1. counting again
     2. ...
 4. four

== Definition List ==

The definition list identifier is a colon, followed by
the term. The term contents is placed on the next line.

 orange::
 :: a yellow fruit
 apple::
 :: a green or red fruit
 other fruits::
   * wee!
   * mixing lists
     1. again!
     2. and again!

= Tables =

Use pipes to compose table rows and cells.
Double pipe at the line beginning starts a heading row.
Natural spaces specify each cell alignment.

||'''heading 1'''||<:>'''heading 2'''||<)>'''heading 3'''||
||cell 1.1||<:>cell 1.2||<)>cell 1.3||
||cell 2.1||<:>cell 2.2||<)>cell 2.3||

Without the last pipe, no border:

||'''heading 1'''||<:>'''heading 2'''||<)>'''heading 3'''||
||cell 1.1||<:>cell 1.2||<)>cell 1.3||
||cell 2.1||<:>cell 2.2||<)>cell 2.3||

= Special Entities =

Because things were too simple.

== Images ==

The image mark is as simple as it can be: {{{[filename]}}}.

[img/photo.jpg]

 * The filename must end in PNG, JPG, GIF, or similar.
 * No spaces inside the brackets!

----

[img/t2tpowered.png]

