[gnome-doc-utils/mallard] [mallard] Finished off ITS conformance doc for now
- From: Shaun McCance <shaunm src gnome org>
- To: svn-commits-list gnome org
- Subject: [gnome-doc-utils/mallard] [mallard] Finished off ITS conformance doc for now
- Date: Wed, 27 May 2009 17:31:09 -0400 (EDT)
commit f79dfb32b99f7d95e79903d07938b148ec5deaf0
Author: Shaun McCance <shaunm gnome org>
Date: Wed May 27 09:07:59 2009 -0500
[mallard] Finished off ITS conformance doc for now
---
doc/mallard/C/its.xml | 41 +++++++++++++++++++++++++----------------
1 files changed, 25 insertions(+), 16 deletions(-)
diff --git a/doc/mallard/C/its.xml b/doc/mallard/C/its.xml
index 3aabf05..5a3e91e 100644
--- a/doc/mallard/C/its.xml
+++ b/doc/mallard/C/its.xml
@@ -5,7 +5,7 @@
<info>
<link type="guide" xref="explore#i18n"/>
- <version number="0.1" date="2009-05-26" status="incomplete"/>
+ <version number="0.1" date="2009-05-27" status="review"/>
<credit type="author">
<name>Shaun McCance</name>
@@ -15,16 +15,23 @@
<year>2009</year>
<name>Shaun McCance</name>
</copyright>
+
+ <desc>Conformance to the W3C Internationalization and Localization
+ Markup Requirements.</desc>
</info>
<title>ITS Conformance</title>
<p>This page discusses Mallard's conformance to the requirements in the
-<link href="http://www.w3.org/TR/itsreq/">W3C Internationalization
-and Localization Markup Requirements</link>, as well as its usage of
-attributes from the <link href="http://www.w3.org/TR/its/">W3C
+<link href="http://www.w3.org/TR/itsreq/">W3C Internationalization and
+Localization Markup Requirements</link>, as well as its usage of attributes
+and elements from the <link href="http://www.w3.org/TR/its/">W3C
Internationalization Tag Set</link>.</p>
+<note><p>As of the time of this writing, there are 26 requirements, though not
+all of them are complete. This page discusses a selection of the requirements.
+Future versions may discuss more requirements.</p></note>
+
<section id="R002">
<title>R002: Span-Like Element</title>
@@ -59,7 +66,7 @@ Internationalization Tag Set</link>.</p>
<code xref="mal_page">page</code> and <code xref="mal_section">section</code>
elements, Mallard does allow attributes from external namespaces to be used
on all elements. If necessary for translation purposes, any attribute from
- an external attribute may be used as a unique identifier. In particular,
+ an external namespace may be used as a unique identifier. In particular,
Mallard does not use the common <code>xml:id</code> for page and section
IDs, but it may be used on any element to provide a unique identifier for
translation or any other purposes.</p>
@@ -106,11 +113,11 @@ Internationalization Tag Set</link>.</p>
information or linked to external terminology data.</p>
</quote>
- <comment>
- <cite date="2009-05-26">shaunm</cite>
- <p>FIXME: not sure what this is asking for. Is this something we need
- to address directly, or something we get for free with external attrs?</p>
- </comment>
+ <p>Mallard does not currently provide a means of marking up terms and
+ definitions. When necessary for translation purposes, the
+ <link href="http://www.w3.org/TR/its/#terminology"><code>its:term</code>
+ and <code>its:termInfoRef</code></link> attributes may be used on any
+ elements to indicate such a relationship.</p>
</section>
<section id="R008">
@@ -127,10 +134,12 @@ Internationalization Tag Set</link>.</p>
representation (such as the Internationalization Tag Set).</p>
</quote>
- <comment>
- <cite date="2009-05-26">shaunm</cite>
- <p>FIXME: need to look into this more.</p>
- </comment>
+ <p>Any purpose mapping that can be encoded using the
+ <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global">its:rules</code>
+ element can be included in a Mallard document. The <code>its:rules</code> element
+ may be used in any <code xref="mal_info">info</code> element. See also
+ <link href="http://www.w3.org/TR/its/#associating-its-with-existing-markup">Associating
+ ITS Data Categories with Existing Markup</link>.</p>
</section>
<section id="R011">
@@ -166,7 +175,7 @@ Internationalization Tag Set</link>.</p>
translated.</p>
<p>Additionally, the
- <code href="http://www.w3.org/TR/its/#trans-datacat">its:rules</code>
+ <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global">its:rules</code>
element may be used in any <code xref="mal_info">info</code> element to
provide translatability rules for a page or section.</p>
</section>
@@ -227,7 +236,7 @@ Internationalization Tag Set</link>.</p>
<p>If more extensive localization notes are needed, the
<code xref="mal_block_comment">comment</code> element may be used. Using a
- <code href="http://www.w3.org/TR/its/#trans-datacat">its:rules</code>
+ <code href="http://www.w3.org/TR/its/#basic-concepts-selection-global">its:rules</code>
element in an <code xref="mal_info">info</code> element, one can clearly
specify which editorial comments are localization notes.</p>
</section>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]