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
@@ -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> \normalfont{} </xsl:text>
|
27
|
+
<xsl:apply-templates/>
|
28
|
+
<xsl:text> \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
|
-
|
22
|
-
|
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.
|
4
|
-
.\" Date:
|
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" "
|
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
|
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
|
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)
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
93
|
-
\fI
|
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
|
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
|
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
|
113
|
-
\fI
|
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
|
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
|
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
|
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
|
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
|
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:
|
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
|
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
|
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
|
174
|
+
a2x \-f pdf doc/source\-highlight\-filter\.txt
|
164
175
|
.RS 4
|
165
|
-
Generates doc/source\-highlight\-filter
|
176
|
+
Generates doc/source\-highlight\-filter\.pdf file\.
|
166
177
|
.RE
|
167
178
|
.PP
|
168
|
-
a2x \-f chunked \-D
|
179
|
+
a2x \-f chunked \-D \.\./webpages guide\.txt
|
169
180
|
.RS 4
|
170
181
|
Creates chunked directory
|
171
|
-
|
172
|
-
containing chunked HTML files
|
173
|
-
docbook\-xsl
|
182
|
+
\.\./webpages/guide\.chunked
|
183
|
+
containing chunked HTML files\. Also copies
|
184
|
+
docbook\-xsl\.css
|
174
185
|
stylesheet to the
|
175
|
-
|
186
|
+
\.\./webpages/guide\.chunked
|
176
187
|
directory plus admonition and navigation icons to the
|
177
|
-
|
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
|
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
|
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
|
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
|
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
|
221
|
+
http://xmlgraphics\.apache\.org/fop/
|
212
222
|
.RE
|
213
223
|
.PP
|
214
|
-
|
224
|
+
w3m (text file generation)
|
215
225
|
.RS 4
|
216
226
|
|
217
|
-
http://
|
227
|
+
http://w3m\.sourceforge\.net/index\.en\.html
|
218
228
|
.RE
|
219
|
-
|
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
|
247
|
+
Written by Stuart Rackham, <srackham@gmail\.com>
|
232
248
|
.sp
|
233
249
|
.SH "RESOURCES"
|
234
|
-
SourceForge: http://sourceforge
|
250
|
+
SourceForge: http://sourceforge\.net/projects/asciidoc/
|
235
251
|
.sp
|
236
|
-
Main web site: http://www
|
252
|
+
Main web site: http://www\.methods\.co\.nz/asciidoc/
|
237
253
|
.sp
|
238
254
|
.SH "COPYING"
|
239
|
-
Copyright (C) 2002\-2008 Stuart Rackham
|
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
|
data/asciidoc/doc/a2x.1.txt
CHANGED
@@ -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
|
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
|
-
|
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.
|
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
|
-
|
274
|
+
|
275
|
+
div.hdlist {
|
248
276
|
margin-top: 0.8em;
|
249
277
|
margin-bottom: 0.8em;
|
250
278
|
}
|
251
|
-
div.
|
279
|
+
div.hdlist tr {
|
252
280
|
padding-bottom: 15px;
|
253
281
|
}
|
254
|
-
td.
|
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.
|
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="
|
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="
|
439
|
-
<div class="
|
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="
|
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="
|
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="
|
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">
|
499
|
+
<div class="image-title">Tiger block image</div>
|
465
500
|
</div>
|
466
|
-
<div class="
|
501
|
+
<div class="paragraph"><p>Followed by an example table:</p></div>
|
467
502
|
<div class="tableblock">
|
468
|
-
<table rules="
|
469
|
-
|
503
|
+
<table rules="all"
|
504
|
+
width="60%"
|
505
|
+
frame="border"
|
470
506
|
cellspacing="0" cellpadding="4">
|
471
|
-
<caption class="title">
|
472
|
-
<col width="
|
473
|
-
<col width="
|
474
|
-
<thead>
|
475
|
-
|
476
|
-
|
477
|
-
|
478
|
-
|
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
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
492
|
-
|
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="
|
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="
|
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="
|
510
|
-
<div class="
|
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="
|
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="
|
519
|
-
<div class="
|
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="
|
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="
|
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="
|
531
|
-
<
|
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 & Leonard Muellner.
|
542
|
-
<em>DocBook - The Definitive Guide</em>. O
|
565
|
+
<em>DocBook - The Definitive Guide</em>. O’Reilly & Associates. 1999.
|
543
566
|
ISBN 1-56592-580-7.
|
544
567
|
</p>
|
545
568
|
</li>
|
546
|
-
</
|
569
|
+
</ul></div>
|
547
570
|
</div>
|
548
571
|
<h2 id="_glossary">6. Glossary</h2>
|
549
572
|
<div class="sectionbody">
|
550
|
-
<div class="
|
551
|
-
|
552
|
-
|
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-
|
597
|
+
Last updated 2008-12-13 09:56:49 NZDT
|
576
598
|
</div>
|
577
599
|
</div>
|
578
600
|
</body>
|