## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:Unknown-Page
##master-date:Unknown-Date
#acl -All:write Default
#format wiki
#language uk

## Description
'''Як виконати базове встановлення MoinMoin на вашій системі.'''

## '''Зміст'''
<<TableOfContents>>

Перед тим, як інтегрувати Moin``Moin у ваше веб-оточення, ви мусите встановити джерельні коди та файли даних MoinMoin, використовуючи стандартний для Python механізм ''distutils'' (`setup.py`). Ця сторінка пояснює кроки, які зазвичай необхідно виконати для цього. Щоб отримати більше інформації щодо процему встановлення з використанням ''distutils'', відвідайте [[http://www.python.org/doc/current/inst/inst.html|Installing Python Modules]] з набору документації до Python.

Процес встановлення на Windows та Linux схожий (а також на інших POSIX системах; для простоти ми будемо вжиати "Linux" у документації).

 (!) Ми будемо використовувати виділення на зразок '''`> command arguments`''', щоб показати, які команди ви маєте вводити на запрошення командної оболонки оточення (вживають також поняття shell, terminal тощо). У наших прикладах "`> `" - це запрошення, ці символи вводити не потрібно, ви маєте набирати команду після них. Рядки, що не починаються із "`> `" - це відгуки на команди, які ви ввели. Читайте відгуки уважно.


= Перевірте, чи працює Python =

Moin``Moin для роботи потребує Python, отже першим кроком буде перевірки наявності достатньої версії Python та коректної її конфігурації. Якщо це не так, ви маєте встановити Python і лише потім продовжувати.

У файлі `CHANGES` у архіві Moin``Moin перелічено версії, достатні для роботи Moin``Moin. Python 2.3 - мінімально достатня версія для Moin``Moin 1.5, але ми радимо використовувати останню версію Python.

Ви можете звантажити Python з [[http://www.python.org/download/]].

Якщо ви впевнені, що достатню версію Python встановлено, але команди, наведені нижче, не працюють, це може статися через те, що ваші файли Python знаходяться поза ''шляхом пошуку''. Встановлення шляху пошуку не входить у зміст цього документа; будь ласка, спитайте на вашому улюбленому форумі з питань конфігурування Python, адміністрування Linux, чи Windows.

Якщо у вас є доступ до командної оболонки, перевірка наявності достатньої версії Python дуже проста. Введіть наступну команду, та перевірте результат:
{{{
> python -V
Python 2.4.3
}}}

Якщо ж у вас немає доступу до командної оболонки, ви можете використати скрипт `pythontest.cgi` (у ньому передбачено, що ви використовуєте веб-сервер на Linux). Завантажте скрипт у каталог `cgi-bin` вашого веб-сервера, введіть `chmod a+rx pythontest.cgi` (чи відповідну команду вашого FTP клієнта), щоб встановити можливість виконання, та відкрийте його у переглядачі.

{{attachment:pythontest.cgi}}

Якщо ви не побачите "CGI scripts work", то, зрозуміло, CGI скрипти не працюють. Якщо ви не побачите одну чи більше версій Python, то Python не встановлено коректно. У обох випадках, перед тим, як продовжити, ви маєте звернутися до адміністратора сервера, щоб вирішити цю проблему.

Також обов'язково прочитайте ../ApacheOnLinuxFtp після того, як закінчите ../БазовеВстановлення.


= Звантаження MoinMoin =

Для отримання архіву Moin``Moin, завітайте на [[http://sourceforge.net/project/showfiles.php?group_id=8482|download area]] та візьміть останню версію.


Наступним кроком треба розпакувати архів (який ви вже розпакували, якщо ви читаєте цю сторінку зі свого жорсткого диска). Якщо ви читаєте цей текст з мережі, зауважте, що ви отримали дистрибутив певної версії Моін``Моін у архіві `.tar.gz`, який ви можете розпакувати як показано нижче.

 * Під Windows
    * Ви можете скористатися останніми версіями програм на кшталт Win``Zip, Win``Rar чи Win``Ace, які працюють із архівами .tar.gz.
    * У командній оболонці ви можете скористатися програмами [[http://gnuwin32.sourceforge.net/packages/gzip.htm|GNU gzip]] та [[http://gnuwin32.sourceforge.net/packages/tar.htm|GNU tar]] для Windows.
 * Під Linux
    * Ви можете використати ваш улюблений менеджер файлів -- він мустить вміти розпаковувати такі архіви.
    * У командній оболонці ви можете використати команду `tar`.

Архів пакунку Моін``Моін завжди буде розпаковано у каталог з назвою `moin-<version>`, наприклад `moin-1.6.0`.

Ось так, наприклад, ви можете розпакувати архів (скориставшися програмою GNU tar) та увійти у каталог з файлами Моін``Моін:
{{{
> tar xzf moin-1.6.0.tar.gz
> cd moin-1.6.0
}}}


= Встановлення MoinMoin =

Ви можете встановити Моін``Моін:
 * у загальносистемний каталог, для всіх користувачів (якщо ви маєте достатньо прав для цього -- під Linux ви мусите бути root'ом) чи
 * у якийсь певний каталог, скажімо, ваш домашній (Linux) чи `C:\moin` (Windows).

Встановлення у загальносистемний каталог простіше, тому виконуйте його, якщо це можливо.

/!\ Якщо у вашій системі встановлено кілька версій Python, будь ласка використовуйте ту саму версію для встановлення та роботи вікі. Зазвичай найкраще використовувати останню версію Python.


== Рекомендовані команди для встановлення під Linux (та MacOs X) ==

Якщо ви вирішили не використовувати пакунок Моін``Моін зі складу вашого дистрибутиву, наполегливо рекомендуємо вам не встановлювати Моін``Моін у типове для вашої системи розташування. Це тому, що у протилежному випадку подальші встановлення Моін``Моін зі складу дистрибутиву перепишуть наявне встановлення. Найпоширеніше розташування для ваших власних встановлень -- під {{{/usr/local}}} (це зветься PREFIX). Команди, які повинні спрацювати у більшості дистибутивів Linux та MacOS X такі:

{{{
> python setup.py install --prefix='/usr/local' --record=install.log
}}}

Ця команда встановить файли для спільного використання у '/usr/local/share/moin' та програми у `/usr/local/lib/python2.x/site-packages/MoinMoin/`.


== Вирішення проблем під час встановлення ==

Якщо у вас виникли проблеми із встановленням на етапі виконання `setup.py`, спробуйте таку команду:
{{{
> python -v setup.py --quiet install --record=install.log
}}}

Додатковий аргумент `-v` має надати детальні повідомлення на кожному кроці виконання.

/!\ Під Linux, якщо ви отримали повідомлення про помилку на зразок `Invalid Python installation: cannot find /usr/lib/Python2.x/config/Makefile`, у вашій системі, можливо, відсутній модуль '''`distutils`''', що зазвичай входить до складу '''Python development libarary (`python-dev`)'''. Деякі збірки Linux можуть не встановлювати цю бібліотеку без обумовлення. Наприклад, у Mandrake ви повинні будете встановити пакунок '''`python-devel`''', у Debian він називається '''`python-dev`'''.


== Встановлення у типове для системи розташування ==

{{{
> python setup.py --quiet install --record=install.log
}}}

Ця команда встановить Moin``Moin у типове для системи розташування (зазвичай у каталог Python, наприклад, під Linux, у `/usr/lib/python2.x/site-packages/MoinMoin` та `/usr/share/moin`). Перегляньте файл `install.log` щоб дізнатися, що саме було встановлено і куди саме.


== Встановлення у домашній каталог чи інше специфічне розташування ==

Приклад встановлення у домашній каталог для Linux систем:
{{{
> python setup.py --quiet install --prefix=$HOME --record=install.log
}}}

Приклад встановлення у каталог `C:\moin` для Windows систем:
{{{
> python setup.py --quiet install --prefix="C:\moin" --record=install.log
}}}

All Moin``Moin files will then be installed inside those directories, see `install.log` to know which files were installed, and where.

Всі файли Моін``Моін буде встановлено у ці каталоги, перегляньте файл `install.log` щоб дізнатися, що саме було встановлено і куди саме.

'''Увага:''' Дуже імовірно, ви побачите таке попередження:

    `warning: install: modules installed to 'C:\moin\', which`<<BR>>
    `is not in Python's module search path (sys.path) -- you'll`<<BR>>
    `have to change the search path yourself`

Це означає саме те, що і написано: модулі встановлено у каталог, що не входить до шляху пошуку модулів Python (sys.path), вам необхідно власноруч змінити шлях пошуку, інакше Python не знайде Моін``Моін.

Наприклад, якщо ви використовуєте веб-сервер та стандартний CGI, відредагуйте `moin.cgi` та додайте розташування вашого Моін``Моін до шляху пошуку Python таким, наприклад, чином:
{{{
import sys
sys.path.insert(0, 'C:/moin')
}}}


= Перевірка встановлення =

На останньому етапі, якщо у вас є доступ до командної оболонки, ви можете перевірити коректність встановлення та готовність до роботи. Запустіть Python та введіть `import MoinMoin` -- ви маєте не отримати жодного відгуку від інтерпретатора. Наприклад:

{{{
> python
Python 2.4.3 (...)
Type "help", "copyright", "credits" or "license" for more information.
>>> import MoinMoin
>>>
}}}

Якщо ж ви отримали таке:

{{{
>>> import MoinMoin
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
ImportError: No module named MoinMoin
>>>
}}}

значить, ви мусите налагодити ваше встановлення. Спробуйте виправити `sys.path` як описано вище.


= Що було встановлено =

Отже, ви маєте готовий до роботи Моін``Моін. Вітаємо! Перед тим, як узятися конфігурувати його, погляньте на різні файли та каталоги, що їх було встановлено.

/!\ Це важливо -- розуміти призначення різних місць, що використовуються при встановленні Моін``Моін, тож прочитайте цей розділ уважно.

У наступному переліку `PREFIX` означає те розташування, яке ви вказали команді `setup.py`, чи типове розташування для вашої системи, якщо ви не використовували аргумент `--prefix`. (Типові розташування для Linux: `/usr` чи `/usr/local`). `X.Y` -- це версія Python. Зазвичай це `2.3`, `2.4` чи `2.5`.

Перегляньте файл `install.log` та знайдіть записи щодо наступних важливих розташувань:

 * '''каталог `MoinMoin`''', зазвичай `PREFIX/lib/pythonX.Y/site-packages/MoinMoin` - тут встановлено '''джерельні коди''' Moin``Moin
 * '''каталог `share`''', зазвичай `PREFIX/share/moin` - тут встановлені ''шаблони''
  * каталог '''`data`''' (сторінки вікі, користувачі тощо) - сюди лише Моін``Моін повинен мати доступ
  * каталог '''`underlay`''' (сторінки вікі) -- сюди лише Моін``Моін повинен мати доступ
  * каталог '''`htdocs`''' з допоміжними файлами html (зображення для тем тощо) - сюди потрібно буде мати доступ веб-серверу
  * '''`server`''' - приклади стартових файлів Моін``Моін (`moin.cgi` для CGIта інші файли для інших методів запуску)
  * '''`config`''' - приклад файлів конфігурації Моін``Моін (`wikiconfig.py` та інші)
 * '''`bin`''' каталог з деякими скриптами, які допомагаються вам використовувати команди оболонки Моін``Моін

Ми сказали про ''шаблони'' у каталозі `share`, тому що ви зазвичай не будете використовувати ті файли у тому каталозі, ви скопіюєте їх у інше місце, де вони будуть вам потрібні. Таким чином ви можете без проблем сконфігурувати кілька вікі, та легко поновлювати версії Моін``Моін.
