Help:Contributing/languages/translator - 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:36Z

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 7:		Line 7:
	<li>Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.</li>		<li>Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.</li>
	<li>Save it to <code>Page/<lang></code> — for example <syntaxhighlight lang="text" inline>Help:Contributing/code/fr</syntaxhighlight> — opening with the banner <syntaxhighlight lang="text" inline>{{Translation\|lang=fr\|based-on=<revid>\|date=YYYY-MM-DD}}</syntaxhighlight>, where <code>based-on</code> is the English revision you translated.</li>		<li>Save it to <code>Page/<lang></code> — for example <syntaxhighlight lang="text" inline>Help:Contributing/code/fr</syntaxhighlight> — opening with the banner <syntaxhighlight lang="text" inline>{{Translation\|lang=fr\|based-on=<revid>\|date=YYYY-MM-DD}}</syntaxhighlight>, where <code>based-on</code> is the English revision you translated.</li>
	<li>The English page's <code>{{Languages}}</code> bar already lists the <code>fr</code> and <code>eo</code> slots — creating the copy fills its slot; the redlink becomes a link.</li>		<li>The English page's <code>{{Languages}}</code> bar already lists the <code>fr</code> and <code>eo</code> slots — creating the copy fills its slot; the redlink becomes a link. The bar is added automatically on every content page (you do not add it by hand).</li>
	</ol>		</ol>

SeedBot: Bar is unconditional (no ParserFunctions): creating a copy fills the slot, nothing to add/remove (via update-page on MediaWiki MCP Server)

2026-08-19T18:20:30Z

Bar is unconditional (no ParserFunctions): creating a copy fills the slot, nothing to add/remove (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 18:20, 19 August 2026
Line 7:		Line 7:
	<li>Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.</li>		<li>Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.</li>
	<li>Save it to <code>Page/<lang></code> — for example <syntaxhighlight lang="text" inline>Help:Contributing/code/fr</syntaxhighlight> — opening with the banner <syntaxhighlight lang="text" inline>{{Translation\|lang=fr\|based-on=<revid>\|date=YYYY-MM-DD}}</syntaxhighlight>, where <code>based-on</code> is the English revision you translated.</li>		<li>Save it to <code>Page/<lang></code> — for example <syntaxhighlight lang="text" inline>Help:Contributing/code/fr</syntaxhighlight> — opening with the banner <syntaxhighlight lang="text" inline>{{Translation\|lang=fr\|based-on=<revid>\|date=YYYY-MM-DD}}</syntaxhighlight>, where <code>based-on</code> is the English revision you translated.</li>
	<li>~~Add the copy to the~~ English page's <code>{{Languages}}</code> bar; ~~remove it again if~~ the ~~copy is deleted~~.</li>		<li>The English page's <code>{{Languages}}</code> bar already lists the <code>fr</code> and <code>eo</code> slots — creating the copy fills its slot; the redlink becomes a link.</li>
	</ol>		</ol>

SeedBot: Rewrite for the static-copy model (ADR static-llm-translation); fold in translationAdmin content (marking role removed) (via update-page on MediaWiki MCP Server)

2026-08-19T18:17:44Z

Rewrite for the static-copy model (ADR static-llm-translation); fold in translationAdmin content (marking role removed) (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 18:17, 19 August 2026
Line 1:		Line 1:
	<languages/>		This page is for producing and maintaining the static translations of wiki pages into the official languages — <code>en</code>, <code>fr</code>, <code>eo</code>. The [[Help:Contributing/languages\|hub]] page explains the model: pages are plain wikitext, translations are separate <code>/lang</code> copies. There is no marking workflow anymore.

	~~<translate>~~		== Creating a translation ==
	~~<!--T:1-->~~
	~~This page is for the translator role: you translate wiki pages into the official languages — <tvar name~~=~~"langs">en, fr, eo</tvar>. The <tvar name~~=~~"hub">[[Help:Contributing/languages]]</tvar> page explains the two mechanisms.~~
	~~</translate>~~

	~~== <translate><!--T:2--> Translating a page</translate> ==~~

	~~<translate>~~
	~~<!--T:3-->~~
	<ol>		<ol>
	<li>~~Open~~ <~~tvar name~~="~~special-translate~~">~~[[Special~~:~~Translate]]~~</~~tvar~~>.</li>		<li>Copy the current English source of a settled page — plain wikitext, no translation markup.</li>
	<li>~~Pick~~ the page ~~group and the target language.~~<~~/li~~>		<li>Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.</li>
	<li>~~Translate~~ the ~~units and save~~.</li>		<li>Save it to <code>Page/<lang></code> — for example <syntaxhighlight lang="text" inline>Help:Contributing/code/fr</syntaxhighlight> — opening with the banner <syntaxhighlight lang="text" inline>{{Translation\|lang=fr\|based-on=<revid>\|date=YYYY-MM-DD}}</syntaxhighlight>, where <code>based-on</code> is the English revision you translated.</li>
			<li>Add the copy to the English page's <code>{{Languages}}</code> bar; remove it again if the copy is deleted.</li>
	</ol>		</ol>
	~~Preview your result with <code>?uselang=</code> plus the language code at the end of the page URL, for example <code>?uselang=fr</code>.~~
	~~</translate>~~

	== ~~<translate><!--T:4--> What not to translate</translate>~~ ==		Copies are created only once a page has settled editorially — do not translate a page that is still being restructured.

			== Keeping copies in sync ==

	<~~translate~~>		* When the English page is edited, regenerate its copies in the same session and update <code>based-on</code>.
	<~~!--T:5--~~>		* If an English page changed outside a session, flag the stale copies rather than silently leaving them.
	* ~~<tvar name="tvar">tvar</tvar> placeholders — copy~~ them ~~unchanged~~.		* Machine translation is a starting point, not a final answer: always read and correct machine-translated text.
	* ~~Markup~~ and ~~code~~.		* Keep terminology consistent with the entity terms in the data layer — see the entity terms section on the [[Help:Contributing/languages\|hub]] page.
	* ~~Entity IDs (~~<code>P1</code>, <code>Q6</code>~~) and language codes~~.		* Browser machine translation complements, never replaces, the static copies: <code>fr</code> is covered everywhere, <code>eo</code> only in Chrome.
	~~</translate>~~		* Check the rendered result after saving — the copy should mirror the original's structure.

	== ~~<translate><!--T:6--> House rules</translate>~~ ==		== What to keep verbatim ==

	<~~translate~~>		* Wikilinks, entity IDs (<code>P1</code>, <code>Q6</code>), URLs, and <syntaxhighlight lang="text" inline><syntaxhighlight></syntaxhighlight>/<code><pre></code>/<code><code></code> blocks.
	<~~!--T:7--~~>		* Template calls and their parameters, except visible prose.
	* Machine translation is a starting point, ~~not a final answer: always read and correct machine-translated units.~~		* Proper nouns and canonical terms — do not translate them.
	* Keep terminology consistent with the entity terms (labels/~~descriptions~~) ~~in the data layer — see the entity terms section on the~~ <~~tvar name~~="~~hub~~">~~[[Help:Contributing~~/~~languages]]~~</~~tvar~~> ~~page~~.
	</translate>

	== ~~<translate><!--T:8-->~~ See also~~</translate>~~ ==		== See also ==

	* ~~<tvar name="hub">~~[[Help:Contributing/languages]]~~</tvar>~~ — the hub		* [[Help:Contributing/languages]] — the hub
	* ~~<tvar name="admin">~~[[Help:Contributing~~/languages/translationAdmin~~]]~~</tvar>~~ — ~~the other role~~		* [[Help:Contributing]] — contributing to this wiki
	* [https://www.mediawiki.org/wiki~~/Help:Extension:Translate Translate extension help] (official)~~

SeedBot: Role page: translator workflow (via create-page on MediaWiki MCP Server)

2026-08-19T07:57:53Z

Role page: translator workflow (via create-page on MediaWiki MCP Server)

New page

<languages/>

<translate>

This page is for the translator role: you translate wiki pages into the official languages — <tvar name="langs">en, fr, eo</tvar>. The <tvar name="hub">[[Help:Contributing/languages]]</tvar> page explains the two mechanisms.
</translate>

== <translate> Translating a page</translate> ==

<translate>

<ol>
<li>Open <tvar name="special-translate">[[Special:Translate]]</tvar>.</li>
<li>Pick the page group and the target language.</li>
<li>Translate the units and save.</li>
</ol>
Preview your result with <code>?uselang=</code> plus the language code at the end of the page URL, for example <code>?uselang=fr</code>.
</translate>

== <translate> What not to translate</translate> ==

<translate>

* <tvar name="tvar">tvar</tvar> placeholders — copy them unchanged.
* Markup and code.
* Entity IDs (<code>P1</code>, <code>Q6</code>) and language codes.
</translate>

== <translate> House rules</translate> ==

<translate>

* 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) in the data layer — see the entity terms section on the <tvar name="hub">[[Help:Contributing/languages]]</tvar> page.
</translate>

== <translate> See also</translate> ==

* <tvar name="hub">[[Help:Contributing/languages]]</tvar> — the hub
* <tvar name="admin">[[Help:Contributing/languages/translationAdmin]]</tvar> — the other role
* [https://www.mediawiki.org/wiki/Help:Extension:Translate Translate extension help] (official)