Как произвести базовую установку MoinMoin на вашу систему.
Содержание
Contents
Прежде чем вы сможете интегрировать MoinMoin в ваше web-окружение, вам нужно установить исходный код и файлы данных MoinMoin используя стандартный механизм Python distutils (setup.py). Эта страница разъясняет шаги, обычно нужные для этого. За подробностями функционирования установочного процесса distutils обращайтесь к документу Установка модулей Python в вашем наборе документации по Python.
Установка одинакова для Windows и Linux (и других POSIX-систем; для простоты мы в этой документации будем называть их "Linux").
Мы используем текст вроде > команда аргументы чтобы показать, что нужно набрать в командной строке (также известной как консоль, терминал, и т.д.). В наших примерах "> " это подсказка командной строки, её набирать не нужно, набирайте только то, что следует после неё. Строки, которые не начинаются с "> " это ответы на набираемые вами команды. Читайте их внимательно.
Проверьте, работает ли Python
Для работы MoinMoin требуется Python, так что первым шагом будет проверка наличия корректно работающего Python нужной версии. Если такового не обнаружится, вам нужно будет исправить это, прежде чем продолжать.
Файл CHANGES file в архиве MoinMoin указывает поддерживаемые версии. Для MoinMoin 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-клиента) чтобы сделать его исполняемым, и вызовите его через ваш веб-браузер.
Если он не отобразит "CGI scripts work", значит CGI-скрипты не работают. Если он не отобразит один или более номеров версий Python, значит Python не проинсталлирован. В обоих случаях, прежде чем продолжать, вам нужно будет связаться с администратором сервера и решить эту проблему.
Также убедитесь, что прочли ../ApacheOnLinuxFtp_ru после выполнения базовой установки, описанной здесь.
Загрузка MoinMoin
Чтобы загрузить архив дистрибутива, отправьтесь на download area и выберите самую свежую версию.
Следующим шагом будет распаковка дистрибуционного архива (который у вас должен уже быть, если вы прочли этот текст со своего жёсткого диска). Если вы читаете это в Интернете, то скачанный вами дистрибутив представляет собой версионный архив .tar.gz, который вы можете распаковать, как показано ниже.
- Под Windows
- Под Linux
- Вы можете использовать ваш любимый файловый менеджер -- он должен уметь распаковывать такое.
В любой оболочке можно использовать команду tar.
Архив дистрибутива всегда будет распаковываться в папку с именем moin-<версия>, например moin-1.5.
Вот как распаковать архив (с помощью GNU tar) и войти в каталог с файлами MoinMoin:
> tar xzf moin-1.5.0.tar.gz > cd moin-1.5.0
Установка MoinMoin
Вы можете установить MoinMoin:
- в системную папку (если у вас достаточно прав для этого -- под Linux нужно быть root-ом)
в другую папку, допустим, в ваш домашний каталог (Linux) или C:\moin (Windows).
Установка в системную папку проще, поэтому выберите её, если есть возможность.
![/!\](/gnome/gnome-responsive/img/dialog-warning-symbolic.png "/!\"){kind=small}
Если у вас установлено несколько версий 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
Это установит MoinMoin в системную папку по умолчанию (обычно, в каталог 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
Все файлы MoinMoin будут установлены внутрь этих каталогов, чтобы узнать, какие файлы куда установились, смотрите install.log.
Примечание: Вероятно, вы увидите следующее предупреждение:
warning: install: modules installed to 'C:\moin\', which
is not in Python's module search path (sys.path) -- you'll
have to change the search path yourself
Это значит именно то, о чём написано в предупреждении. Вам нужно добавить каталог установки в путь поиска Python, иначе он не сможет найти код MoinMoin.
Например, если вы работаете используя веб-сервер и стандартный 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, как описано выше.
Что установилось
Итак, сейчас у вас есть готовая к работе инсталляция MoinMoin. Поздравляем! Прежде чем вы начнёте настраивать её, окиньте взглядом разные файлы и каталоги, которые были установлены.
Очень важно, чтобы вы понимали различные местоположения, использованные в установке MoinMoin, так что читайте это внимательно.
В следующих описаниях 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 - это место, где расположен исходный код MoinMoin
каталог share, обычно, PREFIX/share/moin - это место, где расположены шаблоны
каталог data (страницы wiki, пользователи, и т.д.) - только MoinMoin должен иметь к ним доступ
каталог underlay (страницы wiki) - только MoinMoin должен иметь к ним доступ
каталог htdocs с файлами поддержки html (картинки для разных тем и т.д.) - нужно будет дать веб-серверу доступ сюда
server - примеры стартовых файлов MoinMoin (наподобие moin.cgi для CGI, и другие файлы для других методов запуска)
config - примеры конфигурационных файлов MoinMoin (таких, как wikiconfig.py)
каталог bin с некоторыми скриптами, которые помогут вам использовать команды оболочки MoinMoin
Мы говорим о шаблонах в каталоге share, поскольку вы, обычно, не будете использовать эти файлы на этом самом месте, а скопируете их туда, куда вам понадобится. Это позволит вам создать несколько wiki без особых проблем и легко обновиться до новой версии MoinMoin.