TEXTALLION [tɛkstaljɔ̃]
n.m. — (2009 ; from text, and unknown suffix -llion, probably animal origin or meaning the 1st person plural. Can be written as textallion or TeXtallion.)
Word processor system using txt2tags wiki markup, allowing you edit your document's plain text source in whatever editor you prefer, allowing you to to stay focused on your writing at the keyboard rather than clicking around in a GUI. Textallion produces attractively formatted output files, including PDF, HTML and/or ePUB.
Citation:
The general systax is the one of txt2tags, and we added our own.
A short reminder of the syntax:
[image.jpg]
[link to a website http://www.homepage.com] : link to a website
We added those symbols. They are made with 4 signs between braces (curly brackets):
{*~~~} before the first letter of the word.
*-*- or {*-*-}
{-@- } - this adds a little leaf {-/@-} : {** *}
| Description | symbol | code |
|---|---|---|
| first quarter moon | ☽ |
{ )) } |
| full moon | ○ |
{ () } |
| last quarter moon | ☾ |
{ (( } |
| sun | ☼ |
{( )} |
You may also enter these symbols directly into the source if you wish, but they might be too tiny to read in some plain text editors. You can't enter unicode symbols if you want to publish to pdf because this LaTeX version doesn't use unicode, unless you adjust the preprocessor in your document - remember almost anything is possible using txt2tags! Some ePUB readers also can't read those symbols, so they are replaced by stars * during the ePUB export. They do show up properly in html output.
For getting a m-dash (French conversation for examples), you can type three -, or just enter a real m-dash character —.
Footnotes are enabled by wrap the note text in °° - see the example below and the source code of this document for further examples. You can access this symbol on qwerty keyboards with alt gr + 0 on Linux and alt+248 on windows.
It's also possible to create footnotes with this symbol: { °° }.* (In keeping with the other standard markup in textallion.)
The LaTeX version will use numbered footnotes, while the html version will use a star (*) to indicate the footnote.
It's also possible to add a number between brackets for the html export with something like this:
This is a text with an associated footnote°°This is the note.(1)°°.
which will convert into:
This is a text with an associated footnote1 (This is the note.).
{//..}, or the simplified version //...
If you want to copy and paste texts from the internet or another source, you may find it tedious to keep inserting the special line break marks (*-*-). Just enable this command:
%!postproc: "$" '{//..}'
¯ symbol.
You can get a page break with {/…}.
We use ^^ or { ^^ } to surround the part to be used as exponent. For example 2^^nd^^ or 24^^5^^.
You can specify the image size between brackets:
for example: [path_to/my_image.png][24]
(10)
(20)
(30)
The number represents millimeters for LaTeX output, and % of the page width in html - I couldn't do better at the moment.
A TOC is generated automatically by txt2tags. Use the %%toc command anywhere in your document to place it. Otherwise, by default, it will be at the beginning of your content area.
Use of an Index is optional. To activate it, uncomment the \usepackage{makeidx} and \makeindex into your .sty file. Use the command %%index where you want to place this index.
Index entries are made with {^} surrounding the word to be indexed. To use an alternative name for the indexed word, you can write for example {^}apple{^fruit}.
If you prefer writing [description URL] for your links rather than the txt2tags syntax: [description URL], it will automatically be converted by textallion.
Especially useful for the CYOA module (see below), it's possible to add music with this syntax: [musique.ogg], which will add a HTML5 player in the browser. Only the free and open format ogg/vorbis is supported, because contrary to mp3, it is directly compatible in most browsers: Firefox, Chrome, Opera.
Music example:
You can do the same for ogg/theora or webm videos, using the .ogv or .webm extension instead: [video.ogv]
Video example: (downloaded from an external website):
{ ++ } and ending with {/++ }.
{ -- } and ending with {/-- }.
TODO
Native txt2tags syntax cannot format a block of several paragraphs italic or bold. This will be implemented with { // } and {/// }.
Also with bolding blocks of text: { ** } and {/** }.
Epigraphs (quotations beginning a chapter) are written using { ~~} at the beginning of the sentence, and {/ ~~} at the end. You can add the author at the end.
This way:
deviendra :
You can color text by using @@COLOR@@name of the color@@Text to colorize@@/COLOR@@.
The basic color names are :
black blue brown cyan darkgray gray green lightgray lime magenta olive orange pink purple red teal violet white yellow
You can also use those colors, which are compatible with LaTeX and HTML (svg colors) :
AliceBlue AntiqueWhite Aqua Aquamarine Azure Beige Bisque Black BlanchedAlmond Blue BlueViolet Brown BurlyWood CadetBlue Chartreuse Chocolate Coral CornflowerBlue Cornsilk Crimson Cyan DarkBlue DarkCyan DarkGoldenrod DarkGray DarkGreen DarkGrey DarkKhaki DarkMagenta DarkOliveGreen DarkOrange DarkOrchid DarkRed DarkSalmon DarkSeaGreen DarkSlateBlue DarkSlateGray DarkSlateGrey DarkTurquoise DarkViolet DeepPink DeepSkyBlue DimGray DimGrey DodgerBlue FireBrick FloralWhite ForestGreen Fuchsia Gainsboro GhostWhite Gold Goldenrod Gray Green GreenYellow Grey Honeydew HotPink IndianRed Indigo Ivory Khaki Lavender LavenderBlush LawnGreen LemonChiffon LightBlue LightCoral LightCyan LightGoldenrod LightGoldenrodYellow LightGray LightGreen LightGrey LightPink LightSalmon LightSeaGreen LightSkyBlue LightSlateBlue LightSlateGray LightSlateGrey LightSteelBlue LightYellow Lime LimeGreen Linen Magenta Maroon MediumAquamarine MediumBlue MediumOrchid MediumPurple MediumSeaGreen MediumSlateBlue MediumSpringGreen MediumTurquoise MediumVioletRed MidnightBlue MintCream MistyRose Moccasin NavajoWhite Navy NavyBlue OldLace Olive OliveDrab Orange OrangeRed Orchid PaleGoldenrod PaleGreen PaleTurquoise PaleVioletRed PapayaWhip PeachPuff Peru Pink Plum PowderBlue Purple Red RosyBrown RoyalBlue SaddleBrown Salmon SandyBrown SeaGreen Seashell Sienna Silver SkyBlue SlateBlue SlateGray SlateGrey Snow SpringGreen SteelBlue Tan Teal Thistle Tomato Turquoise Violet VioletRed Wheat White WhiteSmoke Yellow YellowGreen
You can also specify the color with html code instead of the name, such as #6D7D2E, which will display: Here is my nice text in green. LaTeX won't be able to display this color, it will be replaced by gray.
You can center some text (LaTex only) with a leading |
| centered text |
or by surrounding a paragraph with {->--} and {-<--}:
or with @@begin((center))** et @@end((center))**
You can use the {|n|} symbol for setting text in n columns, n being a value between 0 and 4. You can close the area with the same syntax but with n=0 or n=1.
Tables are supported by txt2tags. But because in the LaTeX (pdf) export, tables won't be displayed when they reach the end of a page, we use the longtable and tabu packages instead of tabular. If you don't like this, add this in the header of your document:
%!postproc(tex): 'longtable' 'tabular'``
%!postproc(tex): 'longtabu' 'tabular'``
In the case your tables has so many columns that it might print outside the width of the page, tabu should handle this correctly, but if you use only longtable, you can use this trick to wrap long texts, for example if your table has 4 columns:
%!postproc(tex): '\{\|l\|l\|l\|l\|\}' {|p{3cm}|p{3cm}|p{3cm}|p{3cm}|}
(we must escape the { and | symbols when using *proc in txt2tags)
If your document has only one table, it will be ok. You can also customise the width of each column. If it has more tables and you wish to use different widths, you can use a second trick:
add extra spaces at the beginning of one of the colum, like this:
| left | left | left | right |
so this table will be unique to the document and you can use this now:
%!postproc(tex): '\{\|l\|l\|l\|r\|\}' {|p{2cm}|p{3cm}|p{5cm}|p{3cm}|}
Reminder: tables are aligned like this:
| left align | left align | left align |
| left align | right align | left align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. | | left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. |
| left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. | | left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. |
| left align | right align | center align |
You can add any arbitrary LaTeX code by replacing the "\" with @@ and the "{" and "}" with (( and )). If you want to include your LaTeX codes in the html output, surround them with the txt2tags syntax for verbatim (three ```) or the new tagged format (three '''). If you prefer to exclude these codes from the html output, just indicate the end of the code with two stars **.
The source code of this document will gave you more examples on how to add more latex options in your text. For example this mathematic formula won't appear in the html version:
The verbatim version:
\begin{displaymath}
\frac{a}{b} + \sqrt[n]{abcd}
\end{displaymath}
A simple box:
@@Ovalbox((Example of text in the box))
This last example will appear odd (on purpose) in the html version because there is no ** at the end of this special command.
We can include footnotes this way (version with replacing code)
Beware, these footnotes won't appear in the html version
It's better to use this simpler form for keeping notes in the html version* (This note will be kept in the html version of the document)
Use { $$ } on both sides ; works for PDF export only. For html, you can copy and paste the code via http://www.codecogs.com/latex/eqneditor.php
inline : \delta = 3 \times \sum X_i^2, ainsi que 4 - \sqrt X
block : \delta = 3 \times \sum X_i^2
If you need to include some letters already found in the txt2tags code (such as the pipe |), you can prevent their execution by surrounding them with double quote ("")
| find . -print | cpio -o -H newc | gzip -9 > ../initrd.gz |