DokuWiki: 1. Инсталляция

Источник фото: pxhere.com

Начнем с инсталляции DokuWiki. На нее уйдет примерно 20 минут.

Страницы чек-листа соответствуют последовательности разработки сайта на DokuWiki. Читайте чек-лист страницу за страницей и выполняйте описанные на них действия. По завершении вы получите получите работоспособный DokuWiki сайт.

Дистрибутив

Зайти на сайт: https://www.dokuwiki.org/dokuwiki#

Нажать зеленую кнопку Download. Попадем на страницу: https://download.dokuwiki.org/

Видны три столбика. Слева направо:

Version

Выбрать «Stable (Recommended)», она обычно требует свежего PHP. Но если версия PHP старая, то выбрать «Old Stable».

Languages

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

Нажать Toggle All, чтобы снять выделение со всех языков (английский останется в любом случае).

Если в интерфейсе сайта будут использоваться другие языки, то выбрать их галочками. Например:

• de - Deutsch (Sie)
• es - Español
• fr - Français
• ru - Русский
• zh - 中文 [упрощенный китайский]

Позже в случае необходимости можно будет в DokuWiki добавить нужные языки интерфейса.

Popular Plugins

Плагины, обязательные для установки, отмечены ромбиком: ♦

Плагин без отметки ромбиком устанавливаются, если этого требует техзадание сайта.

CAPTCHA Plugin ♦. Ставить всегда.

Upgrade Plugin, проблематичный плагин. С одной стороны, он позволяет автоматически скачивать новые версии DokuWiki и ядра. С другой стороны, бывает нужно менять код в файлах DokuWiki - ядра, плагинов и тем. Тогда при новом автоматическом обновлении сайта Upgrade Plugin затрет все изменения. Варианты:

• если на сайте предполагаются активные правки ядра DokuWiki и модулей, то Upgrade Plugin не ставить. Поставить сайт лишь контроль новых версий DokuWiki и модулей. После получения извещения о появившемся обновление, обновите вручную, это просто.
• если заказчик оплачивает разработку бюджетного сайта без дальнейшей поддержки, то Upgrade Plugin надежнее поставить. Он будет хотя бы автоматически обновлять найденные дыры в DokuWiki и модулях.

Wrap Plugin ♦. Ставить всегда. Он позволяет дополнительную разметку для текста статей . Многочисленных цветные рамки, колонки или ваши собственные стили.

Translation Plugin. Ставить, если на сайте планируются страницы, существующие в версиях на разных языках. Если страницы сайта будут строго на русском или строго на английском, то плагин не нужен.

Video Share Plugin ♦. Ставить всегда. Вставляет видеоролики с Youtube или Vimeo.

Gallery Plugin ♦. Использовать всегда. Служит для встраивания изображений. Карусели, баннеры, с прокруткой… Им можно не пользоваться, но пускай стоит.

Скачивание

Внизу нажать кнопку «Start Download». Скачать в папку, где расположена локальная версия сайта. Распаковать DokuWiki из архива. Удалить архив.

.htaccess

В корне дистрибутива DokuWiki лежит файл .htaccess.dist . Удалите у него расширение . dist. Получится файл .htaccess .

При необходимости внесите в него 2 правки.

Перенаправление www

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

В файле htaccess первый и третий кусок кода идут друг за другом. Вставьте между ними второй, средний кусок:

...
## Uncomment these rules if you want to have nice URLs using</WRAP>
## $conf['userewrite'] = 1 - not needed for rewrite mode 2</WRAP>
#RewriteEngine on

 

# If your site can be accessed both with and without the 'www.' prefix, you
# can use one of the following settings to redirect users to your preferred//
# URL, either WITH or WITHOUT the 'www.' prefix. Choose ONLY one option:
#
# To redirect all users to access the site WITH the 'www.' prefix,
# (http://example.com/foo will be redirected to http://www.example.com/foo)
# uncomment the following: RewriteEngine on RewriteCond %{HTTP_HOST} . RewriteCond %{HTTP_HOST} !^www\. [NC] RewriteRule ^ http%{ENV:protossl}://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]//

 

#RewriteRule ^_media/(.*) lib/exe/fetch.php?media=$1 [QSA,L]
#RewriteRule ^_detail/(.*) lib/exe/detail.php?media=$1 [QSA,L]
#RewriteRule ^_export/([^/]+)/(.*) doku.php?do=export_$1&id=$2 [QSA,L] ...

Показ админки

Для корректного показа админки в htaccess раскомментируйте следующие строки (удалите значки «#» в начале строк):

#RewriteRule ^_media/(.*) lib/exe/fetch.php?media=$1 [QSA,L]
#RewriteRule ^_detail/(.*) lib/exe/detail.php?media=$1 [QSA,L]
#RewriteRule ^_export/([^/]+)/(.*) doku.php?do=export_$1&id=$2 [QSA,L]
#RewriteRule ^$ doku.php [L] #RewriteCond %{REQUEST_FILENAME} !-f
#RewriteCond %{REQUEST_FILENAME} !-d
#RewriteRule (.*) doku.php?id=$1 [QSA,L]
#RewriteRule ^index.php$ doku.php

Часовой пояс

Все страницы в DokuWiki будут сохраняться в часовом поясе сервера. Если сервер находится в другом часовом поясе от вашего, то поменяйте часовой пояс или в настройках php.ini или в файле DokuWiki:

https://www.dokuwiki.org/tips:timezone

Для изменения часового пояса в DokuWiki найдите в файле /inc/init.php строчки

// set timezone (as in pre 5.3.0 days)
date_default_timezone_set(@date_default_timezone_get());

Поменяйте на:

date_default_timezone_set('Europe/Moscow');

Сохраните файл init.php .

Поддерживаемые DokuWiki обозначения разных часовых поясов:

http://us.php.net/timezones

Загрузка

Требования

Для работы DokuWiki нужно:

• сервер с поддержкой PHP
• PHP 5.6+
• PHP GD или Image Magick, если нужно изменение размеров фотографий

install.php

Запустите файл /install.php

Выбор языка

Если нужен неанглийский язык интерфейса, то вверху слева указать нужный язык и нажать кнопку Update. После этого интерфейс перегрузится, все ранее введенные поля будут почищены. Язык интерфейса можно будет поменять также позже, во время настройки сайта.

Заполнение полей

Wiki Name: Example.com

Enable ACL (recommended): обязательно поставить «да». ACL обеспечивает поддержку разных прав. Без поддержки ACL на сайте будет единственное право, «администратор», и оно будет доступно всем посетителям.

Superuser: superuser [только латинские из набора ASCII, только маленькие, без пробелов]

Real name: Superuser

E-Mail: <E-mail>

Password: <укажите пароль>

once again: <повторите пароль>

Initial ACL policy:

• Open Wiki (read, write, upload for everyone) [Открытая вики]
• Public Wiki (read for everyone, write and upload for registered users) [Общедоступная вики]
• Closed Wiki (read, write, upload for registered users only) [Закрытая вики]

Нужно сразу выбрать правильную политику. Позже менять ее будет сложно. Если поставить Open Wiki, то могут будет много спама. Лучше поставить public Wiki. В случае необходимости вы сможете поменять политику доступа для отдельных статей и каталогов.

Allow users to register themselves: поставить «да», если планируется привлекать к созданию статей посетителей сайта. Но если создается корпоративное wiki, закрытое от посетителей, то поставьте «нет». Тогда сотрудников будет регистрировать Superuser или пользователь с правами администратора.

Please choose the license you want to put your content under:

• CC Attribution-Noncommercial-Share Alike 4.0 International

Оставить лицензию, предложенную по умолчанию (можно использовать материалы сайта в обмен на ссылку). Позже сможете поменять лицензию в настройках сайта.

Once a month, send anonymous usage data to the DokuWiki developers: согласиться. Статистика используется для оценки популярности модулей и тем дизайна.

Нажать кнопку Save

Должно прийти окно с надписью:

The configuration was finished successfully. You may delete the install.php file now. Continue to your new DokuWiki.

Повторная инсталляция

Возможно, инсталляция не удалась и скрипт вернул вас снова на тот же самый экран инсталляции. Или вы передумали и захотели указать другие параметры инсталляции.

После нажатия на кнопку Save программа DokuWiki добавила всего 2 файла:

/conf/plugins.local.php /data/index/page.idx

Удалите их. Это приведет DokuWiki к исходному виду до старта файла install.php. Вы сможете повторить инсталляцию.

Подчистка

В случае удачной установки удалите файл install.php

Возможно, вы используете FTP-синхронизацию с локальной версии сайта на версию на сервере. DokuWiki хранит изменяемые данные в папках:

• /conf ← настройки сайта и модулей
• /data ← информация о страницах
• /lib/plugins ← размещение модулей
• /lib/tpl ← темы дизайна

Разрешите синхронизацию этих папок в обеих направлениях.

---

Ссылки по DokuWiki

Введение в DowuWiki

Чек-лист для администратора «Установка DokuWiki на раз-два-три»:

• 1. Инсталляция <- Вы находитесь здесь
• 2. Управление дополнениями
• 3. Настройка вики
• Пользователи
• Страницы
• Обновление
• Плагин Bureaucracy для DocuWiki