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.'' 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 ----------------------------------- .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 |====================== .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 ------------------------------------------------------------------- .An example table [width="50%",cols=">s,^2m,^2e",frame="none",options="header,footer"] |========================== | |Column 2|Column 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="none",options="header,footer"] |========================== | |Column 2|Column 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 ----------------------------------- 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. .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). |========================================================= 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. |=================================== --------------------------------------------------------------------- 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 --------------------------------------------------------------------- [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 <>. '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 <>. '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 !============================================== |============================================== ---------------------------------------------------------------------