FooBarWidget-mizuho 0.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (175) hide show
  1. data/LICENSE.txt +20 -0
  2. data/README.markdown +68 -0
  3. data/Rakefile +9 -0
  4. data/asciidoc/BUGS +34 -0
  5. data/asciidoc/BUGS.txt +28 -0
  6. data/asciidoc/CHANGELOG +1585 -0
  7. data/asciidoc/CHANGELOG.txt +1595 -0
  8. data/asciidoc/COPYING +339 -0
  9. data/asciidoc/COPYRIGHT +18 -0
  10. data/asciidoc/INSTALL +82 -0
  11. data/asciidoc/INSTALL.txt +71 -0
  12. data/asciidoc/README +46 -0
  13. data/asciidoc/README.txt +36 -0
  14. data/asciidoc/a2x +641 -0
  15. data/asciidoc/asciidoc.conf +404 -0
  16. data/asciidoc/asciidoc.py +4255 -0
  17. data/asciidoc/common.aap +9 -0
  18. data/asciidoc/dblatex/asciidoc-dblatex.sty +18 -0
  19. data/asciidoc/dblatex/asciidoc-dblatex.xsl +17 -0
  20. data/asciidoc/dblatex/dblatex-readme.txt +22 -0
  21. data/asciidoc/doc/a2x.1 +246 -0
  22. data/asciidoc/doc/a2x.1.txt +195 -0
  23. data/asciidoc/doc/article.css-embedded.html +579 -0
  24. data/asciidoc/doc/article.html +62 -0
  25. data/asciidoc/doc/article.pdf +0 -0
  26. data/asciidoc/doc/article.txt +124 -0
  27. data/asciidoc/doc/asciidoc-revhistory.xml +27 -0
  28. data/asciidoc/doc/asciidoc.1 +161 -0
  29. data/asciidoc/doc/asciidoc.1.css-embedded.html +562 -0
  30. data/asciidoc/doc/asciidoc.1.css.html +212 -0
  31. data/asciidoc/doc/asciidoc.1.html +190 -0
  32. data/asciidoc/doc/asciidoc.1.txt +118 -0
  33. data/asciidoc/doc/asciidoc.conf +8 -0
  34. data/asciidoc/doc/asciidoc.css-embedded.html +7954 -0
  35. data/asciidoc/doc/asciidoc.css.html +7553 -0
  36. data/asciidoc/doc/asciidoc.dict +673 -0
  37. data/asciidoc/doc/asciidoc.html +3502 -0
  38. data/asciidoc/doc/asciidoc.txt +4757 -0
  39. data/asciidoc/doc/asciimath.txt +47 -0
  40. data/asciidoc/doc/book-multi.css-embedded.html +575 -0
  41. data/asciidoc/doc/book-multi.html +72 -0
  42. data/asciidoc/doc/book-multi.txt +159 -0
  43. data/asciidoc/doc/book.css-embedded.html +585 -0
  44. data/asciidoc/doc/book.html +60 -0
  45. data/asciidoc/doc/book.txt +133 -0
  46. data/asciidoc/doc/customers.csv +18 -0
  47. data/asciidoc/doc/faq.txt +262 -0
  48. data/asciidoc/doc/latex-backend.html +224 -0
  49. data/asciidoc/doc/latex-backend.txt +193 -0
  50. data/asciidoc/doc/latexmath.txt +35 -0
  51. data/asciidoc/doc/main.aap +293 -0
  52. data/asciidoc/doc/music-filter.html +513 -0
  53. data/asciidoc/doc/music-filter.pdf +0 -0
  54. data/asciidoc/doc/music-filter.txt +158 -0
  55. data/asciidoc/doc/source-highlight-filter.html +183 -0
  56. data/asciidoc/doc/source-highlight-filter.pdf +0 -0
  57. data/asciidoc/doc/source-highlight-filter.txt +174 -0
  58. data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +71 -0
  59. data/asciidoc/docbook-xsl/chunked.xsl +19 -0
  60. data/asciidoc/docbook-xsl/common.xsl +67 -0
  61. data/asciidoc/docbook-xsl/fo.xsl +117 -0
  62. data/asciidoc/docbook-xsl/htmlhelp.xsl +17 -0
  63. data/asciidoc/docbook-xsl/manpage.xsl +28 -0
  64. data/asciidoc/docbook-xsl/shaded-literallayout.patch +32 -0
  65. data/asciidoc/docbook-xsl/xhtml.xsl +14 -0
  66. data/asciidoc/docbook.conf +606 -0
  67. data/asciidoc/examples/website/CHANGELOG.html +3828 -0
  68. data/asciidoc/examples/website/INSTALL.html +163 -0
  69. data/asciidoc/examples/website/README-website.html +129 -0
  70. data/asciidoc/examples/website/README-website.txt +29 -0
  71. data/asciidoc/examples/website/README.html +125 -0
  72. data/asciidoc/examples/website/a2x.1.html +395 -0
  73. data/asciidoc/examples/website/asciidoc-docbook-xsl.html +165 -0
  74. data/asciidoc/examples/website/asciimath.html +157 -0
  75. data/asciidoc/examples/website/build-website.sh +25 -0
  76. data/asciidoc/examples/website/downloads.html +219 -0
  77. data/asciidoc/examples/website/downloads.txt +98 -0
  78. data/asciidoc/examples/website/faq.html +372 -0
  79. data/asciidoc/examples/website/index.html +398 -0
  80. data/asciidoc/examples/website/index.txt +222 -0
  81. data/asciidoc/examples/website/latex-backend.html +640 -0
  82. data/asciidoc/examples/website/latexmath.html +119 -0
  83. data/asciidoc/examples/website/layout1.conf +161 -0
  84. data/asciidoc/examples/website/layout1.css +65 -0
  85. data/asciidoc/examples/website/layout2.conf +158 -0
  86. data/asciidoc/examples/website/layout2.css +93 -0
  87. data/asciidoc/examples/website/manpage.html +266 -0
  88. data/asciidoc/examples/website/music-filter.html +242 -0
  89. data/asciidoc/examples/website/music1.abc +12 -0
  90. data/asciidoc/examples/website/music1.png +0 -0
  91. data/asciidoc/examples/website/music2.ly +9 -0
  92. data/asciidoc/examples/website/music2.png +0 -0
  93. data/asciidoc/examples/website/source-highlight-filter.html +251 -0
  94. data/asciidoc/examples/website/support.html +78 -0
  95. data/asciidoc/examples/website/support.txt +5 -0
  96. data/asciidoc/examples/website/userguide.html +7597 -0
  97. data/asciidoc/examples/website/version9.html +143 -0
  98. data/asciidoc/examples/website/version9.txt +48 -0
  99. data/asciidoc/filters/code-filter-readme.txt +37 -0
  100. data/asciidoc/filters/code-filter-test-c++.txt +7 -0
  101. data/asciidoc/filters/code-filter-test.txt +15 -0
  102. data/asciidoc/filters/code-filter.conf +8 -0
  103. data/asciidoc/filters/code-filter.py +239 -0
  104. data/asciidoc/filters/music-filter-test.txt +40 -0
  105. data/asciidoc/filters/music-filter.conf +40 -0
  106. data/asciidoc/filters/music2png.py +189 -0
  107. data/asciidoc/filters/source-highlight-filter-test.txt +19 -0
  108. data/asciidoc/filters/source-highlight-filter.conf +100 -0
  109. data/asciidoc/help.conf +213 -0
  110. data/asciidoc/html4.conf +363 -0
  111. data/asciidoc/images/highlighter.png +0 -0
  112. data/asciidoc/images/icons/README +5 -0
  113. data/asciidoc/images/icons/callouts/1.png +0 -0
  114. data/asciidoc/images/icons/callouts/10.png +0 -0
  115. data/asciidoc/images/icons/callouts/11.png +0 -0
  116. data/asciidoc/images/icons/callouts/12.png +0 -0
  117. data/asciidoc/images/icons/callouts/13.png +0 -0
  118. data/asciidoc/images/icons/callouts/14.png +0 -0
  119. data/asciidoc/images/icons/callouts/15.png +0 -0
  120. data/asciidoc/images/icons/callouts/2.png +0 -0
  121. data/asciidoc/images/icons/callouts/3.png +0 -0
  122. data/asciidoc/images/icons/callouts/4.png +0 -0
  123. data/asciidoc/images/icons/callouts/5.png +0 -0
  124. data/asciidoc/images/icons/callouts/6.png +0 -0
  125. data/asciidoc/images/icons/callouts/7.png +0 -0
  126. data/asciidoc/images/icons/callouts/8.png +0 -0
  127. data/asciidoc/images/icons/callouts/9.png +0 -0
  128. data/asciidoc/images/icons/caution.png +0 -0
  129. data/asciidoc/images/icons/example.png +0 -0
  130. data/asciidoc/images/icons/home.png +0 -0
  131. data/asciidoc/images/icons/important.png +0 -0
  132. data/asciidoc/images/icons/next.png +0 -0
  133. data/asciidoc/images/icons/note.png +0 -0
  134. data/asciidoc/images/icons/prev.png +0 -0
  135. data/asciidoc/images/icons/tip.png +0 -0
  136. data/asciidoc/images/icons/up.png +0 -0
  137. data/asciidoc/images/icons/warning.png +0 -0
  138. data/asciidoc/images/smallnew.png +0 -0
  139. data/asciidoc/images/tiger.png +0 -0
  140. data/asciidoc/install.sh +55 -0
  141. data/asciidoc/javascripts/ASCIIMathML.js +938 -0
  142. data/asciidoc/javascripts/LaTeXMathML.js +1223 -0
  143. data/asciidoc/javascripts/toc.js +69 -0
  144. data/asciidoc/lang-es.conf +15 -0
  145. data/asciidoc/latex.conf +663 -0
  146. data/asciidoc/linuxdoc.conf +285 -0
  147. data/asciidoc/math.conf +50 -0
  148. data/asciidoc/stylesheets/docbook-xsl.css +271 -0
  149. data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +21 -0
  150. data/asciidoc/stylesheets/xhtml-deprecated.css +247 -0
  151. data/asciidoc/stylesheets/xhtml11-manpage.css +18 -0
  152. data/asciidoc/stylesheets/xhtml11-quirks.css +49 -0
  153. data/asciidoc/stylesheets/xhtml11.css +284 -0
  154. data/asciidoc/t.conf +20 -0
  155. data/asciidoc/text.conf +16 -0
  156. data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +53 -0
  157. data/asciidoc/vim/syntax/asciidoc.vim +139 -0
  158. data/asciidoc/xhtml-deprecated-css.conf +235 -0
  159. data/asciidoc/xhtml-deprecated.conf +351 -0
  160. data/asciidoc/xhtml11-quirks.conf +57 -0
  161. data/asciidoc/xhtml11.conf +514 -0
  162. data/bin/mizuho +40 -0
  163. data/lib/mizuho/chapter.rb +54 -0
  164. data/lib/mizuho/generator.rb +106 -0
  165. data/lib/mizuho/heading.rb +46 -0
  166. data/lib/mizuho/parser.rb +99 -0
  167. data/lib/mizuho/template.rb +50 -0
  168. data/mizuho.gemspec +34 -0
  169. data/templates/asciidoc.css +358 -0
  170. data/templates/asciidoc.html.erb +86 -0
  171. data/templates/manualsonrails.css +165 -0
  172. data/templates/manualsonrails.html.erb +97 -0
  173. data/test/parser_spec.rb +190 -0
  174. data/test/spec_helper.rb +43 -0
  175. metadata +234 -0
@@ -0,0 +1,40 @@
1
+ Music Filter Test
2
+ =================
3
+
4
+ Details of the filter can be found in `./doc/music-filter.txt`.
5
+
6
+
7
+ A tune generated from ABC notation
8
+ ----------------------------------
9
+
10
+ [music,music1.png]
11
+ ---------------------------------------------------------------------
12
+ T:The Butterfly
13
+ R:slip jig
14
+ C:Tommy Potts
15
+ H:Fiddle player Tommy Potts made this tune from two older slip jigs,
16
+ H:one of which is called "Skin the Peelers" in Roche's collection.
17
+ D:Bothy Band: 1975.
18
+ M:9/8
19
+ K:Em
20
+ vB2(E G2)(E F3)|B2(E G2)(E F)ED|vB2(E G2)(E F3)|(B2d) d2(uB A)FD:|
21
+ |:(vB2c) (e2f) g3|(uB2d) (g2e) (dBA)|(B2c) (e2f) g2(ua|b2a) (g2e) (dBA):|
22
+ |:~B3 (B2A) G2A|~B3 BA(uB d)BA|~B3 (B2A) G2(A|B2d) (g2e) (dBA):|
23
+ ---------------------------------------------------------------------
24
+
25
+
26
+ A fragment generated from LilyPond source
27
+ ------------------------------------------
28
+
29
+ ["music", "music2.png", "ly", link="music2.ly"]
30
+ ---------------------------------------------------------------------
31
+ \version "2.10.0"
32
+ \paper {
33
+ ragged-right = ##t
34
+ }
35
+ {
36
+ \time 3/4
37
+ \clef bass
38
+ c2 e4 g2. f4 e d c2 r4
39
+ }
40
+ ---------------------------------------------------------------------
@@ -0,0 +1,40 @@
1
+ #
2
+ # AsciiDoc music filter configuration file.
3
+ #
4
+ # Documented in music-filter.txt in AsciiDoc distribution
5
+ # ./examples/website/ directory.
6
+ #
7
+
8
+ [blockdef-listing]
9
+ music-style=template="music-block",subs=(),posattrs=("style","target","format"),filter='music2png.py {verbose?-v} -m -f {format=abc} -o "{outdir}/{target}" -'
10
+
11
+ ifdef::basebackend-html[]
12
+ [music-block]
13
+ <div class="musicblock">
14
+ <a id="{id}"></a>
15
+ <div class="title">{title}</div>
16
+ <div class="content">
17
+ <a href="{link}">
18
+ <img style="border-width: 0;" src="{target}" alt="{target}"{width? width="{width}"}{height? height="{height}"} />
19
+ {link#}</a>
20
+ </div></div>
21
+ endif::basebackend-html[]
22
+
23
+ ifdef::basebackend-docbook[]
24
+ [music-block]
25
+ template::[image-blockmacro]
26
+ endif::basebackend-docbook[]
27
+
28
+
29
+ #
30
+ # DEPRECATED: Pre 8.2.7 filter definition.
31
+ #
32
+ [blockdef-music]
33
+ delimiter=^music~{4,}$
34
+ template=music-block
35
+ presubs=none
36
+ filter=music2png.py {verbose?-v} -m -f {format=abc} -o "{outdir}/{target}" -
37
+ posattrs=target,format
38
+ #
39
+ # DEPRECATED: End
40
+ #
@@ -0,0 +1,189 @@
1
+ #!/usr/bin/env python
2
+ '''
3
+ NAME
4
+ music2png - Converts textual music notation to classically notated PNG file
5
+
6
+ SYNOPSIS
7
+ music2png [options] INFILE
8
+
9
+ DESCRIPTION
10
+ This filter reads LilyPond or ABC music notation text from the input file
11
+ INFILE (or stdin if INFILE is -), converts it to classical music notation
12
+ and writes it to a trimmed PNG image file.
13
+
14
+ This script is a wrapper for LilyPond and ImageMagick commands.
15
+
16
+ OPTIONS
17
+ -f FORMAT
18
+ The INFILE music format. 'abc' for ABC notation, 'ly' for LilyPond
19
+ notation.
20
+
21
+ -o OUTFILE
22
+ The file name of the output file. If not specified the output file is
23
+ named like INFILE but with a .png file name extension.
24
+
25
+ -m
26
+ Skip if the PNG output file is newer that than the INFILE. When
27
+ INFILE is - (stdin) previously retained input is compared.
28
+
29
+ -v
30
+ Verbosely print processing information to stderr.
31
+
32
+ --help, -h
33
+ Print this documentation.
34
+
35
+ --version
36
+ Print program version number.
37
+
38
+ SEE ALSO
39
+ lilypond(1), abc2ly(1), convert(1)
40
+
41
+ AUTHOR
42
+ Written by Stuart Rackham, <srackham@gmail.com>
43
+
44
+ COPYING
45
+ Copyright (C) 2006 Stuart Rackham. Free use of this software is
46
+ granted under the terms of the GNU General Public License (GPL).
47
+ '''
48
+
49
+ import os, sys
50
+
51
+ VERSION = '0.1.0'
52
+
53
+ # Globals.
54
+ verbose = False
55
+
56
+ class EApp(Exception): pass # Application specific exception.
57
+
58
+ def print_stderr(line):
59
+ sys.stderr.write(line + os.linesep)
60
+
61
+ def print_verbose(line):
62
+ if verbose:
63
+ print_stderr(line)
64
+
65
+ def run(cmd):
66
+ global verbose
67
+ if not verbose:
68
+ cmd += ' 2>/dev/null'
69
+ print_verbose('executing: %s' % cmd)
70
+ if os.system(cmd):
71
+ raise EApp, 'failed command: %s' % cmd
72
+
73
+ def music2png(format, infile, outfile, modified):
74
+ '''Convert ABC notation in file infile to cropped PNG file named outfile.'''
75
+ outfile = os.path.abspath(outfile)
76
+ outdir = os.path.dirname(outfile)
77
+ if not os.path.isdir(outdir):
78
+ raise EApp, 'directory does not exist: %s' % outdir
79
+ basefile = os.path.splitext(outfile)[0]
80
+ abc = basefile + '.abc'
81
+ ly = basefile + '.ly'
82
+ temps = [ basefile + ext for ext in ('.abc', '.ly', '.ps', '.midi') ]
83
+ # Don't delete files that already exist.
84
+ temps = [ f for f in temps if not os.path.exists(f) ]
85
+ skip = False
86
+ if infile == '-':
87
+ lines = sys.stdin.readlines()
88
+ if format == 'abc':
89
+ f = abc
90
+ else:
91
+ f = ly
92
+ if modified:
93
+ if f in temps:
94
+ del temps[temps.index(f)] # Don't delete previous source.
95
+ if os.path.isfile(outfile) and os.path.isfile(f):
96
+ old = open(f, 'r').readlines()
97
+ skip = lines == old
98
+ if not skip:
99
+ open(f, 'w').writelines(lines)
100
+ else:
101
+ if not os.path.isfile(infile):
102
+ raise EApp, 'input file does not exist: %s' % infile
103
+ if modified and os.path.isfile(outfile):
104
+ skip = os.path.getmtime(infile) <= os.path.getmtime(outfile)
105
+ if skip:
106
+ print_verbose('skipped: no change: %s' % outfile)
107
+ return
108
+ saved_pwd = os.getcwd()
109
+ os.chdir(outdir)
110
+ try:
111
+ if format == 'abc':
112
+ run('abc2ly --beams=None "%s"' % abc)
113
+ run('lilypond --png "%s"' % ly)
114
+ finally:
115
+ os.chdir(saved_pwd)
116
+ # Chop the bottom 75 pixels off to get rid of the page footer.
117
+ run('convert "%s" -gravity South -crop 1000x10000+0+75 "%s"' % (outfile, outfile))
118
+ # Trim all blank areas from sides, top and bottom.
119
+ run('convert "%s" -trim "%s"' % (outfile, outfile))
120
+ for f in temps:
121
+ if os.path.isfile(f):
122
+ print_verbose('deleting: %s' % f)
123
+ os.remove(f)
124
+
125
+ def usage(msg=''):
126
+ if msg:
127
+ print_stderr(msg)
128
+ print_stderr('\n'
129
+ 'usage:\n'
130
+ ' music2png [options] INFILE\n'
131
+ '\n'
132
+ 'options:\n'
133
+ ' -f FORMAT\n'
134
+ ' -o OUTFILE\n'
135
+ ' -m\n'
136
+ ' -v\n'
137
+ ' --help\n'
138
+ ' --version')
139
+
140
+ def main():
141
+ # Process command line options.
142
+ global verbose
143
+ format = None
144
+ outfile = None
145
+ modified = False
146
+ import getopt
147
+ opts,args = getopt.getopt(sys.argv[1:], 'f:o:mhv', ['help','version'])
148
+ for o,v in opts:
149
+ if o in ('--help','-h'):
150
+ print __doc__
151
+ sys.exit(0)
152
+ if o =='--version':
153
+ print('music2png version %s' % (VERSION,))
154
+ sys.exit(0)
155
+ if o == '-f': format = v
156
+ if o == '-o': outfile = v
157
+ if o == '-m': modified = True
158
+ if o == '-v': verbose = True
159
+ if len(args) != 1:
160
+ usage()
161
+ sys.exit(1)
162
+ infile = args[0]
163
+ if format is None:
164
+ usage('FORMAT must be specified')
165
+ sys.exit(1)
166
+ if format not in ('abc', 'ly'):
167
+ usage('invalid FORMAT')
168
+ sys.exit(1)
169
+ if outfile is None:
170
+ if infile == '-':
171
+ usage('OUTFILE must be specified')
172
+ sys.exit(1)
173
+ outfile = os.path.splitext(infile)[0] + '.png'
174
+ # Do the work.
175
+ music2png(format, infile, outfile, modified)
176
+ # Print something to suppress asciidoc 'no output from filter' warnings.
177
+ if infile == '-':
178
+ sys.stdout.write(' ')
179
+
180
+ if __name__ == "__main__":
181
+ try:
182
+ main()
183
+ except SystemExit:
184
+ raise
185
+ except KeyboardInterrupt:
186
+ sys.exit(1)
187
+ except Exception, e:
188
+ print_stderr("%s: %s" % (os.path.basename(sys.argv[0]), str(e)))
189
+ sys.exit(1)
@@ -0,0 +1,19 @@
1
+ Source Hightlight Filter Test
2
+ =============================
3
+
4
+ Details of the filter can be found in
5
+ `./doc/source-highlight-filter.txt`.
6
+
7
+ [source,python]
8
+ ---------------------------------------------------------------------
9
+ ''' A multi-line
10
+ comment.'''
11
+ def sub_word(mo):
12
+ ''' Single line comment.'''
13
+ word = mo.group('word') # Inline comment
14
+ if word in keywords[language]:
15
+ return quote + word + quote
16
+ else:
17
+ return word
18
+ ---------------------------------------------------------------------
19
+
@@ -0,0 +1,100 @@
1
+ #
2
+ # AsciiDoc source code highlight filter configuration file.
3
+ #
4
+ # Documented in source-hightlight-filter.txt in AsciiDoc distribution
5
+ # ./examples/website/ directory.
6
+ #
7
+ # HTML outputs require GNU source-highlight
8
+ # http://www.gnu.org/software/src-highlite/source-highlight.html
9
+ #
10
+
11
+ ########################
12
+ # Source block templates
13
+ ########################
14
+ [source-highlight-block]
15
+ template::[listingblock]
16
+
17
+ # Customized listingblock block for xhtml11 to ensure valid XHTML1.1.
18
+ ifdef::backend-xhtml11[]
19
+ [source-highlight-block]
20
+ <div class="listingblock">
21
+ <a id="{id}"></a>
22
+ <div class="title">{caption=Example: }{title}</div>
23
+ <div class="content">
24
+ |
25
+ </div></div>
26
+ endif::backend-xhtml11[]
27
+
28
+ # Use DocBook programlisting element.
29
+ ifdef::backend-docbook[]
30
+ [source-highlight-block]
31
+ <programlisting language="{language}" linenumbering="{src_numbered=unnumbered}">
32
+ <![CDATA[
33
+ |
34
+ ]]>
35
+ </programlisting>
36
+ endif::backend-docbook[]
37
+
38
+ #########################
39
+ # Source paragraph styles
40
+ #########################
41
+ [paradef-default]
42
+ ifdef::backend-html4[]
43
+ source-style=template="passthroughblock",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}}"
44
+ endif::backend-html4[]
45
+
46
+ ifdef::backend-xhtml11[]
47
+ source-style=template="exampleblock",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}}"
48
+ endif::backend-xhtml11[]
49
+
50
+ ifdef::backend-docbook[]
51
+ source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered","src_tab"),filter=""
52
+ endif::backend-docbook[]
53
+
54
+ #########################
55
+ # Source block styles
56
+ #########################
57
+ [blockdef-listing]
58
+ ifdef::backend-html4[]
59
+ 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}}"
60
+ endif::backend-html4[]
61
+
62
+ ifdef::backend-xhtml11[]
63
+ 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}}"
64
+ endif::backend-xhtml11[]
65
+
66
+ ifdef::backend-docbook[]
67
+ source-style=template="source-highlight-block",presubs=(),postsubs=("callouts",),posattrs=("style","language","src_numbered","src_tab"),filter=""
68
+ endif::backend-docbook[]
69
+
70
+
71
+ #
72
+ # DEPRECATED: Pre 8.2.7 filter definition.
73
+ #
74
+
75
+ #########################
76
+ # Source block definition
77
+ #########################
78
+ [blockdef-source-highlight]
79
+ # The old ^ delimiter is for backward compatibility, may be removed from
80
+ # in future versions.
81
+ delimiter=(^source~{4,}$)|(^\^{4,}$)
82
+ template=source-highlight-block
83
+ presubs=none
84
+ postsubs=callouts
85
+ posattrs=language,src_numbered,src_tab
86
+
87
+ ifndef::backend-docbook[]
88
+ # GNU Source Highlight filter.
89
+ filter=source-highlight -f {backend-xhtml11?xhtml}{backend-html4?html}{backend-docbook?docbook} -s {language} {src_numbered?--line-number} {src_tab?--tab={src_tab}}
90
+ endif::backend-docbook[]
91
+
92
+ ifdef::backend-docbook[]
93
+ # In the case of DocBook just pass the listing through and let the DocBook
94
+ # toolchain handle it.
95
+ filter=
96
+ endif::backend-docbook[]
97
+
98
+ #
99
+ # DEPRECATED: End
100
+ #
@@ -0,0 +1,213 @@
1
+ # AsciiDoc help file.
2
+ #
3
+ # INI section format, each section contains a topic.
4
+ # Displayed with 'asciidoc --help sectionname' command.
5
+ #
6
+
7
+ #
8
+ # Default help topic.
9
+ #
10
+ [default]
11
+
12
+ Man page: asciidoc --help manpage
13
+ Syntax: asciidoc --help syntax
14
+
15
+ [manpage]
16
+
17
+
18
+ NAME
19
+
20
+ asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
21
+
22
+ SYNOPSIS
23
+
24
+ asciidoc [OPTIONS] FILE
25
+
26
+ DESCRIPTION
27
+
28
+ The asciidoc(1) command translates the AsciiDoc text file FILE to a
29
+ DocBook, HTML or LinuxDoc file. If FILE is - then the standard input is
30
+ used.
31
+
32
+ OPTIONS
33
+
34
+ -a, --attribute=ATTRIBUTE
35
+ Define or delete document attribute. ATTRIBUTE is formatted like
36
+ NAME=VALUE. Command-line attributes take precedence over
37
+ document and configuration file attributes. Alternate acceptable
38
+ forms are NAME (the VALUE defaults to an empty string); NAME!
39
+ (delete the NAME attribute); NAME@ (do not override document or
40
+ configuration file attributes). Values containing spaces should
41
+ be enclosed in double-quote characters. This option may be
42
+ specified more than once.
43
+
44
+ -b, --backend=BACKEND
45
+ Backend output file format: docbook, xhtml11 or html4. Defaults
46
+ to xhtml11.
47
+
48
+ -f, --conf-file=CONF_FILE
49
+ Use configuration file CONF_FILE.Configuration files processed
50
+ in command-line order (after implicit configuration files). This
51
+ option may be specified more than once.
52
+
53
+ -d, --doctype=DOCTYPE
54
+ Document type: article, manpage or book. The book document type
55
+ is only supported by the docbook backend. Default document type
56
+ is article.
57
+
58
+ -c, --dump-conf
59
+ Dump configuration to stdout.
60
+
61
+ -h, --help[=TOPIC]
62
+ Print help TOPIC. --help=topics will print a list of help
63
+ topics, --help=syntax summarizes AsciiDoc syntax, --help=manpage
64
+ prints the AsciiDoc manpage.
65
+
66
+ -e, --no-conf
67
+ Exclude implicitly loaded configuration files except for those
68
+ named like the input file (infile.conf and infile-backend.conf).
69
+
70
+ -s, --no-header-footer
71
+ Suppress document header and footer output.
72
+
73
+ -o, --out-file=OUT_FILE
74
+ Write output to file OUT_FILE. Defaults to the base name of
75
+ input file with backend extension. If the input is stdin then
76
+ the outfile defaults to stdout. If OUT_FILE is - then the
77
+ standard output is used.
78
+
79
+ -n, --section-numbers
80
+ Auto-number HTML article section titles. Synonym for -a
81
+ numbered.
82
+
83
+ --unsafe
84
+ Disable safe mode. Safe mode is enabled by default, disabling it
85
+ is potentially dangerous.
86
+
87
+ -v, --verbose
88
+ Verbosely print processing information and configuration file
89
+ checks to stderr.
90
+
91
+ --version
92
+ Print program version number.
93
+
94
+ EXIT STATUS
95
+
96
+ 0
97
+ Success
98
+
99
+ 1
100
+ Failure (syntax or usage error; configuration error; document
101
+ processing failure; unexpected error).
102
+
103
+ BUGS
104
+
105
+ See the AsciiDoc distribution BUGS file.
106
+
107
+ AUTHOR
108
+
109
+ Written by Stuart Rackham, <srackham@gmail.com>
110
+
111
+ RESOURCES
112
+
113
+ SourceForge: http://sourceforge.net/projects/asciidoc/
114
+
115
+ Main web site: http://www.methods.co.nz/asciidoc/
116
+
117
+ COPYING
118
+
119
+ Copyright (C) 2002-2008 Stuart Rackham. Free use of this software is
120
+ granted under the terms of the GNU General Public License (GPL).
121
+
122
+ [syntax]
123
+
124
+ AsciiDoc Markup Syntax Summary
125
+ ==============================
126
+
127
+ A summary of the most often used markup.
128
+ For a complete reference see the 'AsciiDoc User Guide'.
129
+
130
+ Text formatting
131
+ ---------------
132
+ *bold text* (boldface font)
133
+ _emphasized text_ (normally italics)
134
+ 'emphasized text'
135
+ +monospaced text+ (proportional font)
136
+ `monospaced text`
137
+
138
+ Document links
139
+ --------------
140
+ [[id]] (define link target)
141
+ <<id,caption>> (link to target id)
142
+ link:filename#id[caption] (link to external HTML file)
143
+
144
+ URLs
145
+ ----
146
+ Use normal URL and email addess syntax or:
147
+
148
+ http:address[caption] (link to web page)
149
+ mailto:address[caption] (link to mail recipient)
150
+
151
+ Images
152
+ ------
153
+ image:filename[caption] (inline image)
154
+ image::filename[caption] (block image)
155
+
156
+ Document header
157
+ ---------------
158
+
159
+ The Document Title
160
+ ==================
161
+ author <email> (optional)
162
+ revision, date (optional)
163
+
164
+ Section title underlines
165
+ ------------------------
166
+ Level 0 (document title): ======================
167
+ Level 1: ----------------------
168
+ Level 2: ~~~~~~~~~~~~~~~~~~~~~~
169
+ Level 3: ^^^^^^^^^^^^^^^^^^^^^^
170
+ Level 4 (bottom level): ++++++++++++++++++++++
171
+
172
+ Delimited blocks
173
+ ----------------
174
+ Delimiters must begin at left margin.
175
+
176
+ -------------------
177
+ listing block
178
+ -------------------
179
+
180
+ ...................
181
+ literal block
182
+ ...................
183
+
184
+ *******************
185
+ sidebar block
186
+ *******************
187
+
188
+ [style, author, cite] (optional)
189
+ ___________________
190
+ quote block
191
+ ___________________
192
+
193
+ ===================
194
+ example block
195
+ ===================
196
+
197
+ ///////////////////
198
+ comment block
199
+ ///////////////////
200
+
201
+ More block elements
202
+ -------------------
203
+ [attributes list] (Note 1)
204
+ .Block title (Note 1)
205
+ // Comment line (Note 1)
206
+ include::filename[] (Note 1)
207
+
208
+ Note 1: Begin at the left margin.
209
+
210
+ More inline elements
211
+ --------------------
212
+ footnote:[footnote text] (document footnote)
213
+