$Id: Overview.xml,v 1.87 2002/06/18 18:20:35 rishida Exp $

Creating Internationalized Stuff at the Top of an HTML Page

W3C Working Draft dd mmmm 2002

This version:
this file
Editor:
Richard Ishida, W3C <ishida@w3.org>

Abstract

This document is a mockup to illustrate the concept of overlays/templates interacting with the i18n techniques document.

Status of this Document

This document is an editors' copy that has no official standing.

This section describes the status of this document at the time of its publication. Other documents may supersede this document. The latest status of this series of documents is maintained at the W3C.

This is only a mockup and has no value other than to illustrate a concept. Note that this is the very first exploration of these ideas, so there are likely to be many issues, and the end result is likely to be substantially different.

The (red) xml code you see exposes possible underlying xml for the purpose of making this illustration clearer. Note that this document DOES NOT represent what an overlay/template would actually look like, but presents to you a picture to help you grasp the concept. It needs explaining.

The mode attribute on the include-text elements helps the associated xsl file choose the appropriate information from the node pointed to by the value of the id attribute. (Maybe id should be replaced with a path attribute that uses xpath expressions as its value.?) In this example, assume perhaps the following results for mode settings:

Note that the order of the first two sections is different from that in the current i18n techniques master xml file, and so is the order of the techniques information in section 2. Also, of course, only a few select techniques have been drawn on.

Note also that the same information items extracted multiple times from the master file to appear in this document.

Table of Contents

1 Declare the language
2 Declare the character encoding
3 Checklist
4 List of sources


1 Declare the language

This can help choose the appropriate styling and screen reader voice, etc.

<include-text desc="declare in html" document="html-tech.xml" id="ri20030115.105511247" path="." mode="technique"/>

2 Declare the character encoding

It is very important to declare the character encoding used in your document, otherwise there is no guarrantee that the reader will see sensible stuff. [note that the xsl file associated with this may be set up to not extract resource information

<include-text desc="use the meta statement" document="html-tech.xml" id="ri20030115.105511247" path="." mode="technique"/>

<include-text desc="use meta statements as early as poss" document="html-tech.xml" id="ri20030115.105725169" path="." mode="technique"/>

<include-text desc="use ascii at top of file" document="html-tech.xml" id="ri20030115.105837934" path="." mode="technique"/>

3 Checklist

  1. <include-text desc="declare in html" document="html-tech.xml" id="ri20030115.105511247" path="." mode="rule"/>
  2. <include-text desc="use the meta statement" document="html-tech.xml" id="ri20030115.105511247" path="." mode="rule"/>
  3. <include-text desc="use meta statements as early as poss" document="html-tech.xml" id="ri20030115.105725169" path="." mode="rule"/>
  4. <include-text desc="use ascii at top of file" document="html-tech.xml" id="ri20030115.105837934" path="." mode="rule"/>

4 List of sources