Установка

Пожалуйста, экспериментируйте в песочнице!

администраторам (основы)

Эта страница объясняет, как загрузить и установить PmWiki 2.1. Здесь дан список связанных с темой страниц:

Требования — Требования для установки PmWiki.
Обновление — Как обновить установленную PmWiki.
ВикиФермы — Запуск нескольких вики с одной установленной.
ChangeLog — Новые возможности и исправления ошибок, которые уже доступны.

Исправления в этих инструкциях всегда приветствуется. Сообщите о возникших у вас проблемах pmwiki-пользователям через mailing lists или воспользуйтесь PmWiki Issue Tracking System(Система Отслеживания Проблем PmWiki).

Установка PmWiki

1. Загрузка

Скачайте архив с последней версией PmWiki в формате zip (pmwiki-latest.zip) или gzipped tarball (pmwiki-latest.tgz) с http://www.pmwiki.org/pub/pmwiki/.

2. Распаковка

Распакуйте архив (tar zxvf pmwiki-latest.tgz или unzip pmwiki-latest.zip). Это создаст папку pmwiki-x.y.z с ПО PmWiki. Например, текущая "наипоследняя" версия распакуется в папку с именем pmwiki-2.3.16. В этой папке находится следующее:

    README.txt        Вводный документ
    pmwiki.php        Главный сценарий PmWiki
    local/            Сценарии с настройками (локальные файлы настроек)
    cookbook/         Рецепты (дополнения) из Рецептурника
    docs/             Обзорная документация, примеры сценариев настроек
    pub/              Файлы доступные публике
      css/            Дополнительные CSS файлы (списки стилей)
      skins/          Шаблоны вёрстки для индивидуального оформления
    scripts/          Подсценарии PmWiki
    wikilib.d/        Комплект изначальных страниц PmWiki

Папку pmwiki-x.y.z следует положить в место доступное вашему веб-серверу (например, в папку public_html или в подобную). Вы можете разместить файлы и папки пользуясь рядом методов — через FTP или командами Unix mv или cp, как правило используемыми для этого.

Примечание: Очевидно, папку "pmwiki-x.y.z" удобнее назвать "pmwiki".

3. Создание папок

В большинстве случаев PmWiki сделает это для вас. Откройте в браузере сценарий pmwiki.php находящийся на сервере (т.е. не на вашем компьютере или через file://...). PmWiki проверит конфигурацию вашей системы и предложит инструкции (при необходимости) для создания папки wiki.d/ используемой для хранения страниц созданных для вашего сайта.

Если создать не получилось, то есть ещё два способа:

3a. Вы можете создать папку wiki.d/ вручную и назначить ей полные права на запись ("chmod 777 wiki.d"). Используйте этот метод, когда PHP на сервере работает в "безопасном режиме".

3b. На некоторых системах можно позволить PmWiki сделать wiki.d/ самой, временно изменив права папки содержащей файл pmwiki.php на 2777. На Unix это обычно делается выбором папки содержащей pmwiki.php и выполнением команды

        chmod 2777 .

(обратите внимание на точку в конце). Команда chmod также работает во многих FTP-программах. Создание wiki.d/ в такой манере (1) сделает папку записываемой так, что веб-сервер может создать папки данных необходимых для wiki, (2) установит групповое владение папкой так, что пользователь установщик может управлять файлами сделанными в этой папке и (3) сделает затруднительным доступ к файлам wiki.d/ для других пользователей того же сервера.

После установки прав папки попробуйте открыть браузером сценарий pmwiki.php снова. Если все в порядке, то папка wiki.d будет создана и вы увидите домашнюю страницу вики.

Важно: Если вы воспользовались методом 3b, вы должны сбросить права, выполнив "chmod 755 ." в папке содержащей pmwiki.php.

4. Инициализация

Чтобы выяснить, что вам может потребоваться сделать перед началом настройки PmWiki, ознакомьтесь с текстами Начальная настройка и Release Notes.

5. Установка языка

Если вы захотите использовать PmWiki с другим языком, то скачайте языковой пакет в zip-архиве ((http://www.pmwiki.org/pub/pmwiki/i18n/i18n-all.zip) c http://www.pmwiki.org/pub/pmwiki/i18n/. Затем распакуйте файл.

В распакованном архиве есть две папки: scripts и wikilib.d. Скопируйте файлы из соответствующих папок в соответствующие папки PmWiki. Например, для русского языка файлы PmWikiRu.* и PmWiki.* должны лежать в одной папке.

Затем, разрешите локализацию — для загрузки выбранной страницы перевода добавьте одну инструкцию в сценарий local/config.php . В нашем случае — XLPage('ru','PmWikiRu.XLPage'); загружает страницу русского языка PmWikiRu.XLPage. (Файл нужно создать по образу и подобию, указанному в Начальная настройка)

Подробнее читайте Интернационализация.

Примечания

Дистрибутив PmWiki сознательно не включает файл index.php. Не стоит поддаваться искушению переименовать файл pmwiki.php в index.php. Если вы это сделаете, то во время обновления этот файл останется прежним. Вместо переименования добавьте "сценарий обёртку" index.php с единственной строчкой (закрывающий тэг " ?>" опущен сознательно):
<?php include_once('pmwiki.php');
Если при выполнении шага 2 для распаковки архива вы пользовались командой Unix tar, удостоверьтесь, что файлы созданы с достаточными правами для доступа к ним веб-сервера. Обычно, перед распаковкой tar файла, вы можете убедиться в этом, набрав в командной строке umask 002.
При установке на Windows для включения функции одновременного редактирования на данной платформе вам надо прочитать +.
Дополнительные подсказки можно найти на странице Troubleshooting.

<< Пароли | Документация | Начальная настройка >>

Перевод страницы PmWiki.Installation — Оригинал перевода PmWikiRu.Installation — Ссылаются
PmWikiRu.Installation: редакция от 25.03.2019 09:05
PmWiki.Installation: редакция от 22.07.2022 06:22

Содержание