Help:Adding a Language - Revision history

DesignerThan at 17:27, 2 October 2023

2023-10-02T17:27:27Z

W126jep at 02:41, 29 July 2022

2022-07-29T02:41:02Z

W126jep: + info about starting translation with IA Connection Honors

2022-02-03T19:13:36Z

+ info about starting translation with IA Connection Honors

W126jep: /* Localization:other pages */

2022-02-03T13:39:21Z

Localization:other pages

DesignerThan at 01:54, 3 February 2022

2022-02-03T01:54:54Z

DesignerThan at 23:52, 2 February 2022

2022-02-02T23:52:40Z

DesignerThan at 15:10, 10 January 2022

2022-01-10T15:10:26Z

DesignerThan at 11:49, 6 September 2021

2021-09-06T11:49:09Z

DesignerThan: /* MediaWiki Messages */

2021-09-05T21:39:29Z

MediaWiki Messages

DesignerThan at 21:42, 2 September 2021

2021-09-02T21:42:39Z

@@ Line 108: / Line 108: @@
 * Admin Links
 ** [[MediaWiki:Adminlinks custom project]]
-** [[MediaWiki:Adminlinks custom item addlang]]
+** [[MediaWiki:Adminlinks custom item dashboard]]
 ==Summary==
 So basically, to add a new language to the wiki, request that it be added to [[:Template:GetLangSuffix]], and then translate [[:Localization:All]] to the new language. Once that's done, you can start translating regular pages.

@@ Line 2: / Line 2: @@
 ==Introduction==
-This wiki uses the Translate extension which is described at [[:Help:Translation]].  You should read that first.  This page describes some of the things we did to make translation easier.
+This wiki uses the Translate extension which is described at [[:Help:Translation]]. You should read that first. This page describes some of the things we did to make translation easier.
 ==Steps==
 ===GetLangSuffix===
-The first thing to do when adding a new language to the wiki is to edit [[:Template:GetLangSuffix]].  The template is protected though, so you may need to leave a request in the [[:Pathfinder Wiki:Community portal|Discussion]] page.  Administrators patrol this wiki daily, so one of us will see the request soon after you leave it.
+The first thing to do when adding a new language to the wiki is to edit [[:Template:GetLangSuffix]]. The template is protected though, so you may need to leave a request in the [[:Pathfinder Wiki:Community portal|Discussion]] page. Administrators patrol this wiki daily, so one of us will see the request soon after you leave it.
-The GetLangSuffix template returns text like ''/es'' or ''/de'' depending on where it is invoked from.  It basically extracts the last element of the page name, runs it through a #switch statement, and returns a slash plus the language code if it recognizes the last element as a language code.  If it is invoked from an English page, or from a page that it doesn't recognize as a translated page, it will return an empty string.  Whatever it returns - an empty string, or a language code - can be tacked to the end of any page title to refer to the translated version of that page.  This technique is used ''extensively'' throughout the wiki.
+The GetLangSuffix template returns text like ''/es'' or ''/de'' depending on where it is invoked from. It basically extracts the last element of the page name, runs it through a #switch statement, and returns a slash plus the language code if it recognizes the last element as a language code. If it is invoked from an English page, or from a page that it doesn't recognize as a translated page, it will return an empty string. Whatever it returns - an empty string, or a language code - can be tacked to the end of any page title to refer to the translated version of that page. This technique is used ''extensively'' throughout the wiki.
 ===Localization:All===
-The next step is to go to the [[:Localization:All]] page, and create a translation for the new language.  This page is a list of words and phrases that we use in templates so that we don't have to translate the templates.  Templates can be very complex, and they are difficult to get right.  Most templates will display text to the user by having that text in the localization page, and then using the [[:Template:Localize]] template which will fetch the translated phrase based on the results returned by <nowiki>{{</nowiki>GetLangSuffix}}.  For example:
+The next step is to go to the [[:Localization:All]] page and create a translation for the new language. This page is a list of words and phrases that we use in templates so that we don't have to translate the templates. Templates can be very complex, and they are difficult to get right. Most templates will display text to the user by having that text in the localization page, and then using the [[:Template:Localize]] template which will fetch the translated phrase based on the results returned by <nowiki>{{</nowiki>GetLangSuffix}}. For example:
 <nowiki>{{</nowiki>Localize|Honor}}
@@ Line 18: / Line 18: @@
 :{{Localize|Honor}}
-Which is admittedly not that impressive - except that if you call if from a page ending in /es, it will return "Especialidad" which is the Spanish translation of the word "Honor".  That makes it quite magical.  It's important to note that the argument passed to the Localize template be in English, and that it have the correct unit name.  Spelling and case are important.  What this means is that you should not expect
+Which is admittedly not that impressive - except that if you call if from a page ending in /es, it will return "Especialidad" which is the Spanish translation of the word "Honor". That makes it quite magical. It's important to note that the argument passed to the Localize template be in English, and that it have the correct unit name. Spelling and case are important. What this means is that you should not expect
 <nowiki>{{</nowiki>Localize|Especialidad}}
-to work.  The name of the phrase is "Honor" and it doesn't matter what language you invoke it from.
+to work. The name of the phrase is "Honor" and it doesn't matter what language you invoke it from.
-The phrases in [[:Localization:All]] are used to display the names of the tabs, the names of the hierarchical names of the SDA Church organization (i.e., General Conference, North American Division, etc), the honor categories, the names of the Master Awards, and basically, anything we want to display in a template.  If a user is going to see it, it should be in [[:Localization:All]].
+The phrases in [[:Localization:All]] are used to display the names of the tabs, the names of the hierarchical names of the SDA Church organization (i.e., General Conference, North American Division, etc), the honor categories, the names of the Master Awards, and basically, anything we want to display in a template. If a user is going to see it, it should be in [[:Localization:All]].
 Each entry in [[:Localization:All]] is saved into a table of the database by calling a template. Those templates have two main parameter's. One is the '''id''', that is used to get the translated text with the [[Template:Localize]]. This parameter shouldn't be touched unless you know what you are doing. To find out where a text get's used on the wiki you can use [[Help:Debug Localization|this]] page. The second parameter is '''text''', that is where the translation goes.
 ===Localization:''other pages''===
-The {{OpenCurly}}Localize}} template can take an optional second argument to specify an alternate localization page containing the localization (the first argument is the term to localize).  This allows us to separate localization terms into more than one page so that the localization replacements can run faster and have a little more organization.  The template is called thusly:
+The {{OpenCurly}}Localize}} template can take an optional second argument to specify an alternate localization page containing the localization (the first argument is the term to localize). This allows us to separate localization terms into more than one page so that the localization replacements can run faster and have a little more organization. The template is called thusly:
 {{OpenCurly}}Localize|Lorem ipsum|page=''alt_page''}} which would search for term in [[Localization:alt_page]] (which doesn't exist - it's just an example).
-If the second argument is not specified, the template defaults to using [[Localization:All]].  Here is a list of alternate Localization pages which also need to be translated:
+If the second argument is not specified, the template defaults to using [[Localization:All]]. Here is a list of alternate Localization pages which also need to be translated:
 * [[Localization:Authorities]]
@@ Line 58: / Line 58: @@
 ==Choose a default Bible version==
-[[:Template:Bible link]] takes a Bible verse as a parameter and converts that to a link to [http://biblegateway.com biblegateway.com].  This template cannot use [[:Localization:All]] to pass in the Bible version because of the additional wiki markup that is added to everything the <nowiki>{{Localize}}</nowiki> template must return.  This extra text is ignored by the wiki rendering software, but we need to use it to specify which version of the Bible is to be used, and the text gets added to a URL.  URLs don't ignore wiki markup, so this operation fails.  So we had to take a different approach.
+[[:Template:Bible link]] takes a Bible verse as a parameter and converts that to a link to [http://biblegateway.com biblegateway.com]. This template cannot use [[:Localization:All]] to pass in the Bible version because of the additional wiki markup that is added to everything the <nowiki>{{Localize}}</nowiki> template must return. This extra text is ignored by the wiki rendering software, but we need to use it to specify which version of the Bible is to be used, and the text gets added to a URL. URLs don't ignore wiki markup, so this operation fails. So we had to take a different approach.
-You will need to first figure out what version string [biblegateway.com] needs to query a language-specific Bible translation.  In English, this string is NKJV.  Once you know what string you need to use, create a file in <nowiki>[[</nowiki>Localization:Default Bible verse/''language code'']].  The only thing that should be placed in the file is the string biblegateway.com needs.  Do not use the Translation extension to create this file.
+You will need to first figure out what version string [biblegateway.com] needs to query a language-specific Bible translation. In English, this string is NKJV. Once you know what string you need to use, create a file in <nowiki>[[</nowiki>Localization:Default Bible verse/''language code'']]. The only thing that should be placed in the file is the string biblegateway.com needs. Do not use the Translation extension to create this file.
 ==Configure Wikipedia links==
-Most wikis support ''interwikis'' - which is an easy way to link to another wiki such as wikipedia.  On our wiki, we can link to a wikipedia article by adding <nowiki>[[</nowiki>W:Anax junius]] to an article.  It creates a link to the wikipedia article about [[w:Anax junius|Anax junius]].  But it will take you to the ''English'' wikipedia.  To make that work in another language, we have to translate [[Template:Localize wikipedia]] and change the ''w'' to something else.  In Spanish, the ''w'' becomes ''esw''.  It's usually just the language code plus a w.  We have several templates that automatically localize to the language of the invoking page, and some of those (such as [[Template:Species id]]) provide a link to the wikipedia article of the species (using its Latin name, so that should work in most languages).
+Most wikis support ''interwikis'' - which is an easy way to link to another wiki such as wikipedia. On our wiki, we can link to a wikipedia article by adding <nowiki>[[</nowiki>W:Anax junius]] to an article. It creates a link to the wikipedia article about [[w:Anax junius|Anax junius]]. But it will take you to the ''English'' wikipedia. To make that work in another language, we have to translate [[Template:Localize wikipedia]] and change the ''w'' to something else. In Spanish, the ''w'' becomes ''esw''. It's usually just the language code plus a w. We have several templates that automatically localize to the language of the invoking page, and some of those (such as [[Template:Species id]]) provide a link to the wikipedia article of the species (using its Latin name, so that should work in most languages).
 ==How to add/change a language specific logo==
@@ Line 90: / Line 90: @@
 ** [[MediaWiki:AY Honors]]
 ** [[MediaWiki:All Honors]]
-** [[MediaWiki:Arts, Crafts, and Hobbies]]
+** [[MediaWiki:Arts, Crafts and Hobbies]]
 ** [[MediaWiki:Health and Science]]
 ** [[MediaWiki:Household Arts]]
@@ Line 101: / Line 101: @@
 ** [[MediaWiki:Master Guide]]
 ** [[MediaWiki:Club Ministries]]
 * [[MediaWiki:Pagetitle]] - only if you want to change the displayed title in the browser tab's (for your language)
 * [[MediaWiki:Copyright]]
@@ Line 112: / Line 113: @@
 ==Summary==
-So basically, to add a new language to the wiki, request that it be added to [[:Template:GetLangSuffix]], and then translate [[:Localization:All]] to the new language.  Once that's done, you can start translating regular pages.
+So basically, to add a new language to the wiki, request that it be added to [[:Template:GetLangSuffix]], and then translate [[:Localization:All]] to the new language. Once that's done, you can start translating regular pages.

@@ Line 42: / Line 42: @@
 * [[Localization:Images]]
 * That's all so far. It's a short list, but we expect it to grow.
 ==Language Specific Graphics==

@@ Line 39: / Line 39: @@
 * [[Localization:Default Bible version]]
 * [[Localization:Honors]]
 * [[Localization:Images]]
 * That's all so far. It's a short list, but we expect it to grow.

@@ Line 26: / Line 26: @@
 The phrases in [[:Localization:All]] are used to display the names of the tabs, the names of the hierarchical names of the SDA Church organization (i.e., General Conference, North American Division, etc), the honor categories, the names of the Master Awards, and basically, anything we want to display in a template.  If a user is going to see it, it should be in [[:Localization:All]].
-Each entry in [[:Localization:All]] is tagged as a section so that it can be extracted as a unit.  We've already shown how to extract a unit from this file by using [[:Template:Localize]].  If we want to add new text to a template, we need to add it to this file, and then translate it (or request a translation) in all the supported languages.  Each unit is surrounded by section tags which is how they are identified by the Localize template.  Because these words and phrases are used so widely, editing it reserved for administrators, so if you need to add a unit, let us know. Inside the section tags are <nowiki><translate></nowiki> tags which identify which part of the entry needs to be translated.  But because both of these translate tags are actually displayed when they are included, the <nowiki><translate> and </translate> tags have to be individually wrapped in <nowiki><noinclude> and </noinclude></nowiki> tags.  It's ugly, but it works and it's powerful.
+Each entry in [[:Localization:All]] is saved into a table of the database by calling a template. Those templates have two main parameter's. One is the '''id''', that is used to get the translated text with the [[Template:Localize]]. This parameter shouldn't be touched unless you know what you are doing. To find out where a text get's used on the wiki you can use [[Help:Debug Localization|this]] page. The second parameter is '''text''', that is where the translation goes.
 ===Localization:''other pages''===

← Older revision		Revision as of 15:10, 10 January 2022
Line 1:		Line 1:
		+	<div style="margin-right:3em; float:left;">__TOC__</div>
		+
	==Introduction==		==Introduction==
	This wiki uses the Translate extension which is described at [[:Help:Translation]]. You should read that first. This page describes some of the things we did to make translation easier.		This wiki uses the Translate extension which is described at [[:Help:Translation]]. You should read that first. This page describes some of the things we did to make translation easier.

@@ Line 91: / Line 91: @@
 * [[MediaWiki:Copyrightwarning]]
 * [[MediaWiki:Copyrightwarning2]]
 ==Summary==
 So basically, to add a new language to the wiki, request that it be added to [[:Template:GetLangSuffix]], and then translate [[:Localization:All]] to the new language.  Once that's done, you can start translating regular pages.

@@ Line 68: / Line 68: @@
 For example: If you want to translate the Copyright message from English to German you open the original page which is [[MediaWiki:Copyright]]. Copy the content and then type the tile plus the language suffix into the search bar and hit enter. In the case of the example the search term would be '''MediaWiki:Copyright/de'''. Now you can paste the original text and start translating it. After you finished translation, delete the original text and safe.
-'''ATTENTION:''' These pages are only editable for administrators so get in contact with one of them. The easiest way is to join Discord, but also here [[Talk:Adding a Language]] is a good place to ask for help.
+'''ATTENTION:''' These pages are only editable for administrators so get in contact with one of them. The easiest way is to join Discord, but also [[Help talk:Adding a Language|here]] is a good place to ask for help.
 ==Summary==
 So basically, to add a new language to the wiki, request that it be added to [[:Template:GetLangSuffix]], and then translate [[:Localization:All]] to the new language.  Once that's done, you can start translating regular pages.