среда, 6 марта 2013 г.

MoinMoin2. Документация. Загрузка и установка

Примечание, курсивом выделены вставки, сделанные мной на личном опыте

 Загрузка

Для moin2 пакеты пока не доступны, так что Вы должны получить его из репозитория. Вы можете использовать один или два URLa репозиториев и либо использовать Mercurial для поддержки кода в актуальном состоянии, или же скачать файлы в архие tar.gz:
  • Использование Mercurial для клонирования одного из репозиториев:
    hg clone http://hg.moinmo.in/moin/2.0 moin-2.0
    или
    hg clone http://bitbucket.org/thomaswaldmann/moin-2.0 moin-2.0
    после этого убедитесь, что ваша рабочая директория использует ветку default:
    cd moin-2.0
    hg up -C default
  • В качестве альтернативы посетите http://hg.moinmo.in/moin/2.0 и скачайте архив (обычно, для ветки default) и распакуйте его

Установка

Перед тем, как Вы запустите moin, Вы должны его установить:

Установка разработчика

Использование стандартной установки Python или каталога  virtualenv

Пожалуйста, убедитесь, что у Вас установлен virtualenv, который включает в себя pip.
Если вы всего лишь хотите запускать moin из рабочего каталога mercurial со стандартной установкой Python, выполните следующую комманду в этом каталоге. Вы не должны выполнять её как администратор машины, используйте стандартный аккаунт пользователя:
./quickinstall # для Linux и других POSIX OS
# или
quickinstall.bat # для Windows

На FreeBSD 9.1 bash не установлен по умолчанию, а он нужен для работы этого скрипта. Так что сперва Вам нужно установить bash:
cd /usr/ports/shells/bash/ && make install clean
после чего надо будет отредактировать первую строку скрипта, указав путь к bash:
#!/usr/local/bin/bash

Эта команда использует virtualenv для создания каталога env/ в текущем рабочем каталоге, создаёт виртуальное окружение для MoinMoin и затем устанавливает moin2 со всеми зависимостями в этот каталог. pip автоматически скачает все зависимости из PyPI и установит их, так что это может занять некоторое время. Кроме того, будут скомпилированы все переводы (файлы *.po) в бинарные файлы *.mo.
Просмотрите вывод скрипта quickinstall  и проверьте отсутствие ошибок.
Если у Вас плохое подключение к сети из-за чего скачивание прерывается, Вы можете попробовать выполнить шаги из quickinstall вручную.
Кроме того, quickinstall создаст скрипт moin для вашей платформы, который Вы сможете использовать для запуска встроенного сервера или команды moin.
После того, как Вы активируете виртуальное окружение (sourcer bin/activate выполненый в bash), встроенный серверный скрипт с именем moin будет находиться в вашем стандартном пути, так что Вы можете просто запустить команду moin из вашей командной строки.
Примечание: в этом специальном режиме MoinMoin код не будет скопирован в каталог env/, всё будет запускаться из вашей рабочей директории, так что Вы можете напрямую править код и смотреть, что получается. Процедуру установки надо выполнить только один раз.

Использование другого Python или другого каталога virtualenv

Например, если Вы хотите использовать PyPy и хотите, чтобы каталог для virtualenv назывался env-pypy, выполните команду:
# для Linux
DIR=env-pypy
PYTHON=/opt/pypy/bin/pypy
Таким образом, Вы можете проверить разные версии Python в разных каталогах вашего рабочего каталога.

Активирование виртуального окружения

ВАЖНО: Вы всегда должны активировать ваше виртуальное окружение перед запуском чего-либо, что будет выполнять код moin! Иначе не будет найдена ни команда moin, ни код moin, ни необходимые библиотеки. Кроме того, если Вы хотите установить дополнительное ПО в виртуальное окружение, активируйте его перед запуском pip!
source env/bin/activete # для Linux или других POSIX OS
# или
env\Scripts\activate.bat # для Windows
После того, как Вы активировали виртуальное окружение, команда moin будет в вашем пути, так что Вы сможете выполнить её.

Помогаем moin найти конфигурацию wiki

moin так же должен обнаружить конфигурацию wiki. Если Вы хотите запустить moin самым простым способом, без передачи параметров команде moin, проще всего это будет сделать из каталога с конфигурационными файлами, т.е. wikiconfig.py.
Если Вы работаете в рабочем каталоге репозитория, то Вам нужен каталог верхнего уровня, где есть уже готовый к использованию wikiconfig.py.
В случае, если Вы хотите указать путь к файлу с конфигурацией, используйте абсолютный путь. moin будет искать конфигурационный файл в таком порядке:
  1. аргумент командной строки --config /path/to/wikiconfig.py
  2. переменная окружения MOINCFG=/path/to/wikiconfig.py
  3. текущий каталог, файл wikiconfig_local.py
  4. текущий каталог, файл wikiconfig.py

 Инициализация индекса и/или хранилища

Если у Вас уже есть хранилищи И индекс (для содержимого этого хранилища и для этой версии moin), Вы можете пропустить этот раздел.
Если Вы начинаете с самого начала, то есть ни хранилища ни индекса ещё не создано, то Вам нужно создать пустое хранилище и пустой индекс:
# создаём хранилище и индекс:
moin index-create -s -i

Загружаем некоторые элемента

Если Вы не хотите получить совсем пустую вики, Вы можете, по желанию, загрузить в хранилище некоторые примеры, например:
moin load --file contrib/serialized/items.moin

Строим индекс

Если у Вас уже есть некоторые элементы в хранилище, но индекса ещё нет, то его нужно построить:
moin index-build

Установка PIL

Для некоторых функций обработки изображений, котоыре использует MoinMoin, например, изменение размера или поворот, Вам нужен PIL - Python Imaging Library.
Пользователи Windows, которые хотят установить PIL должны пропустить этот раздел и перейти к Решение проблем - Установка PIL под Windows.
Если Вы устанавливаете PIL при помощи pip, тогда pip постарается найти библиотеку поддержки jpeg  и ассоциированные заголовки разработки в вашей системе, и если у Вас их нет - то Вы не получите поддержки jpeg в PIL. Так что если Вы хотите обеспечить эту поддержку, убедитесь, что у Вас есть jpeg библиотеки и заголовки:
# установка jpeg библиотеки и заголовков разработки
sudo apt-get install libjpeg62-dev # Ubuntu/Debian
yum install libjpeg-turbo-devel #Fedora/Redhat
cd /usr/ports/graphics/jpeg/ && make install clean # FreeBSD
После этого активируйте виртуальное окружение и установите PIL:
pip install pil

Решение проблем

PyPI не работает

Всегда может быть так, что PyPI окажется недоступен. В этом случае можно использовать зеркала b.pypi.python.org, c.pypi.python.org, d.pypi.python.org. Вам только нужно сказать об этом pip:
# разместите это в ~/.pip/pip.conf
[global]
index-url = http://c.pypi.python.org/simple
В случае, если и это не будет работать, попробуйте mini pypi, где должны быть все необходимые для moin пакеты:
# разместите это в ~/.pip/pip.conf
[global]
index-url = http://pypi.moinmo.in/simple

Проблемы с сетью

Если у Вас плохое или ограниченное подключение к сети, у Вас могут возникнуть проблемы с командами, выполняемыми скриптом quickinstall. Вы можете увидеть трассировку pip, ошибки таймаута и т.д. Обратите внимание на эти сообщения.
В этом случае попробуйте сделать это вручную:
# перейдите в виртуальное окружение:
source env/bin/activate
# убедитесь в проблемах, запустив
pip install -e .
После этого установите каждый пакет в ваше виртуальное окружение вручную:
  •  Найдите все нужные пакеты, перечисленные в install_requires из файла setup.py
  • Загрузите все нужные пакеты из http://pypi.python.org/
  • Установите все эти пакеты:
    pip install package.tar
  • Теперь попробуйте ещё раз:
    pip install -e .
Повторите эти шаги, пока не прекратится появление ошибок.

Установка PIP под Windows

PIL версии 1.1.7 не устанавливается корректно командой pip install pil на Windows. Некоторым пользователям удалось сделать это при помощи pip install pillow, установив форк PIL'a, устранающего эту проблему. Другие установили PIL 1.1.6 в каталог установки Python, скачав его с http://www.pythonware.com/products/pil/

Комментариев нет:

Отправить комментарий