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.
Files changed (136) hide show
  1. data/README.markdown +1 -1
  2. data/Rakefile +14 -2
  3. data/asciidoc/BUGS +11 -6
  4. data/asciidoc/BUGS.txt +7 -3
  5. data/asciidoc/CHANGELOG +313 -151
  6. data/asciidoc/CHANGELOG.txt +177 -12
  7. data/asciidoc/INSTALL +30 -36
  8. data/asciidoc/INSTALL.txt +20 -20
  9. data/asciidoc/Makefile.in +145 -0
  10. data/asciidoc/README +11 -11
  11. data/asciidoc/README.txt +9 -9
  12. data/asciidoc/a2x +40 -7
  13. data/asciidoc/asciidoc.conf +180 -126
  14. data/asciidoc/asciidoc.py +1667 -977
  15. data/asciidoc/common.aap +2 -2
  16. data/asciidoc/configure +2840 -0
  17. data/asciidoc/configure.ac +11 -0
  18. data/asciidoc/dblatex/asciidoc-dblatex.sty +2 -0
  19. data/asciidoc/dblatex/asciidoc-dblatex.xsl +15 -0
  20. data/asciidoc/dblatex/dblatex-readme.txt +19 -2
  21. data/asciidoc/doc/a2x.1 +77 -67
  22. data/asciidoc/doc/a2x.1.txt +11 -2
  23. data/asciidoc/doc/article.css-embedded.html +85 -63
  24. data/asciidoc/doc/article.html +644 -62
  25. data/asciidoc/doc/article.pdf +0 -0
  26. data/asciidoc/doc/article.txt +15 -17
  27. data/asciidoc/doc/asciidoc.1 +34 -40
  28. data/asciidoc/doc/asciidoc.1.css-embedded.html +67 -32
  29. data/asciidoc/doc/asciidoc.1.css.html +28 -28
  30. data/asciidoc/doc/asciidoc.1.html +33 -33
  31. data/asciidoc/doc/asciidoc.css-embedded.html +2234 -2348
  32. data/asciidoc/doc/asciidoc.css.html +2203 -2352
  33. data/asciidoc/doc/asciidoc.dict +52 -1
  34. data/asciidoc/doc/asciidoc.html +980 -1160
  35. data/asciidoc/doc/asciidoc.txt +941 -738
  36. data/asciidoc/doc/asciimathml.txt +63 -0
  37. data/asciidoc/doc/book-multi.html +26 -43
  38. data/asciidoc/doc/book-multi.txt +19 -23
  39. data/asciidoc/doc/book.css-embedded.html +92 -71
  40. data/asciidoc/doc/book.html +24 -41
  41. data/asciidoc/doc/book.txt +19 -21
  42. data/asciidoc/doc/docbook-xsl.css +1 -0
  43. data/asciidoc/doc/faq.txt +288 -60
  44. data/asciidoc/doc/images +1 -0
  45. data/asciidoc/doc/latex-backend.html +16 -123
  46. data/asciidoc/doc/latex-backend.txt +17 -19
  47. data/asciidoc/doc/latexmath.txt +233 -24
  48. data/asciidoc/doc/latexmathml.txt +41 -0
  49. data/asciidoc/doc/main.aap +9 -5
  50. data/asciidoc/doc/music-filter.pdf +0 -0
  51. data/asciidoc/doc/music-filter.txt +2 -2
  52. data/asciidoc/doc/source-highlight-filter.html +476 -105
  53. data/asciidoc/doc/source-highlight-filter.pdf +0 -0
  54. data/asciidoc/doc/source-highlight-filter.txt +39 -10
  55. data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +1 -29
  56. data/asciidoc/docbook-xsl/fo.xsl +35 -3
  57. data/asciidoc/docbook-xsl/manpage.xsl +3 -0
  58. data/asciidoc/docbook-xsl/text.xsl +50 -0
  59. data/asciidoc/docbook.conf +182 -73
  60. data/asciidoc/examples/website/ASCIIMathML.js +1 -0
  61. data/asciidoc/examples/website/CHANGELOG.html +618 -182
  62. data/asciidoc/examples/website/CHANGELOG.txt +1 -0
  63. data/asciidoc/examples/website/INSTALL.html +34 -36
  64. data/asciidoc/examples/website/INSTALL.txt +1 -0
  65. data/asciidoc/examples/website/LaTeXMathML.js +1 -0
  66. data/asciidoc/examples/website/README-website.html +26 -37
  67. data/asciidoc/examples/website/README-website.txt +6 -6
  68. data/asciidoc/examples/website/README.html +15 -15
  69. data/asciidoc/examples/website/README.txt +1 -0
  70. data/asciidoc/examples/website/a2x.1.html +74 -50
  71. data/asciidoc/examples/website/a2x.1.txt +1 -0
  72. data/asciidoc/examples/website/asciidoc-docbook-xsl.html +13 -48
  73. data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +1 -0
  74. data/asciidoc/examples/website/asciimathml.txt +1 -0
  75. data/asciidoc/examples/website/customers.csv +1 -0
  76. data/asciidoc/examples/website/downloads.html +69 -31
  77. data/asciidoc/examples/website/downloads.txt +28 -5
  78. data/asciidoc/examples/website/faq.html +370 -124
  79. data/asciidoc/examples/website/faq.txt +1 -0
  80. data/asciidoc/examples/website/images +1 -0
  81. data/asciidoc/examples/website/index.html +64 -64
  82. data/asciidoc/examples/website/index.txt +22 -15
  83. data/asciidoc/examples/website/latex-backend.html +152 -257
  84. data/asciidoc/examples/website/latex-backend.txt +1 -0
  85. data/asciidoc/examples/website/latexmathml.txt +1 -0
  86. data/asciidoc/examples/website/manpage.html +27 -27
  87. data/asciidoc/examples/website/manpage.txt +1 -0
  88. data/asciidoc/examples/website/music-filter.html +18 -18
  89. data/asciidoc/examples/website/music-filter.txt +1 -0
  90. data/asciidoc/examples/website/music1.abc +1 -1
  91. data/asciidoc/examples/website/music1.png +0 -0
  92. data/asciidoc/examples/website/music2.ly +1 -1
  93. data/asciidoc/examples/website/music2.png +0 -0
  94. data/asciidoc/examples/website/newlists.txt +40 -0
  95. data/asciidoc/examples/website/newtables.txt +397 -0
  96. data/asciidoc/examples/website/source-highlight-filter.html +67 -32
  97. data/asciidoc/examples/website/source-highlight-filter.txt +1 -0
  98. data/asciidoc/examples/website/support.html +4 -4
  99. data/asciidoc/examples/website/toc.js +1 -0
  100. data/asciidoc/examples/website/userguide.html +2190 -2339
  101. data/asciidoc/examples/website/userguide.txt +1 -0
  102. data/asciidoc/examples/website/version83.txt +37 -0
  103. data/asciidoc/examples/website/version9.html +13 -13
  104. data/asciidoc/examples/website/xhtml11-manpage.css +1 -0
  105. data/asciidoc/examples/website/xhtml11-quirks.css +1 -0
  106. data/asciidoc/examples/website/xhtml11.css +1 -0
  107. data/asciidoc/filters/code-filter-readme.txt +3 -3
  108. data/asciidoc/filters/code-filter-test.txt +6 -6
  109. data/asciidoc/filters/source-highlight-filter.conf +12 -5
  110. data/asciidoc/html4.conf +152 -58
  111. data/asciidoc/install-sh +201 -0
  112. data/asciidoc/latex.conf +41 -41
  113. data/asciidoc/stylesheets/docbook-xsl.css +1 -0
  114. data/asciidoc/stylesheets/xhtml11.css +39 -4
  115. data/asciidoc/text.conf +4 -4
  116. data/asciidoc/vim/syntax/asciidoc.vim +58 -32
  117. data/asciidoc/wordpress.conf +48 -0
  118. data/asciidoc/xhtml11-quirks.conf +1 -1
  119. data/asciidoc/xhtml11.conf +198 -70
  120. data/bin/mizuho +5 -2
  121. data/lib/mizuho/generator.rb +48 -19
  122. data/mizuho.gemspec +16 -6
  123. metadata +58 -15
  124. data/asciidoc/doc/asciimath.txt +0 -47
  125. data/asciidoc/docbook-xsl/shaded-literallayout.patch +0 -32
  126. data/asciidoc/examples/website/asciimath.html +0 -157
  127. data/asciidoc/examples/website/latexmath.html +0 -119
  128. data/asciidoc/filters/code-filter-test-c++.txt +0 -7
  129. data/asciidoc/install.sh +0 -55
  130. data/asciidoc/linuxdoc.conf +0 -285
  131. data/asciidoc/math.conf +0 -50
  132. data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +0 -21
  133. data/asciidoc/stylesheets/xhtml-deprecated.css +0 -247
  134. data/asciidoc/t.conf +0 -20
  135. data/asciidoc/xhtml-deprecated-css.conf +0 -235
  136. data/asciidoc/xhtml-deprecated.conf +0 -351
@@ -0,0 +1,11 @@
1
+ AC_INIT(asciidoc, 8.3.1)
2
+
3
+ AC_CONFIG_FILES(Makefile)
4
+
5
+ AC_PROG_SED
6
+
7
+ AC_PROG_LN_S
8
+
9
+ AC_PROG_INSTALL
10
+
11
+ AC_OUTPUT
@@ -16,3 +16,5 @@
16
16
  \end{minipage}\end{Sbox}\doublebox{\TheSbox}%
17
17
  }
18
18
 
19
+ % For DocBook literallayout elements, see `./dblatex/dblatex-readme.txt`.
20
+ \usepackage{alltt}
@@ -4,6 +4,7 @@ dblatex(1) XSL user stylesheet for asciidoc(1).
4
4
  See dblatex(1) -p option.
5
5
  -->
6
6
  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
7
+
7
8
  <!-- TOC links in the titles, and in blue. -->
8
9
  <xsl:param name="latex.hyperparam">colorlinks,linkcolor=blue,pdfstartview=FitH</xsl:param>
9
10
  <xsl:param name="doc.publisher.show">1</xsl:param>
@@ -13,5 +14,19 @@ See dblatex(1) -p option.
13
14
  <xsl:param name="doc.section.depth">3</xsl:param>
14
15
  <xsl:param name="table.in.float">0</xsl:param>
15
16
  <xsl:param name="monoseq.hyphenation">0</xsl:param>
17
+ <xsl:param name="latex.output.revhistory">1</xsl:param>
18
+ <xsl:param name="doc.toc.show">1</xsl:param>
19
+
20
+ <!--
21
+ Override default literallayout template.
22
+ See `./dblatex/dblatex-readme.txt`.
23
+ -->
24
+ <xsl:template match="address|literallayout[@class!='monospaced']">
25
+ <xsl:text>\begin{alltt}</xsl:text>
26
+ <xsl:text>&#10;\normalfont{}&#10;</xsl:text>
27
+ <xsl:apply-templates/>
28
+ <xsl:text>&#10;\end{alltt}</xsl:text>
29
+ </xsl:template>
30
+
16
31
  </xsl:stylesheet>
17
32
 
@@ -18,5 +18,22 @@ Use these files with dblatex(1) `-p` and `-s` options, for example:
18
18
 
19
19
  Limitations
20
20
  -----------
21
- - As of 'dblatex' version 0.2.8 callouts are limited to images and
22
- program listings and therefore aren't useful in AsciiDoc documents.
21
+ Observed in dblatex 0.2.8.
22
+
23
+ - dblatex doesn't seem to process the DocBook 'literallayout' element
24
+ correctly: it is rendered in a monospaced font and no inline
25
+ elements are processed. By default the normal font should be used
26
+ and almost all DocBook inline elements should be processed
27
+ (http://www.docbook.org/tdg/en/html/literallayout.html). I almost
28
+ fixed this by overriding the default dblatex literallayout template
29
+ (in `./dblatex/asciidoc-dblatex.xsl`) and using the LaTeX 'alltt'
30
+ package, but there are remaining problems:
31
+
32
+ * Blank lines are replaced by a single space.
33
+ * The 'literallayout' element incorrectly wraps text when rendered
34
+ inside a table.
35
+
36
+ - Callouts do not work inside DocBook 'literallayout' elements which
37
+ means callouts are not displayed inside AsciiDoc literal blocks. A
38
+ workaround is to change the AsciiDoc literal block to a listing
39
+ block.
data/asciidoc/doc/a2x.1 CHANGED
@@ -1,22 +1,22 @@
1
1
  .\" Title: a2x
2
2
  .\" Author:
3
- .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
4
- .\" Date: 07/04/2008
3
+ .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4
+ .\" Date: 12/13/2008
5
5
  .\" Manual:
6
6
  .\" Source:
7
7
  .\"
8
- .TH "A2X" "1" "07/04/2008" "" ""
8
+ .TH "A2X" "1" "12/13/2008" "" ""
9
9
  .\" disable hyphenation
10
10
  .nh
11
11
  .\" disable justification (adjust text to left margin only)
12
12
  .ad l
13
13
  .SH "NAME"
14
- a2x \- convert Asciidoc text file to PDF, XHTML, HTML Help, manpage or plain text
14
+ a2x - convert Asciidoc text file to PDF, XHTML, HTML Help, manpage or plain text
15
15
  .SH "SYNOPSIS"
16
16
  \fBa2x\fR [\fIOPTIONS\fR] \fIFILE\fR
17
17
  .sp
18
18
  .SH "DESCRIPTION"
19
- A DocBook toolchain wrapper script that translates an AsciiDoc text file \fIFILE\fR to PDF, DVI, PS, LaTeX, XHTML (single page or chunked), man page, HTML Help or plain text formats. PDF, XHTML, man page and HTML Help formats are are generated using the asciidoc(1), xsltproc(1), DocBook XSL Stylesheets, dblatex (or FOP) toolchain. Plain text is produced by passing asciidoc(1) generated HTML through lynx(1). The htmlhelp format option generates .hhp, .hhc and .html files suitable for compilation to an HTML Help .chm file.
19
+ A DocBook toolchain wrapper script that translates an AsciiDoc text file \fIFILE\fR to PDF, DVI, PS, LaTeX, XHTML (single page or chunked), man page, HTML Help or plain text formats\. PDF, XHTML, man page and HTML Help formats are are generated using the asciidoc(1), xsltproc(1), DocBook XSL Stylesheets, dblatex (or FOP) toolchain\. Plain text is produced by passing asciidoc(1) generated HTML through lynx(1)\. The htmlhelp format option generates \.hhp, \.hhc and \.html files suitable for compilation to an HTML Help \.chm file\.
20
20
  .sp
21
21
  .SH "OPTIONS"
22
22
  .PP
@@ -24,28 +24,28 @@ A DocBook toolchain wrapper script that translates an AsciiDoc text file \fIFILE
24
24
  .RS 4
25
25
  Set asciidoc(1) attribute value (shortcut for
26
26
  \fB\-\-asciidoc\-opts\fR=\fI"\-a ATTRIBUTE"\fR
27
- option). This option may be specified more than once.
27
+ option)\. This option may be specified more than once\.
28
28
  .RE
29
29
  .PP
30
30
  \fB\-\-asciidoc\-opts\fR=\fIASCIIDOC_OPTS\fR
31
31
  .RS 4
32
- Additional asciidoc(1) options. This option may be specified more than once.
32
+ Additional asciidoc(1) options\. This option may be specified more than once\.
33
33
  .RE
34
34
  .PP
35
35
  \fB\-\-copy\fR
36
36
  .RS 4
37
- Copy distributed docbook\-xsl CSS stylesheet admonition and navigation icons to their respective destinations. Applies to
37
+ Copy distributed docbook\-xsl CSS stylesheet admonition and navigation icons to their respective destinations\. Applies to
38
38
  \fIxhtml\fR,
39
39
  \fIchunked\fR,
40
40
  \fIhtmlhelp\fR
41
- formats. The default behavior is to suppress copying.
41
+ formats\. The default behavior is to suppress copying\.
42
42
  .RE
43
43
  .PP
44
44
  \fB\-D, \-\-destination\-dir\fR=\fIPATH\fR
45
45
  .RS 4
46
- Output directory. Defaults to source
46
+ Output directory\. Defaults to source
47
47
  \fIFILE\fR
48
- directory.
48
+ directory\.
49
49
  .RE
50
50
  .PP
51
51
  \fB\-d, \-\-doctype\fR=\fIDOCTYPE\fR
@@ -54,12 +54,12 @@ DocBook document type:
54
54
  \fIarticle\fR,
55
55
  \fImanpage\fR
56
56
  or
57
- \fIbook\fR. Default document type is
57
+ \fIbook\fR\. Default document type is
58
58
  \fIarticle\fR
59
59
  unless the format is
60
60
  \fImanpage\fR
61
61
  (in which case it defaults to
62
- \fImanpage\fR).
62
+ \fImanpage\fR)\.
63
63
  .RE
64
64
  .PP
65
65
  \fB\-f, \-\-format\fR=\fIFORMAT\fR
@@ -74,173 +74,183 @@ Output format:
74
74
  \fItex\fR,
75
75
  \fItext\fR
76
76
  or
77
- \fIxhtml\fR.
77
+ \fIxhtml\fR\.
78
78
  .RE
79
79
  .PP
80
80
  \fB\-h, \-\-help\fR
81
81
  .RS 4
82
- Print command\-line syntax and program options to stdout.
82
+ Print command\-line syntax and program options to stdout\.
83
83
  .RE
84
84
  .PP
85
85
  \fB\-\-icons\fR
86
86
  .RS 4
87
- Use admonition or navigation icon images in output documents. The default behavior is to use text in place of icons.
87
+ Use admonition or navigation icon images in output documents\. The default behavior is to use text in place of icons\.
88
88
  .RE
89
89
  .PP
90
90
  \fB\-\-icons\-dir\fR=\fIPATH\fR
91
91
  .RS 4
92
- A path (relative to destination HTML files) containing admonition and navigation icons. Defaults to
93
- \fI./images/icons/\fR. Applies to
92
+ A path (relative to destination HTML files) containing admonition and navigation icons\. Defaults to
93
+ \fI\./images/icons/\fR\. Applies to
94
94
  \fIxhtml\fR,
95
95
  \fIchunked\fR,
96
96
  \fIhtmlhelp\fR
97
- formats.
97
+ formats\.
98
+ .RE
99
+ .PP
100
+ \fB\-L, \-\-no\-xmllint\fR
101
+ .RS 4
102
+ Don\(cqt check asciidoc output with
103
+ \fIxmllint(1)\fR\.
98
104
  .RE
99
105
  .PP
100
106
  \fB\-n, \-\-dry\-run\fR
101
107
  .RS 4
102
- Don't do anything just print what would have been done.
108
+ Don\(cqt do anything just print what would have been done\.
103
109
  .RE
104
110
  .PP
105
111
  \fB\-s, \-\-skip\-asciidoc\fR
106
112
  .RS 4
107
- Skip asciidoc execution. This is useful for converting DocBook XML files not derived from AsciiDoc sources. Ignored if \-\-format*=\fItext\fR.
113
+ Skip asciidoc execution\. This is useful for converting DocBook XML files not derived from AsciiDoc sources\. Ignored if \-\-format*=\fItext\fR\.
108
114
  .RE
109
115
  .PP
110
116
  \fB\-\-stylesheet\fR=\fIPATH\fR
111
117
  .RS 4
112
- A path (relative to destination HTML files) specifying the docbook\-xsl CSS stylesheet file. Defaults to
113
- \fI./docbook\-xsl.css\fR. Applies to
118
+ A path (relative to destination HTML files) specifying the docbook\-xsl CSS stylesheet file\. Defaults to
119
+ \fI\./docbook\-xsl\.css\fR\. Applies to
114
120
  \fIxhtml\fR,
115
121
  \fIchunked\fR,
116
122
  \fIhtmlhelp\fR
117
- formats.
123
+ formats\.
118
124
  .RE
119
125
  .PP
120
126
  \fB\-v, \-\-verbose\fR
121
127
  .RS 4
122
- Print operational details to stderr. A second
128
+ Print operational details to stderr\. A second
123
129
  \fB\-v\fR
124
- option applies the verbose option to toolchain commands.
130
+ option applies the verbose option to toolchain commands\.
125
131
  .RE
126
132
  .PP
127
133
  \fB\-\-version\fR
128
134
  .RS 4
129
- Print program version to stdout.
135
+ Print program version to stdout\.
130
136
  .RE
131
137
  .PP
132
138
  \fB\-\-xsltproc\-opts\fR=\fIXSLTPROC_OPTS\fR
133
139
  .RS 4
134
- Additional xsltproc(1) options. This option may be specified more than once.
140
+ Additional xsltproc(1) options\. This option may be specified more than once\.
141
+ .RE
142
+ .PP
143
+ \fB\-\-fop\fR
144
+ .RS 4
145
+ Use FOP to generate PDFs\.
135
146
  .RE
136
147
  .PP
137
148
  \fB\-\-fop\-opts\fR=\fIFOP_OPTS\fR
138
149
  .RS 4
139
- Additional fop options. This option may be specified more than once. If this option is specified fop is used to generate PDFs.
150
+ Additional fop options\. This option may be specified more than once\. If this option is specified FOP is used to generate PDFs\.
140
151
  .RE
141
152
  .PP
142
153
  \fB\-\-dblatex\-opts\fR=\fIDBLATEX_OPTS\fR
143
154
  .RS 4
144
- Additional dblatex options. This option may be specified more than once.
155
+ Additional dblatex options\. This option may be specified more than once\.
145
156
  .RE
146
157
  .SH "OUTPUT FILES"
147
- Output files are written to the directory specified by the \fB\-\-destination\-dir\fR option. If no \fB\-\-destination\-dir\fR option is set output files are written to the source FILE directory.
158
+ Output files are written to the directory specified by the \fB\-\-destination\-dir\fR option\. If no \fB\-\-destination\-dir\fR option is set output files are written to the source FILE directory\.
148
159
  .sp
149
- Output files have the same name as the source \fIFILE\fR but with an appropriate file name extension: .html for \fIxhtml\fR; .hhp for \fIhtmlhelp\fR; .pdf for \fIpdf\fR; .text for \fItext\fR. By convention manpages have no .man extension (man page section number only). Chunked HTML directory names have a .chunked extension; chunked HTML Help directory names have a .htmlhelp extension.
160
+ Output files have the same name as the source \fIFILE\fR but with an appropriate file name extension: \.html for \fIxhtml\fR; \.hhp for \fIhtmlhelp\fR; \.pdf for \fIpdf\fR; \.text for \fItext\fR\. By convention manpages have no \.man extension (man page section number only)\. Chunked HTML directory names have a \.chunked extension; chunked HTML Help directory names have a \.htmlhelp extension\.
150
161
  .sp
151
- Same named existing files are overwritten.
162
+ Same named existing files are overwritten\.
152
163
  .sp
153
- Intermediate output files are written to the source \fIFILE\fR directory and are not automatically deleted.
164
+ Intermediate output files are written to the source \fIFILE\fR directory and are not automatically deleted\.
154
165
  .sp
155
- Intermediate DocBook XML files generated by AsciiDoc are only regenerated if out of date with respect to the AsciiDoc source \fIFILE\fR.
166
+ Intermediate DocBook XML files generated by AsciiDoc are only regenerated if out of date with respect to the AsciiDoc source \fIFILE\fR\.
156
167
  .sp
157
- In addition to generating HTML files the \fIxhtml\fR, \fIchunked\fR and \fIhtmlhelp\fR formats copy the DocBook XSL stylesheet plus admonition and navigation icons distributed with AsciiDoc to their respective destination locations. Existing stylesheets and icons are only copied if they are newer than the destination files or if the destination files are missing.
168
+ In addition to generating HTML files the \fIxhtml\fR, \fIchunked\fR and \fIhtmlhelp\fR formats copy the DocBook XSL stylesheet plus admonition and navigation icons distributed with AsciiDoc to their respective destination locations\. Existing stylesheets and icons are only copied if they are newer than the destination files or if the destination files are missing\.
158
169
  .sp
159
- The \fIxhtml\fR format generates a single XHTML output page. The \fIchunked\fR format writes multiple per\-section HTML pages to a chunked directory in the destination directory. The chunked directory has the same name as the source \fIFILE\fR name plus a .chunked extension.
170
+ The \fIxhtml\fR format generates a single XHTML output page\. The \fIchunked\fR format writes multiple per\-section HTML pages to a chunked directory in the destination directory\. The chunked directory has the same name as the source \fIFILE\fR name plus a \.chunked extension\.
160
171
  .sp
161
172
  .SH "EXAMPLES"
162
173
  .PP
163
- a2x \-f pdf doc/source\-highlight\-filter.txt
174
+ a2x \-f pdf doc/source\-highlight\-filter\.txt
164
175
  .RS 4
165
- Generates doc/source\-highlight\-filter.pdf file.
176
+ Generates doc/source\-highlight\-filter\.pdf file\.
166
177
  .RE
167
178
  .PP
168
- a2x \-f chunked \-D ../webpages guide.txt
179
+ a2x \-f chunked \-D \.\./webpages guide\.txt
169
180
  .RS 4
170
181
  Creates chunked directory
171
- \&../webpages/guide.chunked
172
- containing chunked HTML files. Also copies
173
- docbook\-xsl.css
182
+ \.\./webpages/guide\.chunked
183
+ containing chunked HTML files\. Also copies
184
+ docbook\-xsl\.css
174
185
  stylesheet to the
175
- \&../webpages/guide.chunked
186
+ \.\./webpages/guide\.chunked
176
187
  directory plus admonition and navigation icons to the
177
- \&../webpages/guide.chunked/images/icons
178
- directory.
188
+ \.\./webpages/guide\.chunked/images/icons
189
+ directory\.
179
190
  .RE
180
191
  .SH "REQUISITES"
181
192
  This script runs under the bash(1) shell and requires the following programs (which may or may not be prepackaged with your Linux distribution):
182
- .sp
183
193
  .PP
184
194
  Asciidoc
185
195
  .RS 4
186
196
 
187
- http://www.methods.co.nz/asciidoc/
197
+ http://www\.methods\.co\.nz/asciidoc/
188
198
  .RE
189
199
  .PP
190
200
  xsltproc
191
201
  .RS 4
192
202
 
193
- http://xmlsoft.org/XSLT/
203
+ http://xmlsoft\.org/XSLT/
194
204
  .RE
195
205
  .PP
196
206
  DocBook XSL Stylesheets
197
207
  .RS 4
198
208
 
199
- http://docbook.sourceforge.net/projects/xsl/
209
+ http://docbook\.sourceforge\.net/projects/xsl/
200
210
  .RE
201
211
  .PP
202
212
  dblatex (for PDF, DVI, PostScript and LaTeX file generation)
203
213
  .RS 4
204
214
 
205
- http://dblatex.sourceforge.net/
215
+ http://dblatex\.sourceforge\.net/
206
216
  .RE
207
217
  .PP
208
218
  FOP (alternative PDF file generation)
209
219
  .RS 4
210
220
 
211
- http://xmlgraphics.apache.org/fop/
221
+ http://xmlgraphics\.apache\.org/fop/
212
222
  .RE
213
223
  .PP
214
- Lynx (for text file generation)
224
+ w3m (text file generation)
215
225
  .RS 4
216
226
 
217
- http://lynx.isc.org/
227
+ http://w3m\.sourceforge\.net/index\.en\.html
218
228
  .RE
219
- See also the latest README file.
229
+ .PP
230
+ Lynx (used for text file generation if w3m(1) not installed)
231
+ .RS 4
232
+
233
+ http://lynx\.isc\.org/
234
+ .RE
235
+ See also the latest README file\.
220
236
  .sp
221
237
  .SH "BUGS"
222
238
  .sp
223
239
  .RS 4
224
- \h'-04'\(bu\h'+03'The odt output format is undocumented and experimental.
240
+ \h'-04'\(bu\h'+03'The odt output format is undocumented and experimental\.
225
241
  .RE
226
242
  .sp
227
243
  .RS 4
228
- \h'-04'\(bu\h'+03'See also the AsciiDoc distribution BUGS file.
244
+ \h'-04'\(bu\h'+03'See also the AsciiDoc distribution BUGS file\.
229
245
  .RE
230
246
  .SH "AUTHOR"
231
- Written by Stuart Rackham, <srackham@gmail.com>
247
+ Written by Stuart Rackham, <srackham@gmail\.com>
232
248
  .sp
233
249
  .SH "RESOURCES"
234
- SourceForge: http://sourceforge.net/projects/asciidoc/
250
+ SourceForge: http://sourceforge\.net/projects/asciidoc/
235
251
  .sp
236
- Main web site: http://www.methods.co.nz/asciidoc/
252
+ Main web site: http://www\.methods\.co\.nz/asciidoc/
237
253
  .sp
238
254
  .SH "COPYING"
239
- Copyright (C) 2002\-2008 Stuart Rackham. Free use of this software is granted under the terms of the GNU General Public License (GPL).
255
+ Copyright (C) 2002\-2008 Stuart Rackham\. Free use of this software is granted under the terms of the GNU General Public License (GPL)\.
240
256
  .sp
241
- .SH "REFERENCES"
242
- .IP " 1." 4
243
- srackham@gmail.com
244
- .RS 4
245
- \%mailto:srackham@gmail.com
246
- .RE
@@ -66,6 +66,9 @@ OPTIONS
66
66
  and navigation icons. Defaults to './images/icons/'.
67
67
  Applies to 'xhtml', 'chunked', 'htmlhelp' formats.
68
68
 
69
+ *-L, --no-xmllint*::
70
+ Don't check asciidoc output with 'xmllint(1)'.
71
+
69
72
  *-n, --dry-run*::
70
73
  Don't do anything just print what would have been done.
71
74
 
@@ -89,9 +92,12 @@ OPTIONS
89
92
  Additional xsltproc(1) options. This option may be specified more
90
93
  than once.
91
94
 
95
+ *--fop*::
96
+ Use FOP to generate PDFs.
97
+
92
98
  *--fop-opts*='FOP_OPTS'::
93
99
  Additional fop options. This option may be specified more than
94
- once. If this option is specified fop is used to generate PDFs.
100
+ once. If this option is specified FOP is used to generate PDFs.
95
101
 
96
102
  *--dblatex-opts*='DBLATEX_OPTS'::
97
103
  Additional dblatex options. This option may be specified more than once.
@@ -164,7 +170,10 @@ dblatex (for PDF, DVI, PostScript and LaTeX file generation)::
164
170
  FOP (alternative PDF file generation)::
165
171
  http://xmlgraphics.apache.org/fop/
166
172
 
167
- Lynx (for text file generation)::
173
+ w3m (text file generation)::
174
+ http://w3m.sourceforge.net/index.en.html
175
+
176
+ Lynx (used for text file generation if `w3m(1)` not installed)::
168
177
  http://lynx.isc.org/
169
178
 
170
179
  See also the latest README file.
@@ -3,7 +3,8 @@
3
3
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4
4
  <head>
5
5
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6
- <meta name="generator" content="AsciiDoc 8.2.7" />
6
+ <meta name="generator" content="AsciiDoc 8.3.1" />
7
+ <title>The Article Title</title>
7
8
  <style type="text/css">
8
9
  /* Debug borders */
9
10
  p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
@@ -218,6 +219,7 @@ dt {
218
219
  margin-top: 0.5em;
219
220
  margin-bottom: 0;
220
221
  font-style: normal;
222
+ color: navy;
221
223
  }
222
224
  dd > *:first-child {
223
225
  margin-top: 0.1em;
@@ -233,6 +235,13 @@ div.olist2 > ol {
233
235
  list-style-type: lower-alpha;
234
236
  }
235
237
 
238
+ div.compact ul, div.compact ol,
239
+ div.compact p, div.compact p,
240
+ div.compact div, div.compact div {
241
+ margin-top: 0.1em;
242
+ margin-bottom: 0.1em;
243
+ }
244
+
236
245
  div.tableblock > table {
237
246
  border: 3px solid #527bbd;
238
247
  }
@@ -243,22 +252,49 @@ thead {
243
252
  tfoot {
244
253
  font-weight: bold;
245
254
  }
255
+ td > div.verse {
256
+ white-space: pre;
257
+ }
258
+ p.table {
259
+ margin-top: 0;
260
+ }
261
+ /* Because the table frame attribute is overriden by CSS in most browsers. */
262
+ div.tableblock > table[frame="void"] {
263
+ border-style: none;
264
+ }
265
+ div.tableblock > table[frame="hsides"] {
266
+ border-left-style: none;
267
+ border-right-style: none;
268
+ }
269
+ div.tableblock > table[frame="vsides"] {
270
+ border-top-style: none;
271
+ border-bottom-style: none;
272
+ }
246
273
 
247
- div.hlist {
274
+
275
+ div.hdlist {
248
276
  margin-top: 0.8em;
249
277
  margin-bottom: 0.8em;
250
278
  }
251
- div.hlist td {
279
+ div.hdlist tr {
252
280
  padding-bottom: 15px;
253
281
  }
254
- td.hlist1 {
282
+ dt.hdlist1.strong, td.hdlist1.strong {
283
+ font-weight: bold;
284
+ }
285
+ td.hdlist1 {
255
286
  vertical-align: top;
256
287
  font-style: normal;
257
288
  padding-right: 0.8em;
289
+ color: navy;
258
290
  }
259
- td.hlist2 {
291
+ td.hdlist2 {
260
292
  vertical-align: top;
261
293
  }
294
+ div.hdlist.compact tr {
295
+ margin: 0;
296
+ padding-bottom: 0;
297
+ }
262
298
 
263
299
  @media print {
264
300
  div#footer-badges { display: none; }
@@ -413,7 +449,6 @@ function generateToc(toclevels) {
413
449
  }
414
450
  /*]]>*/
415
451
  </script>
416
- <title>The Article Title</title>
417
452
  </head>
418
453
  <body>
419
454
  <div id="header">
@@ -429,31 +464,31 @@ Dec 2003
429
464
  </div>
430
465
  <div id="preamble">
431
466
  <div class="sectionbody">
432
- <div class="para"><p>This is the optional preamble (an untitled section body). Useful for
467
+ <div class="paragraph"><p>This is the optional preamble (an untitled section body). Useful for
433
468
  writing simple sectionless documents consisting only of a preamble.</p></div>
434
469
  </div>
435
470
  </div>
436
471
  <h2 id="_abstract">1. Abstract</h2>
437
472
  <div class="sectionbody">
438
- <div class="para"><p>The optional abstract (one or more paragraphs) goes here.</p></div>
439
- <div class="para"><p>This document is an <em>AsciiDoc</em> article skeleton containing briefly
473
+ <div class="paragraph"><p>The optional abstract (one or more paragraphs) goes here.</p></div>
474
+ <div class="paragraph"><p>This document is an <em>AsciiDoc</em> article skeleton containing briefly
440
475
  annotated element placeholders plus a couple of example index entries
441
476
  and footnotes. The preface, appendix, bibliography, glossary and index
442
477
  section titles are significant (<em>specialsections</em>).</p></div>
443
478
  </div>
444
479
  <h2 id="_the_first_section">2. The First Section</h2>
445
480
  <div class="sectionbody">
446
- <div class="para"><p>Article sections start at level 1 and can be nested up to four levels
481
+ <div class="paragraph"><p>Article sections start at level 1 and can be nested up to four levels
447
482
  deep.
448
483
  <br />[An example footnote.]<br /></p></div>
449
- <div class="para"><p>And now for something completely different: monkeys, lions and
484
+ <div class="paragraph"><p>And now for something completely different: monkeys, lions and
450
485
  tigers (Bengal and Siberian) using the alternative syntax index
451
486
  entries.
452
487
 
453
488
 
454
489
 
455
490
  Note that multi-entry terms generate separate index entries.</p></div>
456
- <div class="para"><p>Here are a couple of image examples: an <span class="image">
491
+ <div class="paragraph"><p>Here are a couple of image examples: an <span class="image">
457
492
  <img src="images/smallnew.png" alt="images/smallnew.png" />
458
493
  </span>
459
494
  example inline image followed by an example block image:</p></div>
@@ -461,75 +496,63 @@ example inline image followed by an example block image:</p></div>
461
496
  <div class="content">
462
497
  <img src="images/tiger.png" alt="Tiger image" title="Tiger image"/>
463
498
  </div>
464
- <div class="image-title">Figure: Tiger block image</div>
499
+ <div class="image-title">Tiger block image</div>
465
500
  </div>
466
- <div class="para"><p>Followed by an example table:</p></div>
501
+ <div class="paragraph"><p>Followed by an example table:</p></div>
467
502
  <div class="tableblock">
468
- <table rules="none"
469
- frame="hsides"
503
+ <table rules="all"
504
+ width="60%"
505
+ frame="border"
470
506
  cellspacing="0" cellpadding="4">
471
- <caption class="title">Table: An example table</caption>
472
- <col width="205" />
473
- <col width="308" />
474
- <thead>
475
- <tr>
476
- <th align="left">
477
- Option
478
- </th>
479
- <th align="left">
480
- Description
481
- </th>
482
- </tr>
507
+ <caption class="title">An example table</caption>
508
+ <col width="50%" />
509
+ <col width="50%" />
510
+ <thead valign="top">
511
+ <tr>
512
+ <th align="left"> Option </th>
513
+ <th align="left"> Description</th>
514
+ </tr>
483
515
  </thead>
484
516
  <tbody valign="top">
485
- <tr>
486
- <td align="left">
487
- -a <em>USER GROUP</em>
488
- </td>
489
- <td align="left">
490
- Add <em>USER</em> to <em>GROUP</em>.
491
- </td>
492
- </tr>
493
- <tr>
494
- <td align="left">
495
- -R <em>GROUP</em>
496
- </td>
497
- <td align="left">
498
- Disables access to <em>GROUP</em>.
499
- </td>
500
- </tr>
517
+ <tr>
518
+ <td align="left"><p class="table">-a <em>USER GROUP</em></p></td>
519
+ <td align="left"><p class="table">Add <em>USER</em> to <em>GROUP</em>.</p></td>
520
+ </tr>
521
+ <tr>
522
+ <td align="left"><p class="table">-R <em>GROUP</em></p></td>
523
+ <td align="left"><p class="table">Disables access to <em>GROUP</em>.</p></td>
524
+ </tr>
501
525
  </tbody>
502
526
  </table>
503
527
  </div>
504
528
  <h3 id="X1">2.1. Sub-section with Anchor</h3><div style="clear:left"></div>
505
- <div class="para"><p>Sub-section at level 2.</p></div>
529
+ <div class="paragraph"><p>Sub-section at level 2.</p></div>
506
530
  <h4 id="_a_nested_sub_section">2.1.1. A Nested Sub-section</h4>
507
- <div class="para"><p>Sub-section at level 3.</p></div>
531
+ <div class="paragraph"><p>Sub-section at level 3.</p></div>
508
532
  <h5 id="_yet_another_nested_sub_section">Yet another nested Sub-section</h5>
509
- <div class="para"><p>Sub-section at level 4.</p></div>
510
- <div class="para"><p>This is the maximum sub-section depth supported by the distributed
533
+ <div class="paragraph"><p>Sub-section at level 4.</p></div>
534
+ <div class="paragraph"><p>This is the maximum sub-section depth supported by the distributed
511
535
  <em>AsciiDoc</em> configuration.
512
536
  <br />[A second example footnote.]<br /></p></div>
513
537
  </div>
514
538
  <h2 id="_the_second_section">3. The Second Section</h2>
515
539
  <div class="sectionbody">
516
- <div class="para"><p>Article sections are at level 1 and can contain sub-sections nested up
540
+ <div class="paragraph"><p>Article sections are at level 1 and can contain sub-sections nested up
517
541
  to four deep.</p></div>
518
- <div class="para"><p>An example link to anchor at start of the <a href="#X1">first sub-section</a>.</p></div>
519
- <div class="para"><p>An example link to a bibliography entry <a href="#taoup">[taoup]</a>.</p></div>
542
+ <div class="paragraph"><p>An example link to anchor at start of the <a href="#X1">first sub-section</a>.</p></div>
543
+ <div class="paragraph"><p>An example link to a bibliography entry <a href="#taoup">[taoup]</a>.</p></div>
520
544
  </div>
521
545
  <h2 id="_appendix_a_example_appendix">4. Appendix A: Example Appendix</h2>
522
546
  <div class="sectionbody">
523
- <div class="para"><p><em>AsciiDoc</em> article appendices are just just article sections with
547
+ <div class="paragraph"><p><em>AsciiDoc</em> article appendices are just just article sections with
524
548
  <em>specialsection</em> titles.</p></div>
525
549
  <h3 id="_appendix_sub_section">4.1. Appendix Sub-section</h3><div style="clear:left"></div>
526
- <div class="para"><p>Appendix sub-section at level 2.</p></div>
550
+ <div class="paragraph"><p>Appendix sub-section at level 2.</p></div>
527
551
  </div>
528
552
  <h2 id="_bibliography">5. Bibliography</h2>
529
553
  <div class="sectionbody">
530
- <div class="para"><p>The bibliography list is an example of an <em>AsciiDoc</em> SimpleList, the
531
- <em>AsciiDoc</em> source list items are bulleted with a <tt>+</tt> character.</p></div>
532
- <div class="olist"><ol>
554
+ <div class="paragraph"><p>The bibliography list is a style of <em>AsciiDoc</em> bulleted list.</p></div>
555
+ <div class="ulist bibliography"><ul>
533
556
  <li>
534
557
  <p>
535
558
  <a id="taoup"></a>[taoup] Eric Steven Raymond. <em>The Art of Unix
@@ -539,18 +562,17 @@ to four deep.</p></div>
539
562
  <li>
540
563
  <p>
541
564
  <a id="walsh-muellner"></a>[walsh-muellner] Norman Walsh &amp; Leonard Muellner.
542
- <em>DocBook - The Definitive Guide</em>. O'Reilly &amp; Associates. 1999.
565
+ <em>DocBook - The Definitive Guide</em>. O&#8217;Reilly &amp; Associates. 1999.
543
566
  ISBN 1-56592-580-7.
544
567
  </p>
545
568
  </li>
546
- </ol></div>
569
+ </ul></div>
547
570
  </div>
548
571
  <h2 id="_glossary">6. Glossary</h2>
549
572
  <div class="sectionbody">
550
- <div class="para"><p>Glossaries are optional. Glossaries entries are an example of <em>AsciiDoc</em>
551
- VariableList entries, the <em>AsciiDoc</em> source entry terms are terminated
552
- by the ":-" characters.</p></div>
553
- <div class="vlist"><dl>
573
+ <div class="paragraph"><p>Glossaries are optional. Glossaries entries are an example of a style
574
+ of <em>AsciiDoc</em> labeled lists.</p></div>
575
+ <div class="dlist glossary"><dl>
554
576
  <dt>
555
577
  A glossary term
556
578
  </dt>
@@ -572,7 +594,7 @@ A second glossary term
572
594
  <div id="footer">
573
595
  <div id="footer-text">
574
596
  Version 1.0<br />
575
- Last updated 2008-07-03 13:38:33 NZDT
597
+ Last updated 2008-12-13 09:56:49 NZDT
576
598
  </div>
577
599
  </div>
578
600
  </body>