Welcome

(./) /!\ <!>	If you have just installed or upgraded your wiki you are not in the wrong place. Just read the informations given below.	<!> /!\ (./)

System and Help Page Package installation

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).

Becoming superuser

For installation of the language packages, it is required that you are superuser:

If you do not already have an account, create one (see hints on the login page).

If the wiki is not already configured to recognize you as a superuser, change wiki config appropriately:

superuser = [u"YourLoginName", ]

See HelpOnConfiguration for more details.

Restart the wiki to make it load the changed configuration.

Login in (with the login name you configured as superuser).

Installing page packages

You can 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).

/!\ 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.

/!\ 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.

FrontPage configuration

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.

Note: you must set page_front_page to get rid of this page being the front page:

# Choose this, if most wiki content is in a single language. # If English is not your wiki's main language, choose something in YOUR wiki language page_front_page = u"MyStartingPage"

OR

# Choose this, if wiki content is maintained in multiple languages. # In the navigation, "FrontPage" will get automatically translated for installed languages. page_front_page = u"FrontPage"

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.

If you go the multiple language way, don't forget to edit all translations of FrontPage.

/!\ 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.

Arabic	Arabic (written in Arabic XXX)	ar	none
Bulgarian	Български	bg	НачалнаСтраница
Catalan	català	ca	PàginaPrincipal
Czech	Čeština	cs	HlavniStranka
Danish	Dansk	da	ForSide
German	Deutsch	de	StartSeite
Greek	Ελληνικά	el	none
English	English	en	none
Spanish	Español	es	PáginaInicial
Persian	Persian	fa	صفحه اولیه
Finnish	Suomi	fi	EtuSivu
French	Français	fr	PageD'Accueil
Galician	galego	gl	PáxinaInicial
Hebrew	עברית	he	דף ראשי
Hindi	Hindi (XXX in Hindi)	hi	none
Croatian	Hrvatski	hr	Početna
Hungarian	Magyar	hu	KezdőLap
Indonesian	Bahasa Indonesia	id	HalamanMuka
Italian	Italiano	it	PaginaPrincipale
Japanese	Japanese	ja	フロントページ
Korean	한국어	ko	대문
Kurdish	Kurdish (XXX in kurdish)	ku	none
Lithuanian	Lietuvių	lt	PirmasisPuslapis
Latvian	Latviešu	lv	SākumLapa
Macedonian	Македонски	mk	Почетна
Mongolian	Mongolian (XXX in Mongolian)	mn	Эхний хуудас
Norwegian Bokmal	Norsk Bokmål	nb	StartSide
Dutch	Nederlands	nl	VoorPagina
Polish	Polski	pl	StronaGłówna
Brazilian Portuguese	Português do Brasil	pt-br	PáginaPrincipal
Portuguese	Português	pt	PáginaPrincipal
Romanian	Română	ro	PaginaPrincipală
Russian	Русский	ru	ГлавнаяСтраница
Slovak	slovenčina	sk	HlavnáStránka
Slovenian	slovenščina	sl	PrvaStran
Serbian	Srpski	sr	НасловнаСтрана
Swedish	Svenska	sv	StartSida
Turkish	Türkçe	tr	AnaSayfa
Ukrainian	Українська	uk	Початок
Vietnamese	Tiếng Việt	vi	Trang đầu
Simplified Chinese	简体中文	zh	首页
Chinese/Taiwan	繁體中文	zh-tw	首頁

User interface text translations

MoinMoin tries to adapt the user interface to the language the user prefers.

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.

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.

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.

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.

System and help page translations and the navigation bar

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.

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.

Understanding Language packs

Quickstart (for lazy people) : Install the package all_pages for the language(s) in which you provide some content.

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:

*_System_* - Page needed run the wiki like RecentChanges, FindPage and FrontPage.

*_Help_* - Some help pages (mostly for wiki editors)

*_Template_* - Templates !

*_Category_* - MoinMoin built-in categories (like CategoryCategory)

*_Admin_* - Pages useful for wiki administrators only

*_pages - Contains the content of all 5 packages above.

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:

Categories
System	Help	Template	Category	Admin	All Categories
Essential	essential_system_pages	essential_help_pages	essential_template_pages	essential_category_pages	essential_pages
Optional	optional_system_pages	optional_help_pages	optional_template_pages	optional_pages
All priorities	all_system_pages	all_help_pages	all_template_pages	all_category_pages	admin_pages	all_pages

The language packs are compiled according to pages listed in MoinMoin/i18n/strings.py (using the command moin maint mkpagepacks)