diff options
Diffstat (limited to 'doc/asciidoc/examples/website/newtables.txt')
-rw-r--r-- | doc/asciidoc/examples/website/newtables.txt | 743 |
1 files changed, 743 insertions, 0 deletions
diff --git a/doc/asciidoc/examples/website/newtables.txt b/doc/asciidoc/examples/website/newtables.txt new file mode 100644 index 0000000..038fadc --- /dev/null +++ b/doc/asciidoc/examples/website/newtables.txt @@ -0,0 +1,743 @@ +AsciiDoc New tables +=================== + +*New in version 8.3.0* + +I've finally come up with a 'new tables' syntax that I'm happy with +and can at last remove this footnote from the 'User Guide': ``The +current table syntax is overly complicated and unwieldy to edit, +hopefully a more usable syntax will appear in future versions of +AsciiDoc.'' + +.Update +********************************************************************* +The following additions were made at AsciiDoc 8.4.4: + +- Cell column and row spanning. +- Styles can be applied per cell. +- Vertical cell alignment can be applied to columns and cells. + +See the examples at the end of this document. +********************************************************************* + +At first glance it doesn't look much different to the old syntax but +it's a lot more flexible, easier to enter and supports a lot of column +styles (for example the 'asciidoc' style supports AsciiDoc block and +inline elements). The old tables syntax has been deprecated but is +currently still processed. Here are some examples of AsciiDoc 'new +tables': + +.Simple table +[width="15%"] +|======= +|1 |2 |A +|3 |4 |B +|5 |6 |C +|======= + +.AsciiDoc source +--------------------------------------------------------------------- +[width="15%"] +|======= +|1 |2 |A +|3 |4 |B +|5 |6 |C +|======= +--------------------------------------------------------------------- + + +.Table with title, header and footer +[width="40%",frame="topbot",options="header,footer"] +|====================== +|Column 1 |Column 2 +|1 |Item 1 +|2 |Item 2 +|3 |Item 3 +|6 |Three items +|====================== + +.AsciiDoc source +--------------------------------------------------------------------- +.An example table +[width="40%",frame="topbot",options="header,footer"] +|====================== +|Column 1 |Column 2 +|1 |Item 1 +|2 |Item 2 +|3 |Item 3 +|6 |Three items +|====================== +--------------------------------------------------------------------- + + +.Columns formatted with strong, monospaced and emphasis styles +[width="50%",cols=">s,^2m,^2e",frame="topbot",options="header,footer"] +|========================== +| 2+|Columns 2 and 3 +|1 |Item 1 |Item 1 +|2 |Item 2 |Item 2 +|3 |Item 3 |Item 3 +|4 |Item 4 |Item 4 +|footer 1|footer 2|footer 3 +|========================== + +.AsciiDoc source +--------------------------------------------------------------------- +.An example table +[width="50%",cols=">s,^2m,^2e",frame="topbot",options="header,footer"] +|========================== +| 2+|Columns 2 and 3 +|1 |Item 1 |Item 1 +|2 |Item 2 |Item 2 +|3 |Item 3 |Item 3 +|4 |Item 4 |Item 4 +|footer 1|footer 2|footer 3 +|========================== +--------------------------------------------------------------------- + +.A table with externally sourced CSV data +[format="csv",cols="^1,4*2",options="header"] +|=================================================== +ID,Customer Name,Contact Name,Customer Address,Phone +include::customers.csv[] +|=================================================== + +.AsciiDoc source +--------------------------------------------------------------------- + [format="csv",cols="^1,4*2",options="header"] + |=================================================== + ID,Customer Name,Contact Name,Customer Address,Phone + include::customers.csv[] + |=================================================== +--------------------------------------------------------------------- + + +.DVS formatted table +[width="70%",format="dsv"] +|==================================== +root:x:0:0:root:/root:/bin/bash +daemon:x:1:1:daemon:/usr/sbin:/bin/sh +bin:x:2:2:bin:/bin:/bin/sh +sys:x:3:3:sys:/dev:/bin/sh +sync:x:4:65534:sync:/bin:/bin/sync +games:x:5:60:games:/usr/games:/bin/sh +|==================================== + +.AsciiDoc source +--------------------------------------------------------------------- +[width="70%",format="dsv"] +|==================================== +root:x:0:0:root:/root:/bin/bash +daemon:x:1:1:daemon:/usr/sbin:/bin/sh +bin:x:2:2:bin:/bin:/bin/sh +sys:x:3:3:sys:/dev:/bin/sh +sync:x:4:65534:sync:/bin:/bin/sync +games:x:5:60:games:/usr/games:/bin/sh +|==================================== +--------------------------------------------------------------------- + + +.Horizontal and vertical source data +[width="80%",cols="3,^2,^2,10",options="header"] +|========================================================= +|Date |Duration |Avg HR |Notes + +|22-Aug-08 |10:24 | 157 | +Worked out MSHR (max sustainable heart rate) by going hard +for this interval. + +|22-Aug-08 |23:03 | 152 | +Back-to-back with previous interval. + +|24-Aug-08 |40:00 | 145 | +Moderately hard interspersed with 3x 3min intervals (2min +hard + 1min really hard taking the HR up to 160). + +|========================================================= + +Short cells can be entered horizontally, longer cells vertically. The +default behavior is to strip leading and trailing blank lines within a +cell. These characteristics aid readability and data entry. + +.AsciiDoc source +--------------------------------------------------------------------- +.Windtrainer workouts +[width="80%",cols="3,^2,^2,10",options="header"] +|========================================================= +|Date |Duration |Avg HR |Notes + +|22-Aug-08 |10:24 | 157 | +Worked out MSHR (max sustainable heart rate) by going hard +for this interval. + +|22-Aug-08 |23:03 | 152 | +Back-to-back with previous interval. + +|24-Aug-08 |40:00 | 145 | +Moderately hard interspersed with 3x 3min intervals (2min +hard + 1min really hard taking the HR up to 160). + +|========================================================= +--------------------------------------------------------------------- + + +.Default and verse styles +[cols=",^v",options="header"] +|=================================== +|Default paragraphs |Centered verses +2*|Per id. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +|=================================== + +.AsciiDoc source +--------------------------------------------------------------------- +[cols=",^v",options="header"] +|=================================== +|Default paragraphs |Centered verses +2*|Per id. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +|=================================== +--------------------------------------------------------------------- + + +.Horizontal and vertial headings +[cols="h,4*",options="header",width="50%"] +|================================== +| |West |Central |East | Total +|Q1 |270 |292 |342 | 904 +|Q2 |322 |276 |383 | 981 +|Q3 |298 |252 |274 | 824 +|Q4 |344 |247 |402 | 993 +|================================== + +.AsciiDoc source +--------------------------------------------------------------------- +.Horizontal and vertial headings +[cols="h,4*",options="header",width="50%"] +|================================== +| |West |Central |East | Total +|Q1 |270 |292 |342 | 904 +|Q2 |322 |276 |383 | 981 +|Q3 |298 |252 |274 | 824 +|Q4 |344 |247 |402 | 993 +|================================== +--------------------------------------------------------------------- + + +.AsciiDoc style in first column, Literal in second +[cols="asciidoc,literal",options="header",grid="cols"] +|================================== +|Output markup |AsciiDoc source +2*| +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +----------------------------------- +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +----------------------------------- + +.Code filter example +[source,python] +----------------------------------- +''' A multi-line + comment.''' +def sub_word(mo): + ''' Single line comment.''' + word = mo.group('word') + if word in keywords[language]: + return quote + word + quote + else: + return word +----------------------------------- + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +|================================== + +.AsciiDoc source +[listing] +..................................................................... +[cols="asciidoc,literal",options="header",grid="cols"] +|================================== +|Output markup |AsciiDoc source +2*| +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +----------------------------------- +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +----------------------------------- + +.Code filter example +[source,python] +----------------------------------- +''' A multi-line + comment.''' +def sub_word(mo): + ''' Single line comment.''' + word = mo.group('word') + if word in keywords[language]: + return quote + word + quote + else: + return word +----------------------------------- + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +|================================== +..................................................................... + + +.Cell containing lots of example markup elements +|==================================================================== +|'URLs': +http://www.methods.co.nz/asciidoc/[The AsciiDoc home page], +http://www.methods.co.nz/asciidoc/, +mailto:joe.bloggs@foobar.com[email Joe Bloggs], +joe.bloggs@foobar.com, +callto:joe.bloggs[]. + +'Link': See <<X1,AsciiDoc source>>. + +'Emphasized text', *Strong text*, +Monospaced text+, ``Quoted text''. + +'Subscripts and superscripts': e^{amp}#960;i^+1 = 0. H~2~O and x^10^. +Some ^super text^ and ~some sub text~ + +'Replacements': (C) copyright, (TM) trademark, (R) registered trademark, +-- em dash, ... ellipsis, -> right arrow, <- left arrow, => right +double arrow, <= left double arrow. +|==================================================================== + +[[X1]] +.AsciiDoc source +--------------------------------------------------------------------- +|==================================================================== +|'URLs': +http://www.methods.co.nz/asciidoc/[The AsciiDoc home page], +http://www.methods.co.nz/asciidoc/, +mailto:joe.bloggs@foobar.com[email Joe Bloggs], +joe.bloggs@foobar.com, +callto:joe.bloggs[]. + +'Link': See <<X1,AsciiDoc source>>. + +'Emphasized text', *Strong text*, +Monospaced text+, ``Quoted text''. + +'Subscripts and superscripts': e^{amp}#960;i^+1 = 0. H~2~O and x^10^. +Some ^super text^ and ~some sub text~ + +'Replacements': (C) copyright, (TM) trademark, (R) registered trademark, +-- em dash, ... ellipsis, -> right arrow, <- left arrow, => right +double arrow, <= left double arrow. +|==================================================================== +--------------------------------------------------------------------- + + +.Nested table +[width="75%",cols="1,2a"] +|============================================== +|Normal cell + +|Cell with nested table + +[cols="2,1"] +!============================================== +!Nested table cell 1 !Nested table cell 2 +!============================================== + +|============================================== + +.AsciiDoc source +--------------------------------------------------------------------- +[width="75%",cols="1,2a"] +|============================================== +|Normal cell + +|Cell with nested table + +[cols="2,1"] +!============================================== +!Nested table cell 1 !Nested table cell 2 +!============================================== + +|============================================== +--------------------------------------------------------------------- + + +.Spans, alignments and styles +[cols="e,m,^,>s",width="25%"] +|================ +|1 >s|2 |3 |4 +^|5 2.2+^.^|6 .3+<.>m|7 +^|8 +|9 2+>|10 +|================ + +.AsciiDoc source +--------------------------------------------------------------------- +.Spans, alignments and styles +[cols="e,m,^,>s",width="25%"] +|================ +|1 >s|2 |3 |4 +^|5 2.2+^.^|6 .3+<.>m|7 +^|8 +|9 2+>|10 +|================ +--------------------------------------------------------------------- + +.Three panes +[cols="a,2a"] +|================================== +| +[float] +Top Left Pane +~~~~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +.2+| +[float] +Right Pane +~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +----------------------------------- +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +----------------------------------- + +.Code filter example +[source,python] +----------------------------------- +''' A multi-line + comment.''' +def sub_word(mo): + ''' Single line comment.''' + word = mo.group('word') + if word in keywords[language]: + return quote + word + quote + else: + return word +----------------------------------- + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +| +[float] +Bottom Left Pane +~~~~~~~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +|================================== + +.AsciiDoc source +[listing] +..................................................................... +.Three panes +[cols="a,2a"] +|================================== +| +[float] +Top Left Pane +~~~~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +.2+| +[float] +Right Pane +~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +----------------------------------- +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. +----------------------------------- + +.Code filter example +[source,python] +----------------------------------- +''' A multi-line + comment.''' +def sub_word(mo): + ''' Single line comment.''' + word = mo.group('word') + if word in keywords[language]: + return quote + word + quote + else: + return word +----------------------------------- + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +| +[float] +Bottom Left Pane +~~~~~~~~~~~~~~~~ +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +Consul *necessitatibus* per id, +consetetur, eu pro everti postulant +homero verear ea mea, qui. + +- Lorem ipsum dolor sit amet, + consectetuer adipiscing elit. + * Fusce euismod commodo velit. + * Qui in magna commodo, est labitur + dolorum an. Est ne magna primis + adolescens. Sit munere ponderum + dignissim et. Minim luptatum et vel. + * Vivamus fringilla mi eu lacus. + * Donec eget arcu bibendum nunc + consequat lobortis. +- Nulla porttitor vulputate libero. + . Fusce euismod commodo velit. + . Vivamus fringilla mi eu lacus. + +|================================== +..................................................................... + + +== Combinations of 'align', 'frame', 'grid', 'valign' and 'halign' attributes + +:frame: all +:grid: all +:halign: left +:valign: top + +[options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== + +.AsciiDoc source +--------------------------------------------------------------------- +:frame: all +:grid: all +:halign: left +:valign: top + +[options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== +--------------------------------------------------------------------- + + +:frame: sides +:grid: rows +:halign: center +:valign: middle + +.Table test +[width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== + +.AsciiDoc source +--------------------------------------------------------------------- +:frame: sides +:grid: rows +:halign: center +:valign: middle + +.Table test +[width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== +--------------------------------------------------------------------- + + +:frame: topbot +:grid: cols +:halign: right +:valign: bottom + +[align="right",width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== + +.AsciiDoc source +--------------------------------------------------------------------- +:frame: topbot +:grid: cols +:halign: right +:valign: bottom + +[align="right",width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== +--------------------------------------------------------------------- + + +:frame: none +:grid: none +:halign: left +:valign: top + +[align="center",width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== + +.AsciiDoc source +--------------------------------------------------------------------- +:frame: none +:grid: none +:halign: left +:valign: top + +[align="center",width="50%",options="header"] +|==== +||frame | grid |valign |halign +v| + + +|{frame} | {grid} |{valign} |{halign} +|==== +--------------------------------------------------------------------- + +:frame!: +:grid!: +:halign!: +:valign!: + |