| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| wiki:config [2023/08/19 00:13] – [Общие настройки] vladpolskiy | wiki:config [2025/01/16 16:25] (текущий) – [Флаги функций] vladpolskiy |
|---|
| ====== Конфигурирование «Докувики» ====== | ====== Настройка «Докувики» ====== |
| |
| Большая часть возможностей «[[dokuwiki|Докувики]]» настраивается с помощью соответствующих параметров | «[[dokuwiki|Докувики]]» можно настроить в зависимости от ваших потребностей с помощью «системных» опций, конфигурационных файлов для настройки поведения, оформления темы и отключения/включения расширений. Самым простым способом изменения этих параметров является использование [[.:plugin:config|менеджера конфигурации]]. |
| конфигурации. Самым простым способом изменения этих параметров является использование [[.:plugin:config|менеджера конфигурации]]. | |
| |
| ===== Что можно настраивать в «Докувики» ===== | ===== Что можно настраивать в «Докувики» ===== |
| |
| «Системные» настройки «Докувики» можно найти в файле ''conf/dokuwiki.php''. Однако, он содержит значения настроек системы по умолчанию. Для подстройки их «под себя» вам следует редактировать файл ''conf/local.php'' или создать его, если он не существовал. Что вообще можно настраивать, смотрите ниже в списке [[#доступные параметры]]. | «Системные» параметры 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]]. | Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в [[acl|users.auth.php и acl.auth.php]], которые можно найти в ''conf/'' каталоге. Их можно редактировать через {{fa>user-group?14&recache}} [[wiki:plugin:usermanager|Менеджер пользователей]] и {{fa>key?14&recache}} [[wiki:plugin:acl|Управление списком контроля доступа.]]. |
| |
| Когда вы загружаете на сервер новый файл с помощью [[media_manager|медиаменеджера]], вы можете столкнуться с сообщением ''«Upload denied. This file extension is forbidden!»''. Это вызвано содержимым файла ''conf/mime.conf''. Для загрузки файла нового типа, укажите этот тип в [[mime|mime.conf]]. | Когда вы загружаете на сервер новый файл с помощью [[wiki:ullscreen_mediamanager|медиаменеджера]], вы можете столкнуться с сообщением ''«Upload denied. This file extension is forbidden!»''. Это вызвано содержимым файла ''conf/mime.conf''. Для загрузки файла нового типа, укажите этот тип в [[wiki:mime|mime.local.conf]]. |
| |
| При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] и [[entities|entities.conf]]. | При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах [[wiki:abbreviations|acronyms.conf]], [[wiki:smileys|smileys.conf]] и [[wiki:entities|entities.conf]]. |
| |
| ===== Обзор файлов конфигурации ===== | ===== Обзор файлов конфигурации ===== |
| Все файлы конфигурации хранятся в директории ''./conf'' или в ''/etc/dokuwiki'' при установке из Debian-пакета. | Все файлы конфигурации хранятся в директории ''./conf'' или в ''/etc/dokuwiki'' при установке из Debian-пакета. |
| |
| «Основные» файлы обычно поставляются вместе с «ДокуВики», в то время как «локальные» файлы обычно создаются администратором вики. | «Основные» файлы обычно поставляются вместе с «Докувики», в то время как «локальные» файлы обычно создаются администратором вики. |
| |
| Если какие-то настройки позволено сделать в локальном файле, то лучше сделать именно там, а не в основном файле. Это позволит избежать проблем при [[.:install:upgrade|обновлении]], т. к. основные файлы при нём меняются, а локальные --- нет. | Если какие-то настройки позволено сделать в локальном файле, то лучше сделать именно там, а не в основном файле. Это позволит избежать проблем при [[.:install:upgrade|обновлении]], т. к. основные файлы при нём меняются, а локальные --- нет. |
| | |''acl.auth.php'' |см. [[acl]] | настройки листов доступа | | | |''acl.auth.php'' |см. [[acl]] | настройки листов доступа | |
| | |''users.auth.php'' |см. [[acl]] | имена пользователей и пароли | | | |''users.auth.php'' |см. [[acl]] | имена пользователей и пароли | |
| |''license.php'' |''license.local.php'' |[[.:config:license]] | перечень доступных лицензий | | |''license.php'' |''license.local.php'' |[[~:license]] | перечень доступных лицензий | |
| |''scheme.conf'' |''scheme.local.conf'' |[[urlschemes]] | ключевые слова URL-ссылок | | |''scheme.conf'' |''scheme.local.conf'' |[[urlschemes]] | ключевые слова URL-ссылок | |
| |''mediameta.php'' | |[[exif]] | возможные метаданные для изображений | | |''mediameta.php'' | |[[exif]] | возможные метаданные для изображений | |
| |''wordblock.conf'' |''wordblock.local.conf'' |[[blacklist]] | спамерские чёрные списки | | |''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-улучшения | | | |''userscript.js'' |[[.:devel:javascript]] | Пользовательские JavaScript-улучшения | |
| | |''userstyle.css'' |[[.:devel:css]] | Пользовательские CSS-улучшения | | | |''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'' вы можете изменить это порядок загрузки. |
| |
| ===== Параметры конфигурации ===== | ===== Параметры конфигурации ===== |
| |
| Большая часть возможностей [[ru:dokuwiki|ДокуВики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[ru:plugin:config|Менеджер конфигураций]] | Большая часть возможностей [[dokuwiki|Докувики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[wiki:plugin:config|Менеджер конфигураций]] |
| |
| Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле ''conf/dokuwiki.php''. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле ''conf/local.php'' --- это гарантирует сохранение внесённых изменений при обновлении «ДокуВики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены. | Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле ''conf/dokuwiki.php''. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле ''conf/local.php'' --- это гарантирует сохранение внесённых изменений при обновлении «Докувики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены. |
| |
| Пример файла ''conf/local.php'': | Пример файла ''conf/local.php'': |
| |
| Подразделы: | Подразделы: |
| [[#Антиспамовские настройки|антиспам]], | [[#Настройки блокировки спама|антиспам]], |
| [[#Настройки аутентификации|аутентификация]], | [[#Настройки аутентификации|аутентификация]], |
| [[#Настройки для медиафайлов|медиафайлы]], | [[#Настройки для медиафайлов|медиафайлы]], |
| [[#Общие настройки|общие]], | [[#Основные настройки|основные]], |
| [[#Настройки отображения|отображение]], | [[#Настройки отображения|отображение]], |
| [[#расширенные настройки]], | [[#расширенные настройки]], |
| [[#Настройки ссылок|ссылки]]. | [[#Настройки ссылок|ссылки]]. |
| |
| ==== Общие настройки ==== | ==== Основные настройки ==== |
| |
| * [[.:config:allowdebug]] | |
| * [[.:config:basedir]] | |
| * [[.:config:baseurl]] | |
| * [[.:config:dmode]] | |
| * [[.:config:fmode]] | |
| * [[.:config:lang]] | |
| * [[.:config:license]] | |
| * [[.:config:savedir]] | |
| * [[.:config:startpage|start]] | |
| * [[.:config:template]] | |
| * [[.:config:title]] | |
| * [[~:allowdebug]] | * [[~:allowdebug]] |
| * [[~:basedir]] | * [[~:basedir]] |
| * [[~:template]] | * [[~:template]] |
| * [[~:title]] | * [[~:title]] |
| | |
| ==== Настройки отображения ==== | ==== Настройки отображения ==== |
| |
| * [[.:config:breadcrumbs]] | * [[~:breadcrumbs]] |
| * [[.:config:camelcase]] | * [[~:camelcase]] |
| * [[.:config:deaccent]] | * [[~:deaccent]] |
| * [[.:config:dformat]] | * [[~:dformat]] |
| * [[.:config:fullpath]] | * [[~:fullpath]] |
| * [[.:config:maxseclevel]] | * [[~:hidepages]] |
| * [[.:config:maxtoclevel]] | * [[~:maxseclevel]] |
| * [[.:config:recent]] | * [[~:maxtoclevel]] |
| * [[.:config:refcheck]] | * [[~:recent]] |
| * [[.:config:refshow]] | * [[~:recent_days]] |
| * [[.:config:showuseras]] | * <del>[[~:refshow]]</del> ((Удалено в 2013г.)) |
| * [[.:config:signature]] | * [[~:showuseras]] |
| * [[.:config:tocminheads]] | * [[~:signature]] |
| * [[.:config:toptoclevel]] | * [[~:sneaky_index]] |
| * [[.:config:typography]] | * [[~:tocminheads]] |
| * [[.:config:useheading]] | * [[~:toptoclevel]] |
| * [[.:config:youarehere]] | * [[~:typography]] |
| | * [[~:useheading]] |
| | * [[~:youarehere]] |
| |
| ==== Настройки аутентификации ==== | ==== Настройки аутентификации ==== |
| |
| * [[.:config:auth_security_timeout]] | * [[~:auth_security_timeout]] |
| * [[.:config:authtype]] | * [[~:authtype]] |
| * [[.:config:autopasswd]] | * [[~:autopasswd]] |
| * [[.:config:defaultgroup]] | * [[~:defaultgroup]] |
| * [[.:config:disableactions]] | * [[~:disableactions]] |
| * [[.:config:manager]] | * [[~:manager]] |
| * [[.:config:passcrypt]] | * [[~:passcrypt]] |
| * [[.:config:profileconfirm]] | * [[~:profileconfirm]] |
| * [[.:config:registernotify]] | * [[~:rememberme]] |
| * [[.:config:rememberme]] | * [[~:remote]] |
| * [[.:config:securecookie]] | * [[~:remoteuser]] |
| * [[.:config:sneaky_index]] | * [[~:remotecors]] |
| * [[.:config:superuser]] | * [[~:securecookie]] |
| * [[.:config:useacl]] | * [[~:superuser]] |
| | * [[~:useacl]] |
| |
| ==== Антиспамовские настройки ==== | ==== Настройки блокировки спама ==== |
| |
| * [[.:config:iexssprotect]] | * [[~:iexssprotect]] |
| * [[.:config:indexdelay]] | * [[~:indexdelay]] |
| * [[.:config:mailguard]] | * [[~:mailguard]] |
| * [[.:config:relnofollow]] | * [[~:relnofollow]] |
| * [[.:config:usewordblock]] | * [[~:usewordblock]] |
| |
| ==== Настройки редактирования ==== | ==== Настройки редактирования ==== |
| |
| * [[.:config:cachetime]] | * [[~:cachetime]] |
| * [[.:config:htmlok]] | * [[~:htmlok]] |
| * [[.:config:locktime]] | * [[~:locktime]] |
| * [[.:config:notify]] | * [[~:phpok]] |
| * [[.:config:phpok]] | * [[~:subscribers]] |
| * [[.:config:subscribers]] | * [[~:usedraft]] |
| * [[.:config:usedraft]] | |
| |
| ==== Настройки ссылок ==== | ==== Настройки ссылок ==== |
| |
| * [[.:config:target|target (wiki, interwiki, extern, media, windows)]] | * [[~:target|target(wiki, interwiki, extern, media, windows)]] |
| |
| ==== Настройки для медиафайлов ==== | ==== Настройки для медиафайлов ==== |
| |
| * [[.:config:fetchsize]] | * [[~:fetchsize]] |
| * [[.:config:gdlib]] | * [[~:gdlib]] |
| * [[.:config:im_convert]] | * [[~:im_convert]] |
| * [[.:config:jpg_quality]] | * [[~: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]] |
| |
| ==== Расширенные настройки ==== | ==== Расширенные настройки ==== |
| |
| * [[.:config:autoplural]] | * [[~:autoplural]] |
| * [[.:config:broken_iua]] | * [[~:broken_iua]] |
| * [[.:config:canonical]] | * [[~:canonical]] |
| * [[.:config:compress]] | * [[~:compress]] |
| * [[.:config:compression]] | * [[~:compression]] |
| * [[.:config:fnencode]] ([[config:fnencode|англ.]]) | * [[~:cssdatauri]] |
| * [[.:config:gzip_output]] | * [[~:fnencode]] |
| * [[.:config:hidepages]] | * [[~:gzip_output]] |
| * [[.:config:mailfrom]] | * [[~:readdircache]] |
| * [[.:config:readdircache]] ([[config:readdircache|англ.]]) | * [[~:renderer_xhtml]] |
| * [[.:config:recent_days]] | * [[~:send404]] |
| * [[.:config:renderer_xhtml]] | * [[~:sepchar]] |
| * [[.:config:rss_content]] | * [[~:updatecheck]] |
| * [[.:config:rss_linkto]] | * [[~:userewrite]] |
| * [[.:config:rss_show_summary]] | * [[~:useslash]] |
| * [[.:config:rss_type]] | * [[~:search_fragment]] |
| * [[.:config:rss_update]] | * [[~:search_nslimit]] |
| * [[.:config:send404]] | * [[~:xsendfile]] |
| * [[.:config:sepchar]] | |
| * [[.:config:sitemap]] | |
| * [[.:config:updatecheck]] | |
| * [[.:config:userewrite]] | |
| * [[.:config:useslash]] | |
| * [[.:config:remote]] | |
| * [[.:config:remoteuser]] | |
| * [[.:config:xsendfile]] | |
| |
| ==== Настройки сети ==== | ==== Настройки сети ==== |
| |
| * [[.:config:ftp|ftp (host, port, user, pass, root)]] | * [[~:dnslookups]] |
| * [[.:config:proxy|proxy (host, port, user, pass, ssl)]] | * <del>[[~:ftp|ftp (host, port, user, pass, root)]]</del> ((удалено в релизе 2020)) |
| * [[.:config:safemodehack]] ([[config:safemodehack|англ.]]) | * [[~:jquerycdn]] |
| | * [[~:proxy|proxy(host, port, user, pass, ssl)]] |
| | * <del>[[~:safemodehack]] ([[config:safemodehack|англ.]])</del> ((удалено в релизе 2020)) |
| | * [[~:trustedproxy]] |
| | |
| | ====Флаги функций==== |
| | |
| | * [[~:defer_js]] |
| | * [[~:hidewarnings]] |
| | |
| | ====Дополнения и Файлы==== |
| | [[https://www.dokuwiki.org/config|Ссылка на оригинальную статью]] |
| |
