mizuho 0.9.10 → 0.9.11
Sign up to get free protection for your applications and to get access to all the features.
- data/README.markdown +18 -2
- data/asciidoc/BUGS +3 -6
- data/asciidoc/BUGS.txt +0 -3
- data/asciidoc/CHANGELOG +660 -397
- data/asciidoc/CHANGELOG.txt +237 -2
- data/asciidoc/INSTALL +14 -14
- data/asciidoc/MANIFEST +2 -0
- data/asciidoc/Makefile.in +9 -1
- data/asciidoc/README +2 -2
- data/asciidoc/a2x.py +101 -43
- data/asciidoc/asciidoc.conf +18 -11
- data/asciidoc/asciidoc.py +615 -260
- data/asciidoc/common.aap +2 -2
- data/asciidoc/configure +9 -9
- data/asciidoc/configure.ac +1 -1
- data/asciidoc/doc/a2x.1 +34 -4
- data/asciidoc/doc/a2x.1.txt +12 -0
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/asciidoc.1 +73 -29
- data/asciidoc/doc/asciidoc.1.txt +56 -30
- data/asciidoc/doc/asciidoc.dict +23 -2
- data/asciidoc/doc/asciidoc.txt +468 -327
- data/asciidoc/doc/book.epub +0 -0
- data/asciidoc/doc/faq.txt +201 -25
- data/asciidoc/doc/latex-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/publishing-ebooks-with-asciidoc.txt +1 -1
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +48 -37
- data/asciidoc/docbook45.conf +4 -4
- data/asciidoc/examples/website/ASCIIMathML.js +938 -0
- data/asciidoc/examples/website/CHANGELOG.txt +3056 -0
- data/asciidoc/examples/website/INSTALL.txt +227 -0
- data/asciidoc/examples/website/LaTeXMathML.js +1223 -0
- data/asciidoc/examples/website/README-website.txt +29 -0
- data/asciidoc/examples/website/README.txt +35 -0
- data/asciidoc/examples/website/a2x.1.txt +358 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +65 -0
- data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +170 -0
- data/asciidoc/examples/website/asciidoc.css +533 -0
- data/asciidoc/examples/website/asciidoc.js +189 -0
- data/asciidoc/examples/website/asciidocapi.txt +189 -0
- data/asciidoc/examples/website/asciimathml.txt +61 -0
- data/asciidoc/examples/website/build-website.sh +25 -0
- data/asciidoc/examples/website/customers.csv +18 -0
- data/asciidoc/examples/website/epub-notes.txt +210 -0
- data/asciidoc/examples/website/faq.txt +1298 -0
- data/asciidoc/examples/website/index.txt +502 -0
- data/asciidoc/examples/website/latex-backend.txt +192 -0
- data/asciidoc/examples/website/latex-bugs.txt +134 -0
- data/asciidoc/examples/website/latex-filter.txt +196 -0
- data/asciidoc/examples/website/latexmathml.txt +41 -0
- data/asciidoc/examples/website/layout1.conf +153 -0
- data/asciidoc/examples/website/layout1.css +65 -0
- data/asciidoc/examples/website/layout2.conf +153 -0
- data/asciidoc/examples/website/layout2.css +83 -0
- data/asciidoc/examples/website/main.aap +159 -0
- data/asciidoc/examples/website/manpage.txt +197 -0
- data/asciidoc/examples/website/music-filter.txt +148 -0
- data/asciidoc/examples/website/newlists.txt +40 -0
- data/asciidoc/examples/website/newtables.txt +743 -0
- data/asciidoc/examples/website/plugins.txt +91 -0
- data/asciidoc/examples/website/publishing-ebooks-with-asciidoc.txt +398 -0
- data/asciidoc/examples/website/slidy-example.txt +167 -0
- data/asciidoc/examples/website/slidy.txt +113 -0
- data/asciidoc/examples/website/source-highlight-filter.txt +239 -0
- data/asciidoc/examples/website/support.txt +5 -0
- data/asciidoc/examples/website/testasciidoc.txt +231 -0
- data/asciidoc/examples/website/userguide.txt +5991 -0
- data/asciidoc/examples/website/version83.txt +37 -0
- data/asciidoc/examples/website/xhtml11-quirks.css +43 -0
- data/asciidoc/filters/latex/latex2png.py +28 -12
- data/asciidoc/filters/music/music2png.py +22 -6
- data/asciidoc/filters/source/source-highlight-filter.conf +7 -5
- data/asciidoc/help.conf +147 -131
- data/asciidoc/html4.conf +1 -0
- data/asciidoc/html5.conf +37 -39
- data/asciidoc/javascripts/asciidoc.js +3 -3
- data/asciidoc/lang-de.conf +4 -0
- data/asciidoc/lang-es.conf +2 -0
- data/asciidoc/lang-fr.conf +1 -1
- data/asciidoc/lang-hu.conf +2 -0
- data/asciidoc/lang-it.conf +2 -0
- data/asciidoc/lang-nl.conf +5 -0
- data/asciidoc/lang-pt-BR.conf +2 -0
- data/asciidoc/lang-ru.conf +2 -3
- data/asciidoc/latex.conf +2 -2
- data/asciidoc/slidy.conf +4 -2
- data/asciidoc/stylesheets/asciidoc.css +29 -4
- data/asciidoc/stylesheets/docbook-xsl.css +12 -5
- data/asciidoc/stylesheets/toc2.css +1 -0
- data/asciidoc/stylesheets/xhtml11-quirks.css +1 -1
- data/asciidoc/tests/data/lang-de-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-en-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-es-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-fr-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-hu-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-it-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-it-test.txt +106 -0
- data/asciidoc/tests/data/lang-nl-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-pt-BR-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-ru-man-test.txt +21 -0
- data/asciidoc/tests/data/lang-uk-man-test.txt +21 -0
- data/asciidoc/tests/data/testcases.conf +10 -0
- data/asciidoc/tests/data/testcases.txt +40 -0
- data/asciidoc/tests/testasciidoc.conf +143 -17
- data/asciidoc/tests/testasciidoc.py +11 -2
- data/asciidoc/{stylesheets → themes/flask}/flask.css +0 -0
- data/asciidoc/{stylesheets → themes/volnitsky}/volnitsky.css +1 -1
- data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +1 -1
- data/asciidoc/vim/syntax/asciidoc.vim +1 -1
- data/asciidoc/xhtml11-quirks.conf +2 -2
- data/asciidoc/xhtml11.conf +35 -37
- data/lib/mizuho.rb +1 -1
- data/lib/mizuho/generator.rb +3 -1
- data/source-highlight/darwin/source-highlight +0 -0
- data/templates/juvia.js +30 -5
- metadata +58 -9
- data/asciidoc/stylesheets/asciidoc-manpage.css +0 -18
- data/asciidoc/stylesheets/flask-manpage.css +0 -1
- data/asciidoc/stylesheets/volnitsky-manpage.css +0 -1
@@ -0,0 +1,37 @@
|
|
1
|
+
AsciiDoc Version 8.3
|
2
|
+
====================
|
3
|
+
|
4
|
+
This is significant release, it gets rid of unused cruft, simplifies
|
5
|
+
the http://www.methods.co.nz/asciidoc/newlists.html[lists] syntax and
|
6
|
+
introduces a decent
|
7
|
+
http://www.methods.co.nz/asciidoc/newtables.html[tables] syntax.
|
8
|
+
There are a few fairly minor backward compatibility issues, please
|
9
|
+
read the link:CHANGELOG.html#X1[compatibility issues] section in the
|
10
|
+
CHANGLOG before upgrading.
|
11
|
+
|
12
|
+
New Features
|
13
|
+
------------
|
14
|
+
- AsciiDoc tables have been redesigned. The link:newtables.html[new
|
15
|
+
syntax and features] are a huge improvement over the old tables. The
|
16
|
+
old tables syntax has been deprecated but is currently still
|
17
|
+
processed.
|
18
|
+
- Lists can now be styled like other block elements. This allows a
|
19
|
+
single list syntax for 'glossary', 'qanda' (Question and Answer) and
|
20
|
+
'bibliography' lists instead of having to remember a different
|
21
|
+
syntax for each type. link:newlists.html[Here is some more
|
22
|
+
information].
|
23
|
+
- Inline passthroughs macros have been improved and block passthrough
|
24
|
+
macros added. Attribute substitution can be optionally specified
|
25
|
+
when the macro is called.
|
26
|
+
- The passthrough block has a fully transparent passthrough delimited
|
27
|
+
block block style called 'pass'.
|
28
|
+
- The 'asciimath' and 'latexmath' link:userguide.html#X77[passthrough
|
29
|
+
macros] along with 'asciimath' and 'latexmath'
|
30
|
+
link:userguide.html#X76[passthrough blocks] provide a (backend
|
31
|
+
dependent) mechanism for rendering mathematical formulas. There are
|
32
|
+
link:latexmath.pdf[LaTeX Math], link:asciimathml.html[AsciiMathML]
|
33
|
+
and link:latexmathml.html[LaTeXMathML] examples on the AsciiDoc
|
34
|
+
website.
|
35
|
+
|
36
|
+
Read the link:CHANGELOG.html[CHANGELOG] for a full list of all
|
37
|
+
additions and changes.
|
@@ -0,0 +1,43 @@
|
|
1
|
+
/* Workarounds for IE6's broken and incomplete CSS2. */
|
2
|
+
|
3
|
+
div.sidebar-content {
|
4
|
+
background: #ffffee;
|
5
|
+
border: 1px solid silver;
|
6
|
+
padding: 0.5em;
|
7
|
+
}
|
8
|
+
div.sidebar-title, div.image-title {
|
9
|
+
color: #527bbd;
|
10
|
+
font-family: Arial,Helvetica,sans-serif;
|
11
|
+
font-weight: bold;
|
12
|
+
margin-top: 0.0em;
|
13
|
+
margin-bottom: 0.5em;
|
14
|
+
}
|
15
|
+
|
16
|
+
div.listingblock div.content {
|
17
|
+
border: 1px solid silver;
|
18
|
+
background: #f4f4f4;
|
19
|
+
padding: 0.5em;
|
20
|
+
}
|
21
|
+
|
22
|
+
div.quoteblock-attribution {
|
23
|
+
padding-top: 0.5em;
|
24
|
+
text-align: right;
|
25
|
+
}
|
26
|
+
|
27
|
+
pre.verseblock-content {
|
28
|
+
font-family: inherit;
|
29
|
+
}
|
30
|
+
div.verseblock-attribution {
|
31
|
+
padding-top: 0.75em;
|
32
|
+
text-align: left;
|
33
|
+
}
|
34
|
+
|
35
|
+
div.exampleblock-content {
|
36
|
+
border-left: 3px solid #dddddd;
|
37
|
+
padding-left: 0.5em;
|
38
|
+
}
|
39
|
+
|
40
|
+
div.imageblock.latex div.image-title { margin-top: 0.5em; }
|
41
|
+
|
42
|
+
/* IE6 sets dynamically generated links as visited. */
|
43
|
+
div#toc a:visited { color: blue; }
|
@@ -90,6 +90,20 @@ def print_verbose(line):
|
|
90
90
|
if verbose:
|
91
91
|
print_stderr(line)
|
92
92
|
|
93
|
+
def write_file(filename, data, mode='w'):
|
94
|
+
f = open(filename, mode)
|
95
|
+
try:
|
96
|
+
f.write(data)
|
97
|
+
finally:
|
98
|
+
f.close()
|
99
|
+
|
100
|
+
def read_file(filename, mode='r'):
|
101
|
+
f = open(filename, mode)
|
102
|
+
try:
|
103
|
+
return f.read()
|
104
|
+
finally:
|
105
|
+
f.close()
|
106
|
+
|
93
107
|
def run(cmd):
|
94
108
|
global verbose
|
95
109
|
if verbose:
|
@@ -113,17 +127,16 @@ def latex2png(infile, outfile, dpi, modified):
|
|
113
127
|
skip = False
|
114
128
|
if infile == '-':
|
115
129
|
tex = sys.stdin.read()
|
116
|
-
checksum = md5.new(tex).digest()
|
117
|
-
f = os.path.splitext(outfile)[0] + '.md5'
|
118
130
|
if modified:
|
119
|
-
|
120
|
-
|
131
|
+
checksum = md5.new(tex).digest()
|
132
|
+
md5_file = os.path.splitext(outfile)[0] + '.md5'
|
133
|
+
if os.path.isfile(md5_file) and os.path.isfile(outfile) and \
|
134
|
+
checksum == read_file(md5_file,'rb'):
|
121
135
|
skip = True
|
122
|
-
open(f,'wb').write(checksum)
|
123
136
|
else:
|
124
137
|
if not os.path.isfile(infile):
|
125
138
|
raise EApp, 'input file does not exist: %s' % infile
|
126
|
-
tex =
|
139
|
+
tex = read_file(infile)
|
127
140
|
if modified and os.path.isfile(outfile) and \
|
128
141
|
os.path.getmtime(infile) <= os.path.getmtime(outfile):
|
129
142
|
skip = True
|
@@ -132,7 +145,7 @@ def latex2png(infile, outfile, dpi, modified):
|
|
132
145
|
return
|
133
146
|
tex = '%s\n%s\n%s\n' % (TEX_HEADER, tex.strip(), TEX_FOOTER)
|
134
147
|
print_verbose('tex:\n%s' % tex)
|
135
|
-
|
148
|
+
write_file(texfile, tex)
|
136
149
|
saved_pwd = os.getcwd()
|
137
150
|
os.chdir(outdir)
|
138
151
|
try:
|
@@ -142,15 +155,18 @@ def latex2png(infile, outfile, dpi, modified):
|
|
142
155
|
cmd = 'dvipng'
|
143
156
|
if dpi:
|
144
157
|
cmd += ' -D %s' % dpi
|
145
|
-
cmd += ' -T tight -x 1000 -z 9 -bg Transparent -o "%s" "%s"' \
|
158
|
+
cmd += ' -T tight -x 1000 -z 9 -bg Transparent --truecolor -o "%s" "%s" ' \
|
146
159
|
% (outfile,dvifile)
|
147
160
|
run(cmd)
|
148
161
|
finally:
|
149
162
|
os.chdir(saved_pwd)
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
163
|
+
for f in temps:
|
164
|
+
if os.path.isfile(f):
|
165
|
+
print_verbose('deleting: %s' % f)
|
166
|
+
os.remove(f)
|
167
|
+
if 'md5_file' in locals():
|
168
|
+
print_verbose('writing: %s' % md5_file)
|
169
|
+
write_file(md5_file, checksum, 'wb')
|
154
170
|
|
155
171
|
def usage(msg=''):
|
156
172
|
if msg:
|
@@ -70,6 +70,20 @@ def print_verbose(line):
|
|
70
70
|
if verbose:
|
71
71
|
print_stderr(line)
|
72
72
|
|
73
|
+
def write_file(filename, data, mode='w'):
|
74
|
+
f = open(filename, mode)
|
75
|
+
try:
|
76
|
+
f.write(data)
|
77
|
+
finally:
|
78
|
+
f.close()
|
79
|
+
|
80
|
+
def read_file(filename, mode='r'):
|
81
|
+
f = open(filename, mode)
|
82
|
+
try:
|
83
|
+
return f.read()
|
84
|
+
finally:
|
85
|
+
f.close()
|
86
|
+
|
73
87
|
def run(cmd):
|
74
88
|
global verbose
|
75
89
|
if not verbose:
|
@@ -90,19 +104,20 @@ def music2png(format, infile, outfile, modified):
|
|
90
104
|
if infile == '-':
|
91
105
|
source = sys.stdin.read()
|
92
106
|
checksum = md5.new(source).digest()
|
93
|
-
|
107
|
+
filename = os.path.splitext(outfile)[0] + '.md5'
|
94
108
|
if modified:
|
95
|
-
if os.path.isfile(
|
96
|
-
checksum ==
|
109
|
+
if os.path.isfile(filename) and os.path.isfile(outfile) and \
|
110
|
+
checksum == read_file(filename,'rb'):
|
97
111
|
skip = True
|
98
|
-
|
112
|
+
else:
|
113
|
+
write_file(filename, checksum, 'wb')
|
99
114
|
else:
|
100
115
|
if not os.path.isfile(infile):
|
101
116
|
raise EApp, 'input file does not exist: %s' % infile
|
102
117
|
if modified and os.path.isfile(outfile) and \
|
103
118
|
os.path.getmtime(infile) <= os.path.getmtime(outfile):
|
104
119
|
skip = True
|
105
|
-
source =
|
120
|
+
source = read_file(infile)
|
106
121
|
if skip:
|
107
122
|
print_verbose('skipped: no change: %s' % outfile)
|
108
123
|
return
|
@@ -111,7 +126,8 @@ def music2png(format, infile, outfile, modified):
|
|
111
126
|
format = 'ly'
|
112
127
|
else:
|
113
128
|
format = 'abc'
|
114
|
-
|
129
|
+
# Write temporary source file.
|
130
|
+
write_file('%s.%s' % (basefile,format), source)
|
115
131
|
abc = basefile + '.abc'
|
116
132
|
ly = basefile + '.ly'
|
117
133
|
png = basefile + '.png'
|
@@ -43,25 +43,27 @@ endif::basebackend-xhtml11,basebackend-html5[]
|
|
43
43
|
ifdef::basebackend-docbook[]
|
44
44
|
[source-highlight-block]
|
45
45
|
<formalpara{id? id="{id}"}{role? role="{role}"}{reftext? xreflabel="{reftext}"}><title>{title}</title><para>
|
46
|
-
<programlisting language="{language}" linenumbering="{src_numbered=unnumbered}">
|
46
|
+
<programlisting language="{language}" linenumbering="{src_numbered=unnumbered}"{args? {args}}>
|
47
47
|
|
|
48
48
|
</programlisting>
|
49
49
|
{title#}</para></formalpara>
|
50
50
|
endif::basebackend-docbook[]
|
51
51
|
|
52
|
-
[source-filter-style]
|
53
52
|
# Source styles template.
|
54
53
|
ifdef::basebackend-html[]
|
55
|
-
|
56
|
-
|
54
|
+
[source-filter-style]
|
55
|
+
ifndef::pygments[source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered","src_tab"),filter="source-highlight -f xhtml -s {language} {src_numbered?--line-number} {src_tab?--tab={src_tab}} {args=}"]
|
56
|
+
ifdef::pygments[source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered"),filter="pygmentize -f html -l {language} {src_numbered?-O linenos=table} {encoding?-O encoding={encoding}} {args=}"]
|
57
57
|
endif::basebackend-html[]
|
58
58
|
|
59
59
|
ifdef::basebackend-html4[]
|
60
|
+
[source-filter-style]
|
60
61
|
# html4 does not use pygments.
|
61
|
-
source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered","src_tab"),filter="source-highlight -f html -s {language} {src_numbered?--line-number} {src_tab?--tab={src_tab}}"
|
62
|
+
source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered","src_tab"),filter="source-highlight -f html -s {language} {src_numbered?--line-number} {src_tab?--tab={src_tab}} {args=}"
|
62
63
|
endif::basebackend-html4[]
|
63
64
|
|
64
65
|
ifdef::basebackend-docbook[]
|
66
|
+
[source-filter-style]
|
65
67
|
source-style=template="source-highlight-block",presubs=(),postsubs=("specialcharacters","callouts"),posattrs=("style","language","src_numbered","src_tab")
|
66
68
|
endif::basebackend-docbook[]
|
67
69
|
|
data/asciidoc/help.conf
CHANGED
@@ -16,169 +16,185 @@ Syntax: asciidoc --help syntax
|
|
16
16
|
|
17
17
|
NAME
|
18
18
|
|
19
|
-
|
20
|
-
|
19
|
+
asciidoc - converts an AsciiDoc text file to HTML or DocBook
|
21
20
|
|
22
21
|
SYNOPSIS
|
23
22
|
|
24
|
-
|
25
|
-
|
23
|
+
asciidoc [OPTIONS] FILE
|
26
24
|
|
27
25
|
DESCRIPTION
|
28
26
|
|
29
|
-
|
30
|
-
|
31
|
-
|
27
|
+
The asciidoc(1) command translates the AsciiDoc text file FILE to
|
28
|
+
DocBook or HTML. If FILE is - then the standard input is used.
|
32
29
|
|
33
30
|
OPTIONS
|
34
31
|
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
32
|
+
-a, --attribute=ATTRIBUTE
|
33
|
+
Define or delete document attribute. ATTRIBUTE is formatted like
|
34
|
+
NAME=VALUE. Command-line attributes take precedence over
|
35
|
+
document and configuration file attributes. Alternate acceptable
|
36
|
+
forms are NAME (the VALUE defaults to an empty string); NAME!
|
37
|
+
(delete the NAME attribute); NAME=VALUE@ (do not override
|
38
|
+
document or configuration file attributes). Values containing
|
39
|
+
spaces should be enclosed in double-quote characters. This
|
40
|
+
option may be specified more than once. A special attribute
|
41
|
+
named trace controls the output of diagnostic information.
|
42
|
+
|
43
|
+
-b, --backend=BACKEND
|
44
|
+
Backend output file format: docbook45, xhtml11, html4, html5,
|
45
|
+
slidy, wordpress or latex (the latex backend is experimental).
|
46
|
+
You can also use the backend alias names html (aliased to
|
47
|
+
xhtml11) or docbook (aliased to docbook45). Defaults to
|
48
|
+
html. The --backend option is also used to manage backend
|
49
|
+
plugins (see [1]PLUGIN COMMANDS).
|
50
|
+
|
51
|
+
-f, --conf-file=CONF_FILE
|
52
|
+
Use configuration file CONF_FILE.Configuration files processed
|
53
|
+
in command-line order (after implicit configuration files). This
|
54
|
+
option may be specified more than once.
|
55
|
+
|
56
|
+
--doctest
|
57
|
+
Run Python doctests in asciidoc module.
|
58
|
+
|
59
|
+
-d, --doctype=DOCTYPE
|
60
|
+
Document type: article, manpage or book. The book document type
|
61
|
+
is only supported by the docbook backend. Default document type
|
62
|
+
is article.
|
63
|
+
|
64
|
+
-c, --dump-conf
|
65
|
+
Dump configuration to stdout.
|
66
|
+
|
67
|
+
--filter=FILTER
|
68
|
+
Specify the name of a filter to be loaded (used to load filters
|
69
|
+
that are not auto-loaded). This option may be specified more
|
70
|
+
than once. The --filter option is also used to manage filter
|
71
|
+
plugins (see [2]PLUGIN COMMANDS).
|
72
|
+
|
73
|
+
-h, --help [TOPIC]
|
74
|
+
Print help TOPIC. --help topics will print a list of help
|
75
|
+
topics, --help syntax summarizes AsciiDoc syntax, --help manpage
|
76
|
+
prints the AsciiDoc manpage.
|
77
|
+
|
78
|
+
-e, --no-conf
|
79
|
+
Exclude implicitly loaded configuration files except for those
|
80
|
+
named like the input file (infile.conf and infile-backend.conf).
|
81
|
+
|
82
|
+
-s, --no-header-footer
|
83
|
+
Suppress document header and footer output.
|
84
|
+
|
85
|
+
-o, --out-file=OUT_FILE
|
86
|
+
Write output to file OUT_FILE. Defaults to the base name of
|
87
|
+
input file with backend extension. If the input is stdin then
|
88
|
+
the outfile defaults to stdout. If OUT_FILE is - then the
|
89
|
+
standard output is used.
|
90
|
+
|
91
|
+
-n, --section-numbers
|
92
|
+
Auto-number HTML article section titles. Synonym for --attribute
|
93
|
+
numbered.
|
94
|
+
|
95
|
+
--safe
|
96
|
+
Enable safe mode. Safe mode is disabled by default. AsciiDoc
|
97
|
+
safe mode skips potentially dangerous scripted sections in
|
98
|
+
AsciiDoc source files.
|
99
|
+
|
100
|
+
--theme=THEME
|
101
|
+
Specify a theme name. Synonym for --attribute theme=THEME. The
|
102
|
+
--theme option is also used to manage theme plugins (see
|
103
|
+
[3]PLUGIN COMMANDS).
|
104
|
+
|
105
|
+
-v, --verbose
|
106
|
+
Verbosely print processing information and configuration file
|
107
|
+
checks to stderr.
|
108
|
+
|
109
|
+
--version
|
110
|
+
Print program version number.
|
111
|
+
|
112
|
+
PLUGIN COMMANDS
|
113
|
+
|
114
|
+
The asciidoc(1) --filter, --backend and --theme options are used to
|
115
|
+
install, remove and list AsciiDoc filter, backend and theme plugins.
|
116
|
+
Syntax:
|
117
|
+
|
118
|
+
asciidoc OPTION install ZIP_FILE [PLUGINS_DIR]
|
119
|
+
asciidoc OPTION remove PLUGIN_NAME [PLUGINS_DIR]
|
120
|
+
asciidoc OPTION list
|
121
|
+
asciidoc OPTION build ZIP_FILE PLUGIN_SOURCE
|
117
122
|
|
118
|
-
|
119
|
-
|
120
|
-
See the AsciiDoc distribution BUGS file.
|
123
|
+
Where:
|
121
124
|
|
125
|
+
OPTION
|
126
|
+
asciidoc(1) --filter, --backend or --theme option specifying the
|
127
|
+
type of plugin.
|
122
128
|
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
contributed to it.
|
129
|
+
PLUGIN_NAME
|
130
|
+
A unique plugin name containing only alphanumeric or underscore
|
131
|
+
characters.
|
127
132
|
|
133
|
+
ZIP_FILE
|
134
|
+
A Zip file containing plugin resources, the name must start with
|
135
|
+
the plugin name e.g. my_filter-1.0.zip packages filter
|
136
|
+
my_filter.
|
128
137
|
|
129
|
-
|
138
|
+
PLUGINS_DIR
|
139
|
+
The directory containing installed plugins. Each plugin is
|
140
|
+
contained in its own separate subdirectory which has the same
|
141
|
+
name as the plugin. PLUGINS_DIR defaults to the
|
142
|
+
$HOME/.asciidoc/filters (for filter plugins) or
|
143
|
+
$HOME/.asciidoc/backends (for backend plugins) or
|
144
|
+
$HOME/.asciidoc/themes (for theme plugins).
|
130
145
|
|
131
|
-
|
146
|
+
PLUGIN_SOURCE
|
147
|
+
The name of a directory containing the plugin source files or
|
148
|
+
the name of a single source file.
|
132
149
|
|
133
|
-
|
150
|
+
The plugin commands perform as follows:
|
134
151
|
|
152
|
+
install
|
153
|
+
Create a subdirectory in PLUGINS_DIR with the same name as the
|
154
|
+
plugin then extract the ZIP_FILE into it.
|
135
155
|
|
136
|
-
|
156
|
+
remove
|
157
|
+
Delete the PLUGIN_NAME plugin subdirectory and all its contents
|
158
|
+
from the PLUGINS_DIR.
|
137
159
|
|
138
|
-
|
139
|
-
|
160
|
+
list
|
161
|
+
List the names and locations of all installed filter or theme
|
162
|
+
plugins (including standard plugins installed in the global
|
163
|
+
configuration directory).
|
140
164
|
|
165
|
+
build
|
166
|
+
Create a plugin file named ZIP_FILE containing the files and
|
167
|
+
subdirectories specified by PLUGIN_SOURCE. File and directory
|
168
|
+
names starting with a period are skipped.
|
141
169
|
|
142
|
-
|
170
|
+
EXIT STATUS
|
143
171
|
|
144
|
-
|
172
|
+
0
|
173
|
+
Success
|
145
174
|
|
146
|
-
|
147
|
-
|
175
|
+
1
|
176
|
+
Failure (syntax or usage error; configuration error; document
|
177
|
+
processing failure; unexpected error).
|
148
178
|
|
149
|
-
|
150
|
-
asciidoc --filter remove FILTER_NAME [FILTERS_DIR]
|
151
|
-
asciidoc --filter list
|
179
|
+
BUGS
|
152
180
|
|
153
|
-
|
181
|
+
See the AsciiDoc distribution BUGS file.
|
154
182
|
|
155
|
-
|
156
|
-
A unique filter name containing only alphanumeric or underscore
|
157
|
-
characters.
|
183
|
+
AUTHOR
|
158
184
|
|
159
|
-
|
160
|
-
|
161
|
-
the filter name e.g. my_filter-1.0.zip packages filter my_filter.
|
185
|
+
AsciiDoc was originally written by Stuart Rackham. Many people have
|
186
|
+
contributed to it.
|
162
187
|
|
163
|
-
|
164
|
-
The directory containing installed filters. Each filter is
|
165
|
-
contained in its own separate subdirectory which has the same name
|
166
|
-
as the filter. FILTERS_DIR defaults to the .asciidoc/filters
|
167
|
-
directory in the user's home directory.
|
188
|
+
RESOURCES
|
168
189
|
|
169
|
-
|
190
|
+
SourceForge: [4]http://sourceforge.net/projects/asciidoc/
|
170
191
|
|
171
|
-
|
172
|
-
Create a subdirectory in FILTERS_DIR with the same name as the
|
173
|
-
filter then extract the ZIP_FILE into it.
|
192
|
+
Main web site: [5]http://www.methods.co.nz/asciidoc/
|
174
193
|
|
175
|
-
|
176
|
-
Delete the FILTER_NAME filter subdirectory and all its contents
|
177
|
-
from the FILTERS_DIR.
|
194
|
+
COPYING
|
178
195
|
|
179
|
-
|
180
|
-
|
181
|
-
standard filters installed in the global configuration directory).
|
196
|
+
Copyright (C) 2002-2011 Stuart Rackham. Free use of this software is
|
197
|
+
granted under the terms of the GNU General Public License (GPL).
|
182
198
|
|
183
199
|
|
184
200
|
[syntax]
|