DokuWiki: Обновление

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

DokuWiki очень просто обновить. Если, конечно, вы раньше не корректировали файлы ядра DokuWiki.

==Оглавление==

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

На обновление уходит примерно 10 минут.

Процесс обновления:

1. Нужно ли вообще менять версию DokuWiki?

Проверить журнал изменений:

https://www.dokuwiki.org/start?id=changes

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

Если вы решите, что обновить DokuWiki нужно, то перед обновлением DokuWiki сначала обновите все модули, которые будут работать с обновленной DokuWiki только в своих обновленных версиях. Для этого зайти на страницу «Управление дополнениями»:

/?id=start&do=admin&page=extension

в браузере нажать поиск CTRL+F, указать запрос на поиск: Обновление: доступна новая версия

Модули, нуждающиеся в обновлении, будут содержать желтую строку с этой фразой. Нажать у каждого из них кнопку «Обновить».

Другой способ, в строчке «Показать как:» убрать галочки с «включён» и «отключён». И поставить галочку на «обновление». Тогда будут показаны только модули, которые нуждаются в обновлении.

2. Создать резервную копию сайта

Сделайте полную резервную копию сайта. Или хотя бы сделайте резервную копию папок с пользовательскими данными:

/conf ← настройки сайта и модулей
/data ← информация о страницах

3. Скачать свежую версию DokuWiki

Зайти за свежей версией DokuWiki на страницу: https://download.dokuwiki.org/

Заполните три колонки:

выберите в левой колонке Version: Stable (Recommended) [по умолчанию]
в средней колонке Languages нажмите кнопку Toggle all. Затем выставить галочки на нужных языках. Если сайт англоязычный, то в средней колонке ничего не выставлять. Если забыли, какие языки интерфейса используются на сайте, то их список можно посмотреть, например, в папке: lib\plugins\authmysql\lang\
в правой колонке отметьте ранее установленные плагины. Обычно это CAPTCHA Plugin, Wrap Plugin, Translation Plugin (если для каждой страницы сайта поддерживаются версии на нескольких языках), Video Share Plugin, Gallery Plugin.

Внизу слева нажать кнопку «Start Download».

Распакуйте в папку на локальном компьютере. Удалите install.php.

Если ранее вносили какие-то правки в ядро DokuWiki или в основные модули, которые только что выбрали, то перенесите правки в дистрибутив.

4. Загрузить на сервер

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

5. Удаление ненужных файлов

Возьмите из свежей версии файл \data\deleted.files со списком ненужных файлов от предыдущей версии. (Для минорных изменений чаще всего этот список пуст).

Удалите на сервере файлы, которые более не используются, чтобы они не переходили с версии на версию.

6. Права доступа

Скорректируйте права доступа, если это необходимо. В том числе новые подкаталоги в папке data/.

7. htaccess

Сравните свой файл . htaccess с полученным свежим . htaccess.dist на предмет возможных изменений. Если нужно, поменяйте htaccess и загрузите обновленный файл на сервер.

8. Обновление плагинов и шаблонов

Обновите плагины (plugins) и шаблоны (template).

9. Перегрузка главной страницы

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

Если надпись о несоответствии версии еще показывается, можно подождать сутки, пока она исчезнет.

Если надпись раздражает, то:

или напрямую удалите ее из кэша, удалив файл data/cache/messages.txt
или временно отключите кэш путём правки conf/local.php (пересохраните конфигурацию). Через сутки опять включите кэш.

10. Обновление индекса

Возможно потребуется обновление индекса. См. утилиты командной строки. https://www.dokuwiki.org/ru:cli#indexerphp

Описанные действия безопасны, если вы всегда записываете изменения не в основной версии конфигурационного файла ( conf/dokuwiki.php ), а в локальной версии ( conf/local.php ). При обновлении «ДокуВики» в дистрибутиве нет файла conf/local.php и он при обновлении не затирается свежей версией conf/local.php. Если настраиваете сайт через страницу «Настройки вики» панели администратора, то все сделанные настройки всегда будут записаны в безопасный файл local.php.

11. Удаление лишних плагинов

Во время обновления вместе с дистрибутивом в DokuWiki загрузились заново предустановленные ненужные плагины:

Active Directory Auth Plugin Andreas Gohr
LDAP Auth Plugin Andreas Gohr
[DEPRECATED] MYSQL Auth Plugin Andreas Gohr
authpdo plugin Andreas Gohr
[DEPRECATED] PostgreSQL Auth Plugin Andreas Gohr

Удалить их через «Управление дополнениями» в панели администратора.

Ссылки по DokuWiki

Введение в DowuWiki

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

MaxReform.ru