nested man page

nested — specialized editor for structured documents


nested [FILE]


Nested is a specialized editor focused on creating structured documents such as reports, publications, presentations, books, etc. It is designed to help the user concentrate on writing content without been distracted by format or markup. It offers a rich WYSIWYM interface where the user writes plain text with a lightweight markup language known as txt2tags.

Basic users are assisted with extensive examples, formatting buttons, a simple image gallery per document, assisted internal and external links, section based layout and easy publishing options in HTML, LaTeX or PDF. Power users will like the advanced pre-processing and post-processing options, advanced theming, version control systems compatibility, LaTeX formulas support, a complete set of keyboard shortcuts, among others.

Nested separates content from presentation and publishing option, so same content can be presented as a HTML web page, a rich standard-compliant HTML presentation, a IEEE journal publication, a beautiful PDF book, etc. Nested files are plain text so they can be used with common version control systems.

Please visit the program site at http://nestededitor.sourceforge.net/.


Comment           % comments
Bold              **words**
Italic            //words//
Underline         __words__
Strike            --words--
Superscript       ^^words^^
Subscript         ,,words,,
Monospaced        ``words“
Tagged            ”words''
Separator line    -----------------------...
Strong line       =======================...

Image             [filename.jpg]
External link     [label url]
Internal link     [label #section_name]

Paragraph         words
Quote             <TAB>words
List              - words
Numbered list     + words
Definition list   : words
Table             | cell1 | cell2 | cell3...

Verbatim line     `“ words
Tagged line       ”' words

Verbatim block    ```
Raw block         """
Tagged block      ”'
Math block        <<<
Code block        {{{ code

A more complete example can be found in File > Examples > Markup

Document File

The document files are identified by the .t2t extension (such as myfile.t2t). You have three areas inside your sources:

The first three lines of the file. Used for document title, author, version and date information.
Begins right after the Header and ends when the Body area starts. Used for settings (configurations) in the %!keyword:value format.
Begins after the settings and goes until the end of the document. Used for the document contents.


These are the settings or properties of the document that are loaded into the GUI.


Set the publishing option, it can be xhtmls, tex or txt

%!target: xhtmls

Set common options to each target. Example:

%!options(xhtmls): --toc --toc-level 3

Set special options to each target. Example:

%!nested(xhtmls): --base64 --libs syntaxhighlighter,jquery

Set a style for the document. Right now it can only be used to select the theme on HTML target:

%!style(xhtmls): media/theme/Base/style.css

Input search/replace filter used to change the Body of the source document BEFORE conversion to target. It can be general or specific to target. Search uses Python regular expressions. Example:

%!preproc(xhtmls):  "AUTHOR"  "Carlos Jenkins"

Output search/replace filter used to change the generated document AFTER the conversion is done. Search uses Python regular expressions. It can be general or specific to target. Example:

%!postproc(xhtmls):  "<b>"  "<strong>"


Macros are handy shortcuts to insert dynamic contents in your document. The time macros can be customized with special directives, like %Y and %f, see http://docs.python.org/library/time.html for more information.

Insert the current date. The default format is %%date(%Y%m%d), which gives YYYYMMDD.
Specifies where the Table of Contents will be placed. You can even use it multiple times. Note that you must also use the --toc option.

Target Comments

Target comments are special tokens that will be removed for some specific target, making the content of the line avalaible.

Avalaible targets are xhtmls (or its alias html), tex (or its aliases latex or pdf) or txt (or its alias text). Please note the leading space.

For example, you can insert in your document:

%html% You can download the PDF version of this document from [my website http://www.somedomain.com/myfile.pdf]
%pdf% You can view the HTML version of this document in [my website http://www.somedomain.com/myfile.html]


All examples can be found on File > Examples

Files and Folders

Default user configuration file.
Recently opened files.
User custom examples.
User Javascript libraries.
User content and structural templates.
User HTML presentation themes.


Carlos Jenkins <cjenkins@softwarelibrecr.org>

Nested uses txt2tags by Aurelio Jargas <verde@aurelio.net>




Nov, 2011