Help:Contributing/languages - Revision history

SeedBot: The {{Languages}} bar is now included automatically on every content page (LanguageBar extension) — note it, don't add it by hand (via update-page on MediaWiki MCP Server)

2026-09-10T09:21:34Z

The {{Languages}} bar is now included automatically on every content page (LanguageBar extension) — note it, don't add it by hand (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 09:21, 10 September 2026
Line 32:		Line 32:
	== Wiki pages ==		== Wiki pages ==

	Pages are written in English as plain wikitext — no translation markup. A translation is a separate static page at a language-suffixed title (<code>Page/fr</code>, <code>Page/eo</code>), maintained by hand with machine-translation assistance. A <code>{{Translation}}</code> banner at the top of a copy records which English revision it mirrors, and a <code>{{Languages}}</code> bar on the English page lists the available copies. The English original is always authoritative.		Pages are written in English as plain wikitext — no translation markup. A translation is a separate static page at a language-suffixed title (<code>Page/fr</code>, <code>Page/eo</code>), maintained by hand with machine-translation assistance. A <code>{{Translation}}</code> banner at the top of a copy records which English revision it mirrors, and a <code>{{Languages}}</code> bar on the English page lists the available copies — the bar is included automatically on every content page, so you never add it by hand. The English original is always authoritative.

	Copies are created only once a page has settled editorially — translating a page that is still being restructured is wasted work. Browser machine translation complements, never replaces, the static copies: <code>fr</code> is covered in all browsers, <code>eo</code> only in Chrome.		Copies are created only once a page has settled editorially — translating a page that is still being restructured is wasted work. Browser machine translation complements, never replaces, the static copies: <code>fr</code> is covered in all browsers, <code>eo</code> only in Chrome.

SeedBot: Describe the static-copy translation model (ADR static-llm-translation); drop Special:MyLanguage links and Translate-extension workflow (via update-page on MediaWiki MCP Server)

2026-08-19T18:17:36Z

Describe the static-copy translation model (ADR static-llm-translation); drop Special:MyLanguage links and Translate-extension workflow (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 18:17, 19 August 2026
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~~.		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, as static translated copies. Contribution is never blocked on translation: write in the language you know; translations are produced separately.

	== Entities and properties ==		== Entities and properties ==
Line 30:		Line 30:
	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 ==

	~~Wiki pages~~ are ~~translated~~ with the ~~Translate extension~~, ~~which separates two roles:~~		Pages are written in English as plain wikitext — no translation markup. A translation is a separate static page at a language-suffixed title (<code>Page/fr</code>, <code>Page/eo</code>), maintained by hand with machine-translation assistance. A <code>{{Translation}}</code> banner at the top of a copy records which English revision it mirrors, and a <code>{{Languages}}</code> bar on the English page lists the available copies. The English original is always authoritative.
	* The translation administrator marks pages for translation and ~~manages their units~~.
	* The ~~translator translates units through the translation interface~~.

	~~=== Workflow per role ===~~		Copies are created only once a page has settled editorially — translating a page that is still being restructured is wasted work. Browser machine translation complements, never replaces, the static copies: <code>fr</code> is covered in all browsers, <code>eo</code> only in Chrome.

	* [[Special:MyLanguage/Help:Contributing/languages/translationAdmin\|Translation admin]] — marking and ~~managing pages~~		=== Producing and maintaining translations ===
	* [[~~Special:MyLanguage/~~Help:Contributing/languages/translator\|Translator]] — ~~translating units~~
			* [[Help:Contributing/languages/translator\|Translator]] — how copies are produced, kept in sync and verified

	== See also ==		== See also ==
Line 45:		Line 44:
	* [[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)~~		* [[Help:Contributing/languages/translator]] — producing and maintaining translations

SeedBot: Rewrite in code-guide style: strip translation markup, `for plain tokens (via update-page on MediaWiki MCP Server)`


2026-08-19T17:27:49Z
Rewrite in code-guide style: strip translation markup, <code> for plain tokens (via update-page on MediaWiki MCP Server)

				
				
				
				
				
				← Older revision
				Revision as of 17:27, 19 August 2026
				
Line 1:
Line 1:
<languages/> 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.



<translate> == Entities and properties ==
<!--T:1--> 
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. 
</translate> 



== <translate><!--T:2--> Entities and properties</translate> == 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.
  
<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. 
</translate> 



{| class="wikitable" style="width:100%" {| class="wikitable" style="width:100%"
! Field !! What it is !! Example (property <code>P1</code>)
|- |-
! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (property P1)</translate> | Label || The short, human-readable name of the entity || instance of
|- 
| <translate><!--T:7--> Label</translate> || <translate><!--T:8--> The short, human-readable name of the entity</translate> || <translate><!--T:9--> instance of</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> | Description || A one-line clarification that disambiguates the entity || that class of which this subject is a particular example and member
|- |-
| <translate><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> example of</translate> | Aliases || Alternative names or spellings that also resolve to the entity || example of
|} |}



<translate> 
<!--T:16--> 
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.
</translate> 



=== <translate><!--T:17--> Workflow</translate> === === Workflow ===



<translate> 
<!--T:18--> 
To add or edit terms in another language: To add or edit terms in another language:
<ol> <ol>
<li>Open the entity (for example <tvar name="p1">[[Special:EntityPage/P1]]</tvar>) and enter edit mode.</li> <li>Open the entity (for example [[Special:EntityPage/P1]]) and enter edit mode.</li>
<li>Open the <tvar name="morelanguages">"In more languages"</tvar> section at the top of the page.</li> <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.
</translate> 



== <translate><!--T:19--> Classic wiki pages</translate> == == Classic wiki pages ==



<translate> 
<!--T:20--> 
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.
</translate> 



=== <translate><!--T:21--> Workflow per role</translate> === === Workflow per role ===



<translate> 
<!--T:22--> 
* [[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
</translate> 



== <translate><!--T:23--> See also</translate> == == 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)



SeedBot: Links: translatable labels via Special:MyLanguage instead of whole-link tvars (via update-page on MediaWiki MCP Server)
2026-08-19T09:02:27Z
Links: translatable labels via Special:MyLanguage instead of whole-link tvars (via update-page on MediaWiki MCP Server)

				
				
				
				
				
				← Older revision
				Revision as of 09:02, 19 August 2026
				
Line 58:
Line 58:
<translate> <translate>
<!--T:22--> <!--T:22-->
* <tvar name="admin">[[Help:Contributing/languages/translationAdmin Translation admin]]</tvar> — marking and managing pages * [[Special:MyLanguage/Help:Contributing/languages/translationAdmin|Translation admin]] — marking and managing pages
* <tvar name="translator">[[Help:Contributing/languages/translator Translator]]</tvar> — translating units * [[Special:MyLanguage/Help:Contributing/languages/translator|Translator]] — translating units
</translate> </translate>








Rongzhou: /*  Workflow per role */
2026-08-19T08:55:43Z
Workflow per role

				
				
				
				
				
				← Older revision
				Revision as of 08:55, 19 August 2026
				
Line 58:
Line 58:
<translate> <translate>
<!--T:22--> <!--T:22-->
Follow the page for what you do: * <tvar name="admin">[[Help:Contributing/languages/translationAdmin Translation admin]]</tvar> — marking and managing pages
* <tvar name="admin">[[Help:Contributing/languages/translationAdmin]]</tvar> — marking and managing pages * <tvar name="translator">[[Help:Contributing/languages/translator Translator]]</tvar> — translating units
* <tvar name="translator">[[Help:Contributing/languages/translator]]</tvar> — translating units 
</translate> </translate>








Rongzhou: /*  Entities and properties */
2026-08-19T08:54:22Z
Entities and properties

				
				
				
				
				
				← Older revision
				Revision as of 08:54, 19 August 2026
				
Line 21:
Line 21:
| <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><!--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><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> Example of</translate> | <translate><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> example of</translate>
|} |}








Rongzhou at 08:53, 19 August 2026
2026-08-19T08:53:54Z


				
				
				
				
				
				← Older revision
				Revision as of 08:53, 19 August 2026
				
Line 21:
Line 21:
| <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><!--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><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> — (P1 has no aliases yet)</translate> | <translate><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> Example of</translate>
|} |}








SeedBot: Restructure: general principles (en/fr/eo), entities and properties, classic wiki pages with role subpages (via update-page on MediaWiki MCP Server)
2026-08-19T07:57:45Z
Restructure: general principles (en/fr/eo), entities and properties, classic wiki pages with role subpages (via update-page on MediaWiki MCP Server)

				
				
				
				
				
				← Older revision
				Revision as of 07:57, 19 August 2026
				
Line 3:
Line 3:
<translate> <translate>
<!--T:1--> <!--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 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.
</translate> </translate>



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



<translate> <translate>
Line 25:
Line 25:



<translate> <translate>
<!--T:31--> <!--T:16-->
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.
* 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.
</translate>
 
=== <translate><!--T:17--> Workflow</translate> ===
 
<translate>
<!--T:18-->
To add or edit terms in another language: To add or edit terms in another language:
<ol> <ol>
Line 32:
Line 42:
<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.
</translate> </translate>

== <translate><!--T:19--> Classic wiki pages</translate> ==



<translate> <translate>
<!--T:35--> <!--T:20-->
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. 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.
</translate> </translate>



=== <translate><!--T:17--> House rules for entity terms</translate> === === <translate><!--T:21--> Workflow per role</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><!--T:19--> Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision).</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><!--T:21--> Translating wiki pages</translate> == 



<translate> <translate>
<!--T:22--> <!--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. Follow the page for what you do:
* <tvar name="admin">[[Help:Contributing/languages/translationAdmin]]</tvar> — marking and managing pages
* <tvar name="translator">[[Help:Contributing/languages/translator]]</tvar> — translating units
</translate> </translate>



* <translate><!--T:23--> <tvar name="special-translate">[[Special:Translate|Special:Translate]]</tvar> — the translation interface, listing untranslated units per page.</translate> == <translate><!--T:23--> See also</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><!--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><!--T:26--> House rules for translated pages</translate> === 
  
* <translate><!--T:27--> Machine translation is a starting point, not a final answer: always read and correct machine-translated units.</translate> 
* <translate><!--T:28--> Keep terminology consistent with the entity terms (labels/descriptions) used in the data layer.</translate> 
* <translate><!--T:29--> Do not translate <tvar name="tvar">tvar</tvar> placeholders or markup — translate only the human-readable text.</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)





SeedBot: Fix example table to property P1; show the In more languages workflow (via update-page on MediaWiki MCP Server)
2026-08-19T07:32:43Z
Fix example table to property P1; show the In more languages workflow (via update-page on MediaWiki MCP Server)

				
				
				
				
				
				← Older revision
				Revision as of 07:32, 19 August 2026
				
Line 15:
Line 15:
{| class="wikitable" style="width:100%" {| class="wikitable" style="width:100%"
|- |-
! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (item Q1)</translate> ! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (property P1)</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><!--T:7--> Label</translate> || <translate><!--T:8--> The short, human-readable name of the entity</translate> || <translate><!--T:9--> instance of</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><!--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><!--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><!--T:13--> Aliases</translate> || <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> || <translate><!--T:15--> — (P1 has no aliases yet)</translate>
|} |}



<translate> <translate>
<!--T:16--> <!--T:31-->
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:
<ol>
<li>Open the entity (for example <tvar name="p1">[[Special:EntityPage/P1]]</tvar>) and enter edit mode.</li>
<li>Open the <tvar name="morelanguages">"In more languages"</tvar> section at the top of the page.</li>
<li>Choose the language, type the value, save.</li>
</ol>
</translate>
 
<translate>
<!--T:35-->
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>



Line 37:
Line 47:
== <translate><!--T:21--> Translating wiki pages</translate> == == <translate><!--T:21--> Translating wiki pages</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>
<!--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><!--T:23--> <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>





SeedBot: Add languages bar to translatable page
2026-08-18T22:02:18Z
Add languages bar to translatable page

				
				
				
				
				
				← Older revision
				Revision as of 22:02, 18 August 2026
				
Line 1:
Line 1:
<languages/>

<translate> <translate>
<!--T:1--> <!--T:1-->

← Older revision		Revision as of 17:27, 19 August 2026
Line 1:		Line 1:
	<~~languages~~/>		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.

	~~<translate>~~		== Entities and properties ==
	~~<!--T:1-->~~
	~~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.~~
	~~</translate>~~

	~~== <translate><!--T:2--> Entities and properties</translate> ==~~		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.

	~~<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.
	~~</translate>~~

	{\| class="wikitable" style="width:100%"		{\| class="wikitable" style="width:100%"
			! Field !! What it is !! Example (property <code>P1</code>)
	\|-		\|-
	~~! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (property P1)</translate>~~		\| Label \|\| The short, human-readable name of the entity \|\| instance of
	\|-
	\| ~~<translate><!--T:7-->~~ Label~~</translate>~~ \|\| ~~<translate><!--T:8-->~~ The short, human-readable name of the entity~~</translate>~~ \|\| ~~<translate><!--T:9-->~~ instance of~~</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>~~		\| Description \|\| A one-line clarification that disambiguates the entity \|\| that class of which this subject is a particular example and member
	\|-		\|-
	\| ~~<translate><!--T:13-->~~ Aliases~~</translate>~~ \|\| ~~<translate><!--T:14-->~~ Alternative names or spellings that also resolve to the entity~~</translate>~~ \|\| ~~<translate><!--T:15-->~~ example of~~</translate>~~		\| Aliases \|\| Alternative names or spellings that also resolve to the entity \|\| example of
	\|}		\|}

	~~<translate>~~
	~~<!--T:16-->~~
	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.
	~~</translate>~~

	=== ~~<translate><!--T:17-->~~ Workflow~~</translate>~~ ===		=== Workflow ===

	~~<translate>~~
	~~<!--T:18-->~~
	To add or edit terms in another language:		To add or edit terms in another language:
	<ol>		<ol>
	<li>Open the entity (for example ~~<tvar name="p1">~~[[Special:EntityPage/P1]]~~</tvar>~~) and enter edit mode.</li>		<li>Open the entity (for example [[Special:EntityPage/P1]]) and enter edit mode.</li>
	<li>Open the ~~<tvar name="morelanguages">~~"In more languages"~~</tvar>~~ section at the top of the page.</li>		<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.
	~~</translate>~~

	== ~~<translate><!--T:19-->~~ Classic wiki pages~~</translate>~~ ==		== Classic wiki pages ==

	~~<translate>~~
	~~<!--T:20-->~~
	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.
	~~</translate>~~

	=== ~~<translate><!--T:21-->~~ Workflow per role~~</translate>~~ ===		=== Workflow per role ===

	~~<translate>~~
	~~<!--T:22-->~~
	* [[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
	~~</translate>~~

	== ~~<translate><!--T:23-->~~ See also~~</translate>~~ ==		== 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)

← Older revision		Revision as of 09:02, 19 August 2026
Line 58:		Line 58:
	<translate>		<translate>
	<!--T:22-->		<!--T:22-->
	* ~~<tvar name="admin">~~[[Help:Contributing/languages/translationAdmin Translation admin]]~~</tvar>~~ — marking and managing pages		* [[Special:MyLanguage/Help:Contributing/languages/translationAdmin\|Translation admin]] — marking and managing pages
	* ~~<tvar name="translator">~~[[Help:Contributing/languages/translator Translator]]~~</tvar>~~ — translating units		* [[Special:MyLanguage/Help:Contributing/languages/translator\|Translator]] — translating units
	</translate>		</translate>

← Older revision		Revision as of 08:55, 19 August 2026
Line 58:		Line 58:
	<translate>		<translate>
	<!--T:22-->		<!--T:22-->
	~~Follow the page for what you do:~~		* <tvar name="admin">[[Help:Contributing/languages/translationAdmin Translation admin]]</tvar> — marking and managing pages
	* <tvar name="admin">[[Help:Contributing/languages/translationAdmin]]</tvar> — marking and managing pages		* <tvar name="translator">[[Help:Contributing/languages/translator Translator]]</tvar> — translating units
	* <tvar name="translator">[[Help:Contributing/languages/translator]]</tvar> — translating units
	</translate>		</translate>

← Older revision		Revision as of 08:54, 19 August 2026
Line 21:		Line 21:
	\| <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><!--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><!--T:13--> Aliases</translate> \|\| <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> \|\| <translate><!--T:15--> ~~Example~~ of</translate>		\| <translate><!--T:13--> Aliases</translate> \|\| <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> \|\| <translate><!--T:15--> example of</translate>
	\|}		\|}

← Older revision		Revision as of 08:53, 19 August 2026
Line 21:		Line 21:
	\| <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><!--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><!--T:13--> Aliases</translate> \|\| <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> \|\| <translate><!--T:15--> ~~— (P1 has no aliases yet)~~</translate>		\| <translate><!--T:13--> Aliases</translate> \|\| <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> \|\| <translate><!--T:15--> Example of</translate>
	\|}		\|}

← Older revision		Revision as of 07:57, 19 August 2026
Line 3:		Line 3:
	<translate>		<translate>
	<!--T:1-->		<!--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 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.
	</translate>		</translate>

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

	<translate>		<translate>
Line 25:		Line 25:

	<translate>		<translate>
	<!--T:31-->		<!--T:16-->
			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.
			* 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.
			</translate>

			=== <translate><!--T:17--> Workflow</translate> ===

			<translate>
			<!--T:18-->
	To add or edit terms in another language:		To add or edit terms in another language:
	<ol>		<ol>
Line 32:		Line 42:
	<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.
	</translate>		</translate>

			== <translate><!--T:19--> Classic wiki pages</translate> ==

	<translate>		<translate>
	<!--T:35-->		<!--T:20-->
	~~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~~.		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.
	</translate>		</translate>

	=== <translate><!--T:~~17--> House rules for entity terms</translate> ===~~		=== <translate><!--T:21--> Workflow per role</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><!--T:19--> Do not copy Wikidata property numbers — properties are mirrored and mapped via equivalence statements instead (see the ontology alignment decision).</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><!--T:21--> Translating wiki pages</translate>~~ ==

	<translate>		<translate>
	<!--T:22-->		<!--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.~~		Follow the page for what you do:
			* <tvar name="admin">[[Help:Contributing/languages/translationAdmin]]</tvar> — marking and managing pages
			* <tvar name="translator">[[Help:Contributing/languages/translator]]</tvar> — translating units
	</translate>		</translate>

	* <translate><!--T:23--> <tvar name="special-translate">[[Special:Translate\|Special:Translate]]</tvar> — the translation interface, listing untranslated units per page.</translate>		== <translate><!--T:23--> See also</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><!--T:25--> Translation units are the <code><translate></code> blocks in the source wikitext — keep them self-contained, one sentence or short paragraph each.</translate>

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

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

← Older revision		Revision as of 07:32, 19 August 2026
Line 15:		Line 15:
	{\| class="wikitable" style="width:100%"		{\| class="wikitable" style="width:100%"
	\|-		\|-
	! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (~~item Q1~~)</translate>		! <translate><!--T:4--> Field</translate> !! <translate><!--T:5--> What it is</translate> !! <translate><!--T:6--> Example (property P1)</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><!--T:7--> Label</translate> \|\| <translate><!--T:8--> The short, human-readable name of the entity</translate> \|\| <translate><!--T:9--> instance of</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><!--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><!--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><!--T:13--> Aliases</translate> \|\| <translate><!--T:14--> Alternative names or spellings that also resolve to the entity</translate> \|\| <translate><!--T:15--> — (P1 has no aliases yet)</translate>
	\|}		\|}

	<translate>		<translate>
	<!--T:16-->		<!--T:31-->
	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:
			<ol>
			<li>Open the entity (for example <tvar name="p1">[[Special:EntityPage/P1]]</tvar>) and enter edit mode.</li>
			<li>Open the <tvar name="morelanguages">"In more languages"</tvar> section at the top of the page.</li>
			<li>Choose the language, type the value, save.</li>
			</ol>
			</translate>

			<translate>
			<!--T:35-->
			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>

Line 37:		Line 47:
	== <translate><!--T:21--> Translating wiki pages</translate> ==		== <translate><!--T:21--> Translating wiki pages</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>
			<!--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><!--T:23--> <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>

← Older revision		Revision as of 22:02, 18 August 2026
Line 1:		Line 1:
			<languages/>

	<translate>		<translate>
	<!--T:1-->		<!--T:1-->

Help:Contributing/languages - Revision history

SeedBot: The {{Languages}} bar is now included automatically on every content page (LanguageBar extension) — note it, don't add it by hand (via update-page on MediaWiki MCP Server)

SeedBot: Describe the static-copy translation model (ADR static-llm-translation); drop Special:MyLanguage links and Translate-extension workflow (via update-page on MediaWiki MCP Server)

SeedBot: Rewrite in code-guide style: strip translation markup, for plain tokens (via update-page on MediaWiki MCP Server)

SeedBot: Links: translatable labels via Special:MyLanguage instead of whole-link tvars (via update-page on MediaWiki MCP Server)

Rongzhou: /* Workflow per role */

Rongzhou: /* Entities and properties */

Rongzhou at 08:53, 19 August 2026

SeedBot: Restructure: general principles (en/fr/eo), entities and properties, classic wiki pages with role subpages (via update-page on MediaWiki MCP Server)

SeedBot: Fix example table to property P1; show the In more languages workflow (via update-page on MediaWiki MCP Server)

SeedBot: Add languages bar to translatable page

SeedBot: Rewrite in code-guide style: strip translation markup, `for plain tokens (via update-page on MediaWiki MCP Server)`