Help:Contributing/languages/translator: Difference between revisions
Jump to navigation
Jump to search
Rewrite for the static-copy model (ADR static-llm-translation); fold in translationAdmin content (marking role removed) (via update-page on MediaWiki MCP Server) |
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) |
||
| (One intermediate revision by the same user not shown) | |||
| 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> | <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> | ||
Latest revision as of 09:21, 10 September 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. - The English page's
bar already lists thefrandeoslots — 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).
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