FooBarWidget-mizuho 0.9.1 → 0.9.2
Sign up to get free protection for your applications and to get access to all the features.
- data/README.markdown +1 -1
- data/Rakefile +14 -2
- data/asciidoc/BUGS +11 -6
- data/asciidoc/BUGS.txt +7 -3
- data/asciidoc/CHANGELOG +313 -151
- data/asciidoc/CHANGELOG.txt +177 -12
- data/asciidoc/INSTALL +30 -36
- data/asciidoc/INSTALL.txt +20 -20
- data/asciidoc/Makefile.in +145 -0
- data/asciidoc/README +11 -11
- data/asciidoc/README.txt +9 -9
- data/asciidoc/a2x +40 -7
- data/asciidoc/asciidoc.conf +180 -126
- data/asciidoc/asciidoc.py +1667 -977
- data/asciidoc/common.aap +2 -2
- data/asciidoc/configure +2840 -0
- data/asciidoc/configure.ac +11 -0
- data/asciidoc/dblatex/asciidoc-dblatex.sty +2 -0
- data/asciidoc/dblatex/asciidoc-dblatex.xsl +15 -0
- data/asciidoc/dblatex/dblatex-readme.txt +19 -2
- data/asciidoc/doc/a2x.1 +77 -67
- data/asciidoc/doc/a2x.1.txt +11 -2
- data/asciidoc/doc/article.css-embedded.html +85 -63
- data/asciidoc/doc/article.html +644 -62
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/article.txt +15 -17
- data/asciidoc/doc/asciidoc.1 +34 -40
- data/asciidoc/doc/asciidoc.1.css-embedded.html +67 -32
- data/asciidoc/doc/asciidoc.1.css.html +28 -28
- data/asciidoc/doc/asciidoc.1.html +33 -33
- data/asciidoc/doc/asciidoc.css-embedded.html +2234 -2348
- data/asciidoc/doc/asciidoc.css.html +2203 -2352
- data/asciidoc/doc/asciidoc.dict +52 -1
- data/asciidoc/doc/asciidoc.html +980 -1160
- data/asciidoc/doc/asciidoc.txt +941 -738
- data/asciidoc/doc/asciimathml.txt +63 -0
- data/asciidoc/doc/book-multi.html +26 -43
- data/asciidoc/doc/book-multi.txt +19 -23
- data/asciidoc/doc/book.css-embedded.html +92 -71
- data/asciidoc/doc/book.html +24 -41
- data/asciidoc/doc/book.txt +19 -21
- data/asciidoc/doc/docbook-xsl.css +1 -0
- data/asciidoc/doc/faq.txt +288 -60
- data/asciidoc/doc/images +1 -0
- data/asciidoc/doc/latex-backend.html +16 -123
- data/asciidoc/doc/latex-backend.txt +17 -19
- data/asciidoc/doc/latexmath.txt +233 -24
- data/asciidoc/doc/latexmathml.txt +41 -0
- data/asciidoc/doc/main.aap +9 -5
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.txt +2 -2
- data/asciidoc/doc/source-highlight-filter.html +476 -105
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +39 -10
- data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +1 -29
- data/asciidoc/docbook-xsl/fo.xsl +35 -3
- data/asciidoc/docbook-xsl/manpage.xsl +3 -0
- data/asciidoc/docbook-xsl/text.xsl +50 -0
- data/asciidoc/docbook.conf +182 -73
- data/asciidoc/examples/website/ASCIIMathML.js +1 -0
- data/asciidoc/examples/website/CHANGELOG.html +618 -182
- data/asciidoc/examples/website/CHANGELOG.txt +1 -0
- data/asciidoc/examples/website/INSTALL.html +34 -36
- data/asciidoc/examples/website/INSTALL.txt +1 -0
- data/asciidoc/examples/website/LaTeXMathML.js +1 -0
- data/asciidoc/examples/website/README-website.html +26 -37
- data/asciidoc/examples/website/README-website.txt +6 -6
- data/asciidoc/examples/website/README.html +15 -15
- data/asciidoc/examples/website/README.txt +1 -0
- data/asciidoc/examples/website/a2x.1.html +74 -50
- data/asciidoc/examples/website/a2x.1.txt +1 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +13 -48
- data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +1 -0
- data/asciidoc/examples/website/asciimathml.txt +1 -0
- data/asciidoc/examples/website/customers.csv +1 -0
- data/asciidoc/examples/website/downloads.html +69 -31
- data/asciidoc/examples/website/downloads.txt +28 -5
- data/asciidoc/examples/website/faq.html +370 -124
- data/asciidoc/examples/website/faq.txt +1 -0
- data/asciidoc/examples/website/images +1 -0
- data/asciidoc/examples/website/index.html +64 -64
- data/asciidoc/examples/website/index.txt +22 -15
- data/asciidoc/examples/website/latex-backend.html +152 -257
- data/asciidoc/examples/website/latex-backend.txt +1 -0
- data/asciidoc/examples/website/latexmathml.txt +1 -0
- data/asciidoc/examples/website/manpage.html +27 -27
- data/asciidoc/examples/website/manpage.txt +1 -0
- data/asciidoc/examples/website/music-filter.html +18 -18
- data/asciidoc/examples/website/music-filter.txt +1 -0
- data/asciidoc/examples/website/music1.abc +1 -1
- data/asciidoc/examples/website/music1.png +0 -0
- data/asciidoc/examples/website/music2.ly +1 -1
- data/asciidoc/examples/website/music2.png +0 -0
- data/asciidoc/examples/website/newlists.txt +40 -0
- data/asciidoc/examples/website/newtables.txt +397 -0
- data/asciidoc/examples/website/source-highlight-filter.html +67 -32
- data/asciidoc/examples/website/source-highlight-filter.txt +1 -0
- data/asciidoc/examples/website/support.html +4 -4
- data/asciidoc/examples/website/toc.js +1 -0
- data/asciidoc/examples/website/userguide.html +2190 -2339
- data/asciidoc/examples/website/userguide.txt +1 -0
- data/asciidoc/examples/website/version83.txt +37 -0
- data/asciidoc/examples/website/version9.html +13 -13
- data/asciidoc/examples/website/xhtml11-manpage.css +1 -0
- data/asciidoc/examples/website/xhtml11-quirks.css +1 -0
- data/asciidoc/examples/website/xhtml11.css +1 -0
- data/asciidoc/filters/code-filter-readme.txt +3 -3
- data/asciidoc/filters/code-filter-test.txt +6 -6
- data/asciidoc/filters/source-highlight-filter.conf +12 -5
- data/asciidoc/html4.conf +152 -58
- data/asciidoc/install-sh +201 -0
- data/asciidoc/latex.conf +41 -41
- data/asciidoc/stylesheets/docbook-xsl.css +1 -0
- data/asciidoc/stylesheets/xhtml11.css +39 -4
- data/asciidoc/text.conf +4 -4
- data/asciidoc/vim/syntax/asciidoc.vim +58 -32
- data/asciidoc/wordpress.conf +48 -0
- data/asciidoc/xhtml11-quirks.conf +1 -1
- data/asciidoc/xhtml11.conf +198 -70
- data/bin/mizuho +5 -2
- data/lib/mizuho/generator.rb +48 -19
- data/mizuho.gemspec +16 -6
- metadata +58 -15
- data/asciidoc/doc/asciimath.txt +0 -47
- data/asciidoc/docbook-xsl/shaded-literallayout.patch +0 -32
- data/asciidoc/examples/website/asciimath.html +0 -157
- data/asciidoc/examples/website/latexmath.html +0 -119
- data/asciidoc/filters/code-filter-test-c++.txt +0 -7
- data/asciidoc/install.sh +0 -55
- data/asciidoc/linuxdoc.conf +0 -285
- data/asciidoc/math.conf +0 -50
- data/asciidoc/stylesheets/xhtml-deprecated-manpage.css +0 -21
- data/asciidoc/stylesheets/xhtml-deprecated.css +0 -247
- data/asciidoc/t.conf +0 -20
- data/asciidoc/xhtml-deprecated-css.conf +0 -235
- data/asciidoc/xhtml-deprecated.conf +0 -351
@@ -0,0 +1 @@
|
|
1
|
+
../../doc/faq.txt
|
@@ -0,0 +1 @@
|
|
1
|
+
../../images
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.1" />
|
7
7
|
<meta name="description" content="Text based document generation" />
|
8
8
|
<meta name="keywords" content="text to HTML, text to DocBook, text to XML, AsciiDoc" />
|
9
9
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
@@ -51,46 +51,26 @@ window.onload = function(){generateToc(1)}
|
|
51
51
|
<div class="sectionbody">
|
52
52
|
<div class="sidebarblock">
|
53
53
|
<div class="sidebar-content">
|
54
|
-
<div class="sidebar-title">
|
55
|
-
<div class="
|
56
|
-
<
|
57
|
-
|
58
|
-
<
|
59
|
-
<a href="
|
60
|
-
|
61
|
-
|
62
|
-
</
|
63
|
-
|
64
|
-
<p>
|
65
|
-
Added <tt>dvi</tt>, <tt>ps</tt> and <tt>tex</tt> output format options to <tt>a2x(1)</tt>
|
66
|
-
(courtesy of <tt>dblatex(1)</tt>).
|
67
|
-
</p>
|
68
|
-
</li>
|
69
|
-
<li>
|
70
|
-
<p>
|
71
|
-
URLs and email addresses are recognized without having to use the
|
72
|
-
macro syntax.
|
73
|
-
</p>
|
74
|
-
</li>
|
75
|
-
<li>
|
76
|
-
<p>
|
77
|
-
<a href="source-highlight-filter.html">Source code paragraphs</a> make small
|
78
|
-
code examples easier to enter.
|
79
|
-
</p>
|
80
|
-
</li>
|
81
|
-
</ul></div>
|
82
|
-
<div class="para"><p>Read the <a href="CHANGELOG.html">CHANGELOG</a> for a full description of all
|
83
|
-
the other additions and changes.</p></div>
|
84
|
-
<div class="para"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
54
|
+
<div class="sidebar-title">14 December 2008: AsciiDoc 8.3.1 Released</div>
|
55
|
+
<div class="paragraph"><p>This release fixes a couple of regression bugs in the initial
|
56
|
+
<a href="version83.html">version 8.3</a> release along with some minor
|
57
|
+
additions.
|
58
|
+
The platform dependent <tt>install.sh</tt> script has been replaced with an
|
59
|
+
<a href="INSTALL.html#_distribution_tarball_installation">autoconf make
|
60
|
+
file</a> (this change didn’t make it into the 8.3.0 release because of
|
61
|
+
time constraints).
|
62
|
+
Read the <a href="CHANGELOG.html">CHANGELOG</a> for a full list of all
|
63
|
+
additions and changes.</p></div>
|
64
|
+
<div class="paragraph"><p><a href="mailto:srackham@gmail.com"><em>Stuart Rackham</em></a></p></div>
|
85
65
|
</div></div>
|
86
66
|
</div>
|
87
67
|
</div>
|
88
68
|
<h2 id="_introduction">Introduction</h2>
|
89
69
|
<div class="sectionbody">
|
90
|
-
<div class="
|
70
|
+
<div class="paragraph"><p><em>AsciiDoc</em> is a text document format for writing short documents,
|
91
71
|
articles, books and UNIX man pages. <em>AsciiDoc</em> files can be translated
|
92
72
|
to HTML and DocBook markups using the <tt>asciidoc(1)</tt> command.</p></div>
|
93
|
-
<div class="
|
73
|
+
<div class="paragraph"><p><em>AsciiDoc</em> is highly configurable: both the <em>AsciiDoc</em> source file syntax
|
94
74
|
and the backend output markups (which can be almost any type of
|
95
75
|
SGML/XML markup) can be customized and extended by the user.</p></div>
|
96
76
|
<div class="admonitionblock">
|
@@ -106,17 +86,17 @@ in the left hand margin.</td>
|
|
106
86
|
</div>
|
107
87
|
<h2 id="_overview_and_examples">Overview and Examples</h2>
|
108
88
|
<div class="sectionbody">
|
109
|
-
<div class="
|
89
|
+
<div class="paragraph"><p>You write an <em>AsciiDoc</em> document the same way you would write a
|
110
90
|
normal text document, there are no markup tags or weird format
|
111
91
|
notations. <em>AsciiDoc</em> files are designed to be viewed, edited and
|
112
92
|
printed directly or translated to other presentation formats using
|
113
93
|
the <tt>asciidoc(1)</tt> command.</p></div>
|
114
|
-
<div class="
|
94
|
+
<div class="paragraph"><p>The <tt>asciidoc(1)</tt> command translates <em>AsciiDoc</em> files to HTML, XHTML and
|
115
95
|
DocBook markups. DocBook can be post-processed to presentation
|
116
96
|
formats such as HTML, PDF, DVI, LaTeX, roff, and Postscript using
|
117
97
|
readily available Open Source tools.</p></div>
|
118
98
|
<h3 id="_example_articles">Example Articles</h3><div style="clear:left"></div>
|
119
|
-
<div class="
|
99
|
+
<div class="ulist"><ul>
|
120
100
|
<li>
|
121
101
|
<p>
|
122
102
|
This version of the
|
@@ -127,7 +107,7 @@ This version of the
|
|
127
107
|
</li>
|
128
108
|
<li>
|
129
109
|
<p>
|
130
|
-
Here
|
110
|
+
Here’s the <a href="asciidoc.html">same document</a> created by first
|
131
111
|
generating DocBook markup using <em>AsciiDoc</em> and then converting the
|
132
112
|
DocBook markup to HTML using <em>DocBook XSL Stylesheets</em>.
|
133
113
|
</p>
|
@@ -153,65 +133,67 @@ This <a href="asciidoc.pdf">PDF formatted User Guide</a> was generated from
|
|
153
133
|
</li>
|
154
134
|
</ul></div>
|
155
135
|
<h3 id="_example_books">Example Books</h3><div style="clear:left"></div>
|
156
|
-
<div class="
|
136
|
+
<div class="paragraph"><p><em>AsciiDoc</em> markup supports all the standard DocBook frontmatter and
|
157
137
|
backmatter sections (dedication, preface, bibliography, glossary,
|
158
138
|
index, colophon) plus footnotes and index entries.</p></div>
|
159
|
-
<div class="
|
160
|
-
<dt>
|
139
|
+
<div class="dlist"><dl>
|
140
|
+
<dt class="hdlist1">
|
161
141
|
Book
|
162
142
|
</dt>
|
163
143
|
<dd>
|
164
144
|
<p>
|
165
|
-
This <a href="book.txt"><em>AsciiDoc</em> book
|
145
|
+
This <a href="book.txt"><em>AsciiDoc</em> book’s</a> DocBook output
|
166
146
|
produced <a href="book.html">this HTML file</a> using the
|
167
147
|
<em>DocBook XSL Stylesheets</em>.
|
168
148
|
</p>
|
169
149
|
</dd>
|
170
|
-
<dt>
|
150
|
+
<dt class="hdlist1">
|
171
151
|
Multi-part book
|
172
152
|
</dt>
|
173
153
|
<dd>
|
174
154
|
<p>
|
175
|
-
This <a href="book-multi.txt">multi-part <em>AsciiDoc</em> book
|
155
|
+
This <a href="book-multi.txt">multi-part <em>AsciiDoc</em> book’s</a>
|
176
156
|
DocBook output produced <a href="book-multi.html">this HTML file</a>
|
177
157
|
using the <em>DocBook XSL Stylesheets</em>.
|
178
158
|
</p>
|
179
159
|
</dd>
|
180
160
|
</dl></div>
|
181
161
|
<h3 id="_example_unix_man_pages">Example UNIX Man Pages</h3><div style="clear:left"></div>
|
182
|
-
<div class="
|
162
|
+
<div class="paragraph"><p>HTML formatted <em>AsciiDoc</em> man pages
|
183
163
|
<a href="asciidoc.1.css-embedded.html">with stylesheets</a> and
|
184
164
|
<a href="asciidoc.1.html">without stylesheets</a> were generated by <em>AsciiDoc</em>
|
185
165
|
from <a href="asciidoc.1.txt">this file</a>.</p></div>
|
186
|
-
<div class="
|
166
|
+
<div class="paragraph"><p>This <a href="asciidoc.1">roff formatted man page</a> was generated from
|
187
167
|
<tt>asciidoc(1)</tt> DocBook output using <tt>xsltproc(1)</tt> and DocBook XSL
|
188
168
|
Stylesheets.</p></div>
|
189
169
|
<h3 id="_example_web_site">Example Web Site</h3><div style="clear:left"></div>
|
190
|
-
<div class="
|
170
|
+
<div class="paragraph"><p>The <a href="README-website.html"><em>AsciiDoc</em> website</a> is included in the
|
191
171
|
<em>AsciiDoc</em> distribution (in <tt>./examples/website/</tt>) as example website
|
192
172
|
built using <em>AsciiDoc</em>. See <tt>./examples/website/README-website.txt</tt>.</p></div>
|
193
173
|
</div>
|
194
174
|
<h2 id="_music_filter">Music Filter</h2>
|
195
175
|
<div class="sectionbody">
|
196
|
-
<div class="
|
176
|
+
<div class="paragraph"><p>A <a href="music-filter.html">music filter</a> is included in the distribution
|
197
177
|
<tt>./filters/</tt> directory. It translates music in
|
198
178
|
<a href="http://lilypond.org/">LilyPond</a> or <a href="http://abcnotation.org.uk/">ABC</a>
|
199
179
|
notation to standard classical notation</p></div>
|
200
180
|
</div>
|
201
181
|
<h2 id="_source_code_highlight_filter">Source Code Highlight Filter</h2>
|
202
182
|
<div class="sectionbody">
|
203
|
-
<div class="
|
183
|
+
<div class="paragraph"><p>A <a href="source-highlight-filter.html">source code highlight filter</a> is
|
204
184
|
included in the distribution <tt>./filters/</tt> directory.</p></div>
|
205
185
|
</div>
|
206
186
|
<h2 id="X3">Mathematical Formulae</h2>
|
207
187
|
<div class="sectionbody">
|
208
|
-
<div class="
|
209
|
-
<a href="
|
188
|
+
<div class="paragraph"><p>You can include mathematical formulae in <em>AsciiDoc</em> XHTML documents using
|
189
|
+
<a href="asciimathml.html">ASCIIMathML</a> or <a href="latexmathml.html">LaTeXMathML</a>
|
210
190
|
notation.</p></div>
|
191
|
+
<div class="paragraph"><p><a href="latexmath.pdf">LaTeX Math</a> can be included in <em>AsciiDoc</em>
|
192
|
+
documents processed by <tt>dblatex(1)</tt>.</p></div>
|
211
193
|
</div>
|
212
194
|
<h2 id="_vim_syntax_highlighter">Vim Syntax Highlighter</h2>
|
213
195
|
<div class="sectionbody">
|
214
|
-
<div class="
|
196
|
+
<div class="paragraph"><p>An <em>AsciiDoc</em> syntax highlighter for the Vim text editor is included in
|
215
197
|
the <em>AsciiDoc</em> distribution (see <em>Appendix F</em> of the <em><em>AsciiDoc</em> User
|
216
198
|
Guide</em> for details).</p></div>
|
217
199
|
<div class="imageblock">
|
@@ -222,13 +204,13 @@ Guide</em> for details).</p></div>
|
|
222
204
|
</div>
|
223
205
|
<div class="image-title">Syntax highlighter screenshot</div>
|
224
206
|
</div>
|
225
|
-
<div class="
|
207
|
+
<div class="paragraph"><p>Dag Wieers has implemented an alternative Vim syntax file for <em>AsciiDoc</em>
|
226
208
|
which can be found here
|
227
209
|
<a href="http://svn.rpmforge.net/svn/trunk/tools/asciidoc-vim/">http://svn.rpmforge.net/svn/trunk/tools/asciidoc-vim/</a>.</p></div>
|
228
210
|
</div>
|
229
211
|
<h2 id="X2">Resources</h2>
|
230
212
|
<div class="sectionbody">
|
231
|
-
<div class="
|
213
|
+
<div class="ulist"><ul>
|
232
214
|
<li>
|
233
215
|
<p>
|
234
216
|
Check the <a href="downloads.html">Downloads page</a> for packaged versions
|
@@ -304,23 +286,34 @@ Karl Mowatt-Wilson has developed an <a href="http://ikiwiki.info/">ikiwiki</a>
|
|
304
286
|
</div>
|
305
287
|
<h2 id="_blogpost_weblog_client">Blogpost weblog client</h2>
|
306
288
|
<div class="sectionbody">
|
307
|
-
<div class="
|
289
|
+
<div class="paragraph"><p><a href="http://srackham.wordpress.com/blogpost-readme/">blogpost</a> is a
|
308
290
|
command-line weblog client for publishing <em>AsciiDoc</em> documents to
|
309
291
|
<a href="http://wordpress.org/">WordPress</a> blog hosts. It creates and updates
|
310
292
|
weblog posts and pages directly from <em>AsciiDoc</em> source documents.</p></div>
|
311
293
|
</div>
|
312
294
|
<h2 id="X1">LaTeX Backend</h2>
|
313
295
|
<div class="sectionbody">
|
314
|
-
<div class="
|
296
|
+
<div class="paragraph"><p>An experimental LaTeX backend has been written for <em>AsciiDoc</em> by
|
315
297
|
Benjamin Klum. Benjamin has done a superhuman job (I admit it, I
|
316
|
-
didn
|
317
|
-
<div class="
|
298
|
+
didn’t think this was doable due to <em>AsciiDoc</em>'s SGML/XML bias).</p></div>
|
299
|
+
<div class="paragraph"><p>Here’s <a href="latex-backend.html">Benjamin’s documentation</a>.</p></div>
|
300
|
+
<div class="admonitionblock">
|
301
|
+
<table><tr>
|
302
|
+
<td class="icon">
|
303
|
+
<img src="./images/icons/note.png" alt="Note" />
|
304
|
+
</td>
|
305
|
+
<td class="content">Owning to to other commitments, Benjamin is unable to maintain
|
306
|
+
this backend. I don’t have the expertise or time to take this on
|
307
|
+
consequently the LaTeX backend has not been tested or updated since
|
308
|
+
<em>AsciiDoc</em> version 8.2.7 and is currently unsupported.</td>
|
309
|
+
</tr></table>
|
310
|
+
</div>
|
318
311
|
</div>
|
319
312
|
<h2 id="_projects_using_asciidoc">Projects using AsciiDoc</h2>
|
320
313
|
<div class="sectionbody">
|
321
|
-
<div class="
|
322
|
-
and I
|
323
|
-
<div class="
|
314
|
+
<div class="paragraph"><p>Here are some projects I know of, if you know of more drop me a line
|
315
|
+
and I’ll add them to the list.</p></div>
|
316
|
+
<div class="ulist"><ul>
|
324
317
|
<li>
|
325
318
|
<p>
|
326
319
|
The Linux kernel
|
@@ -360,17 +353,24 @@ The <a href="http://xpt.sourceforge.net/">*Nix Power Tools project</a> uses
|
|
360
353
|
highlighter (see <a href="#X2">Resources</a> above).
|
361
354
|
</p>
|
362
355
|
</li>
|
356
|
+
<li>
|
357
|
+
<p>
|
358
|
+
The <a href="http://www.wesnoth.org/">Battle for Wesnoth</a> project uses
|
359
|
+
<em>AsciiDoc</em> for it’s <a href="http://www.wesnoth.org/wiki/WesnothManual">Manual</a>
|
360
|
+
in a number of different languages.
|
361
|
+
</p>
|
362
|
+
</li>
|
363
363
|
</ul></div>
|
364
364
|
</div>
|
365
365
|
<h2 id="_asciidoc_version_9">AsciiDoc version 9</h2>
|
366
366
|
<div class="sectionbody">
|
367
|
-
<div class="
|
367
|
+
<div class="paragraph"><p>The next version of <em>AsciiDoc</em> is underway — details
|
368
368
|
<a href="version9.html">here</a>.</p></div>
|
369
369
|
</div>
|
370
370
|
<div id="footer">
|
371
371
|
<div id="footer-text">
|
372
|
-
Version 8.
|
373
|
-
Last updated 2008-
|
372
|
+
Version 8.3.1<br />
|
373
|
+
Last updated 2008-12-13 10:13:03 NZDT
|
374
374
|
</div>
|
375
375
|
<div id="footer-badges">
|
376
376
|
<a href="http://validator.w3.org/check?uri=referer">
|
@@ -3,19 +3,15 @@ AsciiDoc Home Page
|
|
3
3
|
|
4
4
|
.{date}: AsciiDoc {revision} Released
|
5
5
|
************************************************************************
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
code examples easier to enter.
|
16
|
-
|
17
|
-
Read the link:CHANGELOG.html[CHANGELOG] for a full description of all
|
18
|
-
the other additions and changes.
|
6
|
+
This release fixes a couple of regression bugs in the initial
|
7
|
+
link:version83.html[version 8.3] release along with some minor
|
8
|
+
additions.
|
9
|
+
The platform dependent `install.sh` script has been replaced with an
|
10
|
+
link:INSTALL.html#_distribution_tarball_installation[autoconf make
|
11
|
+
file] (this change didn't make it into the 8.3.0 release because of
|
12
|
+
time constraints).
|
13
|
+
Read the link:CHANGELOG.html[CHANGELOG] for a full list of all
|
14
|
+
additions and changes.
|
19
15
|
|
20
16
|
mailto:srackham@gmail.com['Stuart Rackham']
|
21
17
|
************************************************************************
|
@@ -120,10 +116,13 @@ included in the distribution `./filters/` directory.
|
|
120
116
|
[[X3]]
|
121
117
|
Mathematical Formulae
|
122
118
|
---------------------
|
123
|
-
You can include mathematical formulae in
|
124
|
-
link:
|
119
|
+
You can include mathematical formulae in AsciiDoc XHTML documents using
|
120
|
+
link:asciimathml.html[ASCIIMathML] or link:latexmathml.html[LaTeXMathML]
|
125
121
|
notation.
|
126
122
|
|
123
|
+
link:latexmath.pdf[LaTeX Math] can be included in AsciiDoc
|
124
|
+
documents processed by `dblatex(1)`.
|
125
|
+
|
127
126
|
|
128
127
|
Vim Syntax Highlighter
|
129
128
|
----------------------
|
@@ -193,6 +192,11 @@ didn't think this was doable due to AsciiDoc's SGML/XML bias).
|
|
193
192
|
|
194
193
|
Here's link:latex-backend.html[Benjamin's documentation].
|
195
194
|
|
195
|
+
NOTE: Owning to to other commitments, Benjamin is unable to maintain
|
196
|
+
this backend. I don't have the expertise or time to take this on
|
197
|
+
consequently the LaTeX backend has not been tested or updated since
|
198
|
+
AsciiDoc version 8.2.7 and is currently unsupported.
|
199
|
+
|
196
200
|
|
197
201
|
Projects using AsciiDoc
|
198
202
|
-----------------------
|
@@ -214,6 +218,9 @@ and I'll add them to the list.
|
|
214
218
|
- The http://xpt.sourceforge.net/[*Nix Power Tools project] uses
|
215
219
|
AsciiDoc for documentation and has released an Emacs syntax
|
216
220
|
highlighter (see <<X2,Resources>> above).
|
221
|
+
- The http://www.wesnoth.org/[Battle for Wesnoth] project uses
|
222
|
+
AsciiDoc for it's http://www.wesnoth.org/wiki/WesnothManual[Manual]
|
223
|
+
in a number of different languages.
|
217
224
|
|
218
225
|
|
219
226
|
AsciiDoc version 9
|
@@ -3,7 +3,7 @@
|
|
3
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
4
4
|
<head>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
6
|
-
<meta name="generator" content="AsciiDoc 8.
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.1" />
|
7
7
|
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
|
8
8
|
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
|
9
9
|
<link rel="stylesheet" href="./layout1.css" type="text/css" />
|
@@ -41,11 +41,11 @@ June 2006
|
|
41
41
|
</div>
|
42
42
|
<h2 id="_introduction">Introduction</h2>
|
43
43
|
<div class="sectionbody">
|
44
|
-
<div class="
|
44
|
+
<div class="paragraph"><p>LaTeX backend is a configuration file for Stuart Rackham’s <a href="http://www.methods.co.nz/asciidoc/">Asciidoc</a>. It generates high-level LaTeX markup from Asciidoc documents. LaTeX is a document preparation system for TeX which in turn is a popular typesetting system. It is well known for producing excellently typesetted high quality printouts, especially suited for scientific text.</p></div>
|
45
45
|
</div>
|
46
46
|
<h2 id="_tutorial">Tutorial</h2>
|
47
47
|
<div class="sectionbody">
|
48
|
-
<div class="
|
48
|
+
<div class="paragraph"><p>Getting a ready-to-print document from an Asciidoc document using the LaTeX backend involves at least two steps:</p></div>
|
49
49
|
<div class="olist"><ol>
|
50
50
|
<li>
|
51
51
|
<p>
|
@@ -58,11 +58,11 @@ Conversion of the LaTeX document into a PDF document (this is done by the TeX sy
|
|
58
58
|
</p>
|
59
59
|
</li>
|
60
60
|
</ol></div>
|
61
|
-
<div class="
|
61
|
+
<div class="paragraph"><p>Try to create a PDF document from the Asciidoc document <tt>article.txt</tt> which resides in the <tt>doc</tt> directory of Asciidoc:</p></div>
|
62
62
|
<div class="olist2"><ol>
|
63
63
|
<li>
|
64
64
|
<p>
|
65
|
-
Make a copy of <tt>article.txt</tt> in a directory of your choice, let
|
65
|
+
Make a copy of <tt>article.txt</tt> in a directory of your choice, let’s call it <tt>latex-test</tt>.
|
66
66
|
</p>
|
67
67
|
</li>
|
68
68
|
<li>
|
@@ -92,7 +92,7 @@ Now there should be a file <tt>article.pdf</tt> in the <tt>latex-test</tt> direc
|
|
92
92
|
<img src="./images/icons/important.png" alt="Important" />
|
93
93
|
</td>
|
94
94
|
<td class="content">
|
95
|
-
<div class="
|
95
|
+
<div class="ulist"><ul>
|
96
96
|
<li>
|
97
97
|
<p>
|
98
98
|
Asciidoc has to be started in <em>unsafe mode</em> when using LaTeX backend.
|
@@ -111,20 +111,20 @@ Note that some special LaTeX packages are necessary, see <a href="#packageRequir
|
|
111
111
|
<h2 id="_general_notes">General notes</h2>
|
112
112
|
<div class="sectionbody">
|
113
113
|
<h3 id="_quality_of_latex_output">Quality of LaTeX output</h3><div style="clear:left"></div>
|
114
|
-
<div class="
|
115
|
-
<div class="
|
114
|
+
<div class="paragraph"><p>High-level LaTeX is not very straightforward to generate. Therefore there’s no guarantee that the generated output is valid and compiles successfully. At all, this backend should be considered as rather experimental. You should have been already in touch with LaTeX in order to use the backend effectively because LaTeX compilation errors can be really nasty.</p></div>
|
115
|
+
<div class="paragraph"><p>Nevertheless good results can be achieved by using LaTeX backend. Try for example to compile Stuart Rackham’s Asciidoc documentation, a rather large document. It should compile without problems. However, the code filter might have to be reconfigured for the code filter example to work.</p></div>
|
116
116
|
<h3 id="_configuration_file_customization">Configuration file customization</h3><div style="clear:left"></div>
|
117
|
-
<div class="
|
117
|
+
<div class="paragraph"><p>Like every other Asciidoc backend the LaTeX backend can be customized easily to fit the user’s needs. Actually it is very important to have this option since LaTeX doesn’t have a companion language like CSS which allows to put styling information in a separate file. Read more about the LaTeX backend configuration file <a href="#configurationFile">here</a>.</p></div>
|
118
118
|
<h3 id="_output_optimization">Output optimization</h3><div style="clear:left"></div>
|
119
|
-
<div class="
|
119
|
+
<div class="paragraph"><p>The LaTeX output is optimized for creating PDF documents using <em>pdflatex</em>.</p></div>
|
120
120
|
<h3 id="unicodeSupport">Unicode support</h3><div style="clear:left"></div>
|
121
|
-
<div class="
|
121
|
+
<div class="paragraph"><p>Unfortunately TeX/LaTeX does not have native unicode support. The package <em>ucs</em> adds elementary unicode support by introducing UTF-8 input encoding recognition and by defining lookup tables which contain the corresponding LaTeX commands for unicode characters. But these lookup tables are far from being complete. When a unicode character is found which is not defined in the lookup tables an error is raised by the TeX/LaTeX compiler. Note that TeX/LaTeX compilation errors caused by missing unicode character definitions are not fatal, that means the result is probably readable but undefined unicode characters are replaced with <tt>[U+…]</tt>. You may (de)activate the recognition of escaped unicode characters. See the <a href="#latex-recognize-escaped-unicode">[latex-recognize-escaped-unicode]</a> backend option.</p></div>
|
122
122
|
</div>
|
123
123
|
<h2 id="_backend_specific_features">Backend specific features</h2>
|
124
124
|
<div class="sectionbody">
|
125
125
|
<h3 id="_special_sections">Special sections</h3><div style="clear:left"></div>
|
126
|
-
<div class="
|
127
|
-
<div class="
|
126
|
+
<div class="paragraph"><p>LaTeX backend supports the following special sections and replaces them with corresponding LaTeX commands or environments:</p></div>
|
127
|
+
<div class="ulist"><ul>
|
128
128
|
<li>
|
129
129
|
<p>
|
130
130
|
Abstract (only for document type <em>article</em>)
|
@@ -157,56 +157,56 @@ Contents
|
|
157
157
|
</li>
|
158
158
|
</ul></div>
|
159
159
|
<h3 id="internalCrossReferences">Internal cross references</h3><div style="clear:left"></div>
|
160
|
-
<div class="
|
160
|
+
<div class="paragraph"><p>Macros for internal cross references have been extended by the attribute <em>style</em>.</p></div>
|
161
161
|
<div class="literalblock">
|
162
162
|
<div class="content">
|
163
163
|
<pre><tt>xref:<id>[<caption>, style=<style>]</tt></pre>
|
164
164
|
</div></div>
|
165
|
-
<div class="
|
165
|
+
<div class="paragraph"><p>or</p></div>
|
166
166
|
<div class="literalblock">
|
167
167
|
<div class="content">
|
168
168
|
<pre><tt><<<id>,<caption>,<style>>></tt></pre>
|
169
169
|
</div></div>
|
170
|
-
<div class="
|
171
|
-
<div class="
|
172
|
-
<dt>
|
170
|
+
<div class="paragraph"><p>The additional attribute <em>style</em> can have following values:</p></div>
|
171
|
+
<div class="dlist"><dl>
|
172
|
+
<dt class="hdlist1">
|
173
173
|
page
|
174
174
|
</dt>
|
175
175
|
<dd>
|
176
176
|
<p>
|
177
|
-
Let
|
177
|
+
Let’s LaTeX print the page number of the referenced anchor.
|
178
178
|
</p>
|
179
179
|
</dd>
|
180
|
-
<dt>
|
180
|
+
<dt class="hdlist1">
|
181
181
|
ref
|
182
182
|
</dt>
|
183
183
|
<dd>
|
184
184
|
<p>
|
185
|
-
Let
|
185
|
+
Let’s LaTeX print the number of the section, subsection, figure, table or theorem the referenced anchor resides.
|
186
186
|
</p>
|
187
187
|
</dd>
|
188
|
-
<dt>
|
188
|
+
<dt class="hdlist1">
|
189
189
|
autoref
|
190
190
|
</dt>
|
191
191
|
<dd>
|
192
192
|
<p>
|
193
|
-
Let
|
193
|
+
Let’s LaTeX print the number of the section, subsection, figure, table or theorem the referenced anchor resides preceded with a contextual label.
|
194
194
|
</p>
|
195
195
|
</dd>
|
196
|
-
<dt>
|
196
|
+
<dt class="hdlist1">
|
197
197
|
cite
|
198
198
|
</dt>
|
199
199
|
<dd>
|
200
200
|
<p>
|
201
|
-
Let
|
201
|
+
Let’s LaTeX interprete this reference as a reference to a bibliography entry. If the attribute <em>latex-use-bibliography-environment</em> is set, references with <em>cite</em> style as well as their corresponding bibliography anchors are presented as automatically generated numbers.
|
202
202
|
</p>
|
203
203
|
</dd>
|
204
204
|
</dl></div>
|
205
|
-
<div class="
|
205
|
+
<div class="paragraph"><p>If the <em>style</em> attribute is not set the reference is printed the common way.</p></div>
|
206
206
|
<h3 id="_options">Options</h3><div style="clear:left"></div>
|
207
|
-
<div class="
|
208
|
-
<div class="
|
209
|
-
<dt>
|
207
|
+
<div class="paragraph"><p>LaTeX document generation is influenced by the following attributes:</p></div>
|
208
|
+
<div class="dlist"><dl>
|
209
|
+
<dt class="hdlist1">
|
210
210
|
latex-table-rowlimit
|
211
211
|
</dt>
|
212
212
|
<dd>
|
@@ -214,7 +214,7 @@ latex-table-rowlimit
|
|
214
214
|
The maximum number of rows for typesetting tables using the <em>tabular</em> environment. If a table has more rows than <em>latex-table-rowlimit</em>, <em>longtable</em> environment is used instead of <em>tabular</em> environment. <em>longtable</em> environment supports tables spanning over several pages.
|
215
215
|
</p>
|
216
216
|
</dd>
|
217
|
-
<dt>
|
217
|
+
<dt class="hdlist1">
|
218
218
|
latex-use-bibliography-environment
|
219
219
|
</dt>
|
220
220
|
<dd>
|
@@ -222,7 +222,7 @@ latex-use-bibliography-environment
|
|
222
222
|
If <em>latex-use-bibliography-environment</em> is defined, <em>thebibliography</em> environment is used for the bibliography section. As a result bibliography entries are automatically numbered. Note that this works only if the bibliography section contains exclusively bibliography list items which start with a bibliography entry ([[[…]]]). Otherwise a TeX/LaTeX compilation error will occur. In order to display bibliography references correctly their <em>style</em> attribute must be set to <em>cite</em>. For more information see <a href="#internalCrossReferences">Internal cross references</a>.
|
223
223
|
</p>
|
224
224
|
</dd>
|
225
|
-
<dt>
|
225
|
+
<dt class="hdlist1">
|
226
226
|
latex-indent-paragraphs
|
227
227
|
</dt>
|
228
228
|
<dd>
|
@@ -230,15 +230,15 @@ latex-indent-paragraphs
|
|
230
230
|
If <em>latex-indent-paragraphs</em> is defined, the first line of paragraphs will be indented. By default LaTeX backend prevents paragraph indentation and prints paragraphs with preceding vertical space.
|
231
231
|
</p>
|
232
232
|
</dd>
|
233
|
-
<dt>
|
233
|
+
<dt class="hdlist1">
|
234
234
|
<a id="latex-recognize-escaped-unicode"></a> latex-recognize-escaped-unicode
|
235
235
|
</dt>
|
236
236
|
<dd>
|
237
237
|
<p>
|
238
|
-
If <em>latex-recognize-escaped-unicode</em> is defined, escaped unicode characters (e.g. <tt
|
238
|
+
If <em>latex-recognize-escaped-unicode</em> is defined, escaped unicode characters (e.g. <tt>{amp}#960;</tt> or <tt>{amp}#x3C0;</tt>) will be recognized. This can lead to LaTeX compilation errors since LaTeX unicode support is only rudimentary. For more information see <a href="#unicodeSupport">Unicode support</a>.
|
239
239
|
</p>
|
240
240
|
</dd>
|
241
|
-
<dt>
|
241
|
+
<dt class="hdlist1">
|
242
242
|
latex-use-custom-list-items
|
243
243
|
</dt>
|
244
244
|
<dd>
|
@@ -246,7 +246,7 @@ latex-use-custom-list-items
|
|
246
246
|
If <em>latex-use-custom-list-items</em> is defined, lists will be bulleted or enumerated the way you have typed them in the original Asciidoc document. That means, <tt>*</tt> turns into a circle bullet, <tt>-</tt> turns into a dash, <tt>.</tt> turns into a number and <tt>..</tt> turns into a letter. Otherwise LaTeX will use different bullets and enumeration characters depending on the level of nesting.
|
247
247
|
</p>
|
248
248
|
</dd>
|
249
|
-
<dt>
|
249
|
+
<dt class="hdlist1">
|
250
250
|
latex-use-colored-tables
|
251
251
|
</dt>
|
252
252
|
<dd>
|
@@ -254,7 +254,7 @@ latex-use-colored-tables
|
|
254
254
|
If <em>latex-use-colored-tables</em> is defined, tables will be printed colored.
|
255
255
|
</p>
|
256
256
|
</dd>
|
257
|
-
<dt>
|
257
|
+
<dt class="hdlist1">
|
258
258
|
latex-use-running-title-headings
|
259
259
|
</dt>
|
260
260
|
<dd>
|
@@ -262,7 +262,7 @@ latex-use-running-title-headings
|
|
262
262
|
If <em>latex-use-running-title-headings</em> is defined, <em>pagestyle</em> will be set to <em>headings</em> which results in running titles in the head.
|
263
263
|
</p>
|
264
264
|
</dd>
|
265
|
-
<dt>
|
265
|
+
<dt class="hdlist1">
|
266
266
|
latex-use-colored-sidebar-blocks
|
267
267
|
</dt>
|
268
268
|
<dd>
|
@@ -270,7 +270,7 @@ latex-use-colored-sidebar-blocks
|
|
270
270
|
If <em>latex-use-colored-sidebar-blocks</em> is defined, sidebar block content will be put in a color box instead of being indented by a vertical bar.
|
271
271
|
</p>
|
272
272
|
</dd>
|
273
|
-
<dt>
|
273
|
+
<dt class="hdlist1">
|
274
274
|
icons
|
275
275
|
</dt>
|
276
276
|
<dd>
|
@@ -278,7 +278,7 @@ icons
|
|
278
278
|
Link admonition paragraph and admonition block icon images and badge images. By default icons is undefined and text is used in place of icon images.
|
279
279
|
</p>
|
280
280
|
</dd>
|
281
|
-
<dt>
|
281
|
+
<dt class="hdlist1">
|
282
282
|
encoding
|
283
283
|
</dt>
|
284
284
|
<dd>
|
@@ -291,8 +291,8 @@ Set the input and output document character set encoding. Currently <tt>ISO-8859
|
|
291
291
|
<h2 id="_requirements">Requirements</h2>
|
292
292
|
<div class="sectionbody">
|
293
293
|
<h3 id="_general">General</h3><div style="clear:left"></div>
|
294
|
-
<div class="
|
295
|
-
<div class="
|
294
|
+
<div class="paragraph"><p>The following software is necessary for using the LaTeX backend:</p></div>
|
295
|
+
<div class="ulist"><ul>
|
296
296
|
<li>
|
297
297
|
<p>
|
298
298
|
An up-to-date version of <a href="http://www.methods.co.nz/asciidoc/">Asciidoc</a>
|
@@ -302,7 +302,7 @@ An up-to-date version of <a href="http://www.methods.co.nz/asciidoc/">Asciidoc</
|
|
302
302
|
<p>
|
303
303
|
An up-to-date TeX distribution, e.g.:
|
304
304
|
</p>
|
305
|
-
<div class="
|
305
|
+
<div class="ulist"><ul>
|
306
306
|
<li>
|
307
307
|
<p>
|
308
308
|
<a href="http://www.miktex.org/">MiKTeX</a> for Windows
|
@@ -317,251 +317,146 @@ An up-to-date TeX distribution, e.g.:
|
|
317
317
|
</li>
|
318
318
|
</ul></div>
|
319
319
|
<h3 id="packageRequirements">TeX/LaTeX Package requirements</h3><div style="clear:left"></div>
|
320
|
-
<div class="
|
320
|
+
<div class="paragraph"><p>LaTeX backend makes use of some LaTeX specialities which don’t belong to a minimal TeX/LaTeX distribution. However, I took special care not to employ exotic packages. Hence the following packages should be available in most package repositories. The table is not complete yet because I don’t know the package names for all TeX distributions.</p></div>
|
321
321
|
<div class="tableblock">
|
322
322
|
<table rules="all"
|
323
|
+
width="100%"
|
323
324
|
frame="border"
|
324
325
|
cellspacing="0" cellpadding="4">
|
325
|
-
<col width="
|
326
|
-
<col width="
|
327
|
-
<col width="
|
328
|
-
<col width="
|
329
|
-
<col width="
|
330
|
-
<thead>
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
|
337
|
-
|
338
|
-
<th align="left">
|
339
|
-
teTeX package name
|
340
|
-
</th>
|
341
|
-
<th align="left">
|
342
|
-
TeX Live package name
|
343
|
-
</th>
|
344
|
-
<th align="left">
|
345
|
-
Description
|
346
|
-
</th>
|
347
|
-
</tr>
|
326
|
+
<col width="12%" />
|
327
|
+
<col width="12%" />
|
328
|
+
<col width="12%" />
|
329
|
+
<col width="12%" />
|
330
|
+
<col width="50%" />
|
331
|
+
<thead valign="top">
|
332
|
+
<tr>
|
333
|
+
<th align="left">Speciality </th>
|
334
|
+
<th align="left"> MiKTeX package name </th>
|
335
|
+
<th align="left"> teTeX package name </th>
|
336
|
+
<th align="left"> TeX Live package name </th>
|
337
|
+
<th align="left"> Description</th>
|
338
|
+
</tr>
|
348
339
|
</thead>
|
349
340
|
<tbody valign="top">
|
350
|
-
|
351
|
-
|
352
|
-
|
353
|
-
|
354
|
-
|
355
|
-
|
356
|
-
|
357
|
-
|
358
|
-
|
359
|
-
|
360
|
-
|
361
|
-
|
362
|
-
|
363
|
-
|
364
|
-
|
365
|
-
|
366
|
-
|
367
|
-
|
368
|
-
|
369
|
-
|
370
|
-
|
371
|
-
|
372
|
-
|
373
|
-
|
374
|
-
|
375
|
-
|
376
|
-
|
377
|
-
|
378
|
-
|
379
|
-
|
380
|
-
|
381
|
-
|
382
|
-
|
383
|
-
|
384
|
-
|
385
|
-
|
386
|
-
|
387
|
-
|
388
|
-
|
389
|
-
|
390
|
-
|
391
|
-
|
392
|
-
|
393
|
-
|
394
|
-
|
395
|
-
|
396
|
-
|
397
|
-
|
398
|
-
|
399
|
-
|
400
|
-
|
401
|
-
|
402
|
-
|
403
|
-
|
404
|
-
|
405
|
-
|
406
|
-
|
407
|
-
|
408
|
-
|
409
|
-
|
410
|
-
|
411
|
-
|
412
|
-
|
413
|
-
|
414
|
-
|
415
|
-
|
416
|
-
|
417
|
-
|
418
|
-
|
419
|
-
|
420
|
-
|
421
|
-
|
422
|
-
|
423
|
-
|
424
|
-
|
425
|
-
|
426
|
-
|
427
|
-
|
428
|
-
|
429
|
-
|
430
|
-
|
431
|
-
|
432
|
-
|
433
|
-
|
434
|
-
<td align="left">
|
435
|
-
</td>
|
436
|
-
<td align="left">
|
437
|
-
When <em>latex-use-custom-list-items</em> is defined this package is used for determining the enumeration character.
|
438
|
-
</td>
|
439
|
-
</tr>
|
440
|
-
<tr>
|
441
|
-
<td align="left">
|
442
|
-
graphicx.sty
|
443
|
-
</td>
|
444
|
-
<td align="left">
|
445
|
-
graphics
|
446
|
-
</td>
|
447
|
-
<td align="left">
|
448
|
-
</td>
|
449
|
-
<td align="left">
|
450
|
-
</td>
|
451
|
-
<td align="left">
|
452
|
-
Used for including images.
|
453
|
-
</td>
|
454
|
-
</tr>
|
455
|
-
<tr>
|
456
|
-
<td align="left">
|
457
|
-
longtable.sty
|
458
|
-
</td>
|
459
|
-
<td align="left">
|
460
|
-
tools
|
461
|
-
</td>
|
462
|
-
<td align="left">
|
463
|
-
</td>
|
464
|
-
<td align="left">
|
465
|
-
</td>
|
466
|
-
<td align="left">
|
467
|
-
Enables page spanning tables.
|
468
|
-
</td>
|
469
|
-
</tr>
|
470
|
-
<tr>
|
471
|
-
<td align="left">
|
472
|
-
ucs.sty
|
473
|
-
</td>
|
474
|
-
<td align="left">
|
475
|
-
unicode
|
476
|
-
</td>
|
477
|
-
<td align="left">
|
478
|
-
</td>
|
479
|
-
<td align="left">
|
480
|
-
</td>
|
481
|
-
<td align="left">
|
482
|
-
Enables support for unicode characters.
|
483
|
-
</td>
|
484
|
-
</tr>
|
485
|
-
<tr>
|
486
|
-
<td align="left">
|
487
|
-
textcomp
|
488
|
-
</td>
|
489
|
-
<td align="left">
|
490
|
-
ltxbase
|
491
|
-
</td>
|
492
|
-
<td align="left">
|
493
|
-
</td>
|
494
|
-
<td align="left">
|
495
|
-
</td>
|
496
|
-
<td align="left">
|
497
|
-
Used for printing various symbols like arrows. Should be already installed.
|
498
|
-
</td>
|
499
|
-
</tr>
|
500
|
-
<tr>
|
501
|
-
<td align="left">
|
502
|
-
alltt
|
503
|
-
</td>
|
504
|
-
<td align="left">
|
505
|
-
ltxbase
|
506
|
-
</td>
|
507
|
-
<td align="left">
|
508
|
-
</td>
|
509
|
-
<td align="left">
|
510
|
-
</td>
|
511
|
-
<td align="left">
|
512
|
-
Used in literal-like blocks for retaining line and whitespace formatting. Should be already installed.
|
513
|
-
</td>
|
514
|
-
</tr>
|
515
|
-
<tr>
|
516
|
-
<td align="left">
|
517
|
-
listings.sty
|
518
|
-
</td>
|
519
|
-
<td align="left">
|
520
|
-
listings
|
521
|
-
</td>
|
522
|
-
<td align="left">
|
523
|
-
</td>
|
524
|
-
<td align="left">
|
525
|
-
</td>
|
526
|
-
<td align="left">
|
527
|
-
Used for listing blocks.
|
528
|
-
</td>
|
529
|
-
</tr>
|
341
|
+
<tr>
|
342
|
+
<td align="left"><p class="table">KOMA-Script</p></td>
|
343
|
+
<td align="left"><p class="table">koma-script</p></td>
|
344
|
+
<td align="left"><p class="table"></p></td>
|
345
|
+
<td align="left"><p class="table"></p></td>
|
346
|
+
<td align="left"><p class="table">LaTeX backend uses the document classes <em>scrartcl</em> and <em>scrbook</em> as well as some other specialities defined in the <em>KOMA-Script</em> package, e.g. the commands <tt>\\addmargin{}</tt> and <tt>\minisec{}</tt>.</p></td>
|
347
|
+
</tr>
|
348
|
+
<tr>
|
349
|
+
<td align="left"><p class="table">xcolor.sty</p></td>
|
350
|
+
<td align="left"><p class="table">xcolor</p></td>
|
351
|
+
<td align="left"><p class="table"></p></td>
|
352
|
+
<td align="left"><p class="table"></p></td>
|
353
|
+
<td align="left"><p class="table">Used to produce colored boxes and tables.</p></td>
|
354
|
+
</tr>
|
355
|
+
<tr>
|
356
|
+
<td align="left"><p class="table">colortbl.sty</p></td>
|
357
|
+
<td align="left"><p class="table">colortbl</p></td>
|
358
|
+
<td align="left"><p class="table"></p></td>
|
359
|
+
<td align="left"><p class="table"></p></td>
|
360
|
+
<td align="left"><p class="table">Used to produce colored tables.</p></td>
|
361
|
+
</tr>
|
362
|
+
<tr>
|
363
|
+
<td align="left"><p class="table">type1ec.sty</p></td>
|
364
|
+
<td align="left"><p class="table">cm-super</p></td>
|
365
|
+
<td align="left"><p class="table"></p></td>
|
366
|
+
<td align="left"><p class="table"></p></td>
|
367
|
+
<td align="left"><p class="table">Enables high quality fonts for PDF output.</p></td>
|
368
|
+
</tr>
|
369
|
+
<tr>
|
370
|
+
<td align="left"><p class="table">hyperref.sty</p></td>
|
371
|
+
<td align="left"><p class="table">hyperref</p></td>
|
372
|
+
<td align="left"><p class="table"></p></td>
|
373
|
+
<td align="left"><p class="table"></p></td>
|
374
|
+
<td align="left"><p class="table">Extensive support for hypertext in PDF documents.</p></td>
|
375
|
+
</tr>
|
376
|
+
<tr>
|
377
|
+
<td align="left"><p class="table">enumerate.sty</p></td>
|
378
|
+
<td align="left"><p class="table">tools</p></td>
|
379
|
+
<td align="left"><p class="table"></p></td>
|
380
|
+
<td align="left"><p class="table"></p></td>
|
381
|
+
<td align="left"><p class="table">When <em>latex-use-custom-list-items</em> is defined this package is used for determining the enumeration character.</p></td>
|
382
|
+
</tr>
|
383
|
+
<tr>
|
384
|
+
<td align="left"><p class="table">graphicx.sty</p></td>
|
385
|
+
<td align="left"><p class="table">graphics</p></td>
|
386
|
+
<td align="left"><p class="table"></p></td>
|
387
|
+
<td align="left"><p class="table"></p></td>
|
388
|
+
<td align="left"><p class="table">Used for including images.</p></td>
|
389
|
+
</tr>
|
390
|
+
<tr>
|
391
|
+
<td align="left"><p class="table">longtable.sty</p></td>
|
392
|
+
<td align="left"><p class="table">tools</p></td>
|
393
|
+
<td align="left"><p class="table"></p></td>
|
394
|
+
<td align="left"><p class="table"></p></td>
|
395
|
+
<td align="left"><p class="table">Enables page spanning tables.</p></td>
|
396
|
+
</tr>
|
397
|
+
<tr>
|
398
|
+
<td align="left"><p class="table">ucs.sty</p></td>
|
399
|
+
<td align="left"><p class="table">unicode</p></td>
|
400
|
+
<td align="left"><p class="table"></p></td>
|
401
|
+
<td align="left"><p class="table"></p></td>
|
402
|
+
<td align="left"><p class="table">Enables support for unicode characters.</p></td>
|
403
|
+
</tr>
|
404
|
+
<tr>
|
405
|
+
<td align="left"><p class="table">textcomp</p></td>
|
406
|
+
<td align="left"><p class="table">ltxbase</p></td>
|
407
|
+
<td align="left"><p class="table"></p></td>
|
408
|
+
<td align="left"><p class="table"></p></td>
|
409
|
+
<td align="left"><p class="table">Used for printing various symbols like arrows. Should be already installed.</p></td>
|
410
|
+
</tr>
|
411
|
+
<tr>
|
412
|
+
<td align="left"><p class="table">alltt</p></td>
|
413
|
+
<td align="left"><p class="table">ltxbase</p></td>
|
414
|
+
<td align="left"><p class="table"></p></td>
|
415
|
+
<td align="left"><p class="table"></p></td>
|
416
|
+
<td align="left"><p class="table">Used in literal-like blocks for retaining line and whitespace formatting. Should be already installed.</p></td>
|
417
|
+
</tr>
|
418
|
+
<tr>
|
419
|
+
<td align="left"><p class="table">listings.sty</p></td>
|
420
|
+
<td align="left"><p class="table">listings</p></td>
|
421
|
+
<td align="left"><p class="table"></p></td>
|
422
|
+
<td align="left"><p class="table"></p></td>
|
423
|
+
<td align="left"><p class="table">Used for listing blocks.</p></td>
|
424
|
+
</tr>
|
530
425
|
</tbody>
|
531
426
|
</table>
|
532
427
|
</div>
|
533
428
|
</div>
|
534
429
|
<h2 id="configurationFile">About the LaTeX backend configuration file</h2>
|
535
430
|
<div class="sectionbody">
|
536
|
-
<div class="
|
537
|
-
<div class="
|
538
|
-
<div class="
|
431
|
+
<div class="paragraph"><p>An important note for people who want to adapt the LaTeX backend configuration file to their own needs:</p></div>
|
432
|
+
<div class="paragraph"><p>LaTeX markup has a lot of special characters, most importantly <tt>\</tt>, <tt>{</tt>, <tt>}</tt>. In order to make things less complicated, I changed the default substitution order (see entry <em>subsnormal</em> in the <tt>[miscellaneous]</tt> section). In contrast to the backends <em>docbook</em> and <em>xhtml11</em>, the <em>specialcharacters</em> substitution is applied very late. As a result all special characters produced by <em>quotes</em>, <em>specialwords</em>, <em>replacements</em>, <em>attributes</em> and <em>macros</em> become escaped at the end. If you don’t want special characters in the corresponding sections to get escaped, you’ve to use following symbols instead of the special characters.</p></div>
|
433
|
+
<div class="ulist"><ul>
|
539
434
|
<li>
|
540
435
|
<p>
|
541
|
-
<tt
|
436
|
+
<tt>!..backslash..!</tt> instead of <tt>\</tt>
|
542
437
|
</p>
|
543
438
|
</li>
|
544
439
|
<li>
|
545
440
|
<p>
|
546
|
-
<tt
|
441
|
+
<tt>!..braceleft..!</tt> instead of <tt>{</tt>
|
547
442
|
</p>
|
548
443
|
</li>
|
549
444
|
<li>
|
550
445
|
<p>
|
551
|
-
<tt
|
446
|
+
<tt>!..braceright..!</tt> instead of <tt>}</tt>
|
552
447
|
</p>
|
553
448
|
</li>
|
554
449
|
</ul></div>
|
555
|
-
<div class="
|
450
|
+
<div class="paragraph"><p>For more special characters take a look in the <tt>[replacements2]</tt> sections. <tt>[replacements2]</tt> section is responsible for replacing the symbols with their corresponding special characters.</p></div>
|
556
451
|
</div>
|
557
452
|
<h2 id="_ideas">Ideas</h2>
|
558
453
|
<div class="sectionbody">
|
559
454
|
<h3 id="_code_listing_block">Code listing block</h3><div style="clear:left"></div>
|
560
|
-
<div class="
|
455
|
+
<div class="paragraph"><p>For creating highlighted code listings I suggest the use of <a href="http://www.andre-simon.de/">Highlight</a> or <a href="http://www.gnu.org/software/src-highlite/">GNU Source Highlight</a>. Both are suited for use as Asciidoc filters.</p></div>
|
561
456
|
</div>
|
562
457
|
<h2 id="_known_bugs">Known Bugs</h2>
|
563
458
|
<div class="sectionbody">
|
564
|
-
<div class="
|
459
|
+
<div class="ulist"><ul>
|
565
460
|
<li>
|
566
461
|
<p>
|
567
462
|
Sometimes LaTeX backend handles things differently from the default backends
|
@@ -576,7 +471,7 @@ A lot of little bugs
|
|
576
471
|
</div>
|
577
472
|
<h2 id="_todo_list">Todo List</h2>
|
578
473
|
<div class="sectionbody">
|
579
|
-
<div class="
|
474
|
+
<div class="ulist"><ul>
|
580
475
|
<li>
|
581
476
|
<p>
|
582
477
|
Remove bugs
|
@@ -612,7 +507,7 @@ Option for switching titlepage on and off
|
|
612
507
|
<div id="footer">
|
613
508
|
<div id="footer-text">
|
614
509
|
Version 1.0<br />
|
615
|
-
Last updated 2008-
|
510
|
+
Last updated 2008-12-13 09:59:45 NZDT
|
616
511
|
</div>
|
617
512
|
<div id="footer-badges">
|
618
513
|
<a href="http://validator.w3.org/check?uri=referer">
|