Difference between revisions of "Project:Languages"

From Second Life Wiki
Jump to navigation Jump to search
(Updated to use Template:Multi-lang for page translation.)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Multi-lang}}
{{Multi-lang}}


= Language Guidelines for SL wiki =
{|
|{{Help/Box|Note:|Project:Languages was recently revised. Please become familiar with the new suggestions and discuss them at [[{{TALKPAGENAME}}|the related discussion page]].}}


This page discusses the guidelines on natural language uses and content translation of SL wiki (http://wiki.secondlife.com).  Translation of SL Viewer UI is discussed on a separate page: [[How to Localize Your World]].  Information on a resident-run activity called <b>I18N Project</b> is available on [[Project:I18n]].


At this moment, the contents on this page is just a set of proposals.  Please feel free to have discussions on the [[Project talk:Languages|associated discussion page]] or simply modify this page.  It is expected, however, that in a future entire contents of SL wiki follow the revised guidelies on this page.  If you are changing existing practices, someone needs to rewrite existing pages to follow the new rule.
<div id="box">
== Language Guidelines for SL Wiki ==
<div style="padding: 0.5em">


So, if you have something to say on this issue, please start soon!
This page discusses the guidelines on natural language uses and content translation of SL Wiki (http://wiki.secondlife.com).  Translation of SL Viewer UI is discussed on a separate page: [[How to Localize Your World]].  Information on a Resident-run activity called <b>i18n Project</b> is available on [[Project:i18n]].


= General =
Currently, the contents on this page are just a set of proposals. Please feel free to have discussions on the [[{{TALKPAGENAME}}|associated discussion page]] or simply modify this page. It is expected, however, that eventually the entire contents of the SL Wiki will follow the revised guidelines on this page.  If you are changing existing practices, someone will need to rewrite existing pages to follow your new rule.


SL wiki generally follows the idea and mechanisms of [http://www.mediawiki.org/wiki/Project:Language_policy MediaWiki site's language policy on Help pages], as opposed to that for [http://www.wikipedia.org Wikipedia]'s language versions.
'''So, if you have something to say on this issue, please start soon!'''
</div></div>
|width="30%x"|__TOC__
|}
 
<div id="box">
== Video Tutorial ==
<div style="padding: 0.5em">
<div align="center"><videoflash>EOHgnwaONVg</videoflash></div>
</div></div>
 
<div id="box">
== Creating pages ==
<div style="padding: 0.5em">
 
=== Primary Language ===
 
English is the primary language of SL Wiki.
 
English is chosen because it is the most common language in international communication today.  It is not to give privilege to native-English speakers.  So, even if you are very good at English, please assume that readers are not fluent in English and use plain simple wording.
 
You may use foreign words or phrases in English sentences if it is needed.  However, please take care to avoid uses of Latin, Greek, or French, unless it is a commonly understood [http://en.wikipedia.org/wiki/Anglicisation Anglicized phrase] or [http://en.wikipedia.org/wiki/Loanword loanword].


= Creating pages =
=== Page Titles ===


== Primary Language ==
The title of a page in the SL Wiki should be in the same language as the article itself.


English is the primary language of SL wiki.
In case article names about the same subject collide (e.g. almost all [[LSL Portal]] related articles like [[llSay]]), the base page should be in English.


English is chosen because it is the most common language in international communication today.  It is not to give privilege to native English speakers.  So, even if you are very good at English, please assume that readers are not fluent in English and use plain simple wording.
=== Non-English Contents ===


You may use foreign words or phrases in English sentences if it is needed. However, please avoid gentility uses of Latin, Greek or French.
If you want to create a new page in a non-English language, please consider writing it in two languages; one in English and another in your non-English language, connecting both via [[Template:Multi-lang]]. See the paragraphs below for a more detailed view of the procedure. The English page doesn't need to be complete in this case. Just a brief summary should be fine.


== Page titles ==
Even if you are not willing or lack proper skills to write the page in English, it is recommended to create an almost empty ''English'' page that only says something like "The content of this page is not available in English currently.", and write your non-English page as a ''translation''.


The title of a page in SL wiki should be based on English.
This way, other residents can eventually translate your contents into English without changing entire page structure.
</div></div>


Although MediaWiki is powerful enough to allow non-English titles (i.e., use of any Unicode characters), SL wiki will not use the feature.
<div id="box">
== Translation ==
<div style="padding: 0.5em">


== Non English contents ==
Linguists are invited to translate SL Wiki pages into other languages.


If you want to create a new page in non-English language, please consider to write it in two languages; one is English and another in your non-English language, making English page a primary page and the non-English page a [[#Translation|translation]].  The English page need not be complete in this case.  Just a brief summary is OK.
=== Page Titles ===


Even if you are not willing or lack enough skills to write the page in English, it is recommended to create an almost empty ''English'' page that only says something like "The content of this page is not available in English for the moment", and write your non-English page as a ''translation''.
Translated content is written in its own page.


This way, other residents can eventually translate your contents into English without changing entire page structures.
The title of the translated page should be a translation of its corresponding English page title. The non-English article should contain
<nowiki>{{multi-lang|1=</nowiki><font color="blue">ENGLISH_ARTICLENAME</font><nowiki>|2=/</nowiki><font color="red">LANGUAGE_CODE</font><nowiki>}}</nowiki>
on top of the page.<br>
The English page should have a subpage located at <span style="white-space:nowrap;"><font color="blue">ENGLISH_ARTICLENAME</font>/<font color="red">LANGUAGE_CODE</font></span> with
<nowiki>#REDIRECT [[</nowiki><font color="blue">NON_ENGLISH_ARTICLENAME</font><nowiki>]]</nowiki>
as its only content.


= Translation =
'''Note:'''<br>
If the parent article contains a <nowiki>{{</nowiki>[[Template:help|help]]}} template rather than a <nowiki>{{</nowiki>[[Template:multi-lang|multi-lang]]}} template, use the following syntax:
<nowiki>{{help</nowiki>/<font color="red">LANGUAGE_CODE</font>|Parent=<font color="blue">ENGLISH_ARTICLENAME</font>}}


It is welcome to translate pages on SL wiki into other languages.
Following this suggestion might lead into article name collisions. There are two possible kinds of article-name collisions which are handled seperately.


== Page titles ==
==== Collision: Identical Title - Same Topic ====
In case two articles of the same topic collide, the English article will be placed at base page and the non-English article will be placed at a subpage with an appropriate language code. For example:
* English page: [[llSay]]
* French page: [[llSay/fr]]
* Japanese page: [[llSay/ja]]
etc.


Translated contents are written in its own page.
==== Collision: Identical Title - Different Topic ====
Consider the following scenario:


The title of the translated page should be its corresponding English page title plus a code for a language, separated by a slash (/).  For example, Dutch translation of the [[Main Page]] is titled [[Main Page/nl]], as opposed to '''Hoofdpagina''' or '''Hoofdpagina/nl''', where '''nl''' is the language code for Dutch.  See [[#Language codes|Language code]] below for possible codes.
* An article about the sim "Lune" would be located at '''/wiki/Lune'''.
* An article about the natural satellite, the "Moon" would be located at '''/wiki/Moon'''


Language code is all in lower case.
Should these articles be translated into french, there is a collision with "Moon" being "Lune".


== Languages Template ==
The current proposal is that a french translation of [[Lune]] (the sim) be located at <b>Lune/fr</b>, and a french translation of '''Moon''' (the natural satellite) be located at '''/wiki/Lune_(satellite_naturel)'''{{footnote|which means: '''Moon (natural satellite)'''}} (with an automatic redirection from '''/wiki/Moon/fr''').


Translated pages should be tagged with the [[Template:Multi-lang|<nowiki>{{Multi-lang}}</nowiki> template]]. English pages that have one or more translation should also.  The <nowiki>{{Multi-lang}}</nowiki> template should be put near the top of the page and kept at the same location in translations of the same page.
The page '''Lune''' (the sim) should contain a disambiguation on top, containing "Si vous recherchez des informations sur le satellite naturel, consultez la page [[Lune (satellite naturel)]]".{{footnote|Translation: "In case you were looking for the natural satellite, please browse to [[Lune (satellite naturel)]]"}}.
 
==== Categories ====


Consistent use of <nowiki>{{Multi-lang}}</nowiki> template helps readers to find their preferred language versions of pages.
Categories are treated like articles. Instead of [[:Category:LSL Money/fr]] we got [[:Category:LSL Argent]].


Note that the [[:Template:Multi-lang]] is also available as another name [[:Template:Languages]] for a historical reason.
=== Languages Template ===


== Links ==
Translated pages should be tagged with the [[Template:Multi-lang|<nowiki>{{Multi-lang}}</nowiki> template]].  English pages that have one or more translation should also.  The <nowiki>{{Multi-lang}}</nowiki> template should be put near the top of the page and kept at the same location in translations of the same page.


If you are linking to another page from a non-English page, and the target page has a translation of the same language, it's better to link to the translated page.  Such links are better to have translated anchor.
Consistent use of the <nowiki>{{Multi-lang}}</nowiki> template helps readers to find their preferred-language versions of pages.


For example, if you are writing a French page, and want to put a link to the French translated version of the page titled '''Voice''', It's better to write the link as <code><nowiki>[[Voice/fr|voix]]</nowiki></code> then to write <code><nowiki>[[Voice/fr]]</nowiki></code>.
Note that the [[:Template:Multi-lang]] is also available as another name [[:Template:Languages]] for a historical reason.


Yes, this is somewhat inconveninent side-effect of the above guideline, that is, page title is always English based.  (Express your opinions on the [[Project talk:Languages|discussion]] page.)
=== Links ===


If the target page has no translation to the same language, link to the primary (English) page.
If the target page has no translation to the same language, link to the primary (English) page.


== Synchronization ==
=== Synchronization ===


Try to synchronize the contents of the translated page with the corresponding English page, though you, as a translator, have no duty to track the changes to the original page.  Any residents who noticed the change are encouraged to update the translation.
Try to synchronize the content of the translated page with the corresponding English page, though you, as a translator, have no duty to track the changes to the original page.  Any Resident who notices the change is encouraged to update the translation.


Adding new info only on the translated page is hence dangerous, because some other resident may remove the addition to ''synchronize'' the contents.  You need some clear indication if you add some.
Adding new info only on the translated page is hence dangerous, because some other Resident may remove the addition to ''synchronize'' the content.  You need some clear indication if you add something only to the translation and not the primary article.
</div></div>


= Language Codes =
<div id="box">
== Language Codes ==
<div style="padding: 0.5em">


SL wiki uses both ISO 639-1 (alpha-2) codes and ISO 639-3 codes for language identification.
SL Wiki uses both ISO 639-1 (alpha-2) codes and ISO 639-3 codes for language identification.


When both are applecable, 639-1 alpha-2 code has a precedence.
When both are applicable, 639-1 alpha-2 code has precedence.


(See [[Project talk:Languages|discussion page]] for this point.)
(See [[{{TALKPAGENAME}}|discussion page]] for this point.)


== List of language codes ==
=== List of Language Codes ===


As of this writing, the following language codes are used in SL wiki.  The list will expand time-to-time.
As of this writing, the following language codes are used in SL Wiki.  The list is expected to expand over time.
 
<div align="center"><onlyinclude>
{| border="1" cellspacing="0"
{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff"
!Code!!Language
| style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Code'''
| style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Language'''
| style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Language (native)'''
|-
|da||Danish||Dansk
|-
|de||German||Deutsch
|-
|el||Greek||ελληνικά
|-
|en||English||English
|-
|es||Spanish||Español
|-
|fr||French||Français
|-
|he||Hebrew||עברית
|-
|it||Italian||Italiano
|-
|-
|de||German
|ko||Korean||한국어
|-
|-
|en||English
|ja||Japanese||日本語
|-
|-
|es||Spanish
|nl||Dutch||Nederlands
|-
|-
|fr||French
|no||Norwegian||Norsk
|-
|-
|it||Italian
|pl||Polish||Polski
|-
|-
|ja||Japanese
|pt||Portuguese||Português
|-
|-
|nl||Dutch
|ru||Russian||Русский
|-
|-
|pl||Polish
|sv||Swedish||Svenska
|-
|-
|pt||Portuguese
|zh-Hans||Chinese (Simplified)||中文(简体) <!-- Refers to the script/characters, see [[Template_talk:Multi-lang#Chinese]] -->
|-
|-
|zh||Chinese
|zh-Hant||Chinese (Traditional)||中文(繁體) <!-- Refers to the script/characters, see [[Template_talk:Multi-lang#Chinese]] -->
|}
|}</onlyinclude></div>
 
Note that an English page title will not have a language code attached, so there should not be a page of the title "Something/en".  However, the code '''en''' for English can and will appear at various locations.
</div></div>
 
<div id="box">


Note that an English page title has no language code attached, so there should not be a page of the title "Something/en".  However, the code '''en''' for English appears on various locations.
== Footnotes ==
<div style="padding: 0.5em">
{{footnotes}}
</div></div>
[[Category:Localization]]

Latest revision as of 10:23, 15 February 2010

Note:

Project:Languages was recently revised. Please become familiar with the new suggestions and discuss them at the related discussion page.


Language Guidelines for SL Wiki

This page discusses the guidelines on natural language uses and content translation of SL Wiki (http://wiki.secondlife.com). Translation of SL Viewer UI is discussed on a separate page: How to Localize Your World. Information on a Resident-run activity called i18n Project is available on Project:i18n.

Currently, the contents on this page are just a set of proposals. Please feel free to have discussions on the associated discussion page or simply modify this page. It is expected, however, that eventually the entire contents of the SL Wiki will follow the revised guidelines on this page. If you are changing existing practices, someone will need to rewrite existing pages to follow your new rule.

So, if you have something to say on this issue, please start soon!

Video Tutorial

<videoflash>EOHgnwaONVg</videoflash>

Creating pages

Primary Language

English is the primary language of SL Wiki.

English is chosen because it is the most common language in international communication today. It is not to give privilege to native-English speakers. So, even if you are very good at English, please assume that readers are not fluent in English and use plain simple wording.

You may use foreign words or phrases in English sentences if it is needed. However, please take care to avoid uses of Latin, Greek, or French, unless it is a commonly understood Anglicized phrase or loanword.

Page Titles

The title of a page in the SL Wiki should be in the same language as the article itself.

In case article names about the same subject collide (e.g. almost all LSL Portal related articles like llSay), the base page should be in English.

Non-English Contents

If you want to create a new page in a non-English language, please consider writing it in two languages; one in English and another in your non-English language, connecting both via Template:Multi-lang. See the paragraphs below for a more detailed view of the procedure. The English page doesn't need to be complete in this case. Just a brief summary should be fine.

Even if you are not willing or lack proper skills to write the page in English, it is recommended to create an almost empty English page that only says something like "The content of this page is not available in English currently.", and write your non-English page as a translation.

This way, other residents can eventually translate your contents into English without changing entire page structure.

Translation

Linguists are invited to translate SL Wiki pages into other languages.

Page Titles

Translated content is written in its own page.

The title of the translated page should be a translation of its corresponding English page title. The non-English article should contain

{{multi-lang|1=ENGLISH_ARTICLENAME|2=/LANGUAGE_CODE}}

on top of the page.
The English page should have a subpage located at ENGLISH_ARTICLENAME/LANGUAGE_CODE with

#REDIRECT [[NON_ENGLISH_ARTICLENAME]]

as its only content.

Note:
If the parent article contains a {{help}} template rather than a {{multi-lang}} template, use the following syntax:

{{help/LANGUAGE_CODE|Parent=ENGLISH_ARTICLENAME}}

Following this suggestion might lead into article name collisions. There are two possible kinds of article-name collisions which are handled seperately.

Collision: Identical Title - Same Topic

In case two articles of the same topic collide, the English article will be placed at base page and the non-English article will be placed at a subpage with an appropriate language code. For example:

etc.

Collision: Identical Title - Different Topic

Consider the following scenario:

  • An article about the sim "Lune" would be located at /wiki/Lune.
  • An article about the natural satellite, the "Moon" would be located at /wiki/Moon

Should these articles be translated into french, there is a collision with "Moon" being "Lune".

The current proposal is that a french translation of Lune (the sim) be located at Lune/fr, and a french translation of Moon (the natural satellite) be located at /wiki/Lune_(satellite_naturel)[1] (with an automatic redirection from /wiki/Moon/fr).

The page Lune (the sim) should contain a disambiguation on top, containing "Si vous recherchez des informations sur le satellite naturel, consultez la page Lune (satellite naturel)".[2].

Categories

Categories are treated like articles. Instead of Category:LSL Money/fr we got Category:LSL Argent.

Languages Template

Translated pages should be tagged with the {{Multi-lang}} template. English pages that have one or more translation should also. The {{Multi-lang}} template should be put near the top of the page and kept at the same location in translations of the same page.

Consistent use of the {{Multi-lang}} template helps readers to find their preferred-language versions of pages.

Note that the Template:Multi-lang is also available as another name Template:Languages for a historical reason.

Links

If the target page has no translation to the same language, link to the primary (English) page.

Synchronization

Try to synchronize the content of the translated page with the corresponding English page, though you, as a translator, have no duty to track the changes to the original page. Any Resident who notices the change is encouraged to update the translation.

Adding new info only on the translated page is hence dangerous, because some other Resident may remove the addition to synchronize the content. You need some clear indication if you add something only to the translation and not the primary article.

Language Codes

SL Wiki uses both ISO 639-1 (alpha-2) codes and ISO 639-3 codes for language identification.

When both are applicable, 639-1 alpha-2 code has precedence.

(See discussion page for this point.)

List of Language Codes

As of this writing, the following language codes are used in SL Wiki. The list is expected to expand over time.

Code Language Language (native)
da Danish Dansk
de German Deutsch
el Greek ελληνικά
en English English
es Spanish Español
fr French Français
he Hebrew עברית
it Italian Italiano
ko Korean 한국어
ja Japanese 日本語
nl Dutch Nederlands
no Norwegian Norsk
pl Polish Polski
pt Portuguese Português
ru Russian Русский
sv Swedish Svenska
zh-Hans Chinese (Simplified) 中文(简体)
zh-Hant Chinese (Traditional) 中文(繁體)

Note that an English page title will not have a language code attached, so there should not be a page of the title "Something/en". However, the code en for English can and will appear at various locations.

Footnotes

  1. ^ which means: Moon (natural satellite)
  2. ^ Translation: "In case you were looking for the natural satellite, please browse to Lune (satellite naturel)"