blob: 0231242d607263fa48bc9e22b99e3a9f9fa87c79 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 9. Document Processing</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="AsciiDoc User Guide" /><link rel="up" href="index.html" title="AsciiDoc User Guide" /><link rel="prev" href="ch08.html" title="Chapter 8. Document Structure" /><link rel="next" href="ch10.html" title="Chapter 10. Text Formatting" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><td width="20%" align="left"><a accesskey="p" href="ch08.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch10.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="_document_processing"></a>Chapter 9. Document Processing</h1></div></div></div><p>The AsciiDoc source document is read and processed as follows:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
The document <span class="emphasis"><em>Header</em></span> is parsed, header parameter values are
substituted into the configuration file <code class="literal">[header]</code> template section
which is then written to the output file.
</li><li class="listitem">
Each document <span class="emphasis"><em>Section</em></span> is processed and its constituent elements
translated to the output file.
</li><li class="listitem">
The configuration file <code class="literal">[footer]</code> template section is substituted
and written to the output file.
</li></ol></div><p>When a block element is encountered asciidoc(1) determines the type of
block by checking in the following order (first to last): (section)
Titles, BlockMacros, Lists, DelimitedBlocks, Tables, AttributeEntrys,
AttributeLists, BlockTitles, Paragraphs.</p><p>The default paragraph definition <code class="literal">[paradef-default]</code> is last element
to be checked.</p><p>Knowing the parsing order will help you devise unambiguous macro, list
and block syntax rules.</p><p>Inline substitutions within block elements are performed in the
following default order:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
Special characters
</li><li class="listitem">
Quotes
</li><li class="listitem">
Special words
</li><li class="listitem">
Replacements
</li><li class="listitem">
Attributes
</li><li class="listitem">
Inline Macros
</li><li class="listitem">
Replacements2
</li></ol></div><p>The substitutions and substitution order performed on
Title, Paragraph and DelimitedBlock elements is determined by
configuration file parameters.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch08.html"><img src="images/icons/prev.png" alt="Prev" /></a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch10.html"><img src="images/icons/next.png" alt="Next" /></a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/icons/home.png" alt="Home" /></a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
|
