DokuWiki

It's better when it's simple

Инструменты пользователя

Инструменты сайта


ru:config

Конфигурирование «Докувики»

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

Что можно настраивать в «Докувики»

«Системные» настройки «Докувики» можно найти в файле 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 smileys подстановки графических смайлов
acl.auth.php см. acl настройки листов доступа
users.auth.php см. acl имена пользователей и пароли
license.php license.local.php license перечень доступных лицензий
scheme.conf scheme.local.conf urlschemes ключевые слова URL-ссылок
mediameta.php exif возможные метаданные для изображений
wordblock.conf wordblock.local.conf blacklist спамерские чёрные списки
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.

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

  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» соответственно).
  • Массив: представляет собой набор из нескольких значений одного из указанных выше типов.

Доступные параметры

Основные настройки

Настройки отображения

Настройки аутентификации

Настройки блокировки спама

Настройки редактирования

Настройки ссылок

Настройки для медиафайлов

Настройки уведомлений

Настройки подписки

Расширенные настройки

Настройки сети

Флаги функций

1)
Удалено в 2013г.
2) , 3)
удалено в релизе 2020
ru/config.txt · Последнее изменение: 2023-04-09 12:49 — 87.225.118.53

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki