Difference between revisions of "Help:Language translation"
(~~~~ I translate all Its took me all my day :D !!!!!) |
|||
Line 1: | Line 1: | ||
− | <! - | + | <!-- Please do not translate this page, it needs to remain in English only. --> |
{{TFWiki navbar}} | {{TFWiki navbar}} | ||
− | Team Fortress Wiki | + | Team Fortress Wiki is capable of handling '''multilingual content''' and providing the reader a user interface in their preferred language. Multilingual editors are encouraged to '''translate and maintain articles''' in as many different languages as possible to reach the whole TF2 global community. Maintaining up to date translated articles is very important and it should be noted that it is preferential to have an up to date English article, rather than an out of date translated one. |
− | == | + | == How to translate a page == |
− | + | Follow these guidelines to start translating an article. | |
− | # | + | # Check that your language is supported (see [[#List of supported languages|List of supported languages]] below). We support most languages that have official in-game translations. |
− | # | + | # Go to the English version of the article's page and click "Edit this page". Select everything in the box and copy it. |
− | # | + | # Navigate to the new language by adding "/LANGUAGE" to the end of the article where LANGUAGE is replaced with the ISO code of the language you wish to translate to, found [[#List of supported languages|Here]] |
− | #: | + | #: Example: <code>[[Scout/fr|http://wiki.teamfortress.com/wiki/Scout/fr]]</code> |
− | # | + | # Paste the code of the English page to the new one. |
− | #: | + | #: The French version of the article "[[Hats]]" would be {{xt|Hats/fr}}, not {{!xt|Chapeaux}}, {{!xt|Hats/Chapeaux}} or {{!xt|Chapeaux/fr}} |
− | # | + | # Add the template {{tl|Trans}} to the top of the page. All such incomplete translations will be [[:Category:Pages_in_translation|in the appropriate category]]. |
− | #: | + | #: You do not need to add {{tlx|Trans|French}} (for example), only {{tl|trans}} or {{tl|translate}} is required. |
− | # | + | # Use <code><nowiki>{{DISPLAYTITLE:abcxyz}}</nowiki></code> to translate the page's title. |
− | #: | + | #: For example: <code><nowiki>{{DISPLAYTITLE:Handlung}}</nowiki></code> would ''show'' the title "Handlung" while keeping the ''real'' article title as "Storyline/de". |
− | #: | + | #: The display title can also be set by the infobox [[#Articles|(see below)]]. Because of this, articles about cosmetic items and weapons should ''not'' use this template to allow dynamic name changes from the [[Template:Dictionary|dictionary]]. |
− | # | + | # Change the categories at the bottom of the page. |
− | #: | + | #: For example: <code><nowiki>[[Category:Lists|Weapons]]</nowiki></code> becomes <code><nowiki>[[Category:Lists</nowiki>'''/fr'''<nowiki>|Weapons]]</nowiki></code>. Do this for all categories at the bottom of the page. |
− | # | + | # You can now translate the rest of the article. Note that some text is stored in other pages (called "templates"). To translate these you will have to edit them individually. |
− | #: | + | #: Whenever possible, make use of [[:Category:Localization files|localization files]] in order to use correct names and descriptions. |
− | == | + | == Translation community == |
− | + | Each language has its own main discussion page at '''[[Team Fortress Wiki:Translation progress]]'''. You can also find statistics about your language's translation effort here. | |
− | + | Please also join the [http://steamcommunity.com/groups/tfwiki-i18n/ TF Wiki Translators] Steam Group and watch the [[Team Fortress Wiki:Translators' noticeboard|translators' noticeboard]] (click the 'watch' tab at the top). This will ensure you stay on top of any changes or announcements. | |
− | == | + | == Multilingual guidelines == |
− | * | + | * English is the main reference language, and all root pages should be named and written in English. |
− | * | + | * Other languages should be placed in an appropriately named sub-page of the English version. |
− | * | + | * Language subpages should use the appropriate ISO 639 code (as listed [[#List of supported languages|below]]) |
− | * | + | * With few exceptions, pages in the <code>Help, Team Fortress Wiki, Mediawiki</code> namespaces should not be translated. These pages are primarily aimed to be read by Wiki editors, and all Wiki editors should all be capable of reading English. As such, it is not very useful to translate these pages and can cause out-of-date guidelines when compared to the authoritative (English) version. Exceptions include language-specific translation guidelines and problematic guidelines repeatedly ignored by non-English-reading editors. |
− | ** | + | ** Disambiguation pages do not need to be translated unless they refer to common words, e.g. [[Shoes]]. |
− | * | + | * If a translated version of a page exists but an English version does not, then please create a stub article for the English version as this aids navigation. |
− | * | + | * The use of {{tl|Languages}} at the bottom of articles is now discouraged, as language links appear in the sidebar. |
− | * | + | * While in the process of translating articles, using {{tlx|Trans}} is encouraged to display to other editors that the article is a work in progress. |
− | * | + | * Pages that are out of date or need updating should be tagged with {{tl|update trans}}. Pages with this tag appear in [[:Category:Translations needing updating]], sorted by language. |
− | * | + | * Please do ''not'' sign articles using the 4 tildes (<code><nowiki>~~~~</nowiki></code>). The list of people who contributed to the article is always available in the history tab, and it would otherwise clutter the page. |
− | === | + | === Automated translation tools === |
− | {{fmbox | + | {{fmbox |
− | | image = Pictogram minus.png | + | | image = Pictogram minus.png |
− | | style = | + | | style = padding: 0.25em; margin-bottom: 1em; |
− | | | + | | class = enerror |
− | | text = <div style = "padding-left: 0.5em;"> | + | | text = <div style="padding-left: 0.5em;"> |
− | <div style = "color: # A51414; | + | <div style="color:#A51414; font-size:1.5em; margin:0.5em 0em;">'''Warning'''</div> |
− | + | The use of '''Google Translate''' or any automated translation tool or service is <span style="color:#A51414;">'''strictly prohibited'''</span>. Pages found to have used these tools will be <span style="color:#A51414;">'''deleted'''</span> and users who repeatedly use these programs will be <span style="color:#A51414;">'''blocked from further editing'''</span>. | |
− | </ div> | + | </div> |
}} | }} | ||
− | : {{c | note}}: | + | :{{c|note}}: please '''report''' any pages that consist of entirely machine-translated text (or any users that appear to repeatedly use these tools) to the '''[[Project:Translators' noticeboard|translators' noticeboard]]'''. |
− | === | + | === On-wiki communication === |
− | * '' ' | + | * '''Talk pages''' |
− | ** | + | ** It is '''vital''' that all discussion based on specific users and articles is in English. This is especially important when discussing the quality or accuracy of any article or translator. |
− | * '' ' | + | * '''Edit summaries''' |
− | ** | + | ** All edit summaries should be written in English where practical. |
− | + | ||
+ | These requirements allow staff and fellow editors to keep up to date with every aspect of translation. | ||
== Articles == | == Articles == | ||
− | {{anchor | DISPLAYTITLE | displaytitle | display}} | + | {{anchor|DISPLAYTITLE|displaytitle|display}} |
− | * '' ' | + | * '''Displaying a different title''' |
− | ** | + | ** Displaying a title in a different language is possible with the use of the magic word {{code|{{DISPLAYTITLE:}}}}. |
− | ** | + | ** For example, using <code><nowiki>{{DISPLAYTITLE:Example}}</nowiki></code> will display the article name as ''Example''. |
+ | |||
+ | * '''Templates''' | ||
+ | ** Templates use parameters with values to display text. The style is <code>| parameter = text</code>. Translating the text is almost always required, but the parameter should never be translated. | ||
+ | ** {{tl|Item infobox}} needs a few lines to stay in English for it to work properly. If a parameter is listed below, please do not translate the text associated with it: | ||
+ | <code>type, game, slot, trade, gift, craft, paint, rename, quality</code> | ||
+ | **:See [[Template:Item infobox]] for further help. | ||
− | * '' ' | + | * '''Links''' |
− | ** | + | ** You can link to translated articles and display different text for the links like this: |
− | ** {{tl | | + | *** {{code|1=[[Weapons/fr|Armes]]}} will create [[Weapons/fr|Armes]]. |
− | + | ** If using external links that are in English, you should also use the template {{tl|lang icon}} directly after the link to indicate the language of the external link. | |
− | **: | + | *** {{code|[http://www.google.com/ Google]}} on [[Soldier/fr]] should look like <code><nowiki>[http://www.google.com/ Google] {{lang icon|en}}</nowiki></code>, which will generate: |
+ | **: [http://www.google.com/ Google] {{lang icon|en}} | ||
+ | ** {{tl|Main}} and {{tl|See also}} – When using these templates you can display a different title using the parameter {{code|l1}} (lowercase L1): | ||
+ | *: {{tlx|Main|Hats/fr|3=l1=Chapeaux}} generates | ||
+ | *::''Main article: [[Hats/fr|Chapeaux]]'' | ||
+ | *: {{tlx|1=Main|2=Hats/fr|3=l1=Chapeaux|4=Miscellaneous items/fr|5=l2=Objets divers}} generates | ||
+ | *::''Main articles: [[Hats/fr|Chapeaux]] and [[Miscellaneous items/fr|Objets divers]]'' | ||
+ | *: '''Note''': To change the "Main article:" text, see the individual template pages for {{tl|main}} and {{tl|see also}} as they use [[Help:Translation switching|translation switching]]. | ||
− | + | * '''Categories''' | |
− | + | ** Language pages should be kept in separate categories. | |
− | + | ** For example on [[Wrench/fr]], if you find <code><nowiki>[[Category:Melee weapons]]</nowiki></code> at the bottom of the page, change it to <code><nowiki>[[Category:Melee weapons/fr]]</nowiki></code>. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ** | ||
− | ** | ||
− | * '' 'Redirects' '' | + | * '''Redirects''' |
− | ** | + | ** You can create as many language redirects as are needed, as long as they are tagged properly with {{tl|R lang}}. See example: |
− | **: [[Дробовик]] | + | **: [[Дробовик]] redirecting to [[Shotgun/ru]] will have the following text on the page 'Дробовик': |
− | **: <code> <nowiki> #REDIRECT [[Shotgun / ru]] {{R lang | ru}} </ nowiki> </ code> | + | **: <code><nowiki>#REDIRECT [[Shotgun/ru]] {{R lang|ru}}</nowiki></code> |
− | ** {{c | note}}: | + | ** {{c|note}}: always remember to add {{tlx|R lang|xx}} (this helps to find these redirects later, as there can be hundreds of them) |
− | * '' ' | + | * '''Disambiguation pages''' |
− | ** [[: | + | ** [[:Category:Disambiguation|Disambiguation pages]] (i.e. pages that list articles with similar names for convenience) that are specific to one language should ''not'' be created. Root pages should always be in English, and much of the wiki page structure relies on this. Language-specific disambiguation pages are too difficult to keep track of. |
− | * '' ' | + | * '''Quotations''' |
− | ** | + | ** The quotation text has to be translated. |
− | ** | + | ** If your language is one of the few having translated voice lines (German, Spanish, French and Russian), you can check if the sound is localized by adding your language code to the sound (e.g. {{code|Demo trade 04.wav}} becomes {{code|Demo trade 04 de.wav}}) and using "Show preview". |
− | *** | + | *** If the sound exists, listen to it and add the translated text. |
− | *** | + | *** If not, translate the quotation on your own, leave the English voice line and add the <code>en-sound=yes</code> parameter to the template. |
− | == | + | == Templates == |
− | + | The majority of templates should use [[Help:Translation switching|translation switching]], with the exception of some [[:Category:Navigational templates|navigational boxes]]. Previously it was necessary to create a localized version of a template, e.g. ''Template:Hat infobox/ru''. Now localized text is stored in one template, where text for all languages is stored. Please see [[Help:Translation switching]] for further information. | |
− | {{ | + | {{anchor|Language codes}} |
− | == | + | == List of supported languages == |
− | Team Fortress Wiki | + | Team Fortress Wiki supports language translation of articles into 22 languages, the majority of which have localization files for TF2. |
− | : {{c | note}}: | + | :{{c|note}}: there are no plans to add support for any further languages at this time. Support for the translation of articles into a specific language will now only be considered if there are localization files present in the game. The reasoning for this is that the workload for translators who do not have support from the [http://translation.steampowered.com/ Steam Translation Server] (in the form of word lists, nouns, etc, and proper discussion channels) is significantly higher. The amount of active translators is also less, meaning pages can quickly become out of date. |
− | : | + | :Please do not make requests to moderators or on the talk page regarding requests, our stance at this time is not changing. |
− | {| class = "wikitable grid" style = "margin-top: 1em;" | + | {| class="wikitable grid" style="margin-top:1em;" |
− | | - | + | |- |
− | ! class = " | + | ! class="header" | ISO639-1 code |
− | ! class = " | + | ! class="header" | Name in English |
− | | - | + | |- |
− | | & ndash; || | + | | – || English |
− | | - | + | |- |
− | | ar || | + | | ar || Arabic |
− | | - | + | |- |
− | | cs || | + | | cs || Czech |
− | | - | + | |- |
− | | da || | + | | da || Danish |
− | | - | + | |- |
− | | de || | + | | de || German |
− | | - | + | |- |
− | | es || | + | | es || Spanish |
− | | - | + | |- |
− | | fi || | + | | fi || Finnish |
− | | - | + | |- |
− | | fr || | + | | fr || French |
− | | - | + | |- |
− | | hu || | + | | hu || Hungarian |
− | | - | + | |- |
− | | | + | | it || Italian |
− | | - | + | |- |
− | | ja || | + | | ja || Japanese |
− | | - | + | |- |
− | | ko || | + | | ko || Korean |
− | | - | + | |- |
− | | nl || | + | | nl || Dutch |
− | | - | + | |- |
− | | | + | | no || Norwegian |
− | | - | + | |- |
− | | pl || | + | | pl || Polish |
− | | - | + | |- |
− | | pt || | + | | pt || Portuguese |
− | | - | + | |- |
− | | pt-br || | + | | pt-br || Portuguese (Brazil) |
− | | - | + | |- |
− | | ro || | + | | ro || Romanian |
− | | - | + | |- |
− | | ru || | + | | ru || Russian |
− | | - | + | |- |
− | | sv || | + | | sv || Swedish |
− | | - | + | |- |
− | | tr || | + | | tr || Turkish |
− | | - | + | |- |
− | | zh-hans || | + | | zh-hans || Chinese (Simplified) |
− | | - | + | |- |
− | | zh-hant || | + | | zh-hant || Chinese (Traditional) |
− | | - | + | |- |
|} | |} | ||
− | [[ | + | [[Category:Help]] |
− | [[ | + | [[Category:Team Fortress Wiki translation| ]] |
Revision as of 15:28, 22 May 2019
|
Team Fortress Wiki is capable of handling multilingual content and providing the reader a user interface in their preferred language. Multilingual editors are encouraged to translate and maintain articles in as many different languages as possible to reach the whole TF2 global community. Maintaining up to date translated articles is very important and it should be noted that it is preferential to have an up to date English article, rather than an out of date translated one.
Contents
How to translate a page
Follow these guidelines to start translating an article.
- Check that your language is supported (see List of supported languages below). We support most languages that have official in-game translations.
- Go to the English version of the article's page and click "Edit this page". Select everything in the box and copy it.
- Navigate to the new language by adding "/LANGUAGE" to the end of the article where LANGUAGE is replaced with the ISO code of the language you wish to translate to, found Here
- Paste the code of the English page to the new one.
- The French version of the article "Hats" would be Hats/fr, not Chapeaux, Hats/Chapeaux or Chapeaux/fr
- Add the template
{{Trans}}
to the top of the page. All such incomplete translations will be in the appropriate category. - Use
{{DISPLAYTITLE:abcxyz}}
to translate the page's title.- For example:
{{DISPLAYTITLE:Handlung}}
would show the title "Handlung" while keeping the real article title as "Storyline/de". - The display title can also be set by the infobox (see below). Because of this, articles about cosmetic items and weapons should not use this template to allow dynamic name changes from the dictionary.
- For example:
- Change the categories at the bottom of the page.
- For example:
[[Category:Lists|Weapons]]
becomes[[Category:Lists/fr|Weapons]]
. Do this for all categories at the bottom of the page.
- For example:
- You can now translate the rest of the article. Note that some text is stored in other pages (called "templates"). To translate these you will have to edit them individually.
- Whenever possible, make use of localization files in order to use correct names and descriptions.
Translation community
Each language has its own main discussion page at Team Fortress Wiki:Translation progress. You can also find statistics about your language's translation effort here.
Please also join the TF Wiki Translators Steam Group and watch the translators' noticeboard (click the 'watch' tab at the top). This will ensure you stay on top of any changes or announcements.
Multilingual guidelines
- English is the main reference language, and all root pages should be named and written in English.
- Other languages should be placed in an appropriately named sub-page of the English version.
- Language subpages should use the appropriate ISO 639 code (as listed below)
- With few exceptions, pages in the
Help, Team Fortress Wiki, Mediawiki
namespaces should not be translated. These pages are primarily aimed to be read by Wiki editors, and all Wiki editors should all be capable of reading English. As such, it is not very useful to translate these pages and can cause out-of-date guidelines when compared to the authoritative (English) version. Exceptions include language-specific translation guidelines and problematic guidelines repeatedly ignored by non-English-reading editors.- Disambiguation pages do not need to be translated unless they refer to common words, e.g. Shoes.
- If a translated version of a page exists but an English version does not, then please create a stub article for the English version as this aids navigation.
- The use of
{{Languages}}
at the bottom of articles is now discouraged, as language links appear in the sidebar. - While in the process of translating articles, using
{{Trans}}
is encouraged to display to other editors that the article is a work in progress. - Pages that are out of date or need updating should be tagged with
{{update trans}}
. Pages with this tag appear in Category:Translations needing updating, sorted by language. - Please do not sign articles using the 4 tildes (
~~~~
). The list of people who contributed to the article is always available in the history tab, and it would otherwise clutter the page.
Automated translation tools
- Note: please report any pages that consist of entirely machine-translated text (or any users that appear to repeatedly use these tools) to the translators' noticeboard.
On-wiki communication
- Talk pages
- It is vital that all discussion based on specific users and articles is in English. This is especially important when discussing the quality or accuracy of any article or translator.
- Edit summaries
- All edit summaries should be written in English where practical.
These requirements allow staff and fellow editors to keep up to date with every aspect of translation.
Articles
- Displaying a different title
- Displaying a title in a different language is possible with the use of the magic word
{{DISPLAYTITLE:}}
. - For example, using
{{DISPLAYTITLE:Example}}
will display the article name as Example.
- Displaying a title in a different language is possible with the use of the magic word
- Templates
- Templates use parameters with values to display text. The style is
| parameter = text
. Translating the text is almost always required, but the parameter should never be translated. {{Item infobox}}
needs a few lines to stay in English for it to work properly. If a parameter is listed below, please do not translate the text associated with it:
- Templates use parameters with values to display text. The style is
type, game, slot, trade, gift, craft, paint, rename, quality
- See Template:Item infobox for further help.
- Links
- You can link to translated articles and display different text for the links like this:
- If using external links that are in English, you should also use the template
{{lang icon}}
directly after the link to indicate the language of the external link.Google
on Soldier/fr should look like[http://www.google.com/ Google] {{lang icon|en}}
, which will generate:
- Google (English)
{{Main}}
and{{See also}}
– When using these templates you can display a different title using the parameterl1
(lowercase L1):
{{Main|Hats/fr|l1=Chapeaux}}
generates- Main article: Chapeaux
{{Main|Hats/fr|l1=Chapeaux|Miscellaneous items/fr|l2=Objets divers}}
generates- Main articles: Chapeaux and Objets divers
- Note: To change the "Main article:" text, see the individual template pages for
{{main}}
and{{see also}}
as they use translation switching.
- Categories
- Language pages should be kept in separate categories.
- For example on Wrench/fr, if you find
[[Category:Melee weapons]]
at the bottom of the page, change it to[[Category:Melee weapons/fr]]
.
- Redirects
- You can create as many language redirects as are needed, as long as they are tagged properly with
{{R lang}}
. See example:- Дробовик redirecting to Shotgun/ru will have the following text on the page 'Дробовик':
#REDIRECT [[Shotgun/ru]] {{R lang|ru}}
- Note: always remember to add
{{R lang|xx}}
(this helps to find these redirects later, as there can be hundreds of them)
- You can create as many language redirects as are needed, as long as they are tagged properly with
- Disambiguation pages
- Disambiguation pages (i.e. pages that list articles with similar names for convenience) that are specific to one language should not be created. Root pages should always be in English, and much of the wiki page structure relies on this. Language-specific disambiguation pages are too difficult to keep track of.
- Quotations
- The quotation text has to be translated.
- If your language is one of the few having translated voice lines (German, Spanish, French and Russian), you can check if the sound is localized by adding your language code to the sound (e.g.
Demo trade 04.wav
becomesDemo trade 04 de.wav
) and using "Show preview".- If the sound exists, listen to it and add the translated text.
- If not, translate the quotation on your own, leave the English voice line and add the
en-sound=yes
parameter to the template.
Templates
The majority of templates should use translation switching, with the exception of some navigational boxes. Previously it was necessary to create a localized version of a template, e.g. Template:Hat infobox/ru. Now localized text is stored in one template, where text for all languages is stored. Please see Help:Translation switching for further information.
List of supported languages
Team Fortress Wiki supports language translation of articles into 22 languages, the majority of which have localization files for TF2.
- Note: there are no plans to add support for any further languages at this time. Support for the translation of articles into a specific language will now only be considered if there are localization files present in the game. The reasoning for this is that the workload for translators who do not have support from the Steam Translation Server (in the form of word lists, nouns, etc, and proper discussion channels) is significantly higher. The amount of active translators is also less, meaning pages can quickly become out of date.
- Please do not make requests to moderators or on the talk page regarding requests, our stance at this time is not changing.
ISO639-1 code | Name in English |
---|---|
– | English |
ar | Arabic |
cs | Czech |
da | Danish |
de | German |
es | Spanish |
fi | Finnish |
fr | French |
hu | Hungarian |
it | Italian |
ja | Japanese |
ko | Korean |
nl | Dutch |
no | Norwegian |
pl | Polish |
pt | Portuguese |
pt-br | Portuguese (Brazil) |
ro | Romanian |
ru | Russian |
sv | Swedish |
tr | Turkish |
zh-hans | Chinese (Simplified) |
zh-hant | Chinese (Traditional) |