Accesskey n skips to in-page navigation. Skip to the content start.

s_gotoW3cHome Internationalization
 

xxxTITLE

Intended audience: users, XHTML/HTML coders (using editors or scripting), script developers (PHP, JSP, etc.), CSS coders, schema developers (DTDs, XML Schema, RelaxNG, etc.), XSLT developers, Web project managers, and anyone who is new to internationalization and needs guidance on topics to consider and ways to get into the material on the site. xxx adapt this to describe the intended reader of the article.

Updated xxxYYYY-MM-DD HH:MM

Question

When is it appropriate, or not, to use language negotiation?

Background

Insidenotes

All the text in this div will be displayed to the right of the main text flow, but will displace the right side of the main text flow if there is another floated item to its right. It was designed to be used only at the top of a page where sidenotes may overlap with stuff at the top of the right page column. Normally you should use a regular sidenote, illustrated below.

Level 2 headings and their related content (including any level 3 sections) should be surrounded by a div with class="section".

This FAQ addresses the question of when it is appropriate (or not) to set up language negotiation on the server.

Answer

Try to summarise the answer in the first paragraph, then go on to provide details.

When providing additional paragraphs in the answer, try to use one paragaph per point, and summarise that point in the first sentence of the paragraph. This helps people skim the article for relevant information.

The answer should be written in an easy to read style, but be as direct and simple as possible. You should also take great pains to ensure that the answer remains very focused on just directly answering the question at the beginning of the FAQ. Put tangential information in the 'by the way' section or in a different article. Of course, a similar simplicity and directness should be used for general articles, too.

Level 3 heading

Level 3 headings and their associated text should be surrounded by a div with class="section2".

Lead in. A lead in will be bolded text at the start of a paragraph. It should be used to break up long passages for the reader, so that they can read more comfortably, and also find specific information quickly on review.

Level 4 heading.

The first paragraph after a level 4 heading should go inside the h4 div, like this.

Additional paragraphs related to the level 4 heading should follow here, outside the h4 div.

Another level 3 heading

Here we have some additional text, blah, blah, blah...

SIDE NOTE Information at the beginning of this div with class="sidenoteGroup" is just part of the ordinary flow of the article. The div, however, marks the point at which any associated note text will occur in a voice browser or destyled page.

You can have as much content as you like here, using p, table, div or any other markup.

Example: My heading goes here
Content-Type: text/html; charset=utf-8
Content-Language: en
This text is a note related to the text above enclosed in the div with class="sidenoteGroup". It will normally be displayed in the right column of the page, and will start level with the start of the aformentioned text (ie. the text at the beginning of the div with class="sidenoteGroup".

You can put any markup you like in here, though it is often best to avoid p etc for the first bit of text, so that it lines up better with the text in the main body.

By the way

Here is some more text: blah, blah, blah....

This 'by the way' section is for use in FAQs in particular. It contains interesting or useful information that is not directly relevant to answering the question posed at the beginning of the article.

Tell us what you think (English).

Subscribe to an RSS feed.

New resources

Home page news

Twitter (Home page news)

‎@webi18n

Further reading

Author: xxxNAME, ORG.

Valid XHTML 1.0!
Valid CSS!
Encoded in UTF-8!

Content first published xxxYYYY-MM-DD. Last substantive update xxxYYYY-MM-DD HH:MM GMT. This version xxxYYYY-MM-DD HH:MM GMT

For the history of document changes, search for xxxsearch-string in the i18n blog.