FooBarWidget-mizuho 0.9.1 → 0.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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.
|