mizuho 0.9.10 → 0.9.11

Sign up to get free protection for your applications and to get access to all the features.
Files changed (121) hide show
  1. data/README.markdown +18 -2
  2. data/asciidoc/BUGS +3 -6
  3. data/asciidoc/BUGS.txt +0 -3
  4. data/asciidoc/CHANGELOG +660 -397
  5. data/asciidoc/CHANGELOG.txt +237 -2
  6. data/asciidoc/INSTALL +14 -14
  7. data/asciidoc/MANIFEST +2 -0
  8. data/asciidoc/Makefile.in +9 -1
  9. data/asciidoc/README +2 -2
  10. data/asciidoc/a2x.py +101 -43
  11. data/asciidoc/asciidoc.conf +18 -11
  12. data/asciidoc/asciidoc.py +615 -260
  13. data/asciidoc/common.aap +2 -2
  14. data/asciidoc/configure +9 -9
  15. data/asciidoc/configure.ac +1 -1
  16. data/asciidoc/doc/a2x.1 +34 -4
  17. data/asciidoc/doc/a2x.1.txt +12 -0
  18. data/asciidoc/doc/article.pdf +0 -0
  19. data/asciidoc/doc/asciidoc.1 +73 -29
  20. data/asciidoc/doc/asciidoc.1.txt +56 -30
  21. data/asciidoc/doc/asciidoc.dict +23 -2
  22. data/asciidoc/doc/asciidoc.txt +468 -327
  23. data/asciidoc/doc/book.epub +0 -0
  24. data/asciidoc/doc/faq.txt +201 -25
  25. data/asciidoc/doc/latex-filter.pdf +0 -0
  26. data/asciidoc/doc/music-filter.pdf +0 -0
  27. data/asciidoc/doc/publishing-ebooks-with-asciidoc.txt +1 -1
  28. data/asciidoc/doc/source-highlight-filter.pdf +0 -0
  29. data/asciidoc/doc/source-highlight-filter.txt +48 -37
  30. data/asciidoc/docbook45.conf +4 -4
  31. data/asciidoc/examples/website/ASCIIMathML.js +938 -0
  32. data/asciidoc/examples/website/CHANGELOG.txt +3056 -0
  33. data/asciidoc/examples/website/INSTALL.txt +227 -0
  34. data/asciidoc/examples/website/LaTeXMathML.js +1223 -0
  35. data/asciidoc/examples/website/README-website.txt +29 -0
  36. data/asciidoc/examples/website/README.txt +35 -0
  37. data/asciidoc/examples/website/a2x.1.txt +358 -0
  38. data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +65 -0
  39. data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +170 -0
  40. data/asciidoc/examples/website/asciidoc.css +533 -0
  41. data/asciidoc/examples/website/asciidoc.js +189 -0
  42. data/asciidoc/examples/website/asciidocapi.txt +189 -0
  43. data/asciidoc/examples/website/asciimathml.txt +61 -0
  44. data/asciidoc/examples/website/build-website.sh +25 -0
  45. data/asciidoc/examples/website/customers.csv +18 -0
  46. data/asciidoc/examples/website/epub-notes.txt +210 -0
  47. data/asciidoc/examples/website/faq.txt +1298 -0
  48. data/asciidoc/examples/website/index.txt +502 -0
  49. data/asciidoc/examples/website/latex-backend.txt +192 -0
  50. data/asciidoc/examples/website/latex-bugs.txt +134 -0
  51. data/asciidoc/examples/website/latex-filter.txt +196 -0
  52. data/asciidoc/examples/website/latexmathml.txt +41 -0
  53. data/asciidoc/examples/website/layout1.conf +153 -0
  54. data/asciidoc/examples/website/layout1.css +65 -0
  55. data/asciidoc/examples/website/layout2.conf +153 -0
  56. data/asciidoc/examples/website/layout2.css +83 -0
  57. data/asciidoc/examples/website/main.aap +159 -0
  58. data/asciidoc/examples/website/manpage.txt +197 -0
  59. data/asciidoc/examples/website/music-filter.txt +148 -0
  60. data/asciidoc/examples/website/newlists.txt +40 -0
  61. data/asciidoc/examples/website/newtables.txt +743 -0
  62. data/asciidoc/examples/website/plugins.txt +91 -0
  63. data/asciidoc/examples/website/publishing-ebooks-with-asciidoc.txt +398 -0
  64. data/asciidoc/examples/website/slidy-example.txt +167 -0
  65. data/asciidoc/examples/website/slidy.txt +113 -0
  66. data/asciidoc/examples/website/source-highlight-filter.txt +239 -0
  67. data/asciidoc/examples/website/support.txt +5 -0
  68. data/asciidoc/examples/website/testasciidoc.txt +231 -0
  69. data/asciidoc/examples/website/userguide.txt +5991 -0
  70. data/asciidoc/examples/website/version83.txt +37 -0
  71. data/asciidoc/examples/website/xhtml11-quirks.css +43 -0
  72. data/asciidoc/filters/latex/latex2png.py +28 -12
  73. data/asciidoc/filters/music/music2png.py +22 -6
  74. data/asciidoc/filters/source/source-highlight-filter.conf +7 -5
  75. data/asciidoc/help.conf +147 -131
  76. data/asciidoc/html4.conf +1 -0
  77. data/asciidoc/html5.conf +37 -39
  78. data/asciidoc/javascripts/asciidoc.js +3 -3
  79. data/asciidoc/lang-de.conf +4 -0
  80. data/asciidoc/lang-es.conf +2 -0
  81. data/asciidoc/lang-fr.conf +1 -1
  82. data/asciidoc/lang-hu.conf +2 -0
  83. data/asciidoc/lang-it.conf +2 -0
  84. data/asciidoc/lang-nl.conf +5 -0
  85. data/asciidoc/lang-pt-BR.conf +2 -0
  86. data/asciidoc/lang-ru.conf +2 -3
  87. data/asciidoc/latex.conf +2 -2
  88. data/asciidoc/slidy.conf +4 -2
  89. data/asciidoc/stylesheets/asciidoc.css +29 -4
  90. data/asciidoc/stylesheets/docbook-xsl.css +12 -5
  91. data/asciidoc/stylesheets/toc2.css +1 -0
  92. data/asciidoc/stylesheets/xhtml11-quirks.css +1 -1
  93. data/asciidoc/tests/data/lang-de-man-test.txt +21 -0
  94. data/asciidoc/tests/data/lang-en-man-test.txt +21 -0
  95. data/asciidoc/tests/data/lang-es-man-test.txt +21 -0
  96. data/asciidoc/tests/data/lang-fr-man-test.txt +21 -0
  97. data/asciidoc/tests/data/lang-hu-man-test.txt +21 -0
  98. data/asciidoc/tests/data/lang-it-man-test.txt +21 -0
  99. data/asciidoc/tests/data/lang-it-test.txt +106 -0
  100. data/asciidoc/tests/data/lang-nl-man-test.txt +21 -0
  101. data/asciidoc/tests/data/lang-pt-BR-man-test.txt +21 -0
  102. data/asciidoc/tests/data/lang-ru-man-test.txt +21 -0
  103. data/asciidoc/tests/data/lang-uk-man-test.txt +21 -0
  104. data/asciidoc/tests/data/testcases.conf +10 -0
  105. data/asciidoc/tests/data/testcases.txt +40 -0
  106. data/asciidoc/tests/testasciidoc.conf +143 -17
  107. data/asciidoc/tests/testasciidoc.py +11 -2
  108. data/asciidoc/{stylesheets → themes/flask}/flask.css +0 -0
  109. data/asciidoc/{stylesheets → themes/volnitsky}/volnitsky.css +1 -1
  110. data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +1 -1
  111. data/asciidoc/vim/syntax/asciidoc.vim +1 -1
  112. data/asciidoc/xhtml11-quirks.conf +2 -2
  113. data/asciidoc/xhtml11.conf +35 -37
  114. data/lib/mizuho.rb +1 -1
  115. data/lib/mizuho/generator.rb +3 -1
  116. data/source-highlight/darwin/source-highlight +0 -0
  117. data/templates/juvia.js +30 -5
  118. metadata +58 -9
  119. data/asciidoc/stylesheets/asciidoc-manpage.css +0 -18
  120. data/asciidoc/stylesheets/flask-manpage.css +0 -1
  121. 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
- if os.path.isfile(f) and os.path.isfile(outfile) and \
120
- checksum == open(f,'rb').read():
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 = open(infile).read()
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
- open(texfile, 'w').write(tex)
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
- for f in temps:
151
- if os.path.isfile(f):
152
- print_verbose('deleting: %s' % f)
153
- os.remove(f)
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
- f = os.path.splitext(outfile)[0] + '.md5'
107
+ filename = os.path.splitext(outfile)[0] + '.md5'
94
108
  if modified:
95
- if os.path.isfile(f) and os.path.isfile(outfile) and \
96
- checksum == open(f,'rb').read():
109
+ if os.path.isfile(filename) and os.path.isfile(outfile) and \
110
+ checksum == read_file(filename,'rb'):
97
111
  skip = True
98
- open(f,'wb').write(checksum)
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 = open(infile).read()
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
- open('%s.%s' % (basefile,format), 'w').write(source) # Temp source file.
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
- 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}}"]
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}}"]
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
- asciidoc - converts an AsciiDoc text file to HTML or DocBook
20
-
19
+ asciidoc - converts an AsciiDoc text file to HTML or DocBook
21
20
 
22
21
  SYNOPSIS
23
22
 
24
- asciidoc [OPTIONS] FILE
25
-
23
+ asciidoc [OPTIONS] FILE
26
24
 
27
25
  DESCRIPTION
28
26
 
29
- The asciidoc(1) command translates the AsciiDoc text file FILE to
30
- DocBook or HTML. If FILE is - then the standard input is used.
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
- -a, --attribute=ATTRIBUTE
36
- Define or delete document attribute. ATTRIBUTE is formatted like
37
- NAME=VALUE. Command-line attributes take precedence over
38
- document and configuration file attributes. Alternate acceptable
39
- forms are NAME (the VALUE defaults to an empty string);
40
- NAME! (delete the NAME attribute); NAME@ (do not override
41
- document or configuration file attributes). Values containing
42
- spaces should be enclosed in double-quote characters. This option
43
- may be specified more than once. A special attribute named
44
- trace controls the output of diagnostic information.
45
-
46
- -b, --backend=BACKEND
47
- Backend output file format: docbook45, xhtml11, html4,
48
- wordpress or latex (the latex backend is experimental).
49
- You can also the backend alias names html (aliased to xhtml11)
50
- or docbook (aliased to docbook45).
51
- Defaults to html.
52
-
53
- -f, --conf-file=CONF_FILE
54
- Use configuration file CONF_FILE.Configuration files processed
55
- in command-line order (after implicit configuration files). This
56
- option may be specified more than once.
57
-
58
- --doctest
59
- Run Python doctests in asciidoc module.
60
-
61
- -d, --doctype=DOCTYPE
62
- Document type: article, manpage or book. The book document
63
- type is only supported by the docbook backend. Default document
64
- type is article.
65
-
66
- -c, --dump-conf
67
- Dump configuration to stdout.
68
-
69
- -h, --help [TOPIC]
70
- Print help TOPIC. '--help topics' will print a list of help
71
- topics, '--help syntax' summarizes AsciiDoc syntax,
72
- '--help manpage' prints the AsciiDoc manpage.
73
-
74
- -e, --no-conf
75
- Exclude implicitly loaded configuration files except for those
76
- named like the input file (infile.conf and
77
- infile-backend.conf).
78
-
79
- -s, --no-header-footer
80
- Suppress document header and footer output.
81
-
82
- -o, --out-file=OUT_FILE
83
- Write output to file OUT_FILE. Defaults to the base name of
84
- input file with backend extension. If the input is stdin then
85
- the outfile defaults to stdout. If OUT_FILE is - then the
86
- standard output is used.
87
-
88
- -n, --section-numbers
89
- Auto-number HTML article section titles. Synonym for -a
90
- numbered.
91
-
92
- --safe
93
- Enable safe mode. Safe mode is disabled by default. AsciiDoc
94
- safe mode skips potentially dangerous scripted sections in
95
- AsciiDoc source files.
96
-
97
- -v, --verbose
98
- Verbosely print processing information and configuration file
99
- checks to stderr.
100
-
101
- --version
102
- Print program version number.
103
-
104
- FILTER COMMANDS
105
-
106
- For more information about filters, type 'asciidoc --help filters'.
107
-
108
- EXIT STATUS
109
-
110
- 0
111
- Success
112
-
113
- 1
114
- Failure (syntax or usage error; configuration error; document
115
- processing failure; unexpected error).
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
- BUGS
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
- AUTHOR
124
-
125
- AsciiDoc was originally written by Stuart Rackham. Many people have
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
- RESOURCES
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
- SourceForge: <http://sourceforge.net/projects/asciidoc/>
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
- Main web site: <http://www.methods.co.nz/asciidoc/>
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
- COPYING
156
+ remove
157
+ Delete the PLUGIN_NAME plugin subdirectory and all its contents
158
+ from the PLUGINS_DIR.
137
159
 
138
- Copyright (C) 2002-2011 Stuart Rackham. Free use of this software is
139
- granted under the terms of the GNU General Public License (GPL).
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
- [filters]
170
+ EXIT STATUS
143
171
 
144
- FILTER COMMANDS
172
+ 0
173
+ Success
145
174
 
146
- The --filter option is used to install, remove and list AsciiDoc filter
147
- plugins. Filter commands syntax:
175
+ 1
176
+ Failure (syntax or usage error; configuration error; document
177
+ processing failure; unexpected error).
148
178
 
149
- asciidoc --filter install ZIP_FILE [FILTERS_DIR]
150
- asciidoc --filter remove FILTER_NAME [FILTERS_DIR]
151
- asciidoc --filter list
179
+ BUGS
152
180
 
153
- Where:
181
+ See the AsciiDoc distribution BUGS file.
154
182
 
155
- FILTER_NAME
156
- A unique filter name containing only alphanumeric or underscore
157
- characters.
183
+ AUTHOR
158
184
 
159
- ZIP_FILE
160
- A Zip file containing filter resources, the name must start with
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
- FILTERS_DIR
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
- The filter commands perform as follows:
190
+ SourceForge: [4]http://sourceforge.net/projects/asciidoc/
170
191
 
171
- install
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
- remove
176
- Delete the FILTER_NAME filter subdirectory and all its contents
177
- from the FILTERS_DIR.
194
+ COPYING
178
195
 
179
- list
180
- List the names and locations of all installed filters (including
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]