summaryrefslogtreecommitdiff
path: root/doc/mallard/C/mal_block_quote.page
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mallard/C/mal_block_quote.page')
-rw-r--r--doc/mallard/C/mal_block_quote.page153
1 files changed, 0 insertions, 153 deletions
diff --git a/doc/mallard/C/mal_block_quote.page b/doc/mallard/C/mal_block_quote.page
deleted file mode 100644
index d0abbc5..0000000
--- a/doc/mallard/C/mal_block_quote.page
+++ /dev/null
@@ -1,153 +0,0 @@
-<page xmlns="http://projectmallard.org/1.0/"
- type="topic"
- id="mal_block_quote">
-
-<info>
- <revision version="0.1" date="2009-05-19" status="review"/>
-
- <credit type="author">
- <name>Shaun McCance</name>
- <email>shaunm@gnome.org</email>
- <years>2008-2009</years>
- </credit>
-
- <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
-
- <desc>Create a block-level quotation with an attribution.</desc>
-</info>
-
-<title>Block Quotes</title>
-
-<synopsis><code mime="application/relax-ng-compact-syntax">
-mal_block_quote = element quote {
- attribute style { xsd:NMTOKENS } ?,
- attribute * - (mal:* | local:*) { text } *,
-
- <link xref="mal_block_title">mal_block_title</link> ?,
- <link xref="mal_block_cite">mal_block_cite</link>,
- <link xref="mal_block">mal_block</link> +
-}
-</code></synopsis>
-
-<p>The <code>quote</code> element allows you to mark a quoted block of text
-and include an attribution for the quote. Block quotations are useful for
-long passages, or for quotes you want to draw attention to. You can provide
-an attribution using the <code xref="mal_block_cite">cite</code> element,
-and have it automatically formatted by display tools.</p>
-
-<!-- BEGIN notes -->
-<section id="notes">
- <title>Notes</title>
- <list>
- <item><p>The <code>quote</code> element contains an optional
- <link xref="mal_block_title">title</link> element, a mandatory
- <link xref="mal_block_cite">cite</link> element, and any
- <link xref="mal_block">general block content</link>.</p></item>
-
- <item><p>The <code>quote</code> element can occur in any
- general block context, including inside
- <link xref="mal_page">pages</link>, <link xref="mal_section">sections</link>,
- and certain <link xref="mal_block">block elements</link>.</p></item>
-
- <item><p>The <code>style</code> attribute takes a space-separated list of
- style hints. Processing tools should adjust their behavior according to
- those style hints they understand.</p></item>
-
- <item>
- <p>The following style hints are recommended:</p>
- <table rules="rows">
- <tr>
- <td><p><code>epigraph</code></p></td>
- <td><p>an introductory or closing quote that is not part of the
- running prose, generally formatted flush right</p></td>
- </tr>
- </table>
- </item>
-
- <item><p>The <code>quote</code> element can have attributes from external
- namespaces. See <link xref="mal_external"/> for more information
- on external-namespace attributes.</p></item>
- </list>
-</section>
-<!-- END notes -->
-
-
-<!-- BEGIN examples -->
-<section id="examples">
- <title>Examples</title>
-
- <p>Include a simple block quote in your document:</p>
-
- <example>
- <code><![CDATA[
-<quote>
- <cite>Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
-</quote>
-]]></code>
- <quote>
- <cite>Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
- </quote>
- </example>
-
- <p>Add a title to the quote:</p>
-
- <example>
- <code><![CDATA[
-<quote>
- <title>Simplify</title>
- <cite>Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
-</quote>
-]]></code>
- <quote>
- <title>Simplify</title>
- <cite>Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
- </quote>
- </example>
-
- <p>Add a date to the attribution:</p>
-
- <example>
- <code><![CDATA[
-<quote>
- <cite date="1854">Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
-</quote>
-]]></code>
- <quote>
- <cite date="1854">Henry David Thoreau</cite>
- <p>Our life is frittered away by detail.... Simplify, simplify.</p>
- </quote>
- </example>
-</section>
-<!-- END examples -->
-
-
-<!-- BEGIN processing -->
-<section id="processing">
- <title>Processing Expectations</title>
-
- <p>Block quotes are displayed as block elements, with each of their child
- elements being interpreted as block elements. When present, the title and
- attribution should be displayed in a way that makes their respective roles
- clear. Block quotes are frequently adorned with a watermark of quotation
- marks. Processing tools should ensure any quotation marks used in the
- formatting of quotes, including watermark images, are appropriate for the
- document's language.</p>
-</section>
-<!-- END processing -->
-
-
-<!-- BEGIN comparison -->
-<section id="comparison">
- <title>Comparison to Other Formats</title>
- <p>The <code>quote</code> element is similar to the
- <code href="http://www.docbook.org/tdg/en/html/blockquote.html">blockquote</code>
- element in DocBook. The <code xref="mal_block_cite">cite</code> element is
- mandatory in Mallard, whereas attribution is optional in DocBook.</p>
-</section>
-<!-- END comparison -->
-</page>