====== Конфигурирование «Докувики» ====== Большая часть возможностей «[[dokuwiki|Докувики]]» настраивается с помощью соответствующих параметров конфигурации. Самым простым способом изменения этих параметров является использование [[.:plugin:config|менеджера конфигурации]]. ===== Что можно настраивать в «Докувики» ===== «Системные» настройки «Докувики» можно найти в файле ''conf/dokuwiki.php''. Однако, он содержит значения настроек системы по умолчанию. Для подстройки их «под себя» вам следует редактировать файл ''conf/local.php'' или создать его, если он не существовал. Что вообще можно настраивать, смотрите ниже в списке [[#доступные параметры]]. Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в [[acl|users.auth.php и acl.auth.php]]. Когда вы загружаете на сервер новый файл с помощью [[media_manager|медиаменеджера]], вы можете столкнуться с сообщением ''«Upload denied. This file extension is forbidden!»''. Это вызвано содержимым файла ''conf/mime.conf''. Для загрузки файла нового типа, укажите этот тип в [[mime|mime.conf]]. При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] и [[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]] | спамерские чёрные списки | | |''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|Докувики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[ru:plugin:config|Менеджер конфигураций]] Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле ''conf/dokuwiki.php''. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле ''conf/local.php'' --- это гарантирует сохранение внесённых изменений при обновлении «Докувики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены. Пример файла ''conf/local.php'': Несколько замечаний относительно формата конфигурационного файла. Этот файл представляет собой фрагмент кода 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]] * [[~:refshow]] ((Удалено в 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]] * [[~:ftp|ftp (host, port, user, pass, root)]] ((удалено в релизе 2020)) * [[~:jquerycdn]] * [[~:proxy|proxy(host, port, user, pass, ssl)]] * [[~:safemodehack]] ([[config:safemodehack|англ.]]) ((удалено в релизе 2020)) * [[~:trustedproxy]] ====Флаги функций==== * [[~:defer_js]] * [[~:hidewarnings]]