← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/moin/oneiric-security

« back to all changes in this revision

Viewing changes to wiki/underlay/pages/LanguageSetup/revisions/00000001

  • Committer: Bazaar Package Importer
  • Author(s): Jamie Strandboge
  • Date: 2010-03-30 12:55:34 UTC
  • mfrom: (0.1.17 sid)
  • Revision ID: james.westby@ubuntu.com-20100330125534-4c2ufc1rok24447l
Tags: 1.9.2-2ubuntu1
https://launchpad.net/bugs/521834
* Merge from Debian testing (LP: #521834). Based on work by Stefan Ebner.
  Remaining changes:
 - Remove python-xml from Suggests field, the package isn't anymore in
   sys.path.
 - Demote fckeditor from Recommends to Suggests; the code was previously
   embedded in moin, but it was also disabled, so there's no reason for us
   to pull this in by default currently. Note: This isn't necessary anymore
   but needs a MIR for fckeditor, so postpone dropping this change until
   lucid+1
* debian/rules:
  - Replace hardcoded python2.5 with python* and hardcore python2.6 for ln
* debian/control.in: drop versioned depends on cdbs

Show diffs side-by-side

added added

removed removed

Lines of Context:
wiki/underlay/pages/LanguageSetup/revisions/00000001
 
1
## Please edit system and help pages ONLY in the master wiki!
 
2
## For more information, please see MoinMoin:MoinDev/Translation.
 
3
##master-page:Unknown-Page
 
4
##master-date:Unknown-Date
 
5
#acl -All:write Default
 
6
#format wiki
 
7
#language en
 
8
 
 
9
## Translator notice: DO NOT TRANSLATE THIS PAGE!
 
10
 
 
11
= Welcome =
 
12
 
 
13
||<tablewidth="99%" (> (./) /!\ <!> ||<: width="76%">If you have just installed or upgraded your wiki you are not in the wrong place.<<BR>>Just read the informations given below.||<)> <!> /!\ (./) ||
 
14
 
 
15
 
 
16
== System and Help Page Package installation ==
 
17
!MoinMoin comes with no system and help pages installed by default (the page you read right now is the only page after a fresh installation).
 
18
 
 
19
=== Becoming superuser ===
 
20
For installation of the language packages, it is required that you are superuser:
 
21
 1. If you do not already have an account, create one (see hints on the login page).
 
22
 1. If the wiki is not already configured to recognize you as a superuser, change wiki config appropriately:
 
23
 {{{
 
24
    superuser = [u"YourLoginName", ]
 
25
}}}
 
26
 See HelpOnConfiguration for more details.
 
27
 1. Restart the wiki to make it load the changed configuration.
 
28
 1. Login in (with the login name you configured as superuser).
 
29
 
 
30
=== Installing page packages ===
 
31
You can <<Action(language_setup, install help and system page packages)>> for any language you want to support for your wiki users. You should see links for each supported language, and below an '''install''' link for each page package of that language - click on it for each of the packages you wish to install. When you're finished, restart the wiki (otherwise it won't recognize the newly installed pages correctly).
 
32
 
 
33
/!\ Make sure you at least install the essential system page package for the `language_default` you might have configured (the default for this setting is `en`, i.e English). Note however that if you don't install the whole page set, the installed pages may contain broken links to the non-installed.
 
34
 
 
35
/!\ If you want to use translated categories and templates, after installing their corresponding pages you still need to update your `page_category_regex` and `page_template_regex` configs to match the translated page names. See HelpOnConfiguration and http://moinmo.in/ConfigMarket for more details.
 
36
 
 
37
== FrontPage configuration ==
 
38
 
 
39
For the root URL of your wiki, moin will use a special page (called the "front page"). Users can be given a translated front page in their preferred language, or they can be given any other single page you specify.
 
40
 
 
41
Note: you '''must''' set `page_front_page` to get rid of this page being the front page:
 
42
 
 
43
{{{
 
44
    # Choose this, if most wiki content is in a single language.
 
45
    # If English is not your wiki's main language, choose something in YOUR wiki language
 
46
    page_front_page = u"MyStartingPage"
 
47
}}}
 
48
 
 
49
OR
 
50
 
 
51
{{{
 
52
    # Choose this, if wiki content is maintained in multiple languages.
 
53
    # In the navigation, "FrontPage" will get automatically translated for installed languages.
 
54
    page_front_page = u"FrontPage"
 
55
}}}
 
56
 
 
57
If you go the ''single language'' way, you can copy some of the content of FrontPage (or one of its translations) to the page you choose as your `page_front_page`.
 
58
 
 
59
If you go the ''multiple language'' way, don't forget to edit all translations of !FrontPage.
 
60
 
 
61
/!\ If you go the ''multiple languages'' way, people reaching your wiki will be directed to the front page corresponding to their browser language setting. If you did not prepare that page, they will see the default page for their language and have the impression the wiki is empty or badly maintained.
 
62
 
 
63
{{{#!wiki comment
 
64
##for f in $(grep '^msgid "FrontPage"' MoinMoin/i18n/*.MoinMoin.po -l) ; do lg="$(sed -n -e '/X-Language-in-English:/s/.*:\s*\(.*\)\\n.*/\1/p' $f )" ; llg="$(sed -n -e '/X-Language:/s/.*:\s*\(.*\)\\n.*/\1/p' $f )"; fp="$(grep '^msgid "FrontPage"' -A 1 $f | sed -n -e '/msgstr/s/.* "\(.*\)".*/\1/p' | sed -e 's/.\+/[[\0]]/' | sed -e 's/^$/none/')" ; cc=$(basename "$f" ".MoinMoin.po"); echo "||$lg||$llg||$cc||$fp||" ; done 
 
65
||Arabic||Arabic (written in Arabic XXX)||ar||none||
 
66
||Bulgarian||Български||bg||[[НачалнаСтраница]]||
 
67
||Catalan||català||ca||[[PàginaPrincipal]]||
 
68
||Czech||Čeština||cs||[[HlavniStranka]]||
 
69
||Danish||Dansk||da||[[ForSide]]||
 
70
||German||Deutsch||de||[[StartSeite]]||
 
71
||Greek||Ελληνικά||el||none||
 
72
||English||English||en||none||
 
73
||Spanish||Español||es||[[PáginaInicial]]||
 
74
||Persian||Persian||fa||[[صفحه اولیه]]||
 
75
||Finnish||Suomi||fi||[[EtuSivu]]||
 
76
||French||Français||fr||[[PageD'Accueil]]||
 
77
||Galician||galego||gl||[[PáxinaInicial]]||
 
78
||Hebrew||עברית||he||[[דף ראשי]]||
 
79
||Hindi||Hindi (XXX in Hindi)||hi||none||
 
80
||Croatian||Hrvatski||hr||[[Početna]]||
 
81
||Hungarian||Magyar||hu||[[KezdőLap]]||
 
82
||Indonesian||Bahasa Indonesia||id||[[HalamanMuka]]||
 
83
||Italian||Italiano||it||[[PaginaPrincipale]]||
 
84
||Japanese||Japanese||ja||[[フロントページ]]||
 
85
||Korean||한국어||ko||[[대문]]||
 
86
||Kurdish||Kurdish (XXX in kurdish)||ku||none||
 
87
||Lithuanian||Lietuvių||lt||[[PirmasisPuslapis]]||
 
88
||Latvian||Latviešu||lv||[[SākumLapa]]||
 
89
||Macedonian||Македонски||mk||[[Почетна]]||
 
90
||Mongolian||Mongolian (XXX in Mongolian)||mn||[[Эхний хуудас]]||
 
91
||Norwegian Bokmal||Norsk Bokmål||nb||[[StartSide]]||
 
92
||Dutch||Nederlands||nl||[[VoorPagina]]||
 
93
||Polish||Polski||pl||[[StronaGłówna]]||
 
94
||Brazilian Portuguese||Português do Brasil||pt-br||[[PáginaPrincipal]]||
 
95
||Portuguese||Português||pt||[[PáginaPrincipal]]||
 
96
||Romanian||Română||ro||[[PaginaPrincipală]]||
 
97
||Russian||Русский||ru||[[ГлавнаяСтраница]]||
 
98
||Slovak||slovenčina||sk||[[HlavnáStránka]]||
 
99
||Slovenian||slovenščina||sl||[[PrvaStran]]||
 
100
||Serbian||Srpski||sr||[[НасловнаСтрана]]||
 
101
||Swedish||Svenska||sv||[[StartSida]]||
 
102
||Turkish||Türkçe||tr||[[AnaSayfa]]||
 
103
||Ukrainian||Українська||uk||[[Початок]]||
 
104
||Vietnamese||Tiếng Việt||vi||[[Trang đầu]]||
 
105
||Simplified Chinese||简体中文||zh||[[首页]]||
 
106
||Chinese/Taiwan||繁體中文||zh-tw||[[首頁]]||
 
107
}}}
 
108
== User interface text translations ==
 
109
 
 
110
!MoinMoin tries to adapt the user interface to the language the user prefers.
 
111
 
 
112
If the user puts a specific language preference into his user preferences, that language will be used for the user interface. But the user doesn't even need to do that if he already has configured his browser with his language preferences.
 
113
 
 
114
If there is no specific user preferences language setting, moin tries to adapt to the languages the user configured in his browser. So if the browser tells moin that its preference is Canadian English, then German, then English in general and moin has German and English available (but not a specific configuration for Canadian English), then the user will get a German user interface.
 
115
 
 
116
If there is no common language in the user's browser configuration and in moin or if you have set {{{language_ignore_browser = True}}}, moin will fall back to using what is configured as {{{language_default}}}. This is also the case if the user's browser does not specify any language.
 
117
 
 
118
The usual case when you want to set {{{language_ignore_browser = True}}} is when running a local wiki with no international audience and you maintain the wiki in only one (your local) language. Don't forget to specify your one-and-only language using language_default when doing this.
 
119
 
 
120
 
 
121
== System and help page translations and the navigation bar ==
 
122
 
 
123
The !MoinMoin distribution archive contains the system pages (like `RecentChanges`) in different languages, selecting the correct language in the same way as for the user interface.
 
124
 
 
125
For example, if the navi_bar contains a link to `RecentChanges`, moin will first look for a translation of `RecentChanges` into the user's language. So if the user's language is German (de), the translation is `AktuelleÄnderungen`. Moin will use `AktuelleÄnderungen` in the navi_bar display if that page actually exists; otherwise, it will fall back to using `RecentChanges`.
 
126
 
 
127
== Understanding Language packs ==
 
128
 
 
129
{{{{#!wiki note
 
130
'''Quickstart (for lazy people)''': Install the package {{{all_pages}}} for the language(s) in which you provide some content.
 
131
}}}}
 
132
 
 
133
For each language, there is up 17 packages of underlay pages. The underlay pages are split by priorities ({{{essential}}}, {{{optional}}} and "{{{all}}}") and by categories:
 
134
 * {{{*_System_*}}} - Page needed run the wiki like RecentChanges, FindPage and FrontPage.
 
135
 * {{{*_Help_*}}} - Some help pages (mostly for wiki editors)
 
136
 * {{{*_Template_*}}} - Templates !
 
137
 * {{{*_Category_*}}} - !MoinMoin built-in categories (like {{{Category}}}{{{Category}}})
 
138
 * {{{*_Admin_*}}} - Pages useful for wiki administrators only
 
139
 * {{{*_pages}}} - Contains the content of all 5 packages above.
 
140
 
 
141
Language packs are named like {{{essential_help_pages.zip}}}, where {{{essential}}} and {{{help}}} are the priority and category. Here's a matrix with the packages available:
 
142
 
 
143
||<tablestyle="border:1pt solid black" style="border-top:hidden;border-left:hidden;border-bottom:hidden">||<: colspan="6"> Categories||
 
144
||<rowstyle="border-width:2pt;" style="border-top:hidden;border-left:hidden"> ||'''System '''||'''Help'''||'''Template'''||'''Category'''||'''Admin'''||<style="border-left-width:2pt">'''All Categories'''||
 
145
||'''Essential'''|| {{{essential_system_pages}}} || {{{essential_help_pages}}} || {{{essential_template_pages}}} || {{{essential_category_pages}}} ||        ||<style="border-left-width:2pt"> {{{essential_pages}}} ||
 
146
||'''Optional '''|| {{{optional_system_pages}}} || {{{optional_help_pages}}} || {{{optional_template_pages}}} ||        ||        ||<style="border-left-width:2pt"> {{{optional_pages}}}  ||
 
147
||<style="border-top-width:2pt">'''All priorities'''||<style="border-top-width:2pt"> {{{all_system_pages}}} ||<style="border-top-width:2pt"> {{{all_help_pages}}} ||<style="border-top-width:2pt"> {{{all_template_pages}}} ||<style="border-top-width:2pt"> {{{all_category_pages}}}  ||<style="border-top-width:2pt"> {{{admin_pages}}} ||<style="border-left-width:2pt; border-top-width:2pt"> '''{{{all_pages}}}'''       ||
 
148
 
 
149
/* The language packs are compiled according to pages listed in [[http://hg.moinmo.in/moin/1.9/file/ac5dc19e0a0e/MoinMoin/i18n/strings.py|MoinMoin/i18n/strings.py]] (using the command {{{moin maint mkpagepacks}}}) */