| |
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|англ.]]) | |
| |