| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия |
| wiki:config [2023/08/27 00:33] – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1 | wiki:config [2025/01/16 16:25] (текущий) – [Флаги функций] vladpolskiy |
|---|
| | ====== Настройка «Докувики» ====== |
| | |
| | «[[dokuwiki|Докувики]]» можно настроить в зависимости от ваших потребностей с помощью «системных» опций, конфигурационных файлов для настройки поведения, оформления темы и отключения/включения расширений. Самым простым способом изменения этих параметров является использование [[.:plugin:config|менеджера конфигурации]]. |
| | |
| | ===== Что можно настраивать в «Докувики» ===== |
| | |
| | «Системные» параметры 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]], которые можно найти в ''conf/'' каталоге. Их можно редактировать через {{fa>user-group?14&recache}} [[wiki:plugin:usermanager|Менеджер пользователей]] и {{fa>key?14&recache}} [[wiki:plugin:acl|Управление списком контроля доступа.]]. |
| | |
| | Когда вы загружаете на сервер новый файл с помощью [[wiki:ullscreen_mediamanager|медиаменеджера]], вы можете столкнуться с сообщением ''«Upload denied. This file extension is forbidden!»''. Это вызвано содержимым файла ''conf/mime.conf''. Для загрузки файла нового типа, укажите этот тип в [[wiki:mime|mime.local.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'' |[[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]] | спамерские чёрные списки | |
| | | ''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-улучшения | |
| | | |''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|Докувики]] настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через [[wiki: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» соответственно). |
| | * **Массив:** представляет собой набор из нескольких значений одного из указанных выше типов. |
| | |
| | ===== Доступные параметры ===== |
| | |
| | Подразделы: |
| | [[#Настройки блокировки спама|антиспам]], |
| | [[#Настройки аутентификации|аутентификация]], |
| | [[#Настройки для медиафайлов|медиафайлы]], |
| | [[#Основные настройки|основные]], |
| | [[#Настройки отображения|отображение]], |
| | [[#расширенные настройки]], |
| | [[#Настройки редактирования|редактирование]], |
| | [[#Настройки сети|сеть]], |
| | [[#Настройки ссылок|ссылки]]. |
| | |
| | ==== Основные настройки ==== |
| | |
| | * [[~: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]] |
| | * <del>[[~:refshow]]</del> ((Удалено в 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]] |
| | * <del>[[~:ftp|ftp (host, port, user, pass, root)]]</del> ((удалено в релизе 2020)) |
| | * [[~:jquerycdn]] |
| | * [[~:proxy|proxy(host, port, user, pass, ssl)]] |
| | * <del>[[~:safemodehack]] ([[config:safemodehack|англ.]])</del> ((удалено в релизе 2020)) |
| | * [[~:trustedproxy]] |
| | |
| | ====Флаги функций==== |
| | |
| | * [[~:defer_js]] |
| | * [[~:hidewarnings]] |
| | |
| | ====Дополнения и Файлы==== |
| | [[https://www.dokuwiki.org/config|Ссылка на оригинальную статью]] |
| |
