====== Конфигурирование «Докувики» ====== Большая часть возможностей «[[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'': Несколько замечаний относительно формата конфигурационного файла. Этот файл представляет собой фрагмент кода 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|англ.]])