| |
| config [2023/08/19 01:48] – создано vladpolskiy | config [Дата неизвестна] (текущий) – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1 |
|---|
| ====== Конфигурирование «Докувики» ====== | |
| |
| Большая часть возможностей «[[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'' |[[.:config: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-улучшения | | |
| |
| ===== Параметры конфигурации ===== | |
| |
| Большая часть возможностей [[ru:dokuwiki|ДокуВики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[ru: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/ru:config | |
| * [[.:config:allowdebug]] | |
| * [[.:config:basedir]] | |
| * [[.:config:baseurl]] | |
| * [[.:config:dmode]] | |
| * [[.:config:fmode]] | |
| * [[.:config:lang]] | |
| * [[.:config:license]] | |
| * [[.:config:savedir]] | |
| * [[.:config:startpage|start]] | |
| * [[.:config:template]] | |
| * [[.:config:title]] | |
| * [[~:allowdebug]] | |
| * [[~:basedir]] | |
| * [[~:baseurl]] | |
| * [[~:cookiedir]] | |
| * [[~:dmode]] | |
| * [[~:fmode]] | |
| * [[~:lang]] | |
| * [[~:license]] | |
| * [[~:savedir]] | |
| * [[~:sidebar]] | |
| * [[~:startpage|start]] | |
| * [[~:tagline]] | |
| * [[~:template]] | |
| * [[~: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|англ.]]) | |
| |