Help:Contributing/languages/translator: Difference between revisions
Jump to navigation
Jump to search
Role page: translator workflow (via create-page on MediaWiki MCP Server) |
Rewrite for the static-copy model (ADR static-llm-translation); fold in translationAdmin content (marking role removed) (via update-page on MediaWiki MCP Server) |
||
| 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. | ||
== Creating a translation == | |||
<ol> | <ol> | ||
<li> | <li>Copy the current English source of a settled page — plain wikitext, no translation markup.</li> | ||
<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>Add the copy to the English page's <code>{{Languages}}</code> bar; remove it again if the copy is deleted.</li> | |||
</ol> | </ol> | ||
== | Copies are created only once a page has settled editorially — do not translate a page that is still being restructured. | ||
== Keeping copies in sync == | |||
< | * When the English page is edited, regenerate its copies in the same session and update <code>based-on</code>. | ||
< | * If an English page changed outside a session, flag the stale copies rather than silently leaving them. | ||
* | * Machine translation is a starting point, not a final answer: always read and correct machine-translated text. | ||
* | * Keep terminology consistent with the entity terms in the data layer — see the entity terms section on the [[Help:Contributing/languages|hub]] page. | ||
* | * Browser machine translation complements, never replaces, the static copies: <code>fr</code> is covered everywhere, <code>eo</code> only in Chrome. | ||
* Check the rendered result after saving — the copy should mirror the original's structure. | |||
== | == What to keep verbatim == | ||
< | * Wikilinks, entity IDs (<code>P1</code>, <code>Q6</code>), URLs, and <syntaxhighlight lang="text" inline><syntaxhighlight></syntaxhighlight>/<code><pre></code>/<code><code></code> blocks. | ||
< | * Template calls and their parameters, except visible prose. | ||
* Proper nouns and canonical terms — do not translate them. | |||
== | == See also == | ||
* | * [[Help:Contributing/languages]] — the hub | ||
* | * [[Help:Contributing]] — contributing to this wiki | ||
Revision as of 18:17, 19 August 2026
This page is for producing and maintaining the static translations of wiki pages into the official languages — en, fr, eo. The hub page explains the model: pages are plain wikitext, translations are separate /lang copies. There is no marking workflow anymore.
Creating a translation
- Copy the current English source of a settled page — plain wikitext, no translation markup.
- Translate it, keeping links, entity IDs, URLs and code blocks verbatim; keep the heading and table structure.
- Save it to
Page/<lang>— for exampleHelp:Contributing/code/fr— opening with the banner{{Translation|lang=fr|based-on=<revid>|date=YYYY-MM-DD}}, wherebased-onis the English revision you translated. - Add the copy to the English page's
bar; remove it again if the copy is deleted.
Copies are created only once a page has settled editorially — do not translate a page that is still being restructured.
Keeping copies in sync
- When the English page is edited, regenerate its copies in the same session and update
based-on. - If an English page changed outside a session, flag the stale copies rather than silently leaving them.
- Machine translation is a starting point, not a final answer: always read and correct machine-translated text.
- Keep terminology consistent with the entity terms in the data layer — see the entity terms section on the hub page.
- Browser machine translation complements, never replaces, the static copies:
fris covered everywhere,eoonly in Chrome. - Check the rendered result after saving — the copy should mirror the original's structure.
What to keep verbatim
- Wikilinks, entity IDs (
P1,Q6), URLs, and<syntaxhighlight>/<pre>/<code>blocks. - Template calls and their parameters, except visible prose.
- Proper nouns and canonical terms — do not translate them.
See also
- Help:Contributing/languages — the hub
- Help:Contributing — contributing to this wiki