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 schemes to be recognized as links
mediameta.php exif возможные метаданные для изображений
wordblock.conf wordblock.local.conf blacklist спамерские чёрные списки
userscript.js javascript Пользовательские JavaScript-улучшения
userstyle.css css Пользовательские CSS-улучшения

Параметры конфигурации

Большая часть возможностей ДокуВики настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через Менеджер конфигураций

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

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

Общие настройки

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

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

Антиспамовские настройки

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

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

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

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

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

ru/config.1380132578.txt.gz · Последнее изменение: 2013-09-25 20:09 — Aleksandr

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: 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