Help:Contributing/languages: Difference between revisions
Jump to navigation
Jump to search
Links: translatable labels via Special:MyLanguage instead of whole-link tvars (via update-page on MediaWiki MCP Server) |
Rewrite in code-guide style: strip translation markup, <code> for plain tokens (via update-page on MediaWiki MCP Server) |
||
| Line 1: | Line 1: | ||
< | The knowledge base is multilingual on a best-effort basis: <code>en</code>, <code>fr</code>, <code>eo</code>. Multilingualism works in two places: inside entities — labels, descriptions and aliases — and on wiki pages, through the Translate extension. Contribution is never blocked on translation: write in the language you know; translators cover the others. | ||
== Entities and properties == | |||
Items and properties are single entities: there is exactly one page per entity (for example [[Special:EntityPage/Q1]]), shown in the reader's interface language. The multilingual content lives <em>inside</em> the entity as per-language values. | |||
Items and properties are single entities: there is exactly one page per entity (for example | |||
{| class="wikitable" style="width:100%" | {| class="wikitable" style="width:100%" | ||
! Field !! What it is !! Example (property <code>P1</code>) | |||
|- | |- | ||
| Label || The short, human-readable name of the entity || instance of | |||
| | |||
|- | |- | ||
| | | Description || A one-line clarification that disambiguates the entity || that class of which this subject is a particular example and member | ||
|- | |- | ||
| | | Aliases || Alternative names or spellings that also resolve to the entity || example of | ||
|} | |} | ||
House rules: | House rules: | ||
* A label and a description must be unique together <em>per language</em>: no two entities may share the same label + description pair in the same language. | * A label and a description must be unique together <em>per language</em>: no two entities may share the same label + description pair in the same language. | ||
* Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision). | * Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision). | ||
* Prefer the local, human-written value over a machine translation; if you use a machine translation, review it against the original before saving. | * Prefer the local, human-written value over a machine translation; if you use a machine translation, review it against the original before saving. | ||
=== | === Workflow === | ||
To add or edit terms in another language: | To add or edit terms in another language: | ||
<ol> | <ol> | ||
<li>Open the entity (for example | <li>Open the entity (for example [[Special:EntityPage/P1]]) and enter edit mode.</li> | ||
<li>Open the | <li>Open the "In more languages" section at the top of the page.</li> | ||
<li>Choose the language, type the value, save.</li> | <li>Choose the language, type the value, save.</li> | ||
</ol> | </ol> | ||
Every field takes a language code (for example <code>en</code>, <code>fr</code>, <code>eo</code>) and the value for that language. | Every field takes a language code (for example <code>en</code>, <code>fr</code>, <code>eo</code>) and the value for that language. | ||
== | == Classic wiki pages == | ||
Wiki pages are translated with the Translate extension, which separates two roles: | Wiki pages are translated with the Translate extension, which separates two roles: | ||
* The translation administrator marks pages for translation and manages their units. | * The translation administrator marks pages for translation and manages their units. | ||
* The translator translates units through the translation interface. | * The translator translates units through the translation interface. | ||
=== | === Workflow per role === | ||
* [[Special:MyLanguage/Help:Contributing/languages/translationAdmin|Translation admin]] — marking and managing pages | * [[Special:MyLanguage/Help:Contributing/languages/translationAdmin|Translation admin]] — marking and managing pages | ||
* [[Special:MyLanguage/Help:Contributing/languages/translator|Translator]] — translating units | * [[Special:MyLanguage/Help:Contributing/languages/translator|Translator]] — translating units | ||
== | == See also == | ||
* [[Help:Contributing]] — contributing to this wiki | * [[Help:Contributing]] — contributing to this wiki | ||
* [[Help:Contributing/code]] — code blocks and syntax highlighting | * [[Help:Contributing/code]] — code blocks and syntax highlighting | ||
* [https://www.mediawiki.org/wiki/Help:Extension:Translate Translate extension help] (official) | * [https://www.mediawiki.org/wiki/Help:Extension:Translate Translate extension help] (official) | ||
Revision as of 17:27, 19 August 2026
The knowledge base is multilingual on a best-effort basis: en, fr, eo. Multilingualism works in two places: inside entities — labels, descriptions and aliases — and on wiki pages, through the Translate extension. Contribution is never blocked on translation: write in the language you know; translators cover the others.
Entities and properties
Items and properties are single entities: there is exactly one page per entity (for example Special:EntityPage/Q1), shown in the reader's interface language. The multilingual content lives inside the entity as per-language values.
| Field | What it is | Example (property P1)
|
|---|---|---|
| Label | The short, human-readable name of the entity | instance of |
| Description | A one-line clarification that disambiguates the entity | that class of which this subject is a particular example and member |
| Aliases | Alternative names or spellings that also resolve to the entity | example of |
House rules:
- A label and a description must be unique together per language: no two entities may share the same label + description pair in the same language.
- Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision).
- Prefer the local, human-written value over a machine translation; if you use a machine translation, review it against the original before saving.
Workflow
To add or edit terms in another language:
- Open the entity (for example Special:EntityPage/P1) and enter edit mode.
- Open the "In more languages" section at the top of the page.
- Choose the language, type the value, save.
Every field takes a language code (for example en, fr, eo) and the value for that language.
Classic wiki pages
Wiki pages are translated with the Translate extension, which separates two roles:
- The translation administrator marks pages for translation and manages their units.
- The translator translates units through the translation interface.
Workflow per role
- Translation admin — marking and managing pages
- Translator — translating units
See also
- Help:Contributing — contributing to this wiki
- Help:Contributing/code — code blocks and syntax highlighting
- Translate extension help (official)