AsciiDoc User Guide - methods

1 AsciiDoc user GuideiAsciiDoc user GuideAsciiDoc user GuideiiREVISION November 2013 SJRA sciiDoc user GuideiiiContents1 Introduction12 Getting AsciiDoc .. AsciiDoc Documents ..13 AsciiDoc Document ..24 AsciiDoc Aliases .. Plugins ..35 DocBook to other file formats .. Toolchain Wrapper .. generation .. generation .. Help generation .. components summary .. dblatex configuration files .. DocBook XSL Stylesheets drivers ..56 Generating Plain Text Files67 HTML5 and XHTML ..78 Document Elements .. document header information.

2 Markup templates .. IDs .. Section Titles .. Elements .. 13 AsciiDoc user Guideiv9 Document Processing1310 Text Quoted Text .. Quoted text attributes .. Constrained and Unconstrained Quotes .. 15 Constrained quotes .. 15 Unconstrained quotes .. Superscripts and Subscripts .. Line Breaks .. Page Breaks .. Rulers .. Tabs .. Replacements .. Special Words .. 1711 Two line titles .. One line titles .. Floating titles .. 1812 Block Titles1813 BlockId Element1814 AttributeList Attribute value substitution.

3 Common attributes .. 1915 normal paragraph syntax .. literal paragraph syntax .. quote and verse paragraph styles .. Admonition Paragraphs .. Admonition Icons and Captions .. 2116 Delimited Predefined Delimited Blocks .. Listing Blocks .. Literal Blocks .. Sidebar Blocks .. Comment Blocks .. 23 AsciiDoc user Passthrough Blocks .. Quote Blocks .. Example Blocks .. Admonition Blocks .. Blocks .. 2617 Bulleted Lists .. Numbered Lists.

4 Labeled Lists .. Horizontal labeled list style .. Question and Answer Lists .. Glossary Lists .. Bibliography Lists .. List Item Continuation .. 3118 Footnotes3219 Indexes3320 Implementation Notes .. Including callouts in included code .. 3521 Inline Macros .. URLs .. Internal Cross References .. 36anchor .. 37xref .. Linking to Local Documents .. Images .. Comment Lines .. Block Macros .. Block Identifier .. Images.

5 Comment Lines .. System Macros .. Include Macros .. Conditional Inclusion Macros .. Executable system macros .. Template System Macro .. Passthrough macros .. Macro Definitions .. 43 AsciiDoc user Guidevi22 HTML 5 audio and video block macros4423 Example tables .. Table input data formats .. Table attributes .. Column Specifiers .. Cell Specifiers .. Table styles .. Markup attributes .. Nested tables .. DocBook table limitations.

6 5224 Manpage Document Header .. The NAME Section .. The SYNOPSIS Section .. refmiscinfo attributes .. 5325 Mathematical LaTeX Math .. ASCIIMathML .. LaTeXMathML .. MathML .. 5426 Configuration Configuration File Format .. Miscellaneous section .. Titles section .. Tags section .. Attributes section .. Special Characters section .. Quoted Text section .. Special Words section .. Replacements section .. Template Sections .. file names, precedence and locations.

7 5927 Document Attributes6128 Attribute Setting configuration entries .. 63 AsciiDoc user Guidevii29 Attribute Options attribute .. Macro Attribute lists .. 6430 Attribute Simple Attributes References .. Conditional Attribute References .. Conditional attribute examples .. System Attribute References .. 6631 Intrinsic Attributes6832 Block Element Styles .. Paragraphs .. Delimited Blocks .. Lists .. Tables .. 7333 Filter Search Paths .. Filter Configuration Files.

8 Example Filter .. Built-in filters .. Filter plugins .. 7534 Plugins7535 Help Customizing Help .. 7536 Tips and Know Your Editor .. Vim Commands for Formatting AsciiDoc .. Text Wrap Paragraphs .. Format Lists .. Indent Paragraphs .. Example~/.vimrcFile .. Troubleshooting .. Gotchas .. Combining separate documents .. Processing document sections separately .. 79 AsciiDoc user Processing document snippets .. Badges in HTML page footers .. Pretty printing AsciiDoc output.

9 Minor DocBook DTD variations .. stand-alone HTML documents .. stand-alone AsciiDoc source .. blank space .. open sections .. output files .. 8137 Glossary81A Migration Version 7 to version 8 .. 81B Packager Notes82C AsciiDoc Safe Mode82D Using AsciiDoc with non-English Languages82E Vim Syntax Highlighter83F Attribute Options83G Diagnostics83H Backend Attributes85 ILicense88 AsciiDoc user Guide1 / 88 AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, blogsand UNIX man pages.

10 AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page. AsciiDocis highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type ofSGML/XML markup) can be customized and extended by the documentThis is an overly large document, it probably needs to be refactored into a Tutorial, Quick Reference and Formal you re new to AsciiDoc read this section and the Getting Started section and take a look at the example AsciiDoc (*.txt) source files in the IntroductionAsciiDoc is a plain text human readable/writable document format that can be translated to DocBook or HTML using theasciidoc(1)command.