Difference between revisions of "Gramps:Language policy"

From Gramps
Jump to: navigation, search
m
Line 8: Line 8:
 
#Mark-up Templates. Templates for markup, eg pretty tables, boxes, should be written language independent, with if necessary a language parameter which is passed to content specific templates that can be translated.
 
#Mark-up Templates. Templates for markup, eg pretty tables, boxes, should be written language independent, with if necessary a language parameter which is passed to content specific templates that can be translated.
  
Note that Content templates can be translated, but do not include the <nowiki>{{languges|pagename}}</nowiki> template to the content of the template. Instead, add it to the noinclude section of the template:
+
Note that Content templates can be translated, but do not include the <nowiki>{{languges|pagename}}</nowiki> template to the content. Instead, add it to the noinclude section of the template: <pre><nowiki><noinclude>{{languages|pagename}}</noinclude></nowiki></pre>
<nowiki><noinclude>{{languages|pagename}}</noinclude></nowiki>
+
  
 
==How?==
 
==How?==
#If you want to translate page <nowiki>[[GRAMPS:Language policy]]</nowiki> in a language with language code ''zz'', you create a page <nowiki>[[GRAMPS:Language policy/zz]]</nowiki>. The root name af the article '''must''' be the '''english''' name. So e.g. <tt>Bonjour</tt> would be <tt>Goodday/fr</tt>
+
#If you want to translate page <nowiki>[[GRAMPS:Language policy]]</nowiki> in a language with language code ''zz'', you create a page <nowiki>[[GRAMPS:Language policy/zz]]</nowiki>. The root name af the article '''must''' be the '''english''' name. So e.g. <tt>Bonjour</tt> would be <tt>Goodday/fr</tt>. However you can use redirection to give French users a <tt>fr:Bonjour</tt> page
 
#Next, you add ''at the bottom of the page'' the template <nowiki>{{languages|GRAMPS:Language policy}}</nowiki>. This same template must be added to the root page as well as all translated pages.
 
#Next, you add ''at the bottom of the page'' the template <nowiki>{{languages|GRAMPS:Language policy}}</nowiki>. This same template must be added to the root page as well as all translated pages.
#In the case no english page exists for the page you want to make, '''first''' add an english page with content  
+
#In the case no english page exists for the page you want to make, '''first''' add an english page with content <pre><nowiki>{{stub}}</nowiki><nowiki>{{languages|pagename}}</nowiki></pre>
<nowiki>{{stub}}</nowiki>
+
#You can redirect people to a page with localized title. This is helpfull for searching pages in non-english, or for inclusion of the pages in [[Help:Categories]]. Eg, you want to translate <nowiki>[[GRAMPS:About]]</nowiki> in Dutch.
<nowiki>{{languages|pagename}}</nowiki>
+
## You make the page <nowiki>[[GRAMPS:About/nl]]</nowiki> with content: <pre>#REDIRECT [[nl:GRAMPS:Info]]</pre>
 +
## In the page <nowiki>[[GRAMPS:About]]</nowiki>, you add at the bottom  <pre>{{languages}}</pre>
 +
## You create the page [[nl:GRAMPS:Info]], with as content the translated English page, and at the bottom you call the languages script, with as first parameter the english root page, and second parameter the true dutch name: <pre>{{languages|GRAMPS:About|GRAMPS:Info}}</pre>
 +
## If you want to link to translated pages, you can use the standard wiki syntax: <nowiki>[[link here/nl|text]]</nowiki>, but  this is off course only possible if the ''nl'' page already exists. You can also use the following handy template: [[Template:Call_lang]], which works as <pre>{{call_lang|link here|nl|text}}</pre> If the required translation exists, it is returned, otherwise the english root page is returned
 +
 
  
 
==More Details==
 
==More Details==
 
For more details, see the documentation on [[Template:Languages]]
 
For more details, see the documentation on [[Template:Languages]]

Revision as of 09:08, 3 March 2007

This page describes the current multi-lingual policy on GRAMPS wiki.

Which Languages?

In theory, all languages for which a person can be found to maintain the translation, can have the GRAMPS main page translated. You can then translate articles on a opt-in basis.

What NOT to translate

  1. The developers section is english only. Development of GRAMPS is in english.
  2. Mark-up Templates. Templates for markup, eg pretty tables, boxes, should be written language independent, with if necessary a language parameter which is passed to content specific templates that can be translated.
Note that Content templates can be translated, but do not include the {{languges|pagename}} template to the content. Instead, add it to the noinclude section of the template:
<noinclude>{{languages|pagename}}</noinclude>

How?

  1. If you want to translate page [[GRAMPS:Language policy]] in a language with language code zz, you create a page [[GRAMPS:Language policy/zz]]. The root name af the article must be the english name. So e.g. Bonjour would be Goodday/fr. However you can use redirection to give French users a fr:Bonjour page
  2. Next, you add at the bottom of the page the template {{languages|GRAMPS:Language policy}}. This same template must be added to the root page as well as all translated pages.
  3. In the case no english page exists for the page you want to make, first add an english page with content
    {{stub}}{{languages|pagename}}
  4. You can redirect people to a page with localized title. This is helpfull for searching pages in non-english, or for inclusion of the pages in Help:Categories. Eg, you want to translate [[GRAMPS:About]] in Dutch.
    1. You make the page [[GRAMPS:About/nl]] with content:
      #REDIRECT [[nl:GRAMPS:Info]]
    2. In the page [[GRAMPS:About]], you add at the bottom
      {{languages}}
    3. You create the page nl:GRAMPS:Info, with as content the translated English page, and at the bottom you call the languages script, with as first parameter the english root page, and second parameter the true dutch name:
      {{languages|GRAMPS:About|GRAMPS:Info}}
    4. If you want to link to translated pages, you can use the standard wiki syntax: [[link here/nl|text]], but this is off course only possible if the nl page already exists. You can also use the following handy template: Template:Call_lang, which works as
      {{call_lang|link here|nl|text}}
      If the required translation exists, it is returned, otherwise the english root page is returned


More Details

For more details, see the documentation on Template:Languages