Как да конфигурирам - Wiki Portal-Python Programmers
Тази страница трябва да помогне в процеса на конфигуриране на вече инсталиран wiki, базиран на MoinMoin.
MoinMoin използва Unicode за вътрешно представяне на низове и UTF-8 кодиране за I/O, което включва съхранение на страници, генериране на HTML страници и файлове за превод. Кодирането, използвано за четене и запис на външни ресурси, е посочено в параметъра config.charset като utf-8. Тази стойност е подходяща за всеки език, тъй като всеки символ може да бъде кодиран в UTF-8. Не се препоръчва промяната на стойността на този параметър, въпреки факта, че това е технически възможно.
Няколко параметъра трябва да използвайте Unicode низове в стойности. Например името на сайта може да съдържа немски умлаути или френски диакритици или да бъде на руски или иврит. Следователно трябва да използвате Unicode низове, за да зададете тези стойности. Unicode низовете се посочват, като се предшестват с "u". Примери за използване:
Не е възможно да се смесват низови литерали в различни кодирания в рамките на един и същ файл. Ако низът за кодиране на файл показва, че се използва кодиране koi8-r, тогава цялото съдържание на файла трябва да го използва.
Когато използвате UTF-8 (или само ASCII) кодиране, няма нужда да използвате Unicode низове, MoinMoin ще декодира правилно низовете в този случай.
Използване на различни кодировки в конфигурационния файл
Конфигурационният файл по подразбиране, включен в дистрибуцията MoinMoin, използва кодиране ISO 8859-1. Това не създава проблем за западноевропейските езици като английски или немски, но не е подходящо за нелатински методи на писане. Трябва да използвате UTF-8 кодиране, когато използвате не-латински символи в конфигурационния файл.
За да направите това, просто посочете следния ред като първи във всички конфигурационни файлове:
Параметрите, чиито стойности са Unicode низове, могат да бъдат разпознати по техните стойности по подразбиране с префикса "u". " Или "ur". " (Префиксният знак "u" означава "unicode" - Unicode) или в случай, когато описанието е ясно посочено.
За готови конфигурации за различни езици вижте ConfigMarket. Вижте също раздела за Unicode променливи.
Конфигуриране на настройките на акаунта
Администраторът може да зададе, деактивира или забрани индивидуални настройки на акаунта, вижте Как да конфигурирате/настройки на акаунта.
Ако на сървъра се стартира единичен екземпляр на wiki, няма нужда да копирате файла farmconfig.py в директорията с конфигурационните файлове (изтрийте този файл и едноименния файл с разширение .pyc, ако те са има ли). Ако конфигурационният файл на фермата липсва, MoinMoin използва файла wikiconfig.py.
Основни бележки за структурата на уики или конфигурационен файл на фермата:
В началото има индикация за кодирането на конфигурационния файл. Кодирането по подразбиране е ISO 8859-1, което съответства на символи в западноевропейските езици. Когато използвате други езици, препоръчително е да посочите кодиране UTF-8, вижте съответния раздел за подробности. Ако не дефинирате кодирането, използването на символи, които не са включени в набора от символи ASCII в конфигурационния файл, е невъзможно.
След това модулът се импортира с конфигурацията по подразбиране MoinMoin. Конфигурацията по подразбиране включва стойности за всички необходими параметри, поради което няма нужда да задавате всички параметри в конфигурационния файл, а само тези, необходими за подниза за съществуващите нужди.
След това се дефинира нов конфигурационен клас с име "Config" и наследява всички конфигурационни параметри от конфигурацията по подразбиране, която е била импортирана по-рано. Важно е да се отбележи, че класът трябва да носи името "Config".
След това параметрите се задават в класа. Трябва да се отбележи, че всеки ред е предшестван с отстъп от четири интервала, таблирането не е разрешено (в краен случай целият файл трябва да използва раздели за отстъп, но това е силно обезкуражено). MoinMoin няма да работи, ако конфигурационният файл има грешно отстъп.
Един от най-конфигурируемите параметри е името на сайта, името на сайта - в повечето случаи не се използва по подразбиране "u" Untitled Wiki ". Името на wiki може да бъде зададено на всеки език, но преди това е препоръчително да прочетете раздела за кодирането
Уикито ще стартира без допълнителни стъпки, ако инсталацията е извършена в съответствие с инструкциите, но може да се наложи да промените някои параметри, като data_dir, data_underlay_dir, acl_rights_before и други. В повечето случаи е достатъчно да зададете параметрите, които вече са налични в wikiconfig.py.
Всичко, което не е посочено в конфигурационния файл, ще има стойности по подразбиране, които са наследени от класа DefaultConfig.