worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка «Докувики» ======

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

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

«Системные» параметры DokuWiki можно задать в {{fa>gear?14&recache}} [[wiki:plugin:config|Configuration Manager]]. Вам нужно войти в систему как суперпользователь и нажать кнопку Admin, чтобы запустить ее. Значения «по умолчанию» системы считываются из файла ''conf/dokuwiki.php''. Чтобы настроить ее, вы можете внести изменения в Configuration Manager, который сохранит изменения в файле ''conf/local.php''. Либо вы можете отредактировать его самостоятельно или создать его, если он не существует. Чтобы узнать, что вы можете настроить в этом файле, см. список [[wiki:plugin:config#available_options|доступных параметров]] ниже.

Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в [[acl|users.auth.php и acl.auth.php]], которые можно найти в ''conf/'' каталоге. Их можно редактировать через {{fa>user-group?14&recache}} [[wiki:plugin:usermanager|Менеджер пользователей]] и {{fa>key?14&recache}} [[wiki:plugin:acl|Управление списком контроля доступа.]].

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

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

===== Обзор файлов конфигурации =====

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

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

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

^«Основной» файл     ^«Локальный» файл          ^Тип настроек              ^ Краткое описание   ^
|''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]]             | спамерские чёрные списки |
| ''plugins.required.php''     | ''plugins.local.php''\\ ''plugins.protected.php''  | see below             | Включение/отключение плагинов          |
| ''manifest.json''            | ''manifest.local.json''                            | [[devel:manifest]]    | PWA Манифест                           |
| ''lib/tpl/<tpl>/style.ini''  | ''conf/tpl/<tpl>/style.ini''                       | [[devel:style.ini]]   | Файлы стилей и переменные              |
|                    |''userscript.js''         |[[.:devel:javascript]]    | Пользовательские JavaScript-улучшения |
|                    |''userstyle.css''         |[[.:devel:css]]           | Пользовательские CSS-улучшения |

==== Файлы конфигурации темы ====

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

===== Включение/отключение плагинов =====

Установленные плагины включены по умолчанию. Их можно отключить с помощью [[plugin:extension|менеджера расширений]], который записывает данные в файл ''%%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'' вы можете изменить это порядок загрузки.

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

Большая часть возможностей [[dokuwiki|Докувики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[wiki:plugin:config|Менеджер конфигураций]]

Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле ''conf/dokuwiki.php''. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле ''conf/local.php'' --- это гарантирует сохранение внесённых изменений при обновлении «Докувики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены.

Пример файла ''conf/local.php'':

<code php>
<?php
$conf['title']     = "Admin's Wiki";
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';
</code>

Несколько замечаний относительно формата конфигурационного файла. Этот файл представляет собой фрагмент кода PHP, потому должен следовать синтаксису этого языка. В частности, каждая строка должна заканчиваться точкой с запятой. Переменные могут иметь следующие типы данных:

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

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

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

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

  * [[~:allowdebug]]
  * [[~:basedir]]
  * [[~:baseurl]]
  * [[~:cookiedir]]
  * [[~:dmode]]
  * [[~:fmode]]
  * [[~:lang]]
  * [[~:license]]
  * [[~:savedir]]
  * [[~:sidebar]]
  * [[~:startpage|start]]
  * [[~:tagline]]
  * [[~:template]]
  * [[~:title]]

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

  * [[~:breadcrumbs]]
  * [[~:camelcase]]
  * [[~:deaccent]]
  * [[~:dformat]]
  * [[~:fullpath]]
  * [[~:hidepages]]
  * [[~:maxseclevel]]
  * [[~:maxtoclevel]]
  * [[~:recent]]
  * [[~:recent_days]]
  * <del>[[~:refshow]]</del> ((Удалено в 2013г.))
  * [[~: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|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]]
  * <del>[[~:ftp|ftp (host, port, user, pass, root)]]</del> ((удалено в релизе 2020))
  * [[~:jquerycdn]]
  * [[~:proxy|proxy(host, port, user, pass, ssl)]]
  * <del>[[~:safemodehack]] ([[config:safemodehack|англ.]])</del> ((удалено в релизе 2020))
  * [[~:trustedproxy]]

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

  * [[~:defer_js]]
  * [[~:hidewarnings]]

====Дополнения и Файлы====
[[https://www.dokuwiki.org/config|Ссылка на оригинальную статью]]