From 1ee6e0e0878bcd655f31deb0caf6a4766e500cc6 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Wed, 14 Aug 2019 22:11:05 -0700
Subject: Use new doctemplates, doclayout.
+ Remove Text.Pandoc.Pretty; use doclayout instead. [API change]
+ Text.Pandoc.Writers.Shared: remove metaToJSON, metaToJSON'
[API change].
+ Text.Pandoc.Writers.Shared: modify `addVariablesToContext`,
`defField`, `setField`, `getField`, `resetField` to work with
Context rather than JSON values. [API change]
+ Text.Pandoc.Writers.Shared: export new function `endsWithPlain` [API
change].
+ Use new templates and doclayout in writers.
+ Use Doc-based templates in all writers.
+ Adjust three tests for minor template rendering differences.
+ Added indentation to body in docbook4, docbook5 templates.
The main impact of this change is better reflowing of content
interpolated into templates. Previously, interpolated variables
were rendered independently and intepolated as strings, which could lead
to overly long lines. Now the templates interpolated as Doc values
which may include breaking spaces, and reflowing occurs
after template interpolation rather than before.
---
test/writer.docbook5 | 2453 +++++++++++++++++++++++++-------------------------
1 file changed, 1228 insertions(+), 1225 deletions(-)
(limited to 'test/writer.docbook5')
diff --git a/test/writer.docbook5 b/test/writer.docbook5
index 9a9eff0c5..afc37e5a7 100644
--- a/test/writer.docbook5
+++ b/test/writer.docbook5
@@ -17,123 +17,123 @@
</authorgroup>
<date>July 17, 2006</date>
</info>
-<para>
- This is a set of tests for pandoc. Most of them are adapted from John
- Gruber’s markdown test suite.
-</para>
-<section xml:id="headers">
- <title>Headers</title>
- <section xml:id="level-2-with-an-embedded-link">
- <title>Level 2 with an <link xlink:href="/url">embedded
- link</link></title>
- <section xml:id="level-3-with-emphasis">
- <title>Level 3 with <emphasis>emphasis</emphasis></title>
- <section xml:id="level-4">
- <title>Level 4</title>
- <section xml:id="level-5">
- <title>Level 5</title>
- <para>
- </para>
+ <para>
+ This is a set of tests for pandoc. Most of them are adapted from John
+ Gruber’s markdown test suite.
+ </para>
+ <section xml:id="headers">
+ <title>Headers</title>
+ <section xml:id="level-2-with-an-embedded-link">
+ <title>Level 2 with an <link xlink:href="/url">embedded
+ link</link></title>
+ <section xml:id="level-3-with-emphasis">
+ <title>Level 3 with <emphasis>emphasis</emphasis></title>
+ <section xml:id="level-4">
+ <title>Level 4</title>
+ <section xml:id="level-5">
+ <title>Level 5</title>
+ <para>
+ </para>
+ </section>
</section>
</section>
</section>
</section>
-</section>
-<section xml:id="level-1">
- <title>Level 1</title>
- <section xml:id="level-2-with-emphasis">
- <title>Level 2 with <emphasis>emphasis</emphasis></title>
- <section xml:id="level-3">
- <title>Level 3</title>
+ <section xml:id="level-1">
+ <title>Level 1</title>
+ <section xml:id="level-2-with-emphasis">
+ <title>Level 2 with <emphasis>emphasis</emphasis></title>
+ <section xml:id="level-3">
+ <title>Level 3</title>
+ <para>
+ with no blank line
+ </para>
+ </section>
+ </section>
+ <section xml:id="level-2">
+ <title>Level 2</title>
<para>
with no blank line
</para>
</section>
</section>
- <section xml:id="level-2">
- <title>Level 2</title>
- <para>
- with no blank line
- </para>
- </section>
-</section>
-<section xml:id="paragraphs">
- <title>Paragraphs</title>
- <para>
- Here’s a regular paragraph.
- </para>
- <para>
- In Markdown 1.0.0 and earlier. Version 8. This line turns into a list
- item. Because a hard-wrapped line in the middle of a paragraph looked like
- a list item.
- </para>
- <para>
- Here’s one with a bullet. * criminey.
- </para>
-<literallayout>There should be a hard line break
-here.</literallayout>
-</section>
-<section xml:id="block-quotes">
- <title>Block Quotes</title>
- <para>
- E-mail style:
- </para>
- <blockquote>
+ <section xml:id="paragraphs">
+ <title>Paragraphs</title>
<para>
- This is a block quote. It is pretty short.
+ Here’s a regular paragraph.
</para>
- </blockquote>
- <blockquote>
<para>
- Code in a block quote:
+ In Markdown 1.0.0 and earlier. Version 8. This line turns into a list
+ item. Because a hard-wrapped line in the middle of a paragraph looked
+ like a list item.
</para>
- <programlisting>
-sub status {
- print "working";
-}
-</programlisting>
<para>
- A list:
+ Here’s one with a bullet. * criminey.
</para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
- <para>
- item one
- </para>
- </listitem>
- <listitem>
- <para>
- item two
- </para>
- </listitem>
- </orderedlist>
+<literallayout>There should be a hard line break
+here.</literallayout>
+ </section>
+ <section xml:id="block-quotes">
+ <title>Block Quotes</title>
<para>
- Nested block quotes:
+ E-mail style:
</para>
<blockquote>
<para>
- nested
+ This is a block quote. It is pretty short.
</para>
</blockquote>
<blockquote>
<para>
- nested
+ Code in a block quote:
+ </para>
+ <programlisting>
+sub status {
+ print "working";
+}
+</programlisting>
+ <para>
+ A list:
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ item one
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ item two
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ Nested block quotes:
</para>
+ <blockquote>
+ <para>
+ nested
+ </para>
+ </blockquote>
+ <blockquote>
+ <para>
+ nested
+ </para>
+ </blockquote>
</blockquote>
- </blockquote>
- <para>
- This should not be a block quote: 2 > 1.
- </para>
- <para>
- And a following paragraph.
- </para>
-</section>
-<section xml:id="code-blocks">
- <title>Code Blocks</title>
- <para>
- Code:
- </para>
- <programlisting>
+ <para>
+ This should not be a block quote: 2 > 1.
+ </para>
+ <para>
+ And a following paragraph.
+ </para>
+ </section>
+ <section xml:id="code-blocks">
+ <title>Code Blocks</title>
+ <para>
+ Code:
+ </para>
+ <programlisting>
---- (should be four hyphens)
sub status {
@@ -142,1250 +142,1253 @@ sub status {
this code block is indented by one tab
</programlisting>
- <para>
- And:
- </para>
- <programlisting>
+ <para>
+ And:
+ </para>
+ <programlisting>
this code block is indented by two tabs
These should not be escaped: \$ \\ \> \[ \{
</programlisting>
-</section>
-<section xml:id="lists">
- <title>Lists</title>
- <section xml:id="unordered">
- <title>Unordered</title>
+ </section>
+ <section xml:id="lists">
+ <title>Lists</title>
+ <section xml:id="unordered">
+ <title>Unordered</title>
+ <para>
+ Asterisks tight:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ asterisk 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ asterisk 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ asterisk 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Asterisks loose:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ asterisk 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ asterisk 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ asterisk 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Pluses tight:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Plus 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Plus 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Plus 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Pluses loose:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Plus 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Plus 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Plus 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Minuses tight:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Minus 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Minus 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Minus 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Minuses loose:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Minus 1
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Minus 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Minus 3
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section xml:id="ordered">
+ <title>Ordered</title>
+ <para>
+ Tight:
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ First
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Second
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Third
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ and:
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ One
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Two
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Three
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ Loose using tabs:
+ </para>
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ First
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Second
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Third
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ and using spaces:
+ </para>
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ One
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Two
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Three
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ Multiple paragraphs:
+ </para>
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ Item 1, graf one.
+ </para>
+ <para>
+ Item 1. graf two. The quick brown fox jumped over the lazy dog’s
+ back.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Item 2.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Item 3.
+ </para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section xml:id="nested">
+ <title>Nested</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Tab
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Tab
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Tab
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Here’s another:
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ First
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Second:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Fee
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Fie
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Foe
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Third
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ Same thing but with paragraphs:
+ </para>
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>
+ First
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Second:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Fee
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Fie
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Foe
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Third
+ </para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section xml:id="tabs-and-spaces">
+ <title>Tabs and spaces</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ this is a list item indented with tabs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ this is a list item indented with spaces
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ this is an example list item indented with tabs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ this is an example list item indented with spaces
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section xml:id="fancy-list-markers">
+ <title>Fancy list markers</title>
+ <orderedlist numeration="arabic">
+ <listitem override="2">
+ <para>
+ begins with 2
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ and now 3
+ </para>
+ <para>
+ with a continuation
+ </para>
+ <orderedlist numeration="lowerroman" spacing="compact">
+ <listitem override="4">
+ <para>
+ sublist with roman numerals, starting with 4
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ more items
+ </para>
+ <orderedlist numeration="upperalpha" spacing="compact">
+ <listitem>
+ <para>
+ a subsublist
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ a subsublist
+ </para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ <para>
+ Nesting:
+ </para>
+ <orderedlist numeration="upperalpha" spacing="compact">
+ <listitem>
+ <para>
+ Upper Alpha
+ </para>
+ <orderedlist numeration="upperroman" spacing="compact">
+ <listitem>
+ <para>
+ Upper Roman.
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem override="6">
+ <para>
+ Decimal start with 6
+ </para>
+ <orderedlist numeration="loweralpha" spacing="compact">
+ <listitem override="3">
+ <para>
+ Lower alpha with paren
+ </para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ <para>
+ Autonumbering:
+ </para>
+ <orderedlist spacing="compact">
+ <listitem>
+ <para>
+ Autonumber.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ More.
+ </para>
+ <orderedlist spacing="compact">
+ <listitem>
+ <para>
+ Nested.
+ </para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </orderedlist>
+ <para>
+ Should not be a list item:
+ </para>
+ <para>
+ M.A. 2007
+ </para>
+ <para>
+ B. Williams
+ </para>
+ </section>
+ </section>
+ <section xml:id="definition-lists">
+ <title>Definition Lists</title>
<para>
- Asterisks tight:
+ Tight using spaces:
</para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- asterisk 1
- </para>
- </listitem>
- <listitem>
- <para>
- asterisk 2
- </para>
- </listitem>
- <listitem>
- <para>
- asterisk 3
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ banana
+ </term>
+ <listitem>
+ <para>
+ yellow fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Asterisks loose:
+ Tight using tabs:
</para>
- <itemizedlist>
- <listitem>
- <para>
- asterisk 1
- </para>
- </listitem>
- <listitem>
- <para>
- asterisk 2
- </para>
- </listitem>
- <listitem>
- <para>
- asterisk 3
- </para>
- </listitem>
- </itemizedlist>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ banana
+ </term>
+ <listitem>
+ <para>
+ yellow fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Pluses tight:
+ Loose:
</para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Plus 1
- </para>
- </listitem>
- <listitem>
- <para>
- Plus 2
- </para>
- </listitem>
- <listitem>
- <para>
- Plus 3
- </para>
- </listitem>
- </itemizedlist>
- <para>
- Pluses loose:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- Plus 1
- </para>
- </listitem>
- <listitem>
- <para>
- Plus 2
- </para>
- </listitem>
- <listitem>
- <para>
- Plus 3
- </para>
- </listitem>
- </itemizedlist>
- <para>
- Minuses tight:
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Minus 1
- </para>
- </listitem>
- <listitem>
- <para>
- Minus 2
- </para>
- </listitem>
- <listitem>
- <para>
- Minus 3
- </para>
- </listitem>
- </itemizedlist>
- <para>
- Minuses loose:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- Minus 1
- </para>
- </listitem>
- <listitem>
- <para>
- Minus 2
- </para>
- </listitem>
- <listitem>
- <para>
- Minus 3
- </para>
- </listitem>
- </itemizedlist>
- </section>
- <section xml:id="ordered">
- <title>Ordered</title>
- <para>
- Tight:
- </para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
- <para>
- First
- </para>
- </listitem>
- <listitem>
- <para>
- Second
- </para>
- </listitem>
- <listitem>
- <para>
- Third
- </para>
- </listitem>
- </orderedlist>
- <para>
- and:
- </para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
- <para>
- One
- </para>
- </listitem>
- <listitem>
- <para>
- Two
- </para>
- </listitem>
- <listitem>
- <para>
- Three
- </para>
- </listitem>
- </orderedlist>
- <para>
- Loose using tabs:
- </para>
- <orderedlist numeration="arabic">
- <listitem>
- <para>
- First
- </para>
- </listitem>
- <listitem>
- <para>
- Second
- </para>
- </listitem>
- <listitem>
- <para>
- Third
- </para>
- </listitem>
- </orderedlist>
- <para>
- and using spaces:
- </para>
- <orderedlist numeration="arabic">
- <listitem>
- <para>
- One
- </para>
- </listitem>
- <listitem>
- <para>
- Two
- </para>
- </listitem>
- <listitem>
- <para>
- Three
- </para>
- </listitem>
- </orderedlist>
- <para>
- Multiple paragraphs:
- </para>
- <orderedlist numeration="arabic">
- <listitem>
- <para>
- Item 1, graf one.
- </para>
- <para>
- Item 1. graf two. The quick brown fox jumped over the lazy dog’s
- back.
- </para>
- </listitem>
- <listitem>
- <para>
- Item 2.
- </para>
- </listitem>
- <listitem>
- <para>
- Item 3.
- </para>
- </listitem>
- </orderedlist>
- </section>
- <section xml:id="nested">
- <title>Nested</title>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Tab
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Tab
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Tab
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ banana
+ </term>
+ <listitem>
+ <para>
+ yellow fruit
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Here’s another:
+ Multiple blocks with italics:
</para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
- <para>
- First
- </para>
- </listitem>
- <listitem>
- <para>
- Second:
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Fee
- </para>
- </listitem>
- <listitem>
- <para>
- Fie
- </para>
- </listitem>
- <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <emphasis>apple</emphasis>
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ <para>
+ contains seeds, crisp, pleasant to taste
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis>orange</emphasis>
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ <programlisting>
+{ orange code block }
+</programlisting>
+ <blockquote>
<para>
- Foe
+ orange block quote
</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>
- Third
- </para>
- </listitem>
- </orderedlist>
+ </blockquote>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Same thing but with paragraphs:
+ Multiple definitions, tight:
</para>
- <orderedlist numeration="arabic">
- <listitem>
- <para>
- First
- </para>
- </listitem>
- <listitem>
- <para>
- Second:
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- Fee
- </para>
- </listitem>
- <listitem>
- <para>
- Fie
- </para>
- </listitem>
- <listitem>
- <para>
- Foe
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>
- Third
- </para>
- </listitem>
- </orderedlist>
- </section>
- <section xml:id="tabs-and-spaces">
- <title>Tabs and spaces</title>
- <itemizedlist>
- <listitem>
- <para>
- this is a list item indented with tabs
- </para>
- </listitem>
- <listitem>
- <para>
- this is a list item indented with spaces
- </para>
- <itemizedlist>
- <listitem>
- <para>
- this is an example list item indented with tabs
- </para>
- </listitem>
- <listitem>
- <para>
- this is an example list item indented with spaces
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
- </section>
- <section xml:id="fancy-list-markers">
- <title>Fancy list markers</title>
- <orderedlist numeration="arabic">
- <listitem override="2">
- <para>
- begins with 2
- </para>
- </listitem>
- <listitem>
- <para>
- and now 3
- </para>
- <para>
- with a continuation
- </para>
- <orderedlist numeration="lowerroman" spacing="compact">
- <listitem override="4">
- <para>
- sublist with roman numerals, starting with 4
- </para>
- </listitem>
- <listitem>
- <para>
- more items
- </para>
- <orderedlist numeration="upperalpha" spacing="compact">
- <listitem>
- <para>
- a subsublist
- </para>
- </listitem>
- <listitem>
- <para>
- a subsublist
- </para>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ <para>
+ computer
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ <para>
+ bank
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Nesting:
+ Multiple definitions, loose:
</para>
- <orderedlist numeration="upperalpha" spacing="compact">
- <listitem>
- <para>
- Upper Alpha
- </para>
- <orderedlist numeration="upperroman" spacing="compact">
- <listitem>
- <para>
- Upper Roman.
- </para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem override="6">
- <para>
- Decimal start with 6
- </para>
- <orderedlist numeration="loweralpha" spacing="compact">
- <listitem override="3">
- <para>
- Lower alpha with paren
- </para>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
+ <para>
+ red fruit
+ </para>
+ <para>
+ computer
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ <para>
+ bank
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
- Autonumbering:
+ Blank line after term, indented marker, alternate markers:
</para>
- <orderedlist spacing="compact">
- <listitem>
- <para>
- Autonumber.
- </para>
- </listitem>
- <listitem>
- <para>
- More.
- </para>
- <orderedlist spacing="compact">
- <listitem>
- <para>
- Nested.
- </para>
- </listitem>
- </orderedlist>
- </listitem>
- </orderedlist>
- <para>
- Should not be a list item:
- </para>
- <para>
- M.A. 2007
- </para>
- <para>
- B. Williams
- </para>
- </section>
-</section>
-<section xml:id="definition-lists">
- <title>Definition Lists</title>
- <para>
- Tight using spaces:
- </para>
- <variablelist spacing="compact">
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- banana
- </term>
- <listitem>
- <para>
- yellow fruit
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Tight using tabs:
- </para>
- <variablelist spacing="compact">
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- banana
- </term>
- <listitem>
- <para>
- yellow fruit
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Loose:
- </para>
- <variablelist>
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- banana
- </term>
- <listitem>
- <para>
- yellow fruit
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Multiple blocks with italics:
- </para>
- <variablelist>
- <varlistentry>
- <term>
- <emphasis>apple</emphasis>
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- <para>
- contains seeds, crisp, pleasant to taste
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <emphasis>orange</emphasis>
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- <programlisting>
-{ orange code block }
-</programlisting>
- <blockquote>
+ <variablelist>
+ <varlistentry>
+ <term>
+ apple
+ </term>
+ <listitem>
<para>
- orange block quote
+ red fruit
</para>
- </blockquote>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Multiple definitions, tight:
- </para>
- <variablelist spacing="compact">
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- <para>
- computer
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- <para>
- bank
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Multiple definitions, loose:
- </para>
- <variablelist>
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- <para>
- computer
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- <para>
- bank
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- Blank line after term, indented marker, alternate markers:
- </para>
- <variablelist>
- <varlistentry>
- <term>
- apple
- </term>
- <listitem>
- <para>
- red fruit
- </para>
- <para>
- computer
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- orange
- </term>
- <listitem>
- <para>
- orange fruit
- </para>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
- <para>
- sublist
- </para>
- </listitem>
- <listitem>
- <para>
- sublist
- </para>
- </listitem>
- </orderedlist>
- </listitem>
- </varlistentry>
- </variablelist>
-</section>
-<section xml:id="html-blocks">
- <title>HTML Blocks</title>
- <para>
- Simple block on one line:
- </para>
- <para>
- foo
- </para>
- <para>
- And nested without indentation:
- </para>
- <para>
- foo
- </para>
- <para>
- bar
- </para>
- <para>
- Interpreted markdown in a table:
- </para>
- This is <emphasis>emphasized</emphasis>
- And this is <emphasis role="strong">strong</emphasis>
- <para>
- Here’s a simple block:
- </para>
- <para>
- foo
- </para>
- <para>
- This should be a code block, though:
- </para>
- <programlisting>
-<div>
- foo
-</div>
-</programlisting>
- <para>
- As should this:
- </para>
- <programlisting>
-<div>foo</div>
-</programlisting>
- <para>
- Now, nested:
- </para>
- <para>
- foo
- </para>
- <para>
- This should just be an HTML comment:
- </para>
- <para>
- Multiline:
- </para>
- <para>
- Code block:
- </para>
- <programlisting>
-<!-- Comment -->
-</programlisting>
- <para>
- Just plain comment, with trailing spaces on the line:
- </para>
- <para>
- Code:
- </para>
- <programlisting>
-<hr />
-</programlisting>
- <para>
- Hr’s:
- </para>
-</section>
-<section xml:id="inline-markup">
- <title>Inline Markup</title>
- <para>
- This is <emphasis>emphasized</emphasis>, and so <emphasis>is
- this</emphasis>.
- </para>
- <para>
- This is <emphasis role="strong">strong</emphasis>, and so
- <emphasis role="strong">is this</emphasis>.
- </para>
- <para>
- An <emphasis><link xlink:href="/url">emphasized link</link></emphasis>.
- </para>
- <para>
- <emphasis role="strong"><emphasis>This is strong and
- em.</emphasis></emphasis>
- </para>
- <para>
- So is <emphasis role="strong"><emphasis>this</emphasis></emphasis> word.
- </para>
- <para>
- <emphasis role="strong"><emphasis>This is strong and
- em.</emphasis></emphasis>
- </para>
- <para>
- So is <emphasis role="strong"><emphasis>this</emphasis></emphasis> word.
- </para>
- <para>
- This is code: <literal>></literal>, <literal>$</literal>,
- <literal>\</literal>, <literal>\$</literal>,
- <literal><html></literal>.
- </para>
- <para>
- <emphasis role="strikethrough">This is
- <emphasis>strikeout</emphasis>.</emphasis>
- </para>
- <para>
- Superscripts: a<superscript>bc</superscript>d
- a<superscript><emphasis>hello</emphasis></superscript>
- a<superscript>hello there</superscript>.
- </para>
- <para>
- Subscripts: H<subscript>2</subscript>O, H<subscript>23</subscript>O,
- H<subscript>many of them</subscript>O.
- </para>
- <para>
- These should not be superscripts or subscripts, because of the unescaped
- spaces: a^b c^d, a~b c~d.
- </para>
-</section>
-<section xml:id="smart-quotes-ellipses-dashes">
- <title>Smart quotes, ellipses, dashes</title>
- <para>
- <quote>Hello,</quote> said the spider. <quote><quote>Shelob</quote> is my
- name.</quote>
- </para>
- <para>
- <quote>A</quote>, <quote>B</quote>, and <quote>C</quote> are letters.
- </para>
- <para>
- <quote>Oak,</quote> <quote>elm,</quote> and <quote>beech</quote> are names
- of trees. So is <quote>pine.</quote>
- </para>
- <para>
- <quote>He said, <quote>I want to go.</quote></quote> Were you alive in the
- 70’s?
- </para>
- <para>
- Here is some quoted <quote><literal>code</literal></quote> and a
- <quote><link xlink:href="http://example.com/?foo=1&bar=2">quoted
- link</link></quote>.
- </para>
- <para>
- Some dashes: one—two — three—four — five.
- </para>
- <para>
- Dashes between numbers: 5–7, 255–66, 1987–1999.
- </para>
- <para>
- Ellipses…and…and….
- </para>
-</section>
-<section xml:id="latex">
- <title>LaTeX</title>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- </para>
- </listitem>
- <listitem>
- <para>
- 2 + 2 = 4
- </para>
- </listitem>
- <listitem>
- <para>
- <emphasis>x</emphasis> ∈ <emphasis>y</emphasis>
- </para>
- </listitem>
- <listitem>
- <para>
- <emphasis>α</emphasis> ∧ <emphasis>ω</emphasis>
- </para>
- </listitem>
- <listitem>
- <para>
- 223
- </para>
- </listitem>
- <listitem>
- <para>
- <emphasis>p</emphasis>-Tree
- </para>
- </listitem>
- <listitem>
- <para>
- Here’s some display math:
- $$\frac{d}{dx}f(x)=\lim_{h\to 0}\frac{f(x+h)-f(x)}{h}$$
- </para>
- </listitem>
- <listitem>
- <para>
- Here’s one that has a line break in it:
- <emphasis>α</emphasis> + <emphasis>ω</emphasis> × <emphasis>x</emphasis><superscript>2</superscript>.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- These shouldn’t be math:
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- To get the famous equation, write <literal>$e = mc^2$</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- $22,000 is a <emphasis>lot</emphasis> of money. So is $34,000. (It
- worked if <quote>lot</quote> is emphasized.)
- </para>
- </listitem>
- <listitem>
- <para>
- Shoes ($20) and socks ($5).
- </para>
- </listitem>
- <listitem>
- <para>
- Escaped <literal>$</literal>: $73 <emphasis>this should be
- emphasized</emphasis> 23$.
- </para>
- </listitem>
- </itemizedlist>
- <para>
- Here’s a LaTeX table:
- </para>
-</section>
-<section xml:id="special-characters">
- <title>Special Characters</title>
- <para>
- Here is some unicode:
- </para>
- <itemizedlist spacing="compact">
- <listitem>
- <para>
- I hat: Î
- </para>
- </listitem>
- <listitem>
- <para>
- o umlaut: ö
- </para>
- </listitem>
- <listitem>
- <para>
- section: §
- </para>
- </listitem>
- <listitem>
- <para>
- set membership: ∈
- </para>
- </listitem>
- <listitem>
- <para>
- copyright: ©
- </para>
- </listitem>
- </itemizedlist>
- <para>
- AT&T has an ampersand in their name.
- </para>
- <para>
- AT&T is another way to write it.
- </para>
- <para>
- This & that.
- </para>
- <para>
- 4 < 5.
- </para>
- <para>
- 6 > 5.
- </para>
- <para>
- Backslash: \
- </para>
- <para>
- Backtick: `
- </para>
- <para>
- Asterisk: *
- </para>
- <para>
- Underscore: _
- </para>
- <para>
- Left brace: {
- </para>
- <para>
- Right brace: }
- </para>
- <para>
- Left bracket: [
- </para>
- <para>
- Right bracket: ]
- </para>
- <para>
- Left paren: (
- </para>
- <para>
- Right paren: )
- </para>
- <para>
- Greater-than: >
- </para>
- <para>
- Hash: #
- </para>
- <para>
- Period: .
- </para>
- <para>
- Bang: !
- </para>
- <para>
- Plus: +
- </para>
- <para>
- Minus: -
- </para>
-</section>
-<section xml:id="links">
- <title>Links</title>
- <section xml:id="explicit">
- <title>Explicit</title>
+ <para>
+ computer
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ orange
+ </term>
+ <listitem>
+ <para>
+ orange fruit
+ </para>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ sublist
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ sublist
+ </para>
+ </listitem>
+ </orderedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section xml:id="html-blocks">
+ <title>HTML Blocks</title>
<para>
- Just a <link xlink:href="/url/">URL</link>.
+ Simple block on one line:
</para>
<para>
- <link xlink:href="/url/">URL and title</link>.
+ foo
</para>
<para>
- <link xlink:href="/url/">URL and title</link>.
+ And nested without indentation:
</para>
<para>
- <link xlink:href="/url/">URL and title</link>.
+ foo
</para>
<para>
- <link xlink:href="/url/">URL and title</link>
+ bar
</para>
<para>
- <link xlink:href="/url/">URL and title</link>
+ Interpreted markdown in a table:
</para>
+ This is <emphasis>emphasized</emphasis>
+ And this is <emphasis role="strong">strong</emphasis>
<para>
- <link xlink:href="/url/with_underscore">with_underscore</link>
+ Here’s a simple block:
</para>
<para>
- Email link (<email>nobody@nowhere.net</email>)
+ foo
</para>
<para>
- <link xlink:href="">Empty</link>.
+ This should be a code block, though:
</para>
- </section>
- <section xml:id="reference">
- <title>Reference</title>
+ <programlisting>
+<div>
+ foo
+</div>
+</programlisting>
<para>
- Foo <link xlink:href="/url/">bar</link>.
+ As should this:
+ </para>
+ <programlisting>
+<div>foo</div>
+</programlisting>
+ <para>
+ Now, nested:
</para>
<para>
- With <link xlink:href="/url/">embedded [brackets]</link>.
+ foo
</para>
<para>
- <link xlink:href="/url/">b</link> by itself should be a link.
+ This should just be an HTML comment:
</para>
<para>
- Indented <link xlink:href="/url">once</link>.
+ Multiline:
</para>
<para>
- Indented <link xlink:href="/url">twice</link>.
+ Code block:
</para>
+ <programlisting>
+<!-- Comment -->
+</programlisting>
<para>
- Indented <link xlink:href="/url">thrice</link>.
+ Just plain comment, with trailing spaces on the line:
</para>
<para>
- This should [not][] be a link.
+ Code:
</para>
<programlisting>
-[not]: /url
+<hr />
</programlisting>
<para>
- Foo <link xlink:href="/url/">bar</link>.
+ Hr’s:
+ </para>
+ </section>
+ <section xml:id="inline-markup">
+ <title>Inline Markup</title>
+ <para>
+ This is <emphasis>emphasized</emphasis>, and so <emphasis>is
+ this</emphasis>.
+ </para>
+ <para>
+ This is <emphasis role="strong">strong</emphasis>, and so
+ <emphasis role="strong">is this</emphasis>.
+ </para>
+ <para>
+ An <emphasis><link xlink:href="/url">emphasized link</link></emphasis>.
+ </para>
+ <para>
+ <emphasis role="strong"><emphasis>This is strong and
+ em.</emphasis></emphasis>
+ </para>
+ <para>
+ So is <emphasis role="strong"><emphasis>this</emphasis></emphasis> word.
+ </para>
+ <para>
+ <emphasis role="strong"><emphasis>This is strong and
+ em.</emphasis></emphasis>
+ </para>
+ <para>
+ So is <emphasis role="strong"><emphasis>this</emphasis></emphasis> word.
+ </para>
+ <para>
+ This is code: <literal>></literal>, <literal>$</literal>,
+ <literal>\</literal>, <literal>\$</literal>,
+ <literal><html></literal>.
+ </para>
+ <para>
+ <emphasis role="strikethrough">This is
+ <emphasis>strikeout</emphasis>.</emphasis>
+ </para>
+ <para>
+ Superscripts: a<superscript>bc</superscript>d
+ a<superscript><emphasis>hello</emphasis></superscript>
+ a<superscript>hello there</superscript>.
+ </para>
+ <para>
+ Subscripts: H<subscript>2</subscript>O, H<subscript>23</subscript>O,
+ H<subscript>many of them</subscript>O.
</para>
<para>
- Foo <link xlink:href="/url/">biz</link>.
+ These should not be superscripts or subscripts, because of the unescaped
+ spaces: a^b c^d, a~b c~d.
</para>
</section>
- <section xml:id="with-ampersands">
- <title>With ampersands</title>
+ <section xml:id="smart-quotes-ellipses-dashes">
+ <title>Smart quotes, ellipses, dashes</title>
+ <para>
+ <quote>Hello,</quote> said the spider. <quote><quote>Shelob</quote> is
+ my name.</quote>
+ </para>
+ <para>
+ <quote>A</quote>, <quote>B</quote>, and <quote>C</quote> are letters.
+ </para>
+ <para>
+ <quote>Oak,</quote> <quote>elm,</quote> and <quote>beech</quote> are
+ names of trees. So is <quote>pine.</quote>
+ </para>
+ <para>
+ <quote>He said, <quote>I want to go.</quote></quote> Were you alive in
+ the 70’s?
+ </para>
+ <para>
+ Here is some quoted <quote><literal>code</literal></quote> and a
+ <quote><link xlink:href="http://example.com/?foo=1&bar=2">quoted
+ link</link></quote>.
+ </para>
+ <para>
+ Some dashes: one—two — three—four — five.
+ </para>
<para>
- Here’s a <link xlink:href="http://example.com/?foo=1&bar=2">link
- with an ampersand in the URL</link>.
+ Dashes between numbers: 5–7, 255–66, 1987–1999.
</para>
<para>
- Here’s a link with an amersand in the link text:
- <link xlink:href="http://att.com/">AT&T</link>.
+ Ellipses…and…and….
</para>
+ </section>
+ <section xml:id="latex">
+ <title>LaTeX</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 2 + 2 = 4
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>x</emphasis> ∈ <emphasis>y</emphasis>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>α</emphasis> ∧ <emphasis>ω</emphasis>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 223
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis>p</emphasis>-Tree
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Here’s some display math:
+ $$\frac{d}{dx}f(x)=\lim_{h\to 0}\frac{f(x+h)-f(x)}{h}$$
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Here’s one that has a line break in it:
+ <emphasis>α</emphasis> + <emphasis>ω</emphasis> × <emphasis>x</emphasis><superscript>2</superscript>.
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
- Here’s an <link xlink:href="/script?foo=1&bar=2">inline link</link>.
+ These shouldn’t be math:
</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ To get the famous equation, write <literal>$e = mc^2$</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ $22,000 is a <emphasis>lot</emphasis> of money. So is $34,000. (It
+ worked if <quote>lot</quote> is emphasized.)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Shoes ($20) and socks ($5).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Escaped <literal>$</literal>: $73 <emphasis>this should be
+ emphasized</emphasis> 23$.
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
- Here’s an <link xlink:href="/script?foo=1&bar=2">inline link in
- pointy braces</link>.
+ Here’s a LaTeX table:
</para>
</section>
- <section xml:id="autolinks">
- <title>Autolinks</title>
+ <section xml:id="special-characters">
+ <title>Special Characters</title>
<para>
- With an ampersand:
- <link xlink:href="http://example.com/?foo=1&bar=2" role="uri">http://example.com/?foo=1&bar=2</link>
+ Here is some unicode:
</para>
<itemizedlist spacing="compact">
<listitem>
<para>
- In a list?
+ I hat: Î
</para>
</listitem>
<listitem>
<para>
- <link xlink:href="http://example.com/" role="uri">http://example.com/</link>
+ o umlaut: ö
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ section: §
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ set membership: ∈
</para>
</listitem>
<listitem>
<para>
- It should.
+ copyright: ©
</para>
</listitem>
</itemizedlist>
<para>
- An e-mail address: <email>nobody@nowhere.net</email>
+ AT&T has an ampersand in their name.
</para>
- <blockquote>
- <para>
- Blockquoted:
- <link xlink:href="http://example.com/" role="uri">http://example.com/</link>
- </para>
- </blockquote>
<para>
- Auto-links should not occur here:
- <literal><http://example.com/></literal>
+ AT&T is another way to write it.
+ </para>
+ <para>
+ This & that.
+ </para>
+ <para>
+ 4 < 5.
+ </para>
+ <para>
+ 6 > 5.
+ </para>
+ <para>
+ Backslash: \
+ </para>
+ <para>
+ Backtick: `
+ </para>
+ <para>
+ Asterisk: *
+ </para>
+ <para>
+ Underscore: _
+ </para>
+ <para>
+ Left brace: {
+ </para>
+ <para>
+ Right brace: }
+ </para>
+ <para>
+ Left bracket: [
+ </para>
+ <para>
+ Right bracket: ]
+ </para>
+ <para>
+ Left paren: (
+ </para>
+ <para>
+ Right paren: )
+ </para>
+ <para>
+ Greater-than: >
+ </para>
+ <para>
+ Hash: #
+ </para>
+ <para>
+ Period: .
+ </para>
+ <para>
+ Bang: !
+ </para>
+ <para>
+ Plus: +
+ </para>
+ <para>
+ Minus: -
</para>
- <programlisting>
-or here: <http://example.com/>
-</programlisting>
</section>
-</section>
-<section xml:id="images">
- <title>Images</title>
- <para>
- From <quote>Voyage dans la Lune</quote> by Georges Melies (1902):
- </para>
- <figure>
- <title>lalune</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="lalune.jpg" />
- </imageobject>
- <textobject><phrase>lalune</phrase></textobject>
- </mediaobject>
- </figure>
- <para>
- Here is a movie <inlinemediaobject>
- <imageobject>
- <imagedata fileref="movie.jpg" />
- </imageobject>
- </inlinemediaobject> icon.
- </para>
-</section>
-<section xml:id="footnotes">
- <title>Footnotes</title>
- <para>
- Here is a footnote reference,<footnote>
+ <section xml:id="links">
+ <title>Links</title>
+ <section xml:id="explicit">
+ <title>Explicit</title>
+ <para>
+ Just a <link xlink:href="/url/">URL</link>.
+ </para>
+ <para>
+ <link xlink:href="/url/">URL and title</link>.
+ </para>
+ <para>
+ <link xlink:href="/url/">URL and title</link>.
+ </para>
+ <para>
+ <link xlink:href="/url/">URL and title</link>.
+ </para>
+ <para>
+ <link xlink:href="/url/">URL and title</link>
+ </para>
+ <para>
+ <link xlink:href="/url/">URL and title</link>
+ </para>
+ <para>
+ <link xlink:href="/url/with_underscore">with_underscore</link>
+ </para>
+ <para>
+ Email link (<email>nobody@nowhere.net</email>)
+ </para>
+ <para>
+ <link xlink:href="">Empty</link>.
+ </para>
+ </section>
+ <section xml:id="reference">
+ <title>Reference</title>
+ <para>
+ Foo <link xlink:href="/url/">bar</link>.
+ </para>
+ <para>
+ With <link xlink:href="/url/">embedded [brackets]</link>.
+ </para>
+ <para>
+ <link xlink:href="/url/">b</link> by itself should be a link.
+ </para>
+ <para>
+ Indented <link xlink:href="/url">once</link>.
+ </para>
<para>
- Here is the footnote. It can go anywhere after the footnote reference.
- It need not be placed at the end of the document.
+ Indented <link xlink:href="/url">twice</link>.
</para>
- </footnote> and another.<footnote>
<para>
- Here’s the long note. This one contains multiple blocks.
+ Indented <link xlink:href="/url">thrice</link>.
</para>
<para>
- Subsequent blocks are indented to show that they belong to the
- footnote (as with list items).
+ This should [not][] be a link.
</para>
<programlisting>
- { <code> }
+[not]: /url
</programlisting>
<para>
- If you want, you can indent every line, but you can also be lazy and
- just indent the first line of each block.
+ Foo <link xlink:href="/url/">bar</link>.
</para>
- </footnote> This should <emphasis>not</emphasis> be a footnote reference,
- because it contains a space.[^my note] Here is an inline note.<footnote>
<para>
- This is <emphasis>easier</emphasis> to type. Inline notes may contain
- <link xlink:href="http://google.com">links</link> and
- <literal>]</literal> verbatim characters, as well as [bracketed text].
+ Foo <link xlink:href="/url/">biz</link>.
</para>
- </footnote>
- </para>
- <blockquote>
+ </section>
+ <section xml:id="with-ampersands">
+ <title>With ampersands</title>
+ <para>
+ Here’s a <link xlink:href="http://example.com/?foo=1&bar=2">link
+ with an ampersand in the URL</link>.
+ </para>
+ <para>
+ Here’s a link with an amersand in the link text:
+ <link xlink:href="http://att.com/">AT&T</link>.
+ </para>
+ <para>
+ Here’s an <link xlink:href="/script?foo=1&bar=2">inline
+ link</link>.
+ </para>
+ <para>
+ Here’s an <link xlink:href="/script?foo=1&bar=2">inline link in
+ pointy braces</link>.
+ </para>
+ </section>
+ <section xml:id="autolinks">
+ <title>Autolinks</title>
+ <para>
+ With an ampersand:
+ <link xlink:href="http://example.com/?foo=1&bar=2" role="uri">http://example.com/?foo=1&bar=2</link>
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ In a list?
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link xlink:href="http://example.com/" role="uri">http://example.com/</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ It should.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ An e-mail address: <email>nobody@nowhere.net</email>
+ </para>
+ <blockquote>
+ <para>
+ Blockquoted:
+ <link xlink:href="http://example.com/" role="uri">http://example.com/</link>
+ </para>
+ </blockquote>
+ <para>
+ Auto-links should not occur here:
+ <literal><http://example.com/></literal>
+ </para>
+ <programlisting>
+or here: <http://example.com/>
+</programlisting>
+ </section>
+ </section>
+ <section xml:id="images">
+ <title>Images</title>
+ <para>
+ From <quote>Voyage dans la Lune</quote> by Georges Melies (1902):
+ </para>
+ <figure>
+ <title>lalune</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="lalune.jpg" />
+ </imageobject>
+ <textobject><phrase>lalune</phrase></textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Here is a movie <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="movie.jpg" />
+ </imageobject>
+ </inlinemediaobject> icon.
+ </para>
+ </section>
+ <section xml:id="footnotes">
+ <title>Footnotes</title>
<para>
- Notes can go in quotes.<footnote>
+ Here is a footnote reference,<footnote>
+ <para>
+ Here is the footnote. It can go anywhere after the footnote
+ reference. It need not be placed at the end of the document.
+ </para>
+ </footnote> and another.<footnote>
+ <para>
+ Here’s the long note. This one contains multiple blocks.
+ </para>
+ <para>
+ Subsequent blocks are indented to show that they belong to the
+ footnote (as with list items).
+ </para>
+ <programlisting>
+ { <code> }
+</programlisting>
+ <para>
+ If you want, you can indent every line, but you can also be lazy and
+ just indent the first line of each block.
+ </para>
+ </footnote> This should <emphasis>not</emphasis> be a footnote
+ reference, because it contains a space.[^my note] Here is an inline
+ note.<footnote>
<para>
- In quote.
+ This is <emphasis>easier</emphasis> to type. Inline notes may
+ contain <link xlink:href="http://google.com">links</link> and
+ <literal>]</literal> verbatim characters, as well as [bracketed
+ text].
</para>
</footnote>
</para>
- </blockquote>
- <orderedlist numeration="arabic" spacing="compact">
- <listitem>
+ <blockquote>
<para>
- And in list items.<footnote>
+ Notes can go in quotes.<footnote>
<para>
- In list.
+ In quote.
</para>
</footnote>
</para>
- </listitem>
- </orderedlist>
- <para>
- This paragraph should not be part of the note, as it is not indented.
- </para>
-</section>
+ </blockquote>
+ <orderedlist numeration="arabic" spacing="compact">
+ <listitem>
+ <para>
+ And in list items.<footnote>
+ <para>
+ In list.
+ </para>
+ </footnote>
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ This paragraph should not be part of the note, as it is not indented.
+ </para>
+ </section>
</article>
--
cgit v1.2.3