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
data/asciidoc/common.aap CHANGED
@@ -2,8 +2,8 @@
2
2
  # Executed by all main.aap's before anything else.
3
3
  #
4
4
 
5
- _parent.VERS = 8.6.5
6
- _parent.DATE = 20 May 2011
5
+ _parent.VERS = 8.6.7
6
+ _parent.DATE = 17 March 2012
7
7
 
8
8
  all:
9
9
  :pass
data/asciidoc/configure CHANGED
@@ -1,6 +1,6 @@
1
1
  #! /bin/sh
2
2
  # Guess values for system-dependent variables and create Makefiles.
3
- # Generated by GNU Autoconf 2.65 for asciidoc 8.6.5.
3
+ # Generated by GNU Autoconf 2.65 for asciidoc 8.6.7.
4
4
  #
5
5
  #
6
6
  # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
@@ -549,8 +549,8 @@ MAKEFLAGS=
549
549
  # Identity of this package.
550
550
  PACKAGE_NAME='asciidoc'
551
551
  PACKAGE_TARNAME='asciidoc'
552
- PACKAGE_VERSION='8.6.5'
553
- PACKAGE_STRING='asciidoc 8.6.5'
552
+ PACKAGE_VERSION='8.6.7'
553
+ PACKAGE_STRING='asciidoc 8.6.7'
554
554
  PACKAGE_BUGREPORT=''
555
555
  PACKAGE_URL=''
556
556
 
@@ -1147,7 +1147,7 @@ if test "$ac_init_help" = "long"; then
1147
1147
  # Omit some internal or obsolete options to make the list less imposing.
1148
1148
  # This message is too long to be a string in the A/UX 3.1 sh.
1149
1149
  cat <<_ACEOF
1150
- \`configure' configures asciidoc 8.6.5 to adapt to many kinds of systems.
1150
+ \`configure' configures asciidoc 8.6.7 to adapt to many kinds of systems.
1151
1151
 
1152
1152
  Usage: $0 [OPTION]... [VAR=VALUE]...
1153
1153
 
@@ -1208,7 +1208,7 @@ fi
1208
1208
 
1209
1209
  if test -n "$ac_init_help"; then
1210
1210
  case $ac_init_help in
1211
- short | recursive ) echo "Configuration of asciidoc 8.6.5:";;
1211
+ short | recursive ) echo "Configuration of asciidoc 8.6.7:";;
1212
1212
  esac
1213
1213
  cat <<\_ACEOF
1214
1214
 
@@ -1275,7 +1275,7 @@ fi
1275
1275
  test -n "$ac_init_help" && exit $ac_status
1276
1276
  if $ac_init_version; then
1277
1277
  cat <<\_ACEOF
1278
- asciidoc configure 8.6.5
1278
+ asciidoc configure 8.6.7
1279
1279
  generated by GNU Autoconf 2.65
1280
1280
 
1281
1281
  Copyright (C) 2009 Free Software Foundation, Inc.
@@ -1292,7 +1292,7 @@ cat >config.log <<_ACEOF
1292
1292
  This file contains any messages produced by compilers while
1293
1293
  running configure, to aid debugging if configure makes a mistake.
1294
1294
 
1295
- It was created by asciidoc $as_me 8.6.5, which was
1295
+ It was created by asciidoc $as_me 8.6.7, which was
1296
1296
  generated by GNU Autoconf 2.65. Invocation command line was
1297
1297
 
1298
1298
  $ $0 $@
@@ -2383,7 +2383,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
2383
2383
  # report actual input values of CONFIG_FILES etc. instead of their
2384
2384
  # values after options handling.
2385
2385
  ac_log="
2386
- This file was extended by asciidoc $as_me 8.6.5, which was
2386
+ This file was extended by asciidoc $as_me 8.6.7, which was
2387
2387
  generated by GNU Autoconf 2.65. Invocation command line was
2388
2388
 
2389
2389
  CONFIG_FILES = $CONFIG_FILES
@@ -2436,7 +2436,7 @@ _ACEOF
2436
2436
  cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
2437
2437
  ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
2438
2438
  ac_cs_version="\\
2439
- asciidoc config.status 8.6.5
2439
+ asciidoc config.status 8.6.7
2440
2440
  configured by $0, generated by GNU Autoconf 2.65,
2441
2441
  with options \\"\$ac_cs_config\\"
2442
2442
 
@@ -1,4 +1,4 @@
1
- AC_INIT(asciidoc, 8.6.5)
1
+ AC_INIT(asciidoc, 8.6.7)
2
2
 
3
3
  AC_CONFIG_FILES(Makefile)
4
4
 
data/asciidoc/doc/a2x.1 CHANGED
@@ -2,12 +2,12 @@
2
2
  .\" Title: a2x
3
3
  .\" Author: [see the "AUTHOR" section]
4
4
  .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
- .\" Date: 20 May 2011
5
+ .\" Date: 17 March 2012
6
6
  .\" Manual: \ \&
7
- .\" Source: \ \& 8.6.5
7
+ .\" Source: \ \& 8.6.7
8
8
  .\" Language: English
9
9
  .\"
10
- .TH "A2X" "1" "20 May 2011" "\ \& 8\&.6\&.5" "\ \&"
10
+ .TH "A2X" "1" "17 March 2012" "\ \& 8\&.6\&.7" "\ \&"
11
11
  .\" -----------------------------------------------------------------
12
12
  .\" * Define some portability stuff
13
13
  .\" -----------------------------------------------------------------
@@ -78,6 +78,26 @@ unless the format is
78
78
  \fImanpage\fR)\&.
79
79
  .RE
80
80
  .PP
81
+ \fB\-b, \-\-backend\fR=\fIBACKEND\fR
82
+ .RS 4
83
+
84
+ \fIBACKEND\fR
85
+ is the name of an installed backend plugin\&. When this option is specified
86
+ \fIa2x\fR
87
+ attempts load a file name
88
+ \fIa2x\-backend\&.py\fR
89
+ from the
90
+ \fIBACKEND\fR
91
+ plugin directory It then converts the
92
+ \fISOURCE_FILE\fR
93
+ to a
94
+ \fIBACKEND\fR
95
+ formatted output file using a global function defined in
96
+ \fIa2x\-backend\&.py\fR
97
+ called
98
+ \fIto_BACKEND\fR\&.
99
+ .RE
100
+ .PP
81
101
  \fB\-f, \-\-format\fR=\fIFORMAT\fR
82
102
  .RS 4
83
103
  Output formats:
@@ -92,7 +112,10 @@ Output formats:
92
112
  \fIps\fR,
93
113
  \fItex\fR,
94
114
  \fItext\fR,
95
- \fIxhtml\fR\&.
115
+ \fIxhtml\fR\&. The AsciiDoc
116
+ \fIa2x\-format\fR
117
+ attribute value is set to
118
+ \fIFORMAT\fR\&.
96
119
  .RE
97
120
  .PP
98
121
  \fB\-h, \-\-help\fR
@@ -220,6 +243,13 @@ Additional
220
243
  \fIdblatex(1)\fR
221
244
  options\&. This option may be specified more than once\&.
222
245
  .RE
246
+ .PP
247
+ \fB\-\-backend\-opts\fR=\fIBACKEND_OPTS\fR
248
+ .RS 4
249
+ Options for the backend plugin specified by the
250
+ \fI\-\-backend\fR
251
+ option\&. This option may be specified more than once\&.
252
+ .RE
223
253
  .sp
224
254
  Options can also be set in the AsciiDoc source file\&. If \fISOURCE_FILE\fR contains a comment line beginning with \fB// a2x:\fR then the remainder of the line will be treated as \fIa2x\fR command\-line options\&. For example:
225
255
  .sp
@@ -45,9 +45,17 @@ OPTIONS
45
45
  document type is 'article' unless the format is 'manpage' (in which
46
46
  case it defaults to 'manpage').
47
47
 
48
+ *-b, --backend*='BACKEND'::
49
+ 'BACKEND' is the name of an installed backend plugin. When this
50
+ option is specified 'a2x' attempts load a file name 'a2x-backend.py'
51
+ from the 'BACKEND' plugin directory It then converts the
52
+ 'SOURCE_FILE' to a 'BACKEND' formatted output file using a global
53
+ function defined in 'a2x-backend.py' called 'to_BACKEND'.
54
+
48
55
  *-f, --format*='FORMAT'::
49
56
  Output formats: 'chunked', 'docbook', 'dvi', 'epub', 'htmlhelp',
50
57
  'manpage', 'pdf' (default), 'ps', 'tex', 'text', 'xhtml'.
58
+ The AsciiDoc 'a2x-format' attribute value is set to 'FORMAT'.
51
59
 
52
60
  *-h, --help*::
53
61
  Print command-line syntax and program options to stdout.
@@ -123,6 +131,10 @@ OPTIONS
123
131
  Additional 'dblatex(1)' options.
124
132
  This option may be specified more than once.
125
133
 
134
+ *--backend-opts*='BACKEND_OPTS'::
135
+ Options for the backend plugin specified by the '--backend' option.
136
+ This option may be specified more than once.
137
+
126
138
  Options can also be set in the AsciiDoc source file. If 'SOURCE_FILE'
127
139
  contains a comment line beginning with *// a2x:* then the remainder of
128
140
  the line will be treated as 'a2x' command-line options. For example:
Binary file
@@ -2,12 +2,12 @@
2
2
  .\" Title: asciidoc
3
3
  .\" Author: [see the "AUTHOR" section]
4
4
  .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
- .\" Date: 20 May 2011
5
+ .\" Date: 17 March 2012
6
6
  .\" Manual: \ \&
7
- .\" Source: \ \& 8.6.5
7
+ .\" Source: \ \& 8.6.7
8
8
  .\" Language: English
9
9
  .\"
10
- .TH "ASCIIDOC" "1" "20 May 2011" "\ \& 8\&.6\&.5" "\ \&"
10
+ .TH "ASCIIDOC" "1" "17 March 2012" "\ \& 8\&.6\&.7" "\ \&"
11
11
  .\" -----------------------------------------------------------------
12
12
  .\" * Define some portability stuff
13
13
  .\" -----------------------------------------------------------------
@@ -63,19 +63,24 @@ Backend output file format:
63
63
  \fIdocbook45\fR,
64
64
  \fIxhtml11\fR,
65
65
  \fIhtml4\fR,
66
+ \fIhtml5\fR,
67
+ \fIslidy\fR,
66
68
  \fIwordpress\fR
67
69
  or
68
70
  \fIlatex\fR
69
71
  (the
70
72
  \fIlatex\fR
71
- backend is experimental)\&. You can also the backend alias names
73
+ backend is experimental)\&. You can also use the backend alias names
72
74
  \fIhtml\fR
73
75
  (aliased to
74
76
  \fIxhtml11\fR) or
75
77
  \fIdocbook\fR
76
78
  (aliased to
77
79
  \fIdocbook45\fR)\&. Defaults to
78
- \fIhtml\fR\&.
80
+ \fIhtml\fR\&. The
81
+ \fB\-\-backend\fR
82
+ option is also used to manage backend plugins (see
83
+ \fBPLUGIN COMMANDS\fR)\&.
79
84
  .RE
80
85
  .PP
81
86
  \fB\-f, \-\-conf\-file\fR=\fICONF_FILE\fR
@@ -110,10 +115,12 @@ backend\&. Default document type is
110
115
  Dump configuration to stdout\&.
111
116
  .RE
112
117
  .PP
113
- \fB\-\-filter\fR
118
+ \fB\-\-filter\fR=\fIFILTER\fR
114
119
  .RS 4
115
- Manage asciidoc(1) filters (see
116
- \fBFILTER COMMANDS\fR)\&.
120
+ Specify the name of a filter to be loaded (used to load filters that are not auto\-loaded)\&. This option may be specified more than once\&. The
121
+ \fB\-\-filter\fR
122
+ option is also used to manage filter plugins (see
123
+ \fBPLUGIN COMMANDS\fR)\&.
117
124
  .RE
118
125
  .PP
119
126
  \fB\-h, \-\-help\fR [\fITOPIC\fR]
@@ -157,7 +164,7 @@ then the standard output is used\&.
157
164
  \fB\-n, \-\-section\-numbers\fR
158
165
  .RS 4
159
166
  Auto\-number HTML article section titles\&. Synonym for
160
- \fB\-a numbered\fR\&.
167
+ \fB\-\-attribute numbered\fR\&.
161
168
  .RE
162
169
  .PP
163
170
  \fB\-\-safe\fR
@@ -167,6 +174,15 @@ Enable safe mode\&. Safe mode is disabled by default\&. AsciiDoc
167
174
  skips potentially dangerous scripted sections in AsciiDoc source files\&.
168
175
  .RE
169
176
  .PP
177
+ \fB\-\-theme\fR=\fITHEME\fR
178
+ .RS 4
179
+ Specify a theme name\&. Synonym for
180
+ \fB\-\-attribute theme\fR=\fITHEME\fR\&. The
181
+ \fB\-\-theme\fR
182
+ option is also used to manage theme plugins (see
183
+ \fBPLUGIN COMMANDS\fR)\&.
184
+ .RE
185
+ .PP
170
186
  \fB\-v, \-\-verbose\fR
171
187
  .RS 4
172
188
  Verbosely print processing information and configuration file checks to stderr\&.
@@ -176,17 +192,18 @@ Verbosely print processing information and configuration file checks to stderr\&
176
192
  .RS 4
177
193
  Print program version number\&.
178
194
  .RE
179
- .SH "FILTER COMMANDS"
195
+ .SH "PLUGIN COMMANDS"
180
196
  .sp
181
- The \fB\-\-filter\fR option is used to install, remove and list AsciiDoc filter plugins\&. Filter commands syntax:
197
+ The asciidoc(1) \fB\-\-filter\fR, \fB\-\-backend\fR and \fB\-\-theme\fR options are used to install, remove and list AsciiDoc filter, backend and theme plugins\&. Syntax:
182
198
  .sp
183
199
  .if n \{\
184
200
  .RS 4
185
201
  .\}
186
202
  .nf
187
- asciidoc \-\-filter install ZIP_FILE [FILTERS_DIR]
188
- asciidoc \-\-filter remove FILTER_NAME [FILTERS_DIR]
189
- asciidoc \-\-filter list
203
+ asciidoc OPTION install ZIP_FILE [PLUGINS_DIR]
204
+ asciidoc OPTION remove PLUGIN_NAME [PLUGINS_DIR]
205
+ asciidoc OPTION list
206
+ asciidoc OPTION build ZIP_FILE PLUGIN_SOURCE
190
207
  .fi
191
208
  .if n \{\
192
209
  .RE
@@ -194,35 +211,54 @@ asciidoc \-\-filter list
194
211
  .sp
195
212
  Where:
196
213
  .PP
197
- \fBFILTER_NAME\fR
214
+ \fBOPTION\fR
215
+ .RS 4
216
+ asciidoc(1)
217
+ \fB\-\-filter\fR,
218
+ \fB\-\-backend\fR
219
+ or
220
+ \fB\-\-theme\fR
221
+ option specifying the type of plugin\&.
222
+ .RE
223
+ .PP
224
+ \fBPLUGIN_NAME\fR
198
225
  .RS 4
199
- A unique filter name containing only alphanumeric or underscore characters\&.
226
+ A unique plugin name containing only alphanumeric or underscore characters\&.
200
227
  .RE
201
228
  .PP
202
229
  \fBZIP_FILE\fR
203
230
  .RS 4
204
- A Zip file containing filter resources, the name must start with the filter name e\&.g\&.
231
+ A Zip file containing plugin resources, the name must start with the plugin name e\&.g\&.
205
232
  my_filter\-1\&.0\&.zip
206
233
  packages filter
207
234
  my_filter\&.
208
235
  .RE
209
236
  .PP
210
- \fBFILTERS_DIR\fR
237
+ \fBPLUGINS_DIR\fR
211
238
  .RS 4
212
- The directory containing installed filters\&. Each filter is contained in its own separate subdirectory which has the same name as the filter\&.
213
- \fBFILTERS_DIR\fR
239
+ The directory containing installed plugins\&. Each plugin is contained in its own separate subdirectory which has the same name as the plugin\&.
240
+ \fBPLUGINS_DIR\fR
214
241
  defaults to the
215
- \&.asciidoc/filters
216
- directory in the user\(cqs home directory\&.
242
+ $HOME/\&.asciidoc/filters
243
+ (for filter plugins) or
244
+ $HOME/\&.asciidoc/backends
245
+ (for backend plugins) or
246
+ $HOME/\&.asciidoc/themes
247
+ (for theme plugins)\&.
248
+ .RE
249
+ .PP
250
+ \fBPLUGIN_SOURCE\fR
251
+ .RS 4
252
+ The name of a directory containing the plugin source files or the name of a single source file\&.
217
253
  .RE
218
254
  .sp
219
- The filter commands perform as follows:
255
+ The plugin commands perform as follows:
220
256
  .PP
221
257
  \fBinstall\fR
222
258
  .RS 4
223
259
  Create a subdirectory in
224
- \fBFILTERS_DIR\fR
225
- with the same name as the filter then extract the
260
+ \fBPLUGINS_DIR\fR
261
+ with the same name as the plugin then extract the
226
262
  \fBZIP_FILE\fR
227
263
  into it\&.
228
264
  .RE
@@ -230,14 +266,22 @@ into it\&.
230
266
  \fBremove\fR
231
267
  .RS 4
232
268
  Delete the
233
- \fBFILTER_NAME\fR
234
- filter subdirectory and all its contents from the
235
- \fBFILTERS_DIR\fR\&.
269
+ \fBPLUGIN_NAME\fR
270
+ plugin subdirectory and all its contents from the
271
+ \fBPLUGINS_DIR\fR\&.
236
272
  .RE
237
273
  .PP
238
274
  \fBlist\fR
239
275
  .RS 4
240
- List the names and locations of all installed filters (including standard filters installed in the global configuration directory)\&.
276
+ List the names and locations of all installed filter or theme plugins (including standard plugins installed in the global configuration directory)\&.
277
+ .RE
278
+ .PP
279
+ \fBbuild\fR
280
+ .RS 4
281
+ Create a plugin file named
282
+ \fBZIP_FILE\fR
283
+ containing the files and subdirectories specified by
284
+ \fBPLUGIN_SOURCE\fR\&. File and directory names starting with a period are skipped\&.
241
285
  .RE
242
286
  .SH "EXIT STATUS"
243
287
  .PP
@@ -34,10 +34,11 @@ OPTIONS
34
34
 
35
35
  *-b, --backend*='BACKEND'::
36
36
  Backend output file format: 'docbook45', 'xhtml11', 'html4',
37
- 'wordpress' or 'latex' (the 'latex' backend is experimental).
38
- You can also the backend alias names 'html' (aliased to 'xhtml11')
39
- or 'docbook' (aliased to 'docbook45').
40
- Defaults to 'html'.
37
+ 'html5', 'slidy', 'wordpress' or 'latex' (the 'latex' backend is
38
+ experimental). You can also use the backend alias names 'html'
39
+ (aliased to 'xhtml11') or 'docbook' (aliased to 'docbook45').
40
+ Defaults to 'html'. The *--backend* option is also used to manage
41
+ backend plugins (see <<X1,*PLUGIN COMMANDS*>>).
41
42
 
42
43
  *-f, --conf-file*='CONF_FILE'::
43
44
  Use configuration file 'CONF_FILE'.Configuration files processed
@@ -55,8 +56,11 @@ OPTIONS
55
56
  *-c, --dump-conf*::
56
57
  Dump configuration to stdout.
57
58
 
58
- *--filter*::
59
- Manage asciidoc(1) filters (see <<X1,*FILTER COMMANDS*>>).
59
+ *--filter*='FILTER'::
60
+ Specify the name of a filter to be loaded (used to load filters
61
+ that are not auto-loaded). This option may be specified more than
62
+ once. The *--filter* option is also used to manage filter plugins
63
+ (see <<X1,*PLUGIN COMMANDS*>>).
60
64
 
61
65
  *-h, --help* ['TOPIC']::
62
66
  Print help TOPIC. *--help* 'topics' will print a list of help
@@ -78,14 +82,19 @@ OPTIONS
78
82
  standard output is used.
79
83
 
80
84
  *-n, --section-numbers*::
81
- Auto-number HTML article section titles. Synonym for *-a
82
- numbered*.
85
+ Auto-number HTML article section titles. Synonym for
86
+ *--attribute numbered*.
83
87
 
84
88
  *--safe*::
85
89
  Enable safe mode. Safe mode is disabled by default. AsciiDoc
86
90
  'safe mode' skips potentially dangerous scripted sections in
87
91
  AsciiDoc source files.
88
92
 
93
+ *--theme*='THEME'::
94
+ Specify a theme name. Synonym for *--attribute theme*='THEME'.
95
+ The *--theme* option is also used to manage theme plugins (see
96
+ <<X1,*PLUGIN COMMANDS*>>).
97
+
89
98
  *-v, --verbose*::
90
99
  Verbosely print processing information and configuration file
91
100
  checks to stderr.
@@ -95,45 +104,62 @@ OPTIONS
95
104
 
96
105
 
97
106
  [[X1]]
98
- FILTER COMMANDS
107
+ PLUGIN COMMANDS
99
108
  ---------------
100
- The *--filter* option is used to install, remove and list AsciiDoc
101
- filter plugins. Filter commands syntax:
109
+ The asciidoc(1) *--filter*, *--backend* and *--theme* options are used
110
+ to install, remove and list AsciiDoc filter, backend and theme
111
+ plugins. Syntax:
102
112
 
103
- asciidoc --filter install ZIP_FILE [FILTERS_DIR]
104
- asciidoc --filter remove FILTER_NAME [FILTERS_DIR]
105
- asciidoc --filter list
113
+ asciidoc OPTION install ZIP_FILE [PLUGINS_DIR]
114
+ asciidoc OPTION remove PLUGIN_NAME [PLUGINS_DIR]
115
+ asciidoc OPTION list
116
+ asciidoc OPTION build ZIP_FILE PLUGIN_SOURCE
106
117
 
107
118
  Where:
108
119
 
109
- *FILTER_NAME*::
110
- A unique filter name containing only alphanumeric or underscore
120
+ *OPTION*::
121
+ asciidoc(1) *--filter*, *--backend* or *--theme* option specifying
122
+ the type of plugin.
123
+
124
+ *PLUGIN_NAME*::
125
+ A unique plugin name containing only alphanumeric or underscore
111
126
  characters.
112
127
 
113
128
  *ZIP_FILE*::
114
- A Zip file containing filter resources, the name must start with the
115
- filter name e.g. `my_filter-1.0.zip` packages filter `my_filter`.
129
+ A Zip file containing plugin resources, the name must start with the
130
+ plugin name e.g. `my_filter-1.0.zip` packages filter `my_filter`.
116
131
 
117
- *FILTERS_DIR*::
118
- The directory containing installed filters. Each filter is contained
132
+ *PLUGINS_DIR*::
133
+ The directory containing installed plugins. Each plugin is contained
119
134
  in its own separate subdirectory which has the same name as the
120
- filter.
121
- *FILTERS_DIR* defaults to the `.asciidoc/filters` directory in the
122
- user's home directory.
135
+ plugin.
136
+ *PLUGINS_DIR* defaults to the `$HOME/.asciidoc/filters` (for
137
+ filter plugins) or `$HOME/.asciidoc/backends` (for backend plugins) or
138
+ `$HOME/.asciidoc/themes` (for theme plugins).
139
+
140
+ *PLUGIN_SOURCE*::
141
+ The name of a directory containing the plugin source files or the
142
+ name of a single source file.
123
143
 
124
- The filter commands perform as follows:
144
+ The plugin commands perform as follows:
125
145
 
126
146
  *install*::
127
- Create a subdirectory in *FILTERS_DIR* with the same name as the
128
- filter then extract the *ZIP_FILE* into it.
147
+ Create a subdirectory in *PLUGINS_DIR* with the same name as the
148
+ plugin then extract the *ZIP_FILE* into it.
129
149
 
130
150
  *remove*::
131
- Delete the *FILTER_NAME* filter subdirectory and all its contents from
132
- the *FILTERS_DIR*.
151
+ Delete the *PLUGIN_NAME* plugin subdirectory and all its contents
152
+ from the *PLUGINS_DIR*.
133
153
 
134
154
  *list*::
135
- List the names and locations of all installed filters (including
136
- standard filters installed in the global configuration directory).
155
+ List the names and locations of all installed filter or theme
156
+ plugins (including standard plugins installed in the global
157
+ configuration directory).
158
+
159
+ *build*::
160
+ Create a plugin file named *ZIP_FILE* containing the files and
161
+ subdirectories specified by *PLUGIN_SOURCE*. File and directory
162
+ names starting with a period are skipped.
137
163
 
138
164
 
139
165
  EXIT STATUS