Help:Contributing/languages: Difference between revisions

From Wikibase
Jump to navigation Jump to search
Create multilingual-contribution help page (Translate extension, issue: multilingual publishing)
 
Marked this version for translation
Line 1: Line 1:
<translate>
<translate>
<!--T:1-->
The knowledge base is multilingual by design: every item and property can carry <tvar name="label">labels</tvar>, <tvar name="desc">descriptions</tvar> and <tvar name="alias">aliases</tvar> in many languages, and wiki pages can be marked for translation. This page explains how the two mechanisms work and the house rules around them.
The knowledge base is multilingual by design: every item and property can carry <tvar name="label">labels</tvar>, <tvar name="desc">descriptions</tvar> and <tvar name="alias">aliases</tvar> in many languages, and wiki pages can be marked for translation. This page explains how the two mechanisms work and the house rules around them.
</translate>
</translate>


== <translate>Labels, descriptions and aliases (entity terms)</translate> ==
== <translate><!--T:2--> Labels, descriptions and aliases (entity terms)</translate> ==


<translate>
<translate>
<!--T:3-->
Items and properties are single entities: there is exactly one page per entity (for example <tvar name="item">[[Special:EntityPage/Q1]]</tvar>), 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 <tvar name="item">[[Special:EntityPage/Q1]]</tvar>), shown in the reader's interface language. The multilingual content lives <em>inside</em> the entity as per-language values.
</translate>
</translate>
Line 11: Line 13:
{| class="wikitable" style="width:100%"
{| class="wikitable" style="width:100%"
|-
|-
! <translate>Field</translate> !! <translate>What it is</translate> !! <translate>Example (item Q1)</translate>
! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (item Q1)</translate>
|-
|-
| <translate>Label</translate> || <translate>The short, human-readable name of the entity</translate> || <translate>Instance of</translate>
| <translate><!--T:7--> Label</translate> || <translate><!--T:8--> The short, human-readable name of the entity</translate> || <translate><!--T:9--> Instance of</translate>
|-
|-
| <translate>Description</translate> || <translate>A one-line clarification that disambiguates the entity</translate> || <translate>that class of which this subject is a particular example and member</translate>
| <translate><!--T:10--> Description</translate> || <translate><!--T:11--> A one-line clarification that disambiguates the entity</translate> || <translate><!--T:12--> that class of which this subject is a particular example and member</translate>
|-
|-
| <translate>Aliases</translate> || <translate>Alternative names or spellings that also resolve to the entity</translate> || <translate>is a; belongs to class</translate>
| <translate><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> is a; belongs to class</translate>
|}
|}


<translate>
<translate>
<!--T:16-->
To add or edit terms in another language, open the entity in edit mode and use the <tvar name="morelanguages">"In more languages"</tvar> section at the top of the page. Every field takes a <tvar name="lang">language code</tvar> (for example <code>en</code>, <code>fr</code>, <code>de</code>, <code>eo</code>) and the value for that language.
To add or edit terms in another language, open the entity in edit mode and use the <tvar name="morelanguages">"In more languages"</tvar> section at the top of the page. Every field takes a <tvar name="lang">language code</tvar> (for example <code>en</code>, <code>fr</code>, <code>de</code>, <code>eo</code>) and the value for that language.
</translate>
</translate>


=== <translate>House rules for entity terms</translate> ===
=== <translate><!--T:17--> House rules for entity terms</translate> ===


* <translate>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.</translate>
* <translate><!--T:18--> 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.</translate>
* <translate>Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision).</translate>
* <translate><!--T:19--> Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision).</translate>
* <translate>Prefer the local, human-written value over a machine translation; if you use a machine translation, review it against the original before saving.</translate>
* <translate><!--T:20--> Prefer the local, human-written value over a machine translation; if you use a machine translation, review it against the original before saving.</translate>


== <translate>Translating wiki pages</translate> ==
== <translate><!--T:21--> Translating wiki pages</translate> ==


<translate>Wiki pages (help pages, documentation, the main page) are translated with the <tvar name="translate-ext">[https://www.mediawiki.org/wiki/Extension:Translate Translate extension]</tvar>. A translation administrator marks a page for translation; translators then work through the translation interface.</translate>
<translate><!--T:22--> Wiki pages (help pages, documentation, the main page) are translated with the <tvar name="translate-ext">[https://www.mediawiki.org/wiki/Extension:Translate Translate extension]</tvar>. A translation administrator marks a page for translation; translators then work through the translation interface.</translate>


* <translate><tvar name="special-translate">[[Special:Translate|Special:Translate]]</tvar> — the translation interface, listing untranslated units per page.</translate>
* <translate><!--T:23--> <tvar name="special-translate">[[Special:Translate|Special:Translate]]</tvar> — the translation interface, listing untranslated units per page.</translate>
* <translate>Translated pages are served in the reader's interface language automatically; you can force a language with <code>?uselang=fr</code>.</translate>
* <translate><!--T:24--> Translated pages are served in the reader's interface language automatically; you can force a language with <code>?uselang=fr</code>.</translate>
* <translate>Translation units are the <code>&lt;translate&gt;</code> blocks in the source wikitext — keep them self-contained, one sentence or short paragraph each.</translate>
* <translate><!--T:25--> Translation units are the <code>&lt;translate&gt;</code> blocks in the source wikitext — keep them self-contained, one sentence or short paragraph each.</translate>


=== <translate>House rules for translated pages</translate> ===
=== <translate><!--T:26--> House rules for translated pages</translate> ===


* <translate>Machine translation is a starting point, not a final answer: always read and correct machine-translated units.</translate>
* <translate><!--T:27--> Machine translation is a starting point, not a final answer: always read and correct machine-translated units.</translate>
* <translate>Keep terminology consistent with the entity terms (labels/descriptions) used in the data layer.</translate>
* <translate><!--T:28--> Keep terminology consistent with the entity terms (labels/descriptions) used in the data layer.</translate>
* <translate>Do not translate <tvar name="tvar">tvar</tvar> placeholders or markup — translate only the human-readable text.</translate>
* <translate><!--T:29--> Do not translate <tvar name="tvar">tvar</tvar> placeholders or markup — translate only the human-readable text.</translate>


== <translate>See also</translate> ==
== <translate><!--T:30--> See also</translate> ==


* [[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 21:21, 18 August 2026

Languages: English · français · Esperanto

The knowledge base is multilingual by design: every item and property can carry labels, descriptions and aliases in many languages, and wiki pages can be marked for translation. This page explains how the two mechanisms work and the house rules around them.

Labels, descriptions and aliases (entity terms)

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 (item Q1)
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 is a; belongs to class

To add or edit terms in another language, open the entity in edit mode and use the "In more languages" section at the top of the page. Every field takes a language code (for example en, fr, de, eo) and the value for that language.

House rules for entity terms

  • 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.

Translating wiki pages

Wiki pages (help pages, documentation, the main page) are translated with the Translate extension. A translation administrator marks a page for translation; translators then work through the translation interface.

  • Special:Translate — the translation interface, listing untranslated units per page.
  • Translated pages are served in the reader's interface language automatically; you can force a language with ?uselang=fr.
  • Translation units are the <translate> blocks in the source wikitext — keep them self-contained, one sentence or short paragraph each.

House rules for translated pages

  • Machine translation is a starting point, not a final answer: always read and correct machine-translated units.
  • Keep terminology consistent with the entity terms (labels/descriptions) used in the data layer.
  • Do not translate tvar placeholders or markup — translate only the human-readable text.

See also