i18n-drafts

A place to edit articles, tutorials, and the like for the /International subtree of the W3C site. Also, captures issues and comments.

Note that this is only a temporary location for articles, etc., while they are being edited and approved. The canonical location for the resulting pages is under https://www.w3.org/International/.

To view a page as HTML, go to https://w3c.github.io/i18n-drafts/ and add the appropriate path to the file you want to view. You’ll need to provide the filename plus language extension as a minimum, eg. https://w3c.github.io/i18n-drafts/articles/vertical-text.en

File Naming

Content files follow the pattern: {filename}.{language}.html

Examples:

• qa-link-lang.en.html (English)
• qa-link-lang.de.html (German translation)

Each content file has a companion {filename}-data/ directory containing translations.js and supporting files.

Translations

If you want to translate one or more of these resources, see the Translation instructions page.

Contributing

Editors should be familiar with and use the following:

• GitHub guidelines for working with i18n documents
• Editorial guidelines for working with i18n documents

Validation

If you don’t already have Node.js, install it first:

1. Go to https://nodejs.org/en/download
2. Install the current LTS release for your platform.

Then run the metadata and asset checks with:

npm test

To validate only specific files, pass them through to the script:

npm test -- --files questions/qa-link-lang.en.html tutorials/tutorial-char-enc/index.ro.html

The validator checks page filename language suffixes, key f.* metadata fields, date formats, local script/image/stylesheet references, boilerplate-<lang>.js, and companion translations.js consistency.