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

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

  • Показать исходный текст
  • История страницы
  • Ссылки сюда
  • Оставить на чай
  • Экспорт в PDF
  • Наверх

  • wiki: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 Смайлики подстановки графических смайлов
    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.

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

    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

    Обсуждение

    Ваш комментарий:

    Внимание! Оставляя комментарий Вы соглашаетесь с пониманием и несете ответственность за свои действия гл.2 ст.18 Федерального закона №38-ФЗ «О рекламе» и ст.3 п.1 Федерального закона №152-ФЗ «О персональных данных»
    181 -8 = 
     
    wiki/config.txt · Последнее изменение: 2023/08/27 00:33 — vladpolskiy