AsciiDoc User Guide

Question

17.4.1.

+ Answer two.

Renders:

17.4.1.

Question one

17.4.2.

+

17.4.2.

Question two

Table 22.1. Audio macro attributes

Name	Value
options	A comma separated list of one or more of the following items: +

Table 22.1. Audio macro attributes

Name	Value
options	A comma separated list of one or more of the following items: autoplay, loop which correspond to the same-named HTML 5 audio element boolean attributes. By default the player controls are -enabled, include the nocontrols option value to hide them.

Table 22.2. Video macro attributes

Name	Value
height	The height of the player in pixels.
width	The width of the player in pixels.
poster	The URL or file name of an image representing the video.
options	A comma separated list of one or more of the following items: +enabled, include the nocontrols option value to hide them.

Table 22.2. Video macro attributes

Name Value

height

The height of the player in pixels.

width

The width of the player in pixels.

poster

The URL or file name of an image representing the video.

options

A comma separated list of one or more of the following items: autoplay, loop and nocontrols. The autoplay and loop options correspond to the same-named HTML 5 video element boolean attributes. By default the player controls are enabled, include the diff --git a/chunked/ch23.html b/chunked/ch23.html index c54758f..4eb8962 100644 --- a/chunked/ch23.html +++ b/chunked/ch23.html @@ -17,14 +17,14 @@ less seldom are tables containing block elements (such as paragraphs or lists) or spanned cells. This is no accident, like figures, tables are outside the normal document flow — tables are for consulting not for reading.

Tables are designed for, and should normally only be used for, -displaying column oriented tabular data.

23.1. Example tables

Table 23.1. Simple table

1	2	A
3	4	B
5	6	C

AsciiDoc source. +displaying column oriented tabular data.

23.1. Example tables

Table 23.1. Simple table

1	2	A
3	4	B
5	6	C

AsciiDoc source.

[width="15%"]
 |=======
 |1 |2 |A
 |3 |4 |B
 |5 |6 |C
 |=======

-

Table 23.2. Columns formatted with strong, monospaced and emphasis styles

	Columns 2 and 3
footer 1	`footer 2`	footer 3
1	`Item 1`	Item 1
2	`Item 2`	Item 2
3	`Item 3`	Item 3
4	`Item 4`	Item 4

AsciiDoc source. +

Table 23.2. Columns formatted with strong, monospaced and emphasis styles

	Columns 2 and 3
footer 1	`footer 2`	footer 3
1	`Item 1`	Item 1
2	`Item 2`	Item 2
3	`Item 3`	Item 3
4	`Item 4`	Item 4

AsciiDoc source.

.An example table
 [width="50%",cols=">s,^m,e",frame="topbot",options="header,footer"]
 |==========================
@@ -35,7 +35,7 @@ displaying column oriented tabular data.

-

Table 23.3. Horizontal and vertical source data

Date Duration Avg HR Notes

22-Aug-08

10:24

157

Worked out MSHR (max sustainable heart rate) by going hard +

Table 23.3. Horizontal and vertical source data

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 @@ -57,7 +57,7 @@ Moderately hard interspersed with 3x 3min intervals (2min hard + 1min really hard taking the HR up to 160). |=========================================================

-

Table 23.4. A table with externally sourced CSV data

ID Customer Name Contact Name Customer Address Phone

AROUT

Around the Horn

Thomas Hardy

120 Hanover Sq. +

Table 23.4. A table with externally sourced CSV data

ID Customer Name Contact Name Customer Address Phone

AROUT

Around the Horn

Thomas Hardy

120 Hanover Sq. London

(171) 555-7788

BERGS

Berglunds snabbkop

Christina Berglund

Berguvsvagen 8 Lulea

0921-12 34 65

BLAUS

Blauer See Delikatessen

Hanna Moos

Forsterstr. 57 Mannheim

0621-08460

BLONP

Blondel pere et fils

Frederique Citeaux

24, place Kleber @@ -72,7 +72,7 @@ Buenos Aires

(1) 135-5555

< ID,Customer Name,Contact Name,Customer Address,Phone include::customers.csv[] |===================================================

-

Table 23.5. Cell spans, alignments and styles

1	2	3	4
5	`6`		`7`
8
9	`10`

AsciiDoc source. +

Table 23.5. Cell spans, alignments and styles

1	2	3	4
5	`6`		`7`
8
9	`10`

AsciiDoc source.

[cols="e,m,^,>s",width="25%"]
 |============================
 |1 >s|2 |3 |4
diff --git a/chunked/ch31.html b/chunked/ch31.html
index a81a245..5bed362 100644
--- a/chunked/ch31.html
+++ b/chunked/ch31.html
@@ -86,7 +86,7 @@ See also the ifdef,
    ifndef and endif System macros for conditional inclusion.
-   ^[4]
+   ^[4]
 
 {docfile} and {docdir} refer to root document specified on the
    asciidoc(1) command-line; {infile} and {indir} refer to the
@@ -129,7 +129,7 @@ If the SOURCE_DATE_EPOCH environment variable is se
    timestamps newer than SOURCE_DATE_EPOCH replaced by
    SOURCE_DATE_EPOCH. (This helps software using AsciiDoc to build
    reproducibly.)
-

^[4]Conditional inclusion using ifdef and ifndef macros +

^[4]Conditional inclusion using ifdef and ifndef macros differs from attribute conditional inclusion in that the former occurs when the file is read while the latter occurs when the contents are written.

\ No newline at end of file diff --git a/chunked/ch33.html b/chunked/ch33.html index 63642a1..6d31e80 100644 --- a/chunked/ch33.html +++ b/chunked/ch33.html @@ -44,7 +44,7 @@ highlighter. If you want a full featured multi-language highlighter use the source code highlighter filter.

33.4. Built-in filters

The AsciiDoc distribution includes source, music, latex and graphviz filters, details are on the -AsciiDoc website.

Table 33.1. Built-in filters list

Filter name Description

music

A music filter is included in the +AsciiDoc website.

Table 33.1. Built-in filters list

Filter name Description

music

A music filter is included in the distribution ./filters/ directory. It translates music in LilyPond or ABC notation to standard classical notation.

source

A source code highlight filter diff --git a/chunked/index.html b/chunked/index.html index 1a8ae74..938bf69 100644 --- a/chunked/index.html +++ b/chunked/index.html @@ -1,2 +1,2 @@ -AsciiDoc User Guide

AsciiDoc User Guide

AsciiDoc.py Team

Table of Contents

1. Introduction

2. Getting Started

2.1. Installing AsciiDoc
2.2. Example AsciiDoc Documents

3. AsciiDoc Document Types

3.1. article
3.2. book
3.3. manpage

4. AsciiDoc Backends

4.1. Backend Aliases
4.2. Backend Plugins

5. DocBook

5.1. Converting DocBook to other file formats
5.2. a2x Toolchain Wrapper
5.3. HTML generation
5.4. PDF generation
5.5. HTML Help generation
5.6. Toolchain components summary
5.7. AsciiDoc dblatex configuration files
5.8. AsciiDoc DocBook XSL Stylesheets drivers

6. Generating Plain Text Files

7. HTML5 and XHTML 1.1

7.1. Themes

8. Document Structure

8.1. Block Elements
8.2. Header
8.3. Preamble
8.4. Sections
8.5. Inline Elements

9. Document Processing

10. Text Formatting

10.1. Quoted Text
10.2. Superscripts and Subscripts
10.3. Line Breaks
10.4. Page Breaks
10.5. Rulers
10.6. Tabs
10.7. Replacements
10.8. Special Words

11. Titles

11.1. Two line titles
11.2. One line titles
11.3. Floating titles

12. Block Titles

13. BlockId Element

14. AttributeList Element

14.1. Attribute value substitution
14.2. Common attributes

15. Paragraphs

15.1. normal paragraph syntax
15.2. literal paragraph syntax
15.3. quote and verse paragraph styles
15.4. Admonition Paragraphs

16. Delimited Blocks

16.1. Predefined Delimited Blocks
16.2. Listing Blocks
16.3. Literal Blocks
16.4. Sidebar Blocks
16.5. Comment Blocks
16.6. Passthrough Blocks
16.7. Quote Blocks
16.8. Example Blocks
16.9. Admonition Blocks
16.10. Open Blocks

17. Lists

17.1. Bulleted Lists
17.2. Numbered Lists
17.3. Labeled Lists
17.4. Question and Answer Lists
17.5. Glossary Lists
17.6. Bibliography Lists
17.7. List Item Continuation

18. Footnotes

19. Indexes

20. Callouts

20.1. Implementation Notes
20.2. Including callouts in included code

21. Macros

21.1. Inline Macros
21.2. Block Macros
21.3. System Macros
21.4. Passthrough macros
21.5. Macro Definitions

22. HTML 5 audio and video block macros

23. Tables

23.1. Example tables
23.2. Table input data formats
23.3. Table attributes
23.4. Column Specifiers
23.5. Cell Specifiers
23.6. Table styles
23.7. Markup attributes
23.8. Nested tables
23.9. DocBook table limitations

24. Manpage Documents

24.1. Document Header
24.2. The NAME Section
24.3. The SYNOPSIS Section
24.4. refmiscinfo attributes

25. Mathematical Formulas

25.1. LaTeX Math
25.2. MathJax
25.3. LaTeXMathML
25.4. ASCIIMath
25.5. MathML

26. Configuration Files

26.1. Configuration File Format
26.2. Miscellaneous section
26.3. Titles section
26.4. Tags section
26.5. Attributes section
26.6. Special Characters section
26.7. Quoted Text section
26.8. Special Words section
26.9. Replacements section
26.10. Markup Template Sections
26.11. Configuration file names, precedence and locations

27. Document Attributes

28. Attribute Entries

28.1. Setting configuration entries

29. Attribute Lists

29.1. Options attribute
29.2. Macro Attribute lists

30. Attribute References

30.1. Simple Attributes References
30.2. Conditional Attribute References
30.3. System Attribute References

31. Intrinsic Attributes

32. Block Element Definitions

32.1. Styles
32.2. Paragraphs
32.3. Delimited Blocks
32.4. Lists
32.5. Tables

33. Filters

33.1. Filter Search Paths
33.2. Filter Configuration Files
33.3. Example Filter
33.4. Built-in filters
33.5. Filter plugins

34. Plugins

35. Help Commands

35.1. Customizing Help

36. Tips and Tricks

36.1. Know Your Editor
36.2. Vim Commands for Formatting AsciiDoc
36.3. Troubleshooting
36.4. Gotchas
36.5. Combining separate documents
36.6. Processing document sections separately
36.7. Processing document snippets
36.8. Badges in HTML page footers
36.9. Pretty printing AsciiDoc output
36.10. Supporting minor DocBook DTD variations
36.11. Creating stand-alone HTML documents
36.12. Shipping stand-alone AsciiDoc source
36.13. Inserting blank space
36.14. Closing open sections
36.15. Validating output files

Glossary

A. Migration Notes

A.1. Version 7 to version 8

B. Packager Notes

C. AsciiDoc Safe Mode

D. Using AsciiDoc with non-English Languages

E. Vim Syntax Highlighter

F. Attribute Options

G. Diagnostics

H. Backend Attributes

I. License

List of Tables

7.1. Stylesheet file locations
7.2. JavaScript file locations
16.1. Default DelimitedBlock substitutions
22.1. Audio macro attributes
22.2. Video macro attributes
23.1. Simple table
23.2. Columns formatted with strong, monospaced and emphasis styles
23.3. Horizontal and vertical source data
23.4. A table with externally sourced CSV data
23.5. Cell spans, alignments and styles
33.1. Built-in filters list

List of Examples

16.1. An example

\ No newline at end of file +AsciiDoc User Guide

AsciiDoc User Guide

AsciiDoc.py Team

Table of Contents

1. Introduction

2. Getting Started

2.1. Installing AsciiDoc
2.2. Example AsciiDoc Documents

3. AsciiDoc Document Types

3.1. article
3.2. book
3.3. manpage

4. AsciiDoc Backends

4.1. Backend Aliases
4.2. Backend Plugins

5. DocBook

5.1. Converting DocBook to other file formats
5.2. a2x Toolchain Wrapper
5.3. HTML generation
5.4. PDF generation
5.5. HTML Help generation
5.6. Toolchain components summary
5.7. AsciiDoc dblatex configuration files
5.8. AsciiDoc DocBook XSL Stylesheets drivers

6. Generating Plain Text Files

7. HTML5 and XHTML 1.1

7.1. Themes

8. Document Structure

8.1. Block Elements
8.2. Header
8.3. Preamble
8.4. Sections
8.5. Inline Elements

9. Document Processing

10. Text Formatting

10.1. Quoted Text
10.2. Superscripts and Subscripts
10.3. Line Breaks
10.4. Page Breaks
10.5. Rulers
10.6. Tabs
10.7. Replacements
10.8. Special Words

11. Titles

11.1. Two line titles
11.2. One line titles
11.3. Floating titles

12. Block Titles

13. BlockId Element

14. AttributeList Element

14.1. Attribute value substitution
14.2. Common attributes

15. Paragraphs

15.1. normal paragraph syntax
15.2. literal paragraph syntax
15.3. quote and verse paragraph styles
15.4. Admonition Paragraphs

16. Delimited Blocks

16.1. Predefined Delimited Blocks
16.2. Listing Blocks
16.3. Literal Blocks
16.4. Sidebar Blocks
16.5. Comment Blocks
16.6. Passthrough Blocks
16.7. Quote Blocks
16.8. Example Blocks
16.9. Admonition Blocks
16.10. Open Blocks

17. Lists

17.1. Bulleted Lists
17.2. Numbered Lists
17.3. Labeled Lists
17.4. Question and Answer Lists
17.5. Glossary Lists
17.6. Bibliography Lists
17.7. List Item Continuation

18. Footnotes

19. Indexes

20. Callouts

20.1. Implementation Notes
20.2. Including callouts in included code

21. Macros

21.1. Inline Macros
21.2. Block Macros
21.3. System Macros
21.4. Passthrough macros
21.5. Macro Definitions

22. HTML 5 audio and video block macros

23. Tables

23.1. Example tables
23.2. Table input data formats
23.3. Table attributes
23.4. Column Specifiers
23.5. Cell Specifiers
23.6. Table styles
23.7. Markup attributes
23.8. Nested tables
23.9. DocBook table limitations

24. Manpage Documents

24.1. Document Header
24.2. The NAME Section
24.3. The SYNOPSIS Section
24.4. refmiscinfo attributes

25. Mathematical Formulas

25.1. LaTeX Math
25.2. MathJax
25.3. LaTeXMathML
25.4. ASCIIMath
25.5. MathML

26. Configuration Files

26.1. Configuration File Format
26.2. Miscellaneous section
26.3. Titles section
26.4. Tags section
26.5. Attributes section
26.6. Special Characters section
26.7. Quoted Text section
26.8. Special Words section
26.9. Replacements section
26.10. Markup Template Sections
26.11. Configuration file names, precedence and locations

27. Document Attributes

28. Attribute Entries

28.1. Setting configuration entries

29. Attribute Lists

29.1. Options attribute
29.2. Macro Attribute lists

30. Attribute References

30.1. Simple Attributes References
30.2. Conditional Attribute References
30.3. System Attribute References

31. Intrinsic Attributes

32. Block Element Definitions

32.1. Styles
32.2. Paragraphs
32.3. Delimited Blocks
32.4. Lists
32.5. Tables

33. Filters

33.1. Filter Search Paths
33.2. Filter Configuration Files
33.3. Example Filter
33.4. Built-in filters
33.5. Filter plugins

34. Plugins

35. Help Commands

35.1. Customizing Help

36. Tips and Tricks

36.1. Know Your Editor
36.2. Vim Commands for Formatting AsciiDoc
36.3. Troubleshooting
36.4. Gotchas
36.5. Combining separate documents
36.6. Processing document sections separately
36.7. Processing document snippets
36.8. Badges in HTML page footers
36.9. Pretty printing AsciiDoc output
36.10. Supporting minor DocBook DTD variations
36.11. Creating stand-alone HTML documents
36.12. Shipping stand-alone AsciiDoc source
36.13. Inserting blank space
36.14. Closing open sections
36.15. Validating output files

Glossary

A. Migration Notes

A.1. Version 7 to version 8

B. Packager Notes

C. AsciiDoc Safe Mode

D. Using AsciiDoc with non-English Languages

E. Vim Syntax Highlighter

F. Attribute Options

G. Diagnostics

H. Backend Attributes

I. License

List of Tables

7.1. Stylesheet file locations
7.2. JavaScript file locations
16.1. Default DelimitedBlock substitutions
22.1. Audio macro attributes
22.2. Video macro attributes
23.1. Simple table
23.2. Columns formatted with strong, monospaced and emphasis styles
23.3. Horizontal and vertical source data
23.4. A table with externally sourced CSV data
23.5. Cell spans, alignments and styles
33.1. Built-in filters list

List of Examples

16.1. An example

\ No newline at end of file diff --git a/chunked/pr01.html b/chunked/pr01.html index db1e308..000696c 100644 --- a/chunked/pr01.html +++ b/chunked/pr01.html @@ -5,6 +5,12 @@ pages. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page. AsciiDoc is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended -by the user.

This document

This is an overly large document, it probably needs to be refactored +by the user.


	This user guide is for AsciiDoc.py, which is a legacy processor for +this syntax, handling an older rendition of AsciiDoc. As such, this +will not properly handle the +current AsciiDoc specification. +It is suggested that unless you specifically require the AsciiDoc.py +toolchain, you should find a processor that handles the modern +AsciiDoc syntax.

\ No newline at end of file diff --git a/epub-notes.html b/epub-notes.html index b6cd27d..7c2cc70 100644 --- a/epub-notes.html +++ b/epub-notes.html @@ -270,7 +270,7 @@ will emit errors like “extra field length for first filename must be

Version 9.0.5
-Last updated 2021-02-06 05:19:16 UTC
+Last updated 2021-02-11 01:46:17 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

Version 9.0.5
-Last updated 2021-02-06 05:19:17 UTC
+Last updated 2021-02-11 01:46:18 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

Introduction

AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page.

-

AsciiDoc is highly configurable: both the AsciiDoc source file syntax +

AsciiDoc.py is a legacy processor for this syntax, handling an older +rendition of AsciiDoc. As such, this will not properly handle the +current AsciiDoc specification. +It is suggested that unless you specifically require the AsciiDoc.py +toolchain, you should find a processor that handles the modern AsciiDoc +syntax.

+

AsciiDoc.py is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.

-

AsciiDoc is free software and is licensed under the terms of the GNU +

AsciiDoc.py is free software and is licensed under the terms of the GNU General Public License version 2 (GPLv2).

@@ -890,7 +896,7 @@ Include documentation updates if you’re up to it; otherwise insert

Version 9.0.5
-Last updated 2021-02-06 05:19:17 UTC
+Last updated 2021-02-11 01:46:18 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/index.txt b/index.txt index d7c89a3..c1d5db1 100644 --- a/index.txt +++ b/index.txt @@ -22,11 +22,18 @@ Introduction ------------ {description} -AsciiDoc is highly configurable: both the AsciiDoc source file syntax +AsciiDoc.py is a legacy processor for this syntax, handling an older +rendition of AsciiDoc. As such, this will not properly handle the +https://projects.eclipse.org/projects/technology.asciidoc[current AsciiDoc specification]. +It is suggested that unless you specifically require the AsciiDoc.py +toolchain, you should find a processor that handles the modern AsciiDoc +syntax. + +AsciiDoc.py is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user. -AsciiDoc is free software and is licensed under the terms of the 'GNU +AsciiDoc.py is free software and is licensed under the terms of the 'GNU General Public License version 2' (GPLv2). TIP: The pages you are reading were written using AsciiDoc, to view diff --git a/latex-backend.html b/latex-backend.html index 11f59d8..257c918 100644 --- a/latex-backend.html +++ b/latex-backend.html @@ -560,7 +560,7 @@ Option for switching titlepage on and off

Version 9.0.5
-Last updated 2021-02-06 05:19:18 UTC
+Last updated 2021-02-11 01:46:18 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/latex-bugs.html b/latex-bugs.html index d7cb855..355bcc6 100644 --- a/latex-bugs.html +++ b/latex-bugs.html @@ -405,7 +405,7 @@ Wait until this bug is fixed?

Version 9.0.5
-Last updated 2021-02-06 05:19:18 UTC
+Last updated 2021-02-11 01:46:19 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/latex-filter.html b/latex-filter.html index fac9445..6644061 100644 --- a/latex-filter.html +++ b/latex-filter.html @@ -272,7 +272,7 @@ The asciidoc(1) input and output files cannot both be -
Version 9.0.5
-Last updated 2021-02-06 05:19:18 UTC
+Last updated 2021-02-11 01:46:19 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/latexmath.html b/latexmath.html index 19e1ae6..1f5f2e1 100644 --- a/latexmath.html +++ b/latexmath.html @@ -161,7 +161,7 @@ passthrough delimited block.

Version 9.0.5
-Last updated 2021-02-06 05:19:19 UTC
+Last updated 2021-02-11 01:46:20 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/latexmathml.html b/latexmathml.html index cd0ca0b..1069f02 100644 --- a/latexmathml.html +++ b/latexmathml.html @@ -104,7 +104,7 @@ $\displaystyle{ V_i = C_0 - C_3

Version 9.0.5
-Last updated 2021-02-06 05:19:20 UTC
+Last updated 2021-02-11 01:46:20 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/manpage.html b/manpage.html index 36a7465..cba0db8 100644 --- a/manpage.html +++ b/manpage.html @@ -467,7 +467,7 @@ Public License version 2 (GPLv2).

Version 9.0.5
-Last updated 2021-02-06 05:19:20 UTC
+Last updated 2021-02-11 01:46:20 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/music-filter.html b/music-filter.html index 2db3de3..60f8c7b 100644 --- a/music-filter.html +++ b/music-filter.html @@ -215,7 +215,7 @@ a problem).

Version 9.0.5
-Last updated 2021-02-06 05:19:20 UTC
+Last updated 2021-02-11 01:46:20 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/newlists.html b/newlists.html index c50c61a..30e40b5 100644 --- a/newlists.html +++ b/newlists.html @@ -98,7 +98,7 @@ You’ll need to update any customized configuration file list

Version 9.0.5
-Last updated 2021-02-06 05:19:22 UTC
+Last updated 2021-02-11 01:46:22 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/newtables.html b/newtables.html index 06b36d9..fd71f94 100644 --- a/newtables.html +++ b/newtables.html @@ -1370,7 +1370,7 @@ v| 

Version 9.0.5
-Last updated 2021-02-06 05:19:22 UTC
+Last updated 2021-02-11 01:46:22 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/plugins.html b/plugins.html index eb1dc77..270c3bf 100644 --- a/plugins.html +++ b/plugins.html @@ -226,7 +226,7 @@ cellspacing="0" cellpadding="4">

Version 9.0.5
-Last updated 2021-02-06 05:19:23 UTC
+Last updated 2021-02-11 01:46:23 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/publishing-ebooks-with-asciidoc.html b/publishing-ebooks-with-asciidoc.html index 816a291..6eef2b5 100644 --- a/publishing-ebooks-with-asciidoc.html +++ b/publishing-ebooks-with-asciidoc.html @@ -545,7 +545,7 @@ can be formatted as EPUB eBooks.

Version 9.0.5
-Last updated 2021-02-06 05:19:23 UTC
+Last updated 2021-02-11 01:46:23 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/slidy-example.html b/slidy-example.html index 3e9b889..30b6ac9 100644 --- a/slidy-example.html +++ b/slidy-example.html @@ -753,7 +753,7 @@ SUVORK5CYII=" />

Version 9.0.5
-Last updated 2021-02-06 05:19:24 UTC
+Last updated 2021-02-11 01:46:23 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/slidy.html b/slidy.html index e72270d..c86d220 100644 --- a/slidy.html +++ b/slidy.html @@ -270,7 +270,7 @@ Use the AsciiDoc max-width attribute to set the document display

Version 9.0.5
-Last updated 2021-02-06 05:19:25 UTC
+Last updated 2021-02-11 01:46:24 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/source-highlight-filter.html b/source-highlight-filter.html index 5810009..78d398e 100644 --- a/source-highlight-filter.html +++ b/source-highlight-filter.html @@ -442,7 +442,7 @@ You should place callout markers inside source code comments to

Version 9.0.5
-Last updated 2021-02-06 05:19:25 UTC
+Last updated 2021-02-11 01:46:24 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/support.html b/support.html index c26ee0f..e3cc007 100644 --- a/support.html +++ b/support.html @@ -66,7 +66,7 @@ Questions about general syntax or usage should be posted to the

Version 9.0.5
-Last updated 2021-02-06 05:19:25 UTC
+Last updated 2021-02-11 01:46:24 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/testasciidoc.1.html b/testasciidoc.1.html index fc9c8ae..10c62a7 100644 --- a/testasciidoc.1.html +++ b/testasciidoc.1.html @@ -253,7 +253,7 @@ contributed to it.

Version 9.0.5
-Last updated 2021-02-06 05:19:25 UTC
+Last updated 2021-02-11 01:46:24 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/testasciidoc.html b/testasciidoc.html index 7890d4e..6cc5d78 100644 --- a/testasciidoc.html +++ b/testasciidoc.html @@ -402,7 +402,7 @@ directory).

Version 9.0.5
-Last updated 2021-02-06 05:19:26 UTC
+Last updated 2021-02-11 01:46:25 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/userguide.html b/userguide.html index 20a9f1c..75e6601 100644 --- a/userguide.html +++ b/userguide.html @@ -58,6 +58,20 @@ HTML, PDF, EPUB, man page. AsciiDoc is highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.
+
+
+ + +
+ + This user guide is for AsciiDoc.py, which is a legacy processor for +this syntax, handling an older rendition of AsciiDoc. As such, this +will not properly handle the +current AsciiDoc specification. +It is suggested that unless you specifically require the AsciiDoc.py +toolchain, you should find a processor that handles the modern +AsciiDoc syntax.
+

This document
@@ -9763,7 +9777,7 @@ General Public License version 2 for more details.

Version 9.0.5
-Last updated 2021-02-06 05:19:26 UTC
+Last updated 2021-02-11 01:46:25 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

diff --git a/userguide.txt b/userguide.txt index fe204fa..0721022 100644 --- a/userguide.txt +++ b/userguide.txt @@ -14,6 +14,15 @@ AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user. +[WARNING] +This user guide is for AsciiDoc.py, which is a legacy processor for +this syntax, handling an older rendition of AsciiDoc. As such, this +will not properly handle the +https://projects.eclipse.org/projects/technology.asciidoc[current AsciiDoc specification]. +It is suggested that unless you specifically require the AsciiDoc.py +toolchain, you should find a processor that handles the modern +AsciiDoc syntax. + .This document ********************************************************************** This is an overly large document, it probably needs to be refactored diff --git a/version83.html b/version83.html index 7a88c29..967bbd9 100644 --- a/version83.html +++ b/version83.html @@ -108,7 +108,7 @@ additions and changes.

Version 9.0.5
-Last updated 2021-02-06 05:19:34 UTC
+Last updated 2021-02-11 01:46:31 UTC
AsciiDoc is a trademark of the Eclipse Foundation, Inc.

-- cgit v1.2.1

Answer 1

Answer one. -

Answer 2

Answer two. diff --git a/chunked/ch18.html b/chunked/ch18.html index 05aeb67..d3b01d3 100644 --- a/chunked/ch18.html +++ b/chunked/ch18.html @@ -17,6 +17,6 @@ JavaScript; html4 outputs do not use Java footnotes inline; docbook footnotes are processed by the downstream DocBook toolchain.

Example footnotes:

A footnote footnote:[An example footnote.];
 a second footnote with a reference ID footnoteref:[note2,Second footnote.];
-finally a reference to the second footnote footnoteref:[note2].

Renders:

A footnote ^[2]; +finally a reference to the second footnote footnoteref:[note2].

Renders:

A footnote ^[2]; a second footnote with a reference ID ^[3]; -finally a reference to the second footnote ^[3].

^[2]An example footnote.

^[3]Second footnote.

\ No newline at end of file +finally a reference to the second footnote ^[3].

^[2]An example footnote.

^[3]Second footnote.

\ No newline at end of file diff --git a/chunked/ch22.html b/chunked/ch22.html index 378f624..bc58332 100644 --- a/chunked/ch22.html +++ b/chunked/ch22.html @@ -25,10 +25,10 @@ The URL or file name of the video or audio file.

A list of named attributes (see below).

-

7.1. Themes

8.1. Block Elements

16.2. Listing Blocks

16.2. Listing Blocks

23.1. Example tables

23.1. Example tables

33.4. Built-in filters

AsciiDoc User Guide

AsciiDoc.py Team

AsciiDoc User Guide

AsciiDoc.py Team

Introduction