[css2] Added note about quotes in multilingual documents.

--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401273

Author: bert-github

css2/generate.src

@@ -352,13 +352,14 @@ Centaurs: ... have hoofs
 </pre>
 </div>
 
-<h2><a name="quotes">Quotation marks</a></h2>
+<h2><a name="quotes">Quotation marks: the 'quotes' property</a></h2>
 
 <!-- #include src=properties/quotes.srb -->
 
 <P>So that user agents may handle nested quotation marks in a
 language-dependent way, CSS provides the <span
-class="propinst-quotes">'quotes'</span> property. Values have
+class="propinst-quotes">'quotes'</span> property. It defines the
+quotation marks to use in generated text. Values have
 the following meanings:</p>
 
 <dl>
@@ -379,32 +380,49 @@ agent must apply the appropriate pair of quotation marks according to
 the level of embedding.
 </dl>
 
-<P>Applying the following style sheet:</p>
+<div class="example">
+<P>For example, applying the following style sheet:</p>
 
 <PRE class="example">
-  [LANG|="en"] { quoting: �"� �"� "�" "�" �"� �"� }
-  [LANG|="fr"] { quoting: "� " " �" �"� �"� "�" "�"  }
-  [LANG|="no"] { quoting: "�" "�" "'" "'" "\"" "\""  }
-<!--  [LANG|="se"] { quoting: "�" "�"  �"� �"� "�" "�"  }-->
-</PRE>
+[LANG|="en"] { quoting: �"� �"� "�" "�" �"� �"� }
+[LANG|="fr"] { quoting: "� " " �" �"� �"� "�" "�"  }
+[LANG|="no"] { quoting: "�" "�" "'" "'" "\"" "\""  }
+<!--  [LANG|="se"] { quoting: "�" "�"  �"� �"� "�" "�"  }--></PRE>
 
 <P>to the following HTML fragment:</p>
 
 <PRE class="html-example">
-&lt;BODY lang="en"&gt;
-   &lt;P&gt;&lt;Q&gt;Quote me!&lt;/Q&gt;
-   &lt;P LANG="no"&gt;&lt;Q&gt;Siter &lt;Q&gt;meg&lt;/Q&gt;!&lt;/Q&gt;
-&lt;/BODY&gt;
+&lt;HTML lang="en"&gt;
+  &lt;BODY&gt;
+    &lt;P&gt;&lt;Q&gt;Quote me!&lt;/Q&gt;
+  &lt;/BODY&gt;
+&lt;/HTML&gt;
 </PRE>
 
-<P>would allow a user agent to render:</p>
+would allow a user agent to render:</p>
 
-<PRE>
-  "Quote me!"
+<PRE class="asciiart">
+"Quote me!"
+</PRE>
+
+<p>While this HTML fragment:
 
-  �Siter 'meg'!�
+<PRE class="html-example">
+&lt;HTML lang="no"&gt;
+  &lt;BODY&gt;
+    &lt;P&gt;&lt;Q&gt;Siter &lt;Q&gt;meg&lt;/Q&gt;!&lt;/Q&gt;
+  &lt;/BODY&gt;
+&lt;/HTML&gt;
 </PRE>
 
+would produce:
+
+<PRE class="ascii-art">
+�Siter 'meg'!�
+</PRE>
+</div>
+
+
 <p>Authors may insert quotation marks in generated text with the <span
 class="index-def" title="open-quote"><a class="value-def"
 name="value-def-open-quote">'open-quote'</a></span> and <span
@@ -457,6 +475,48 @@ title="no-open-quote"><a class="value-def"
 name="value-def-no-open-quote">'no-open-quote'</a></span> keyword,
 which inserts nothing, but increments the quotation depth by one.
 
+<div class="note">
+<p>Note. If a quotation is in a different language than the
+surrounding text, it is customary to quote the text with the quote
+marks of the surrounding language, not the language of the quotation
+itself. For example, French inside English:
+
+<blockquote>
+The device of the order of the garter is &#8220;honi soit qui mal y
+pense&#8221;
+</blockquote>
+
+<p>English inside French:
+
+<blockquote>
+Il disait: �&nbsp;Il faut mettre l'action en &#8249;&nbsp;fast
+forward&nbsp;&#8250;.�
+</blockquote>
+
+<p>For French-English documents, a style sheet like the following will
+ensure the right quotes everywhere. Note the use of the ">" to set
+quotes on the children of elements with a "lang" attribute.
+
+<pre class="example">
+HTML:lang(fr) {quotes:  "�" "�"   "\2039" "\203A"}
+HTML:lang(en) {quotes:  "\201C" "\201D"   "\2018" "\2019"}
+[LANG|=fr] > * {quotes:  "�" "�"   "\2039" "\203A"}
+[LANG|=en} > * {quotes:  "\201C" "\201D"   "\2018" "\2019"}
+</pre>
+
+<p>The quotation marks are shown here in a form that most people will
+be able to type. If you can type them directly, they will look like
+this:
+
+<blockquote class="example">
+HTML:lang(fr) {quotes:  "�" "�"   "&#8249;" "&#8250;"}<br>
+HTML:lang(en) {quotes:  "&#8220;" "&#8221;"   "&#8216;" "&#8217;"}<br>
+[LANG|=fr] > * {quotes:  "�" "�"   "&#8249;" "&#8250;"}<br>
+[LANG|=en} > * {quotes:  "&#8220;" "&#8221;"   "&#8216;" "&#8217;"}
+</blockquote>
+
+</div>
+
 
 <h2>Automatic <span class="index-def" title="counters"><a name="counters">counters</a></span>
 and numbering</h2>