«Докувики» можно настроить в зависимости от ваших потребностей с помощью «системных» опций, конфигурационных файлов для настройки поведения, оформления темы и отключения/включения расширений. Самым простым способом изменения этих параметров является использование менеджера конфигурации.

«Системные» параметры DokuWiki можно задать в Configuration Manager. Вам нужно войти в систему как суперпользователь и нажать кнопку Admin, чтобы запустить ее. Значения «по умолчанию» системы считываются из файла conf/dokuwiki.php. Чтобы настроить ее, вы можете внести изменения в Configuration Manager, который сохранит изменения в файле conf/local.php. Либо вы можете отредактировать его самостоятельно или создать его, если он не существует. Чтобы узнать, что вы можете настроить в этом файле, см. список доступных параметров ниже.

Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в users.auth.php и acl.auth.php, которые можно найти в conf/ каталоге. Их можно редактировать через Менеджер пользователей и Управление списком контроля доступа..

Когда вы загружаете на сервер новый файл с помощью медиаменеджера, вы можете столкнуться с сообщением «Upload denied. This file extension is forbidden!». Это вызвано содержимым файла conf/mime.conf. Для загрузки файла нового типа, укажите этот тип в mime.local.conf.

При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах acronyms.conf, smileys.conf и entities.conf.

Все файлы конфигурации хранятся в директории ./conf или в /etc/dokuwiki при установке из Debian-пакета.

«Основные» файлы обычно поставляются вместе с «Докувики», в то время как «локальные» файлы обычно создаются администратором вики.

Если какие-то настройки позволено сделать в локальном файле, то лучше сделать именно там, а не в основном файле. Это позволит избежать проблем при обновлении, т. к. основные файлы при нём меняются, а локальные — нет.

Дополнительные конфигурационные файлы находятся в /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), например style.ini. Style.ini – это текстовый файл, который считывается темой по умолчанию, и пользователь может настроить, например, цвет фона.

Установленные плагины включены по умолчанию. Их можно отключить с помощью менеджера расширений, который записывает данные в файл plugin.local.php. Вы можете защитить определенные плагины, разместив их в conf/plugins.protected.php.

По умолчанию Докувики загружает свои конфигурационные файлы в следующем порядке:

1. conf/plugins.php – плагины по умолчанию;
2. conf/plugins.local.php – изменено менеджером расширений;
3. conf/plugins.required.php – основные плагины. Не могут управляться менеджером расширений;
4. 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, потому должен следовать синтаксису этого языка. В частности, каждая строка должна заканчиваться точкой с запятой. Переменные могут иметь следующие типы данных:

• Числовой: значения записываются как есть. Пример: 9.
• Строковый: строки заключаются в одинарные или двойные кавычки. Например, 'foo bar'.
• Логический: допустимы значения «true» (истина) или «false» (ложь) («1» и «0» соответственно).
• Массив: представляет собой набор из нескольких значений одного из указанных выше типов.

Подразделы: антиспам, аутентификация, медиафайлы, основные, отображение, расширенные настройки, редактирование, сеть, ссылки.

• allowdebug
• basedir
• baseurl
• cookiedir
• dmode
• fmode
• lang
• license
• savedir
• sidebar
• start
• tagline
• template
• title

• breadcrumbs
• camelcase
• deaccent
• dformat
• fullpath
• hidepages
• maxseclevel
• maxtoclevel
• recent
• recent_days
• refshow ¹²⁾
• showuseras
• signature
• sneaky_index
• tocminheads
• toptoclevel
• typography
• useheading
• youarehere

• auth_security_timeout
• authtype
• autopasswd
• defaultgroup
• disableactions
• manager
• passcrypt
• profileconfirm
• rememberme
• remote
• remoteuser
• remotecors
• securecookie
• superuser
• useacl

• iexssprotect
• indexdelay
• mailguard
• relnofollow
• usewordblock

• cachetime
• htmlok
• locktime
• phpok
• subscribers
• usedraft

• target(wiki, interwiki, extern, media, windows)

• fetchsize
• gdlib
• im_convert
• jpg_quality
• mediarevisions
• refcheck

• dontlog
• htmlmail
• mailfrom
• mailprefix
• mailreturnpath
• notify
• registernotify
• subscribers
• subscribe_time

• sitemap
• rss_type
• rss_linkto
• rss_content
• rss_media
• rss_update
• rss_show_summary
• rss_show_deleted

• autoplural
• broken_iua
• canonical
• compress
• compression
• cssdatauri
• fnencode
• gzip_output
• readdircache
• renderer_xhtml
• send404
• sepchar
• updatecheck
• userewrite
• useslash
• search_fragment
• search_nslimit
• xsendfile

• dnslookups
• ftp (host, port, user, pass, root) ¹³⁾
• jquerycdn
• proxy(host, port, user, pass, ssl)
• safemodehack (англ.) ¹⁴⁾
• trustedproxy

• defer_js
• hidewarnings

Ссылка на оригинальную статью