Большая часть возможностей «Докувики» настраивается с помощью соответствующих параметров конфигурации. Самым простым способом изменения этих параметров является использование менеджера конфигурации.
«Системные» настройки «Докувики» можно найти в файле conf/dokuwiki.php
. Однако, он содержит значения настроек системы по умолчанию. Для подстройки их «под себя» вам следует редактировать файл conf/local.php
или создать его, если он не существовал. Что вообще можно настраивать, смотрите ниже в списке доступные параметры.
Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в users.auth.php и acl.auth.php.
Когда вы загружаете на сервер новый файл с помощью медиаменеджера, вы можете столкнуться с сообщением «Upload denied. This file extension is forbidden!»
. Это вызвано содержимым файла conf/mime.conf
. Для загрузки файла нового типа, укажите этот тип в mime.conf.
При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах acronyms.conf, smileys.conf и entities.conf.
Все файлы конфигурации хранятся в директории ./conf
или в /etc/dokuwiki
при установке из Debian-пакета.
«Основные» файлы обычно поставляются вместе с «Докувики», в то время как «локальные» файлы обычно создаются администратором вики.
Если какие-то настройки позволено сделать в локальном файле, то лучше сделать именно там, а не в основном файле. Это позволит избежать проблем при обновлении, т. к. основные файлы при нём меняются, а локальные — нет.
«Основной» файл | «Локальный» файл | Тип настроек | Краткое описание |
---|---|---|---|
dokuwiki.php | local.php local.protected.php | см. ниже | основные настройки вики |
acronyms.conf | acronyms.local.conf | abbreviations | автоматические подсказки аббревиатур |
entities.conf | entities.local.conf | entities | автоматические подстановки текста |
interwiki.conf | interwiki.local.conf | interwiki | сокращения ссылок интервики |
mime.conf | mime.local.conf | Конфигурация MIME | настройки mime-типов для загрузки на сервер |
smileys.conf | smileys.local.conf | Смайлики | подстановки графических смайлов |
acl.auth.php | см. Контроль доступа с помощью списков доступа (ACL) | настройки листов доступа | |
users.auth.php | см. Контроль доступа с помощью списков доступа (ACL) | имена пользователей и пароли | |
license.php | license.local.php | Настройки: лицензия | перечень доступных лицензий |
scheme.conf | scheme.local.conf | urlschemes | ключевые слова URL-ссылок |
mediameta.php | exif | возможные метаданные для изображений | |
wordblock.conf | wordblock.local.conf | Чёрный список | спамерские чёрные списки |
userscript.js | JavaScript | Пользовательские JavaScript-улучшения | |
userstyle.css | css | Пользовательские CSS-улучшения |
Дополнительные конфигурационные файлы находятся в /var/lib/dokuwiki/lib/tpl/dokuwiki
(Debian), например style.ini. Style.ini
– это текстовый файл, который считывается темой по умолчанию, и пользователь может настроить, например, цвет фона.
Установленные плагины включены по умолчанию. Их можно отключить с помощью менеджера расширений, который записывает данные в файл plugin.local.php
. Вы можете защитить определенные плагины, разместив их в conf/plugins.protected.php
.
По умолчанию Докувики загружает свои конфигурационные файлы в следующем порядке:
conf/plugins.php
– плагины по умолчанию;conf/plugins.local.php
– изменено менеджером расширений;conf/plugins.required.php
– основные плагины. Не могут управляться менеджером расширений;conf/plugins.protected.php
– переопределяет настройки в других файлах;
Порядок загрузки файлов конфигурации контролируется глобальной переменной $config_cascade
. Используя файл preload.php
вы можете изменить это порядок загрузки.
Большая часть возможностей Докувики настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через Менеджер конфигураций
Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле conf/dokuwiki.php
. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле conf/local.php
— это гарантирует сохранение внесённых изменений при обновлении «Докувики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены.
Пример файла conf/local.php
:
<?php $conf['title'] = "Admin's Wiki"; $conf['useacl'] = 1; $conf['superuser'] = 'admin';
Несколько замечаний относительно формата конфигурационного файла. Этот файл представляет собой фрагмент кода PHP, потому должен следовать синтаксису этого языка. В частности, каждая строка должна заканчиваться точкой с запятой. Переменные могут иметь следующие типы данных:
Подразделы: антиспам, аутентификация, медиафайлы, основные, отображение, расширенные настройки, редактирование, сеть, ссылки.