FooBarWidget-mizuho 0.9.0
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE.txt +20 -0
- data/README.markdown +68 -0
- data/Rakefile +9 -0
- data/asciidoc/BUGS +34 -0
- data/asciidoc/BUGS.txt +28 -0
- data/asciidoc/CHANGELOG +1585 -0
- data/asciidoc/CHANGELOG.txt +1595 -0
- data/asciidoc/COPYING +339 -0
- data/asciidoc/COPYRIGHT +18 -0
- data/asciidoc/INSTALL +82 -0
- data/asciidoc/INSTALL.txt +71 -0
- data/asciidoc/README +46 -0
- data/asciidoc/README.txt +36 -0
- data/asciidoc/a2x +641 -0
- data/asciidoc/asciidoc.conf +404 -0
- data/asciidoc/asciidoc.py +4255 -0
- data/asciidoc/common.aap +9 -0
- data/asciidoc/dblatex/asciidoc-dblatex.sty +18 -0
- data/asciidoc/dblatex/asciidoc-dblatex.xsl +17 -0
- data/asciidoc/dblatex/dblatex-readme.txt +22 -0
- data/asciidoc/doc/a2x.1 +246 -0
- data/asciidoc/doc/a2x.1.txt +195 -0
- data/asciidoc/doc/article.css-embedded.html +579 -0
- data/asciidoc/doc/article.html +62 -0
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/article.txt +124 -0
- data/asciidoc/doc/asciidoc-revhistory.xml +27 -0
- data/asciidoc/doc/asciidoc.1 +161 -0
- data/asciidoc/doc/asciidoc.1.css-embedded.html +562 -0
- data/asciidoc/doc/asciidoc.1.css.html +212 -0
- data/asciidoc/doc/asciidoc.1.html +190 -0
- data/asciidoc/doc/asciidoc.1.txt +118 -0
- data/asciidoc/doc/asciidoc.conf +8 -0
- data/asciidoc/doc/asciidoc.css-embedded.html +7954 -0
- data/asciidoc/doc/asciidoc.css.html +7553 -0
- data/asciidoc/doc/asciidoc.dict +673 -0
- data/asciidoc/doc/asciidoc.html +3502 -0
- data/asciidoc/doc/asciidoc.txt +4757 -0
- data/asciidoc/doc/asciimath.txt +47 -0
- data/asciidoc/doc/book-multi.css-embedded.html +575 -0
- data/asciidoc/doc/book-multi.html +72 -0
- data/asciidoc/doc/book-multi.txt +159 -0
- data/asciidoc/doc/book.css-embedded.html +585 -0
- data/asciidoc/doc/book.html +60 -0
- data/asciidoc/doc/book.txt +133 -0
- data/asciidoc/doc/customers.csv +18 -0
- data/asciidoc/doc/faq.txt +262 -0
- data/asciidoc/doc/latex-backend.html +224 -0
- data/asciidoc/doc/latex-backend.txt +193 -0
- data/asciidoc/doc/latexmath.txt +35 -0
- data/asciidoc/doc/main.aap +293 -0
- data/asciidoc/doc/music-filter.html +513 -0
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.txt +158 -0
- data/asciidoc/doc/source-highlight-filter.html +183 -0
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +174 -0
- data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +71 -0
- data/asciidoc/docbook-xsl/chunked.xsl +19 -0
- data/asciidoc/docbook-xsl/common.xsl +67 -0
- data/asciidoc/docbook-xsl/fo.xsl +117 -0
- data/asciidoc/docbook-xsl/htmlhelp.xsl +17 -0
- data/asciidoc/docbook-xsl/manpage.xsl +28 -0
- data/asciidoc/docbook-xsl/shaded-literallayout.patch +32 -0
- data/asciidoc/docbook-xsl/xhtml.xsl +14 -0
- data/asciidoc/docbook.conf +606 -0
- data/asciidoc/examples/website/CHANGELOG.html +3828 -0
- data/asciidoc/examples/website/INSTALL.html +163 -0
- data/asciidoc/examples/website/README-website.html +129 -0
- data/asciidoc/examples/website/README-website.txt +29 -0
- data/asciidoc/examples/website/README.html +125 -0
- data/asciidoc/examples/website/a2x.1.html +395 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +165 -0
- data/asciidoc/examples/website/asciimath.html +157 -0
- data/asciidoc/examples/website/build-website.sh +25 -0
- data/asciidoc/examples/website/downloads.html +219 -0
- data/asciidoc/examples/website/downloads.txt +98 -0
- data/asciidoc/examples/website/faq.html +372 -0
- data/asciidoc/examples/website/index.html +398 -0
- data/asciidoc/examples/website/index.txt +222 -0
- data/asciidoc/examples/website/latex-backend.html +640 -0
- data/asciidoc/examples/website/latexmath.html +119 -0
- data/asciidoc/examples/website/layout1.conf +161 -0
- data/asciidoc/examples/website/layout1.css +65 -0
- data/asciidoc/examples/website/layout2.conf +158 -0
- data/asciidoc/examples/website/layout2.css +93 -0
- data/asciidoc/examples/website/manpage.html +266 -0
- data/asciidoc/examples/website/music-filter.html +242 -0
- data/asciidoc/examples/website/music1.abc +12 -0
- data/asciidoc/examples/website/music1.png +0 -0
- data/asciidoc/examples/website/music2.ly +9 -0
- data/asciidoc/examples/website/music2.png +0 -0
- data/asciidoc/examples/website/source-highlight-filter.html +251 -0
- data/asciidoc/examples/website/support.html +78 -0
- data/asciidoc/examples/website/support.txt +5 -0
- data/asciidoc/examples/website/userguide.html +7597 -0
- data/asciidoc/examples/website/version9.html +143 -0
- data/asciidoc/examples/website/version9.txt +48 -0
- data/asciidoc/filters/code-filter-readme.txt +37 -0
- data/asciidoc/filters/code-filter-test-c++.txt +7 -0
- data/asciidoc/filters/code-filter-test.txt +15 -0
- data/asciidoc/filters/code-filter.conf +8 -0
- data/asciidoc/filters/code-filter.py +239 -0
- data/asciidoc/filters/music-filter-test.txt +40 -0
- data/asciidoc/filters/music-filter.conf +40 -0
- data/asciidoc/filters/music2png.py +189 -0
- data/asciidoc/filters/source-highlight-filter-test.txt +19 -0
- data/asciidoc/filters/source-highlight-filter.conf +100 -0
- data/asciidoc/help.conf +213 -0
- data/asciidoc/html4.conf +363 -0
- data/asciidoc/images/highlighter.png +0 -0
- data/asciidoc/images/icons/README +5 -0
- data/asciidoc/images/icons/callouts/1.png +0 -0
- data/asciidoc/images/icons/callouts/10.png +0 -0
- data/asciidoc/images/icons/callouts/11.png +0 -0
- data/asciidoc/images/icons/callouts/12.png +0 -0
- data/asciidoc/images/icons/callouts/13.png +0 -0
- data/asciidoc/images/icons/callouts/14.png +0 -0
- data/asciidoc/images/icons/callouts/15.png +0 -0
- data/asciidoc/images/icons/callouts/2.png +0 -0
- data/asciidoc/images/icons/callouts/3.png +0 -0
- data/asciidoc/images/icons/callouts/4.png +0 -0
- data/asciidoc/images/icons/callouts/5.png +0 -0
- data/asciidoc/images/icons/callouts/6.png +0 -0
- data/asciidoc/images/icons/callouts/7.png +0 -0
- data/asciidoc/images/icons/callouts/8.png +0 -0
- data/asciidoc/images/icons/callouts/9.png +0 -0
- data/asciidoc/images/icons/caution.png +0 -0
- data/asciidoc/images/icons/example.png +0 -0
- data/asciidoc/images/icons/home.png +0 -0
- data/asciidoc/images/icons/important.png +0 -0
- data/asciidoc/images/icons/next.png +0 -0
- data/asciidoc/images/icons/note.png +0 -0
- data/asciidoc/images/icons/prev.png +0 -0
- data/asciidoc/images/icons/tip.png +0 -0
- data/asciidoc/images/icons/up.png +0 -0
- data/asciidoc/images/icons/warning.png +0 -0
- data/asciidoc/images/smallnew.png +0 -0
- data/asciidoc/images/tiger.png +0 -0
- data/asciidoc/install.sh +55 -0
- data/asciidoc/javascripts/ASCIIMathML.js +938 -0
- data/asciidoc/javascripts/LaTeXMathML.js +1223 -0
- data/asciidoc/javascripts/toc.js +69 -0
- data/asciidoc/lang-es.conf +15 -0
- data/asciidoc/latex.conf +663 -0
- data/asciidoc/linuxdoc.conf +285 -0
- data/asciidoc/math.conf +50 -0
- data/asciidoc/stylesheets/docbook-xsl.css +271 -0
- data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +21 -0
- data/asciidoc/stylesheets/xhtml-deprecated.css +247 -0
- data/asciidoc/stylesheets/xhtml11-manpage.css +18 -0
- data/asciidoc/stylesheets/xhtml11-quirks.css +49 -0
- data/asciidoc/stylesheets/xhtml11.css +284 -0
- data/asciidoc/t.conf +20 -0
- data/asciidoc/text.conf +16 -0
- data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +53 -0
- data/asciidoc/vim/syntax/asciidoc.vim +139 -0
- data/asciidoc/xhtml-deprecated-css.conf +235 -0
- data/asciidoc/xhtml-deprecated.conf +351 -0
- data/asciidoc/xhtml11-quirks.conf +57 -0
- data/asciidoc/xhtml11.conf +514 -0
- data/bin/mizuho +40 -0
- data/lib/mizuho/chapter.rb +54 -0
- data/lib/mizuho/generator.rb +106 -0
- data/lib/mizuho/heading.rb +46 -0
- data/lib/mizuho/parser.rb +99 -0
- data/lib/mizuho/template.rb +50 -0
- data/mizuho.gemspec +34 -0
- data/templates/asciidoc.css +358 -0
- data/templates/asciidoc.html.erb +86 -0
- data/templates/manualsonrails.css +165 -0
- data/templates/manualsonrails.html.erb +97 -0
- data/test/parser_spec.rb +190 -0
- data/test/spec_helper.rb +43 -0
- 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
|
+
#
|
data/asciidoc/help.conf
ADDED
@@ -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
|
+
|