## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnInstalling/BasicInstallation
##master-date:Unknown-Date
#acl -All:write Default
#format wiki
#language ru
'''Как произвести базовую установку MoinMoin на вашу систему.'''

'''Содержание'''
<<TableOfContents>>

Прежде чем вы сможете интегрировать Moin``Moin в ваше web-окружение, вам нужно установить исходный код и файлы данных MoinMoin используя стандартный механизм Python ''distutils'' (`setup.py`). Эта страница разъясняет шаги, обычно нужные для этого. За подробностями функционирования установочного процесса ''distutils'' обращайтесь к документу [[http://www.python.org/doc/current/inst/inst.html|Установка модулей Python]] в вашем наборе документации по Python.

Установка одинакова для Windows и Linux (и других POSIX-систем; для простоты мы в этой документации будем называть их "Linux").

 (!) Мы используем текст вроде '''`> команда аргументы`''' чтобы показать, что нужно набрать в командной строке (также известной как консоль, терминал, и т.д.). В наших примерах "`> `" это подсказка командной строки, её набирать не нужно, набирайте только то, что следует после неё. Строки, которые не начинаются с "`> `" это ответы на набираемые вами команды. Читайте их внимательно.

= Проверьте, работает ли Python =

Для работы Moin``Moin требуется Python, так что первым шагом будет проверка наличия корректно работающего Python нужной версии. Если такового не обнаружится, вам нужно будет исправить это, прежде чем продолжать.

Файл `CHANGES` file в архиве Moin``Moin указывает поддерживаемые версии. Для Moin``Moin 1.5 требуется как минимум Python 2.3, но мы рекомендуем использовать самую последнюю версию Python.

Вы можете загрузить Python с [[http://www.python.org/download/]].

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

Если у вас есть доступ к консоли, проверить работает ли Python очень просто. Просто наберите следующую команду и посмотрите на результат:
{{{
> python -V
Python 2.3.4
}}}

Если у вас нет доступа к консоли, вы можете попытаться использовать скрипт `pythontest.cgi` (подразумевается, что вы пользуетесь веб-сервером типа Linux). Загрузите скрипт в ваш каталог `cgi-bin`, выполните `chmod a+rx pythontest.cgi` (или аналогичную команду вашего FTP-клиента) чтобы сделать его исполняемым, и вызовите его через ваш веб-браузер.

{{attachment:pythontest.cgi}}

Если он не отобразит "CGI scripts work", значит CGI-скрипты не работают. Если он не отобразит один или более номеров версий Python, значит Python не проинсталлирован. В обоих случаях, прежде чем продолжать, вам нужно будет связаться с администратором сервера и решить эту проблему.

Также убедитесь, что прочли [[../ApacheOnLinuxFtp_ru]] после выполнения базовой установки, описанной здесь.

= Загрузка MoinMoin =

Чтобы загрузить архив дистрибутива, отправьтесь на  [[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-<версия>`, например `moin-1.5`.

Вот как распаковать архив (с помощью GNU tar) и войти в каталог с файлами Moin``Moin:
{{{
> tar xzf moin-1.5.0.tar.gz
> cd moin-1.5.0
}}}

= Установка MoinMoin =

Вы можете установить Moin``Moin:
 * в системную папку (если у вас достаточно прав для этого -- под Linux нужно быть root-ом)
 * в другую папку, допустим, в ваш домашний каталог (Linux) или `C:\moin` (Windows).

Установка в системную папку проще, поэтому выберите её, если есть возможность.

/!\ Если у вас установлено несколько версий Python, пожалуйста, используйте одну и ту же версию как для установки, так и для запуска wiki. Обычно, самые лучшие результаты даёт последняя версия Python.

Если возникли какие-то проблемы с установкой из `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 library (`python-dev`)'''. Некоторые дистрибутивы Linux могут не устанавливать его по умолчанию. Например, в Mandrake вам понадобится установить пакет '''`python-devel`''', в Debian он называется '''`python-dev`'''.

== Установка в системную папку по умолчанию ==

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

Это установит Moin``Moin в системную папку по умолчанию (обычно, в каталог Python, например, под Linux в `/usr/lib` и `/usr/share`). Просмотрите файл `install.log`, чтобы увидеть, что и куда было установлено.

 * Примечание для Mac OS X: используйте команду:
 {{{
python setup.py install --install-data='/usr/local'
}}}
 Она установит разделяемые файлы в '/usr/local/share/moin', вместо неудобного расположения в системной папке.

== Установка в домашний каталог или любую другую папку ==

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

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

Все файлы Moin``Moin будут установлены внутрь этих каталогов, чтобы узнать, какие файлы куда установились, смотрите `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, иначе он не сможет найти код Moin``Moin.

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

= Проверка установки =

В качестве завершающего шага, если у вас есть доступ к оболочке или командной строке, вы можете проверить, действительно ли всё корректно установилось и готово к работе. Запустите Python и наберите `import MoinMoin`. В ответ на эту команду ничего не должно произойти. Пример:

{{{
> python
Python 2.3.4 (#1, May 29 2004, 17:05:23)
[GCC 3.3.3] on linux2
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`, как описано выше.

= Что установилось =

Итак, сейчас у вас есть готовая к работе инсталляция Moin``Moin. Поздравляем! Прежде чем вы начнёте настраивать её, окиньте взглядом разные файлы и каталоги, которые были установлены.

/!\ Очень важно, чтобы вы понимали различные местоположения, использованные в установке Moin``Moin, так что читайте это внимательно.

В следующих описаниях `PREFIX` это то, что вы использовали вместе с командой `setup.py`, или расположение по умолчанию, если вы не пользовались опцией `--prefix`. (Типичные значения по умолчанию для Linux это `/usr` и `/usr/local`.) `X.Y` это версия Python. Обычно, это `2.3` или `2.4`.

Изучите `install.log`, чтобы найти упоминания о следующих важных местах:

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

Мы говорим о ''шаблонах'' в каталоге `share`, поскольку вы, обычно, не будете использовать эти файлы на этом самом месте, а скопируете их туда, куда вам понадобится. Это позволит вам создать несколько wiki без особых проблем и легко обновиться до новой версии Moin``Moin.
