worldwide open-source software

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

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

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

«Системные» настройки «Докувики» можно найти в файле ''conf/dokuwiki.php''. Однако, он содержит значения настроек системы по умолчанию. Для подстройки их «под себя» вам следует редактировать файл ''conf/local.php'' или создать его, если он не существовал. Что вообще можно настраивать, смотрите ниже в списке [[#доступные параметры]].

Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в [[wiki:acl|users.auth.php и acl.auth.php]].

Когда вы загружаете на сервер новый файл с помощью [[wiki:plugin:media_manager|медиа менеджера]], вы можете столкнуться с сообщением ''«Upload denied. This file extension is forbidden!»''. Это вызвано содержимым файла ''conf/mime.conf''. Для загрузки файла нового типа, укажите этот тип в [[wiki:mime|mime.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''   |[[wiki:abbreviations]]         | автоматические подсказки аббревиатур |
|''entities.conf''   |''entities.local.conf''   |[[wiki:entities]]              | автоматические подстановки текста  |
|''interwiki.conf''  |''interwiki.local.conf''  |[[wiki:interwiki]]             | сокращения ссылок интервики  |
|''mime.conf''       |''mime.local.conf''       |[[wiki:mime]]                  | настройки mime-типов для загрузки на сервер |
|''smileys.conf''    |''smileys.local.conf''    |[[wiki:smileys]]               | подстановки графических смайлов |
|                    |''acl.auth.php''          |см. [[acl]]               | настройки листов доступа |
|                    |''users.auth.php''        |см. [[acl]]               | имена пользователей и пароли |
|''license.php''     |''license.local.php''     |[[wiki:config:license]]      | перечень доступных лицензий |
|''scheme.conf''     |''scheme.local.conf''     |[[wiki:urlschemes]]            | ключевые слова URL-ссылок |
|''mediameta.php''   |                          |[[wiki:exif]]                  | возможные метаданные для изображений |
|''wordblock.conf''  |''wordblock.local.conf''  |[[wiki:blacklist]]             | спамерские чёрные списки |
|                    |''userscript.js''         |[[wiki:devel:javascript]]    | Пользовательские JavaScript-улучшения |
|                    |''userstyle.css''         |[[wiki:devel:css]]           | Пользовательские CSS-улучшения |

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

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

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

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

==== Общие настройки ====
https://www.dokuwiki.org/wiki:config
  * [[wiki:config:allowdebug]]
  * [[wiki:config:basedir]]
  * [[wiki:config:baseurl]]
  * [[wiki:config:dmode]]
  * [[wiki:config:fmode]]
  * [[wiki:config:lang]]
  * [[wiki:config:license]]
  * [[wiki:config:savedir]]
  * [[wiki:config:startpage|start]]
  * [[wiki:config:template]]
  * [[wiki:config:title]]
  * [[wiki:config:allowdebug]]
  * [[wiki:config:basedir]]
  * [[wiki:config:baseurl]]
  * [[wiki:config:cookiedir]]
  * [[wiki:config:dmode]]
  * [[wiki:config:fmode]]
  * [[wiki:config:lang]]
  * [[wiki:config:license]]
  * [[wiki:config:savedir]]
  * [[wiki:config:sidebar]]
  * [[wiki:config:startpage|start]]
  * [[wiki:config:tagline]]
  * [[wiki:config:template]]
  * [[wiki:config:title]]
==== Настройки отображения ====

  * [[.:config:breadcrumbs]]
  * [[.:config:camelcase]]
  * [[.:config:deaccent]]
  * [[.:config:dformat]]
  * [[.:config:fullpath]]
  * [[.:config:maxseclevel]]
  * [[.:config:maxtoclevel]]
  * [[.:config:recent]]
  * [[.:config:refcheck]]
  * [[.:config:refshow]]
  * [[.:config:showuseras]]
  * [[.:config:signature]]
  * [[.:config:tocminheads]]
  * [[.:config:toptoclevel]]
  * [[.:config:typography]]
  * [[.:config:useheading]]
  * [[.:config:youarehere]]

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

  * [[.:config:auth_security_timeout]]
  * [[.:config:authtype]]
  * [[.:config:autopasswd]]
  * [[.:config:defaultgroup]]
  * [[.:config:disableactions]]
  * [[.:config:manager]]
  * [[.:config:passcrypt]]
  * [[.:config:profileconfirm]]
  * [[.:config:registernotify]]
  * [[.:config:rememberme]]
  * [[.:config:securecookie]]
  * [[.:config:sneaky_index]]
  * [[.:config:superuser]]
  * [[.:config:useacl]]

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

  * [[.:config:iexssprotect]]
  * [[.:config:indexdelay]]
  * [[.:config:mailguard]]
  * [[.:config:relnofollow]]
  * [[.:config:usewordblock]]

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

  * [[.:config:cachetime]]
  * [[.:config:htmlok]]
  * [[.:config:locktime]]
  * [[.:config:notify]]
  * [[.:config:phpok]]
  * [[.:config:subscribers]]
  * [[.:config:usedraft]]

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

  * [[.:config:target|target (wiki, interwiki, extern, media, windows)]]

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

  * [[.:config:fetchsize]]
  * [[.:config:gdlib]]
  * [[.:config:im_convert]]
  * [[.:config:jpg_quality]]

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

  * [[.:config:autoplural]]
  * [[.:config:broken_iua]]
  * [[.:config:canonical]]
  * [[.:config:compress]]
  * [[.:config:compression]]
  * [[.:config:fnencode]] ([[config:fnencode|англ.]])
  * [[.:config:gzip_output]]
  * [[.:config:hidepages]]
  * [[.:config:mailfrom]]
  * [[.:config:readdircache]] ([[config:readdircache|англ.]])
  * [[.:config:recent_days]]
  * [[.:config:renderer_xhtml]]
  * [[.:config:rss_content]]
  * [[.:config:rss_linkto]]
  * [[.:config:rss_show_summary]]
  * [[.:config:rss_type]]
  * [[.:config:rss_update]]
  * [[.:config:send404]]
  * [[.:config:sepchar]]
  * [[.:config:sitemap]]
  * [[.:config:updatecheck]]
  * [[.:config:userewrite]]
  * [[.:config:useslash]]
  * [[.:config:remote]]
  * [[.:config:remoteuser]]
  * [[.:config:xsendfile]]

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

  * [[.:config:ftp|ftp (host, port, user, pass, root)]]
  * [[.:config:proxy|proxy (host, port, user, pass, ssl)]]
  * [[.:config:safemodehack]] ([[config:safemodehack|англ.]])