Jump to content
From ArchWiki

Related articles

- ArchWiki:Translation Team
- International communities

This article serves as a comprehensive guideline for ArchWiki internationalization and localization.

## Guidelines

### Page titles

Non-English page titles must be of the form "Title in English (Language)" where "Language" is the localized spelling of said language. Note the space between the title and the language tag. For example: Installation guide (Nederlands). English titles should not include a language tag.

Also note that in case of sub-pages, the language tag shall be appended to each segment in the title path, so "Title (Language)/Sub-page" is wrong, while "Title (Language)/Sub-page (Language)" is correct. For example: systemd (Русский)/User (Русский). Using language tags on each segment enables proper operation of the superpage links, and in particular the last tag is added automatically in interlanguage links, plus it makes it more practical and safe for bots to detect the language of a page. "Title/Sub-page (Language)" was the previously accepted format, which is now obsolete but possibly still in use by some articles.

The root categories for every language are the only exception to this rule, as they must not repeat the language name in a suffix.

See #Languages for a list of languages and expected localized spellings.

Rationale:

- English titles facilitate administration; all administrators understand English, but may not be multilingual. When browsing Special:RecentChanges and other special pages, admins need to know what is being edited without resorting to external translation programs.
- Standardized article titles simplify inter-language linking.

### Localized redirects

Localized titles can and should be created, but must redirect to the English-named article as described above. Redirect titles need not include language tags. For example: Guía oficial de Instalación redirects to Installation guide (Español). Note that this is however not possible for Category pages, since categorizing a page under a redirect will not list the page under the target category.

Rationale:

- Localized titles improve navigability for international readers. Both the internal search feature and external search engines can utilize such redirects.
- Useful redirects facilitate internal linking.

### Interlanguage links

If an article exists in more than one language, please add interlanguage links at the top of each translation:

    [[de:Title]]
    [[en:Title]]
    [[es:Title]]

Note: Interlanguage links add the suffix mentioned in #Page titles automatically, so for example the interlanguage link associated to Main page (Dansk) is `[[da:Main page]]`, and that associated to Help:Style (Português)/Formatting and punctuation (Português) is `[[pt:Help:Style (Português)/Formatting and punctuation]]`.

See #Languages for a list of the available language tags. See Help:Style#Interlanguage links for usage guidelines.

Rationale:

- Including inter-language links at the beginning of an article allows international readers to promptly determine whether content is available in their language, and similarly allows translators to ascertain whether an article requires translation.

#### Finding articles with specific interlanguage links

In order to obtain a list of the articles with interlanguage links pointing to a specific title (language backlinks), use:

https://wiki.archlinux.org/api.php?action=query&list=langbacklinks&lbllimit=500&lblprop=lltitle&lbllang=en&lbltitle=Main%20Page

This example looks for (`[[en:Main Page]]`), but for other links it is enough to change the value of `lbllang` and `lbltitle`.

If you want to obtain a list of the articles using interlanguage links of a specific language, just omit the `lbltitle` key:

https://wiki.archlinux.org/api.php?action=query&list=langbacklinks&lbllimit=500&lblprop=lltitle&lbllang=de

This example uses German (`de`), but for the other languages it is enough to change the value of `lbllang`.

Note: This query may not find all redirects using interlanguage links (regulated by Help:Style#Redirect pages): a search like this should work instead (if you get zero results it means that everything is fine).

Note that API queries are always limited, so if a language has more than 500 backlinks it will be necessary to continue the search adding the `lblcontinue` attribute that appears at the bottom of the list to the query string.

## Languages

The following table lists all languages encountered on the wiki along with related links.

English name | Localized name | Subtag | Root category | External wiki
--- | --- | --- | --- | ---
Arabic | العربية | ar | Category:العربية
Bangla | বাংলা | not configured | Category:বাংলা
Bosnian | Bosanski | bs | Category:Bosanski
Bulgarian | Български | bg | Category:Български
Cantonese | 粵語 | not configured | Category:粵語
Catalan | Català | ca | Category:Català
Chinese (Classical) | 文言文 | not configured | Category:文言文
Chinese (Simplified) | 简体中文 | zh-hans | Category:简体中文 | https://wiki.archlinuxcn.org
Chinese (Traditional) | 正體中文 | zh-hant | Category:正體中文
Croatian | Hrvatski | hr | Category:Hrvatski
Czech | Čeština | cs | Category:Čeština
Danish | Dansk | da | Category:Dansk
Dutch | Nederlands | nl | Category:Nederlands
English | English | en | Category:English
Esperanto | Esperanto | not configured | Category:Esperanto
Finnish | Suomi | fi | Category:Suomi
French | Français | fr | Category:Français
German | Deutsch | de | – | https://wiki.archlinux.de/
Greek | Ελληνικά | el | Category:Ελληνικά
Hebrew | עברית | he | Category:עברית
Hungarian | Magyar | hu | Category:Magyar
Indonesian | Bahasa Indonesia | id | Category:Bahasa Indonesia
Italian | Italiano | it | Category:Italiano
Japanese | 日本語 | ja | – | https://wiki.archlinux.jp/
Korean | 한국어 | ko | Category:한국어
Lithuanian | Lietuvių | lt | Category:Lietuvių
Norwegian (Bokmål) | Norsk Bokmål | not configured | Category:Norsk Bokmål
Persian | فارسی | fa | – | https://wiki.archusers.ir/
Polish | Polski | pl | Category:Polski
Portuguese | Português | pt | Category:Português
Romanian | Română | not configured | Category:Română
Russian | Русский | ru | Category:Русский
Serbian | Српски (Srpski) | sr | Category:Српски
Slovak | Slovenčina | sk | Category:Slovenčina
Spanish | Español | es | Category:Español
Swedish | Svenska | sv | Category:Svenska
Thai | ไทย | th | Category:ไทย
Turkish | Türkçe | tr | Category:Türkçe
Ukrainian | Українська | uk | Category:Українська
Vietnamese | Tiếng Việt | not configured | – | https://archlinuxvn.tuxfamily.org/
Quechua | Runa simi | not configured | Category:Qhichwa

Subtags are treated case-insensitively by the MediaWiki backend. By convention, the interlanguage links on ArchWiki should use the lowercase form of the subtag. For information regarding subtags, please see:

- https://www.iana.org/assignments/language-subtag-registry
- https://tools.ietf.org/rfc/bcp/bcp47.txt
- https://r12a.github.io/app-subtags/

### Adding local interlanguage links

If you want interlanguage links to be enabled for a new language hosted in wiki.archlinux.org, please open a request in Help talk:I18n. Note that a minimum number of translated articles will be required by the administrators for the request to be fulfilled. The following checklist summarizes the steps needed to add a new language:

1. Notify about the new language in Help talk:I18n. Make sure to include the information needed to fill out the #Languages table.
2. Create a base language category under Category:Languages and add the translated articles to it or a subcategory.
3. A maintainer should update the #Languages table.
4. Translate at least Main page, Arch Linux, Installation guide and General recommendations.
5. Initialize a translation of Table of contents: it will then be kept up to date with a bot, see below.
6. An administrator should consider the request; a maintainer should then update the #Languages table accordingly.
7. An administrator should add the language prefix to Special:Interwiki and update AbuseFilter/4 and AbuseFilter/13.
8. Developers should update the respective ArchWiki:Bots to support the new language.

### Adding external interlanguage links

If you want interlanguage links to be set for a new or existing language that has set up a separate wiki, please open a request in Help talk:I18n: the interlanguage links will be set as soon as possible!

### Moving local languages to external wikis

Moving local languages to their own wikis is a very welcome and encouraged thing, which will get all the assistance that is needed. There are two possible procedures:

- First move all the articles to the external wiki. Once done, update the interlanguage links to point to the new domain, then fix all their target titles with the new ones. Finally, either delete the local articles, or, upon authorization from the ArchWiki:Maintenance Team, redirect them to the external wiki using the interlanguage links.
- Set up temporary interlanguage links (e.g. `[[ja-temp:Title]]`) and use them to redirect the various articles to the external wiki as they are moved one by one. Once the move is complete, point the regular interlanguage links (i.e. `[[ja:Title]]`) to the external wiki, and update them all with the new target titles. Next, either delete the local redirects, or, upon authorization from the ArchWiki:Maintenance Team, update them to use the regular interlanguage links. Finally, disable the temporary interlanguage links.

Category:

- Help