FooBarWidget-mizuho 0.9.1 → 0.9.2
Sign up to get free protection for your applications and to get access to all the features.
- data/README.markdown +1 -1
- data/Rakefile +14 -2
- data/asciidoc/BUGS +11 -6
- data/asciidoc/BUGS.txt +7 -3
- data/asciidoc/CHANGELOG +313 -151
- data/asciidoc/CHANGELOG.txt +177 -12
- data/asciidoc/INSTALL +30 -36
- data/asciidoc/INSTALL.txt +20 -20
- data/asciidoc/Makefile.in +145 -0
- data/asciidoc/README +11 -11
- data/asciidoc/README.txt +9 -9
- data/asciidoc/a2x +40 -7
- data/asciidoc/asciidoc.conf +180 -126
- data/asciidoc/asciidoc.py +1667 -977
- data/asciidoc/common.aap +2 -2
- data/asciidoc/configure +2840 -0
- data/asciidoc/configure.ac +11 -0
- data/asciidoc/dblatex/asciidoc-dblatex.sty +2 -0
- data/asciidoc/dblatex/asciidoc-dblatex.xsl +15 -0
- data/asciidoc/dblatex/dblatex-readme.txt +19 -2
- data/asciidoc/doc/a2x.1 +77 -67
- data/asciidoc/doc/a2x.1.txt +11 -2
- data/asciidoc/doc/article.css-embedded.html +85 -63
- data/asciidoc/doc/article.html +644 -62
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/article.txt +15 -17
- data/asciidoc/doc/asciidoc.1 +34 -40
- data/asciidoc/doc/asciidoc.1.css-embedded.html +67 -32
- data/asciidoc/doc/asciidoc.1.css.html +28 -28
- data/asciidoc/doc/asciidoc.1.html +33 -33
- data/asciidoc/doc/asciidoc.css-embedded.html +2234 -2348
- data/asciidoc/doc/asciidoc.css.html +2203 -2352
- data/asciidoc/doc/asciidoc.dict +52 -1
- data/asciidoc/doc/asciidoc.html +980 -1160
- data/asciidoc/doc/asciidoc.txt +941 -738
- data/asciidoc/doc/asciimathml.txt +63 -0
- data/asciidoc/doc/book-multi.html +26 -43
- data/asciidoc/doc/book-multi.txt +19 -23
- data/asciidoc/doc/book.css-embedded.html +92 -71
- data/asciidoc/doc/book.html +24 -41
- data/asciidoc/doc/book.txt +19 -21
- data/asciidoc/doc/docbook-xsl.css +1 -0
- data/asciidoc/doc/faq.txt +288 -60
- data/asciidoc/doc/images +1 -0
- data/asciidoc/doc/latex-backend.html +16 -123
- data/asciidoc/doc/latex-backend.txt +17 -19
- data/asciidoc/doc/latexmath.txt +233 -24
- data/asciidoc/doc/latexmathml.txt +41 -0
- data/asciidoc/doc/main.aap +9 -5
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.txt +2 -2
- data/asciidoc/doc/source-highlight-filter.html +476 -105
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +39 -10
- data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +1 -29
- data/asciidoc/docbook-xsl/fo.xsl +35 -3
- data/asciidoc/docbook-xsl/manpage.xsl +3 -0
- data/asciidoc/docbook-xsl/text.xsl +50 -0
- data/asciidoc/docbook.conf +182 -73
- data/asciidoc/examples/website/ASCIIMathML.js +1 -0
- data/asciidoc/examples/website/CHANGELOG.html +618 -182
- data/asciidoc/examples/website/CHANGELOG.txt +1 -0
- data/asciidoc/examples/website/INSTALL.html +34 -36
- data/asciidoc/examples/website/INSTALL.txt +1 -0
- data/asciidoc/examples/website/LaTeXMathML.js +1 -0
- data/asciidoc/examples/website/README-website.html +26 -37
- data/asciidoc/examples/website/README-website.txt +6 -6
- data/asciidoc/examples/website/README.html +15 -15
- data/asciidoc/examples/website/README.txt +1 -0
- data/asciidoc/examples/website/a2x.1.html +74 -50
- data/asciidoc/examples/website/a2x.1.txt +1 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +13 -48
- data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +1 -0
- data/asciidoc/examples/website/asciimathml.txt +1 -0
- data/asciidoc/examples/website/customers.csv +1 -0
- data/asciidoc/examples/website/downloads.html +69 -31
- data/asciidoc/examples/website/downloads.txt +28 -5
- data/asciidoc/examples/website/faq.html +370 -124
- data/asciidoc/examples/website/faq.txt +1 -0
- data/asciidoc/examples/website/images +1 -0
- data/asciidoc/examples/website/index.html +64 -64
- data/asciidoc/examples/website/index.txt +22 -15
- data/asciidoc/examples/website/latex-backend.html +152 -257
- data/asciidoc/examples/website/latex-backend.txt +1 -0
- data/asciidoc/examples/website/latexmathml.txt +1 -0
- data/asciidoc/examples/website/manpage.html +27 -27
- data/asciidoc/examples/website/manpage.txt +1 -0
- data/asciidoc/examples/website/music-filter.html +18 -18
- data/asciidoc/examples/website/music-filter.txt +1 -0
- data/asciidoc/examples/website/music1.abc +1 -1
- data/asciidoc/examples/website/music1.png +0 -0
- data/asciidoc/examples/website/music2.ly +1 -1
- data/asciidoc/examples/website/music2.png +0 -0
- data/asciidoc/examples/website/newlists.txt +40 -0
- data/asciidoc/examples/website/newtables.txt +397 -0
- data/asciidoc/examples/website/source-highlight-filter.html +67 -32
- data/asciidoc/examples/website/source-highlight-filter.txt +1 -0
- data/asciidoc/examples/website/support.html +4 -4
- data/asciidoc/examples/website/toc.js +1 -0
- data/asciidoc/examples/website/userguide.html +2190 -2339
- data/asciidoc/examples/website/userguide.txt +1 -0
- data/asciidoc/examples/website/version83.txt +37 -0
- data/asciidoc/examples/website/version9.html +13 -13
- data/asciidoc/examples/website/xhtml11-manpage.css +1 -0
- data/asciidoc/examples/website/xhtml11-quirks.css +1 -0
- data/asciidoc/examples/website/xhtml11.css +1 -0
- data/asciidoc/filters/code-filter-readme.txt +3 -3
- data/asciidoc/filters/code-filter-test.txt +6 -6
- data/asciidoc/filters/source-highlight-filter.conf +12 -5
- data/asciidoc/html4.conf +152 -58
- data/asciidoc/install-sh +201 -0
- data/asciidoc/latex.conf +41 -41
- data/asciidoc/stylesheets/docbook-xsl.css +1 -0
- data/asciidoc/stylesheets/xhtml11.css +39 -4
- data/asciidoc/text.conf +4 -4
- data/asciidoc/vim/syntax/asciidoc.vim +58 -32
- data/asciidoc/wordpress.conf +48 -0
- data/asciidoc/xhtml11-quirks.conf +1 -1
- data/asciidoc/xhtml11.conf +198 -70
- data/bin/mizuho +5 -2
- data/lib/mizuho/generator.rb +48 -19
- data/mizuho.gemspec +16 -6
- metadata +58 -15
- data/asciidoc/doc/asciimath.txt +0 -47
- data/asciidoc/docbook-xsl/shaded-literallayout.patch +0 -32
- data/asciidoc/examples/website/asciimath.html +0 -157
- data/asciidoc/examples/website/latexmath.html +0 -119
- data/asciidoc/filters/code-filter-test-c++.txt +0 -7
- data/asciidoc/install.sh +0 -55
- data/asciidoc/linuxdoc.conf +0 -285
- data/asciidoc/math.conf +0 -50
- data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +0 -21
- data/asciidoc/stylesheets/xhtml-deprecated.css +0 -247
- data/asciidoc/t.conf +0 -20
- data/asciidoc/xhtml-deprecated-css.conf +0 -235
- data/asciidoc/xhtml-deprecated.conf +0 -351
data/asciidoc/doc/book.html
CHANGED
|
@@ -1,60 +1,43 @@
|
|
|
1
|
-
<?xml version="1.0" encoding="UTF-8"?>
|
|
2
1
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
3
|
-
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Book Title Goes Here</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.
|
|
2
|
+
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Book Title Goes Here</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="book" lang="en" xml:lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="id2425213"></a>Book Title Goes Here</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Author's</span> <span class="surname">Name</span></h3></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 1.0</td><td align="left">Dec 2003</td><td align="left">AN</td></tr></table></div></div></div><hr /></div><div class="dedication" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_dedication"></a>Dedication</h2></div></div></div><p>Optional dedication.</p><p>This document is an <span class="emphasis"><em>AsciiDoc</em></span> book skeleton containing briefly
|
|
4
3
|
annotated example elements plus a couple of example index entries and
|
|
5
4
|
footnotes.</p><p>Books are normally used to generate DocBook markup and the titles of
|
|
6
5
|
the preface, appendix, bibliography, glossary and index sections are
|
|
7
|
-
significant (<span class="emphasis"><em>specialsections</em></span>).</p></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="preface"><a href="#_preface">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="#_preface_sub_section">1. Preface Sub-section</a></span></dt></dl></dd><dt><span class="chapter"><a href="#_the_first_chapter">1. The First Chapter</a></span></dt><dd><dl><dt><span class="section"><a href="#X1">1.1. Sub-section with Anchor</a></span></dt><dd><dl><dt><span class="section"><a href="#_chapter_sub_section">1.1.1. Chapter Sub-section</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#_the_second_chapter">2. The Second Chapter</a></span></dt><dt><span class="chapter"><a href="#_the_third_chapter">3. The Third Chapter</a></span></dt><dt><span class="appendix"><a href="#_example_appendix">A. Example Appendix</a></span></dt><dd><dl><dt><span class="section"><a href="#_appendix_sub_section">A.1. Appendix Sub-section</a></span></dt></dl></dd><dt><span class="bibliography"><a href="#_bibliography">Bibliography</a></span></dt><dt><span class="glossary"><a href="#_glossary">Glossary</a></span></dt><dt><span class="index"><a href="#_index">Index</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>1.1. <a href="#
|
|
8
|
-
<sup>[<a id="
|
|
9
|
-
<a id="
|
|
10
|
-
monkeys, lions and
|
|
6
|
+
significant (<span class="emphasis"><em>specialsections</em></span>).</p></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="preface"><a href="#_preface">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="#_preface_sub_section">1. Preface Sub-section</a></span></dt></dl></dd><dt><span class="chapter"><a href="#_the_first_chapter">1. The First Chapter</a></span></dt><dd><dl><dt><span class="section"><a href="#X1">1.1. Sub-section with Anchor</a></span></dt><dd><dl><dt><span class="section"><a href="#_chapter_sub_section">1.1.1. Chapter Sub-section</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#_the_second_chapter">2. The Second Chapter</a></span></dt><dt><span class="chapter"><a href="#_the_third_chapter">3. The Third Chapter</a></span></dt><dt><span class="appendix"><a href="#_example_appendix">A. Example Appendix</a></span></dt><dd><dl><dt><span class="section"><a href="#_appendix_sub_section">A.1. Appendix Sub-section</a></span></dt></dl></dd><dt><span class="bibliography"><a href="#_bibliography">Bibliography</a></span></dt><dt><span class="glossary"><a href="#_glossary">Glossary</a></span></dt><dt><span class="index"><a href="#_index">Index</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>1.1. <a href="#id2477575">Tiger block image</a></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1.1. <a href="#id2477601">An example table</a></dt></dl></div><div class="preface" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_preface"></a>Preface</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_preface_sub_section">1. Preface Sub-section</a></span></dt></dl></div><p>Optional preface.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_preface_sub_section"></a>1. Preface Sub-section</h2></div></div></div><p>Preface sub-section body.</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_the_first_chapter"></a>Chapter 1. The First Chapter</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#X1">1.1. Sub-section with Anchor</a></span></dt><dd><dl><dt><span class="section"><a href="#_chapter_sub_section">1.1.1. Chapter Sub-section</a></span></dt></dl></dd></dl></div><p>Chapters can contain sub-sections nested up to three deep.
|
|
7
|
+
<sup>[<a id="id2518172" href="#ftn.id2518172" class="footnote">1</a>]</sup>
|
|
8
|
+
<a id="id2518176" class="indexterm"></a></p><p>Chapters can have their own bibliography, glossary and index.</p><p>And now for something completely different: <a id="id2477454" class="indexterm"></a>monkeys, lions and
|
|
11
9
|
tigers (Bengal and Siberian) using the alternative syntax index
|
|
12
10
|
entries.
|
|
13
|
-
<a id="
|
|
14
|
-
<a id="
|
|
15
|
-
<a id="
|
|
16
|
-
<a id="
|
|
17
|
-
<a id="
|
|
18
|
-
<a id="
|
|
19
|
-
<a id="
|
|
20
|
-
<a id="
|
|
11
|
+
<a id="id2477463" class="indexterm"></a>
|
|
12
|
+
<a id="id2477475" class="indexterm"></a>
|
|
13
|
+
<a id="id2477484" class="indexterm"></a>
|
|
14
|
+
<a id="id2477498" class="indexterm"></a>
|
|
15
|
+
<a id="id2477509" class="indexterm"></a>
|
|
16
|
+
<a id="id2477518" class="indexterm"></a>
|
|
17
|
+
<a id="id2477532" class="indexterm"></a>
|
|
18
|
+
<a id="id2477543" class="indexterm"></a>
|
|
21
19
|
Note that multi-entry terms generate separate index entries.</p><p>Here are a couple of image examples: an <span class="inlinemediaobject"><img src="images/smallnew.png" alt="images/smallnew.png" /></span>
|
|
22
|
-
example inline image followed by an example block image:</p><div class="figure"><a id="
|
|
23
|
-
Option
|
|
24
|
-
</th><th style="" align="left">
|
|
25
|
-
Description
|
|
26
|
-
</th></tr></thead><tbody><tr><td style="" align="left">
|
|
27
|
-
-a <span class="emphasis"><em>USER GROUP</em></span>
|
|
28
|
-
</td><td style="" align="left">
|
|
29
|
-
Add <span class="emphasis"><em>USER</em></span> to <span class="emphasis"><em>GROUP</em></span>.
|
|
30
|
-
</td></tr><tr><td style="" align="left">
|
|
31
|
-
-R <span class="emphasis"><em>GROUP</em></span>
|
|
32
|
-
</td><td style="" align="left">
|
|
33
|
-
Disables access to <span class="emphasis"><em>GROUP</em></span>.
|
|
34
|
-
</td></tr></tbody></table></div></div><br class="table-break" /><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="X1"></a>1.1. Sub-section with Anchor</h2></div></div></div><p>Sub-section at level 2.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="_chapter_sub_section"></a>1.1.1. Chapter Sub-section</h3></div></div></div><p>Sub-section at level 3.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="_chapter_sub_section_2"></a>1.1.1.1. Chapter Sub-section</h4></div></div></div><p>Sub-section at level 4.</p><p>This is the maximum sub-section depth supported by the distributed
|
|
20
|
+
example inline image followed by an example block image:</p><div class="figure"><a id="id2477575"></a><p class="title"><b>Figure 1.1. Tiger block image</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/tiger.png" alt="Tiger image" /></div></div></div><br class="figure-break" /><p>Followed by an example table:</p><div class="table"><a id="id2477601"></a><p class="title"><b>Table 1.1. An example table</b></p><div class="table-contents"><table summary="An example table" cellpadding="4px" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead valign="top"><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left" valign="top"> Option </th><th style="border-bottom: 1px solid ; " align="left" valign="top"> Description</th></tr></thead><tbody valign="top"><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left" valign="top"><p>-a <span class="emphasis"><em>USER GROUP</em></span></p></td><td style="border-bottom: 1px solid ; " align="left" valign="top"><p>Add <span class="emphasis"><em>USER</em></span> to <span class="emphasis"><em>GROUP</em></span>.</p></td></tr><tr><td style="border-right: 1px solid ; " align="left" valign="top"><p>-R <span class="emphasis"><em>GROUP</em></span></p></td><td style="" align="left" valign="top"><p>Disables access to <span class="emphasis"><em>GROUP</em></span>.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="X1"></a>1.1. Sub-section with Anchor</h2></div></div></div><p>Sub-section at level 2.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="_chapter_sub_section"></a>1.1.1. Chapter Sub-section</h3></div></div></div><p>Sub-section at level 3.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="_chapter_sub_section_2"></a>1.1.1.1. Chapter Sub-section</h4></div></div></div><p>Sub-section at level 4.</p><p>This is the maximum sub-section depth supported by the distributed
|
|
35
21
|
<span class="emphasis"><em>AsciiDoc</em></span> configuration.
|
|
36
|
-
<sup>[<a id="
|
|
37
|
-
<a id="
|
|
38
|
-
<span class="emphasis"><em>AsciiDoc</em></span> source list items are bulleted with a <code class="literal">+</code> character. The
|
|
39
|
-
first entry in this example has an anchor.</p><div class="bibliomixed"><a id="id2488885"></a><p class="bibliomixed">
|
|
22
|
+
<sup>[<a id="id2477784" href="#ftn.id2477784" class="footnote">2</a>]</sup></p></div></div></div><div class="footnotes"><br /><hr width="100" align="left" /><div class="footnote"><p><sup>[<a id="ftn.id2518172" href="#id2518172" class="simpara">1</a>] </sup>An example footnote.</p></div><div class="footnote"><p><sup>[<a id="ftn.id2477784" href="#id2477784" class="simpara">2</a>] </sup>A second example footnote.</p></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_the_second_chapter"></a>Chapter 2. The Second Chapter</h2></div></div></div><p>An example link to anchor at start of the <a class="link" href="#X1" title="1.1. Sub-section with Anchor">first sub-section</a>.
|
|
23
|
+
<a id="id2477912" class="indexterm"></a></p><p>An example link to a bibliography entry <a class="xref" href="#taoup">[taoup]</a>.</p></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_the_third_chapter"></a>Chapter 3. The Third Chapter</h2></div></div></div><p>Book chapters are at level 1 and can contain sub-sections.</p></div><div class="appendix" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="_example_appendix"></a>Appendix A. Example Appendix</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_appendix_sub_section">A.1. Appendix Sub-section</a></span></dt></dl></div><p>One or more optional appendixes go here at section level 1.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_appendix_sub_section"></a>A.1. Appendix Sub-section</h2></div></div></div><p>Sub-section body.</p></div></div><div class="bibliography"><div class="titlepage"><div><div><h2 class="title"><a id="_bibliography"></a>Bibliography</h2></div></div></div><p>The bibliography list is a style of <span class="emphasis"><em>AsciiDoc</em></span> bulleted list.</p><div class="bibliomixed"><a id="id2478223"></a><p class="bibliomixed">
|
|
40
24
|
<span class="bibliomisc">
|
|
41
|
-
<a id="taoup"></a>[taoup] Eric Steven Raymond. <span class="emphasis"><em>The Art of Unix
|
|
42
|
-
Addison-Wesley. ISBN 0-13-142901-9.
|
|
25
|
+
<a id="taoup"></a>[taoup] Eric Steven Raymond. <span class="emphasis"><em>The Art of Unix
|
|
26
|
+
Programming</em></span>. Addison-Wesley. ISBN 0-13-142901-9.
|
|
43
27
|
</span>
|
|
44
|
-
</p></div><div class="bibliomixed"><a id="
|
|
28
|
+
</p></div><div class="bibliomixed"><a id="id2478242"></a><p class="bibliomixed">
|
|
45
29
|
<span class="bibliomisc">
|
|
46
30
|
<a id="walsh-muellner"></a>[walsh-muellner] Norman Walsh & Leonard Muellner.
|
|
47
|
-
<span class="emphasis"><em>DocBook - The
|
|
31
|
+
<span class="emphasis"><em>DocBook - The Definitive Guide</em></span>. O’Reilly & Associates. 1999.
|
|
48
32
|
ISBN 1-56592-580-7.
|
|
49
33
|
</span>
|
|
50
|
-
</p></div></div><div class="glossary"><div class="titlepage"><div><div><h2 class="title"><a id="_glossary"></a>Glossary</h2></div></div></div><p>Glossaries are optional. Glossaries are an example of
|
|
51
|
-
|
|
52
|
-
by the <code class="literal">:-</code> characters.</p><dl><dt>
|
|
34
|
+
</p></div></div><div class="glossary"><div class="titlepage"><div><div><h2 class="title"><a id="_glossary"></a>Glossary</h2></div></div></div><p>Glossaries are optional. Glossaries entries are an example of a style
|
|
35
|
+
of <span class="emphasis"><em>AsciiDoc</em></span> labeled lists.</p><dl><dt>
|
|
53
36
|
A glossary term
|
|
54
37
|
</dt><dd><p>
|
|
55
|
-
|
|
38
|
+
The corresponding (indented) definition.
|
|
56
39
|
</p></dd><dt>
|
|
57
40
|
A second glossary term
|
|
58
41
|
</dt><dd><p>
|
|
59
|
-
|
|
60
|
-
</p></dd></dl></div><div class="index"><div class="titlepage"><div><div><h2 class="title"><a id="_index"></a>Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>B</h3><dl><dt>Bengal Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt><dt>Big cats</dt><dd><dl><dt>Lions, <a href="#_the_first_chapter">The First Chapter</a></dt><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt><dt>Siberian Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>Example index entry, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Lions, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>monkeys, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>Second example index entry, <a href="#_the_second_chapter">The Second Chapter</a></dt><dt>Siberian Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt><dt>Siberian Tiger, <a href="#_the_first_chapter">The First Chapter</a></dt></dl></dd></dl></div></div></div></div></body></html>
|
|
42
|
+
The corresponding (indented) definition.
|
|
43
|
+
</p></dd></dl></div><div class="index"><div class="titlepage"><div><div><h2 class="title"><a id="_index"></a>Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>B</h3><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt><dt>Big cats</dt><dd><dl><dt>Lions, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>Example index entry, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Lions, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>monkeys, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>Second example index entry, <a class="indexterm" href="#_the_second_chapter">The Second Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_chapter">The First Chapter</a></dt></dl></dd></dl></div></div></div></div></body></html>
|
data/asciidoc/doc/book.txt
CHANGED
|
@@ -51,12 +51,12 @@ image::images/tiger.png[Tiger image]
|
|
|
51
51
|
Followed by an example table:
|
|
52
52
|
|
|
53
53
|
.An example table
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
-a 'USER GROUP'
|
|
58
|
-
-R 'GROUP'
|
|
59
|
-
|
|
54
|
+
[width="60%",options="header"]
|
|
55
|
+
|==============================================
|
|
56
|
+
| Option | Description
|
|
57
|
+
| -a 'USER GROUP' | Add 'USER' to 'GROUP'.
|
|
58
|
+
| -R 'GROUP' | Disables access to 'GROUP'.
|
|
59
|
+
|==============================================
|
|
60
60
|
|
|
61
61
|
[[X1]]
|
|
62
62
|
Sub-section with Anchor
|
|
@@ -100,29 +100,27 @@ Sub-section body.
|
|
|
100
100
|
|
|
101
101
|
Bibliography
|
|
102
102
|
------------
|
|
103
|
-
The bibliography list is
|
|
104
|
-
AsciiDoc source list items are bulleted with a `+` character. The
|
|
105
|
-
first entry in this example has an anchor.
|
|
103
|
+
The bibliography list is a style of AsciiDoc bulleted list.
|
|
106
104
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
'DocBook - The
|
|
105
|
+
[bibliography]
|
|
106
|
+
- [[[taoup]]] Eric Steven Raymond. 'The Art of Unix
|
|
107
|
+
Programming'. Addison-Wesley. ISBN 0-13-142901-9.
|
|
108
|
+
- [[[walsh-muellner]]] Norman Walsh & Leonard Muellner.
|
|
109
|
+
'DocBook - The Definitive Guide'. O'Reilly & Associates. 1999.
|
|
112
110
|
ISBN 1-56592-580-7.
|
|
113
111
|
|
|
114
112
|
|
|
115
113
|
Glossary
|
|
116
114
|
--------
|
|
117
|
-
Glossaries are optional. Glossaries are an example of
|
|
118
|
-
|
|
119
|
-
by the `:-` characters.
|
|
115
|
+
Glossaries are optional. Glossaries entries are an example of a style
|
|
116
|
+
of AsciiDoc labeled lists.
|
|
120
117
|
|
|
121
|
-
|
|
122
|
-
|
|
118
|
+
[glossary]
|
|
119
|
+
A glossary term::
|
|
120
|
+
The corresponding (indented) definition.
|
|
123
121
|
|
|
124
|
-
A second glossary term
|
|
125
|
-
|
|
122
|
+
A second glossary term::
|
|
123
|
+
The corresponding (indented) definition.
|
|
126
124
|
|
|
127
125
|
|
|
128
126
|
Index
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
../stylesheets/docbook-xsl.css
|
data/asciidoc/doc/faq.txt
CHANGED
|
@@ -4,6 +4,214 @@ AsciiDoc Frequently Asked Questions
|
|
|
4
4
|
An embryonic AsciiDoc FAQ.
|
|
5
5
|
|
|
6
6
|
|
|
7
|
+
== How can I render indented paragraphs?
|
|
8
|
+
|
|
9
|
+
To unconditionally indent all paragraphs add the following line to the
|
|
10
|
+
`xhtml11.css` stylesheet (or a custom stylesheet).
|
|
11
|
+
|
|
12
|
+
---------------------------------------------------------------------
|
|
13
|
+
div.paragraph p {text-indent: 3em;}
|
|
14
|
+
---------------------------------------------------------------------
|
|
15
|
+
|
|
16
|
+
This will restyle the entire document by indenting all paragraphs
|
|
17
|
+
which is normally what you want to do (mixed paragraph styles produce
|
|
18
|
+
ugly documents).
|
|
19
|
+
|
|
20
|
+
To selectively indent paragraphs with the 'indented' style add the
|
|
21
|
+
following line to the `xhtml11.css` stylesheet (or a custom
|
|
22
|
+
stylesheet).
|
|
23
|
+
|
|
24
|
+
---------------------------------------------------------------------
|
|
25
|
+
div.paragraph.indented p {text-indent: 3em;}
|
|
26
|
+
---------------------------------------------------------------------
|
|
27
|
+
|
|
28
|
+
Then apply the 'indented' style to normal paragraphs, for example:
|
|
29
|
+
|
|
30
|
+
---------------------------------------------------------------------
|
|
31
|
+
[indented]
|
|
32
|
+
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas
|
|
33
|
+
ultrices justo porttitor augue. Vestibulum pretium. Donec porta
|
|
34
|
+
vestibulum mi. Aliquam pede. Aenean lobortis lorem et lacus. Sed
|
|
35
|
+
lacinia. Vivamus at lectus.
|
|
36
|
+
---------------------------------------------------------------------
|
|
37
|
+
|
|
38
|
+
NOTE: This FAQ applies to XHTML output not DocBook. To achieve the
|
|
39
|
+
same results with DocBook you would need to customize the DocBook XSL
|
|
40
|
+
stylesheets to indent paragraphs with the `simpara` element
|
|
41
|
+
`role="indented"` attribute.
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
== Is there a way to set default image height and width attributes?
|
|
45
|
+
|
|
46
|
+
You can set the 'height' and 'width' attributes globally in your
|
|
47
|
+
document with Attribute Entries or from the command-line using the
|
|
48
|
+
`--attribute` option. In the following example images that don't
|
|
49
|
+
explicitly set the 'height' and 'width' values will be 350 by 250
|
|
50
|
+
pixels.
|
|
51
|
+
|
|
52
|
+
---------------------------------------------------------------------
|
|
53
|
+
:height: 250
|
|
54
|
+
:width: 350
|
|
55
|
+
|
|
56
|
+
image:images/tiger.png[]
|
|
57
|
+
---------------------------------------------------------------------
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
== How can I place a backslash character in front of an attribute reference without escaping the reference?
|
|
61
|
+
|
|
62
|
+
Use the predefined `\{backslash}` attribute reference instead of an
|
|
63
|
+
actual backslash, for example if the `\{projectname}` attribute has
|
|
64
|
+
the value `foobar` then:
|
|
65
|
+
|
|
66
|
+
d:\data{backslash}{projectname}
|
|
67
|
+
|
|
68
|
+
would be rendered as:
|
|
69
|
+
|
|
70
|
+
d:\data\foobar
|
|
71
|
+
|
|
72
|
+
== How can I escape AsciiDoc markup?
|
|
73
|
+
|
|
74
|
+
Most AsciiDoc inline elements can be suppressed by preceding them with
|
|
75
|
+
a backslash character. These elements include:
|
|
76
|
+
|
|
77
|
+
- Attribute references.
|
|
78
|
+
- Text formatting.
|
|
79
|
+
- Quoting,
|
|
80
|
+
- 'URLs', 'image' and 'link' macros.
|
|
81
|
+
- Replacements.
|
|
82
|
+
- Special words.
|
|
83
|
+
- Table cell separators.
|
|
84
|
+
|
|
85
|
+
But there are exceptions -- see the next question.
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
== Some elements can't be escaped with a single backslash
|
|
89
|
+
|
|
90
|
+
There are a number of exceptions to the usual single backslash rule
|
|
91
|
+
-- mostly relating to URL macros that have two syntaxes or quoting
|
|
92
|
+
ambiguity. Here are some non-standard escape examples:
|
|
93
|
+
|
|
94
|
+
[cols="1default,4literal",width="70%",grid="none",frame="none"]
|
|
95
|
+
|====================================================================
|
|
96
|
+
|Mailto URLs |
|
|
97
|
+
\srackham@methods.co.nz
|
|
98
|
+
<\srackham@methods.co.nz>
|
|
99
|
+
\mailto:[\srackham@methods.co.nz]
|
|
100
|
+
|
|
101
|
+
|Web URLs |
|
|
102
|
+
\http://www.foo1.co.nz
|
|
103
|
+
\\http://www.foobar.com[]
|
|
104
|
+
\\http://www.foobar.com[Foobar Limited]
|
|
105
|
+
|
|
106
|
+
|Other |
|
|
107
|
+
A C+\+ Library for C++
|
|
108
|
+
A C+\+ Library for C+\+ \+++
|
|
109
|
+
\\``double-quotes''
|
|
110
|
+
\*\*F**ile Open...
|
|
111
|
+
|====================================================================
|
|
112
|
+
|
|
113
|
+
The source of this problem is ambiguity across substitution types --
|
|
114
|
+
the first match unescapes allowing the second to substitute. A
|
|
115
|
+
work-around for difficult cases is to side-step the problem using the
|
|
116
|
+
`\pass:[]` passthrough inline macro.
|
|
117
|
+
|
|
118
|
+
NOTE: System macros cannot be escaped.
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
== How can I set default list and tables styles?
|
|
122
|
+
|
|
123
|
+
You can set the element's 'style' entry in a global or custom
|
|
124
|
+
configuration file.
|
|
125
|
+
|
|
126
|
+
This example this will horizontally style all labeled lists that don't
|
|
127
|
+
have an explicit style attribute:
|
|
128
|
+
|
|
129
|
+
----------------------------------
|
|
130
|
+
[listdef-labeled]
|
|
131
|
+
style=horizontal
|
|
132
|
+
|
|
133
|
+
[listdef-labeled2]
|
|
134
|
+
style=horizontal
|
|
135
|
+
----------------------------------
|
|
136
|
+
|
|
137
|
+
This example will put a top and bottom border on all tables that don't
|
|
138
|
+
already have an explicit style attribute:
|
|
139
|
+
|
|
140
|
+
----------------------------------
|
|
141
|
+
[tabledef-default]
|
|
142
|
+
style=topbot
|
|
143
|
+
topbot-style=frame="topbot"
|
|
144
|
+
----------------------------------
|
|
145
|
+
|
|
146
|
+
Alternatively you can set the configuration entries from inside your
|
|
147
|
+
document, the above examples are equivalent to:
|
|
148
|
+
|
|
149
|
+
----------------------------------
|
|
150
|
+
:listdef-labeled.style: horizontal
|
|
151
|
+
:listdef-labeled2.style: horizontal
|
|
152
|
+
|
|
153
|
+
:tabledef-default.topbot-style: frame="topbot"
|
|
154
|
+
:tabledef-default.style: topbot
|
|
155
|
+
----------------------------------
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
== Why do I get a filter non-zero exit code error?
|
|
159
|
+
|
|
160
|
+
An error was returned when AsciiDoc tried to execute an external
|
|
161
|
+
filter command. The most common reason for this is that the filter
|
|
162
|
+
command could not be found by the command shell. To figure out what
|
|
163
|
+
the problem is run AsciiDoc with the `--verbose` option to determine
|
|
164
|
+
the command that is failing and then try to run the command manually
|
|
165
|
+
from the command-line.
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
== Are there any DocBook viewers?
|
|
169
|
+
|
|
170
|
+
http://live.gnome.org/Yelp[Yelp], the GNOME help viewer, does a
|
|
171
|
+
creditable job of displaying DocBook files XML files directly. Just
|
|
172
|
+
run it from the command-line, for example:
|
|
173
|
+
|
|
174
|
+
$ yelp file://home/srackham/tmp/book.xml
|
|
175
|
+
|
|
176
|
+
Note that you have to supply the full path name in URI format, this
|
|
177
|
+
shell script makes interactive use easier:
|
|
178
|
+
|
|
179
|
+
-------------------------------
|
|
180
|
+
#!/bin/sh
|
|
181
|
+
if [ -z "$1" ]; then
|
|
182
|
+
echo "usage: dbkview FILE"
|
|
183
|
+
exit 1
|
|
184
|
+
fi
|
|
185
|
+
yelp "file://$(pwd)/$1"
|
|
186
|
+
-------------------------------
|
|
187
|
+
|
|
188
|
+
This tip was submitted by Lionel Orry.
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
== Can you create ODF documents using AsciiDoc?
|
|
192
|
+
|
|
193
|
+
The easiest and highest fidelity methods I've seen is to generate
|
|
194
|
+
HTML from AsciiDoc then paste it from your browser (we use Firefox)
|
|
195
|
+
into OpenOffice Writer.
|
|
196
|
+
|
|
197
|
+
- I found that that there is better fidelity pasting HTML generated by
|
|
198
|
+
the 'html4' backend instead of the default 'xhtml11' backend.
|
|
199
|
+
- Don't paste AsciiDoc tables of contents, OpenOffice Writer (I was
|
|
200
|
+
using version 2.3) hangs when saving. This may be something to do
|
|
201
|
+
with the embedded JavaScript but I haven't looked closely at it, I
|
|
202
|
+
may even be wrong about this.
|
|
203
|
+
|
|
204
|
+
This tip was contributed by Bernard Amade.
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
== How can I supress cell separators in included table data files?
|
|
208
|
+
|
|
209
|
+
Use the `\{include:}` system attribute instead of the `\include::[]`
|
|
210
|
+
macro (the former is not expanded until after the table data has been
|
|
211
|
+
parsed into cells, whereas the latter is included before the table is
|
|
212
|
+
processed.
|
|
213
|
+
|
|
214
|
+
|
|
7
215
|
== How can I preserve paragraph line boundaries?
|
|
8
216
|
|
|
9
217
|
Apply the The 'verse' paragraph style, the rendered text preserves
|
|
@@ -16,14 +224,31 @@ consetetur, eu pro everti postulant
|
|
|
16
224
|
homero verear ea mea, qui.
|
|
17
225
|
---------------------------------------------------------------------
|
|
18
226
|
|
|
227
|
+
If you are generating PDF files (using FOP) or HTML files then you can
|
|
228
|
+
use line breaks. For example:
|
|
229
|
+
|
|
230
|
+
---------------------------------------------------------------------
|
|
231
|
+
Consul *necessitatibus* per id, +
|
|
232
|
+
consetetur, eu pro everti postulant +
|
|
233
|
+
homero verear ea mea, qui.
|
|
234
|
+
---------------------------------------------------------------------
|
|
235
|
+
|
|
19
236
|
|
|
20
237
|
== How can I include non-breaking space characters?
|
|
21
238
|
|
|
22
239
|
The predefined `\{nbsp}` attribute reference will be replaced by a
|
|
23
|
-
non-breaking space character.
|
|
240
|
+
non-breaking space character. You could also use the non-breaking
|
|
241
|
+
space character entity reference `\ ` (see the next question).
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
== Can I include HTML and XML character entity references in my document?
|
|
24
245
|
|
|
246
|
+
Yes, just enter the reference in your document. For example `\β`
|
|
247
|
+
will print a Greek small beta character β
|
|
25
248
|
|
|
26
|
-
|
|
249
|
+
|
|
250
|
+
[[X1]]
|
|
251
|
+
== How do I include spaces in URLs?
|
|
27
252
|
|
|
28
253
|
URL inline macro targets (addresses) cannot contain white space
|
|
29
254
|
characters. If you need spaces encode them as `%20`. For example:
|
|
@@ -78,7 +303,7 @@ example:
|
|
|
78
303
|
|
|
79
304
|
asciidoc(1) replaces the underscores with spaces.
|
|
80
305
|
|
|
81
|
-
The longer,
|
|
306
|
+
The longer, semantically correct, way is to override the
|
|
82
307
|
`[header]` configuration file section in a document specific `.conf`
|
|
83
308
|
file. For example if your document is `mydoc.txt` then a file called
|
|
84
309
|
`mydoc.conf` in the document directory would be picked up
|
|
@@ -92,23 +317,6 @@ related markup:
|
|
|
92
317
|
:
|
|
93
318
|
|
|
94
319
|
|
|
95
|
-
|
|
96
|
-
== How can I escape AsciiDoc markup?
|
|
97
|
-
|
|
98
|
-
Most AsciiDoc inline elements can be suppressed by preceding them with
|
|
99
|
-
a backslash character. These elements include:
|
|
100
|
-
|
|
101
|
-
- Attribute references.
|
|
102
|
-
- Text formatting.
|
|
103
|
-
- Quoting,
|
|
104
|
-
- 'URLs', 'image' and 'link' macros.
|
|
105
|
-
- Replacements.
|
|
106
|
-
- Special words.
|
|
107
|
-
|
|
108
|
-
In some cases you may need to escape both left and right quotes (see
|
|
109
|
-
the 'AsciiDoc User Guide').
|
|
110
|
-
|
|
111
|
-
|
|
112
320
|
== How can I escape a labeled list entry?
|
|
113
321
|
|
|
114
322
|
Two colons or semicolons in a paragraph may be confused with a labeled
|
|
@@ -124,31 +332,26 @@ Qui in magna commodo{two_colons} est labitur dolorum an. Est ne
|
|
|
124
332
|
magna primis adolescens.
|
|
125
333
|
|
|
126
334
|
|
|
127
|
-
== How can I disable a quoted text substitution?
|
|
335
|
+
== How can I selectively disable a quoted text substitution?
|
|
128
336
|
|
|
129
|
-
Omitting the tag will disable quoting. For example, if you don't
|
|
130
|
-
superscripts or subscripts then put the following in a custom
|
|
337
|
+
Omitting the tag name will disable quoting. For example, if you don't
|
|
338
|
+
want superscripts or subscripts then put the following in a custom
|
|
131
339
|
configuration file or edit the global `asciidoc.conf` configuration
|
|
132
340
|
file:
|
|
133
341
|
|
|
134
|
-
|
|
342
|
+
-------------------
|
|
135
343
|
[quotes]
|
|
136
344
|
^=
|
|
137
345
|
~=
|
|
138
|
-
|
|
346
|
+
-------------------
|
|
139
347
|
|
|
348
|
+
Alternatively you can set the configuration entries from within your
|
|
349
|
+
document, the above examples are equivalent to:
|
|
140
350
|
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
---------------------------------------------------------------------
|
|
147
|
-
[subs="macros"]
|
|
148
|
-
~subscripts~ and ^superscripts^ quotes won't be substituted.
|
|
149
|
-
Nor will the non-alphanumeric characters in the following URL:
|
|
150
|
-
http://host/~user/file#_anchor_tag_str_
|
|
151
|
-
---------------------------------------------------------------------
|
|
351
|
+
-------------------
|
|
352
|
+
:quotes.^:
|
|
353
|
+
:quotes.~:
|
|
354
|
+
-------------------
|
|
152
355
|
|
|
153
356
|
|
|
154
357
|
== How can I customize the \{localdate} format?
|
|
@@ -206,19 +409,6 @@ AsciiDoc documentation (even if you don't use A-A-P you'll still find
|
|
|
206
409
|
it useful).
|
|
207
410
|
|
|
208
411
|
|
|
209
|
-
== How can I place a backslash character in front of an attribute reference without escaping the reference?
|
|
210
|
-
|
|
211
|
-
Use the predefined `\{backslash}` attribute reference instead of an
|
|
212
|
-
actual backslash, for example if the `\{projectname}` attribute has
|
|
213
|
-
the value `foobar` then:
|
|
214
|
-
|
|
215
|
-
d:\data{backslash}{projectname}
|
|
216
|
-
|
|
217
|
-
would be rendered as:
|
|
218
|
-
|
|
219
|
-
d:\data\foobar
|
|
220
|
-
|
|
221
|
-
|
|
222
412
|
== Why have you used the DocBook <simpara> element instead of <para>?
|
|
223
413
|
|
|
224
414
|
`<simpara>` is really the same as `<para>` except it can't contain
|
|
@@ -226,13 +416,13 @@ block elements -- this matched, more closely, the AsciiDoc paragraph
|
|
|
226
416
|
semantics.
|
|
227
417
|
|
|
228
418
|
|
|
229
|
-
== How can I format text inside a
|
|
419
|
+
== How can I format text inside a listing block?
|
|
230
420
|
|
|
231
421
|
By default only 'specialcharacters' and 'callouts' are substituted in
|
|
232
422
|
listing blocks; you can add quotes substitutions by explicitly setting
|
|
233
423
|
the block 'subs' attribute, for example:
|
|
234
424
|
|
|
235
|
-
[subs="
|
|
425
|
+
[subs="quotes"]
|
|
236
426
|
------------------------------------------
|
|
237
427
|
$ ls *-al*
|
|
238
428
|
------------------------------------------
|
|
@@ -246,17 +436,55 @@ The `-al` will rendered bold. Note that:
|
|
|
246
436
|
`<emphasis>` elements inside `<screen>` elements.
|
|
247
437
|
|
|
248
438
|
|
|
249
|
-
== Why doesn't the
|
|
439
|
+
== Why doesn't the include1::[] macro work?
|
|
250
440
|
|
|
251
441
|
Internally the `include1` macro is translated to the `include1` system
|
|
252
442
|
attribute which means it must be evaluated in a region where attribute
|
|
253
|
-
substitution is enabled.
|
|
254
|
-
|
|
255
|
-
|
|
443
|
+
substitution is enabled. `include1` won't work, for example, in a
|
|
444
|
+
ListingBlock (unless attribute substitution is enabled). `include1`
|
|
445
|
+
is intended for use in configuration files, use the `include` macro
|
|
446
|
+
and set the attribute `depth=1` instead, for example:
|
|
447
|
+
|
|
448
|
+
-----------------------------------------------
|
|
449
|
+
include::blogpost_media_processing.txt[depth=1]
|
|
450
|
+
-----------------------------------------------
|
|
451
|
+
|
|
452
|
+
== How can I customize PDF files generated by dblatex?
|
|
453
|
+
|
|
454
|
+
There are a number of dblatex XSL parameters that can be used to
|
|
455
|
+
customize PDF output. You can set them globally in the AsciiDoc
|
|
456
|
+
`./dblatex/asciidoc-dblatex.xsl` configuration file or you can also
|
|
457
|
+
pass them on the a2x(1) command-line, for example:
|
|
458
|
+
|
|
459
|
+
a2x -f pdf --dblatex-opts "-P latex.output.revhistory=0" doc/article.txt
|
|
460
|
+
|
|
461
|
+
See also the http://dblatex.sourceforge.net/[dblatex] documentation.
|
|
462
|
+
|
|
463
|
+
|
|
464
|
+
== How can I make the mailto macro work with multiple email addresses?
|
|
465
|
+
|
|
466
|
+
For the AsciiDoc 'mailto' macro to work with multiple email addresses
|
|
467
|
+
(as per RFC2368) you need to URL encode the '@' characters (replace
|
|
468
|
+
them with '%40'), if you don't the individual addresses will be
|
|
469
|
+
rendered as separate links. You also need to <<X1,replace spaces with
|
|
470
|
+
'%20'>>.
|
|
471
|
+
|
|
472
|
+
For example, the following call won't work:
|
|
473
|
+
|
|
474
|
+
mailto:jb@foobar.com,jd@acme.co.nz?subject=New foofoo release[New foofoo release]
|
|
475
|
+
|
|
476
|
+
Use this instead:
|
|
477
|
+
|
|
478
|
+
mailto:jb%40foobar.com,jd%40acme.co.nz?subject=New%20foofoo%20release[New foofoo release]
|
|
479
|
+
|
|
480
|
+
|
|
481
|
+
== How can a replacement have a trailing backslash?
|
|
482
|
+
Quote the entry name -- this nonsensical example replaces `x\` with
|
|
483
|
+
`y`:
|
|
484
|
+
|
|
485
|
+
"x\\"=y
|
|
486
|
+
|
|
487
|
+
If quoting were omitted the equals character (separating the
|
|
488
|
+
entry name `x` from the value `y`) would be escaped.
|
|
256
489
|
|
|
257
|
-
[subs="attributes"]
|
|
258
|
-
-----------------------------------------
|
|
259
|
-
include1::blogpost_media_processing.txt[]
|
|
260
|
-
-----------------------------------------
|
|
261
490
|
|
|
262
|
-
Or, preferably, use the `include` block macro instead.
|