Tables

Tables may be embedded within topic bodies.

Summary
TablesTables may be embedded within topic bodies.
IntroductionSimilar to embedded code snippets and text diagrams you can create complex table structures using the generalised syntax as follows:
FormatsND+ supports a number of different table formatting styles for the table body, the default being nd:

Introduction

Similar to embedded code snippets and text diagrams you can create complex table structures using the generalised syntax as follows:

(start table Title, Caption [,options])

       --- table body ----

(end table)

Example

Tables make stuff easy to read
Planet
Distance from
the sun (km)
Radius
(km)
Year Length
(days)
Day Length
(days)
Moons
Mercury
57,909,175
2,439.64
88
58
0
Venus
108,208,930
6,051.59
225
225
0
Earth
149,597,870
6,378.15
365
1
1
Mars
227,936,640
3,397.00
687
1
2
Jupitar
778,412,010
71,492.68
4,344
0.40
63
Saturn
1,426,725,400
60,267.14
10,768
0.40
57
Uranus
2,870,972,200
25,557.25
30,660
0.70
27
Neptune
4,498,252,900
24,766.36
60,150
0.65
13
My Test Table

Formats

ND+ supports a number of different table formatting styles for the table body, the default being nd:

Options

The following style options are available allowing aspects of the table import format and/or output layout to be controlled:

format=typeInput style, where type is one of the following:
ndDefault, ND+ style ND Table Format.
simplePipe seperated values Simple Table Format.
csvComma seperated values CSV Table Format.
wikiReserved for future development.
delimiter=charDelimiter override.
For simple formatted tables, allows an alternative to pipe (|), which may be any non whitespace character.
For nd formatted tables, allows an alternative to bang (!) as a row delimiter and which may be any non-whitespace character except [ and ].  Note, for normal treatment of the [ character escape using ‘\[‘.
For csv formatted tables, allows an alternative to a comma (, ), which may be any non whitespace character except single quote (‘), double quote (“) and brackets ({) and (}).header=noDisables header generation in simple and csv formatted tables.link=noDisable links (i.e.  <text>) within the table cell text from being processed.border=typeOverride the default border type using one of none, single or double.frame=typeOverride the default cell frame type using one of none, single or double.

Note: Unknown options shall be ignored.

To send feedback on this topic email: natural.nosp@m.docsplus@gmai.nosp@m.l.com

© Some Rights Reserved. see License

The table Simple or wiki format uses a similar syntax to a number of Wiki’s which is an effective yet easy method of creating tables.
Following in the design spirit of Natural Docs this table format has a layout within the original source files which shall read just as easily as the generated documentation.
Similar to the ND format, is the basic layout, which uses a fixed format column defined by the header like the ND format.
The table Comma Seperated Value (CSV) format uses a similar syntax as Simple Table Format with support for quoted columns of dating.
ND+ is licensed under the GPL-2.0, the same terms and conditions as Natural Docs 1.4.