TXT2TAGS SAMPLE Aurelio Jargas 10/20/2010 = 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 () and URL ([[http://www.duh.com]]) are detected automagically, as long as the horizontal line: ---- ^ thin or large v ---- 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). # one # two # three ** mixed lists! ** what a mess ### counting again ### ... # 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 ### again! ### 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! == Other == The handy %%date macro expands to the current date. So today is 20101031 on the ISO YYYYMMDD format. You can also specify the date format with the %? flags, as %%date(%m-%d-%Y) which gives: 10-31-2010. That's all for now. ---- {{img/t2tpowered.png}} ([[sample.t2t|sample.t2t]])