worldwide open-source software - wiki:faq

cookies

anonymous@undisclosed.example.com (Anonymous) — Sun, 18 Jan 2026 14:25:16 +0000

Cookies

Я хочу соблюдать закон ЕС о файлах cookie и мне нужно знать, какие именно файлы cookie использует DokuWiki?

При стандартной установке DokuWiki устанавливаются три cookie-файла . Но имейте в виду, что плагины могут устанавливать свои собственные cookie-файлы!

Как видите, по умолчанию требуются только функциональные файлы cookie. Отслеживание с помощью этих файлов cookie не осуществляется. Тем не менее, вы можете использовать плагины cookielaw или cookiebanner для отображения баннера с запросом согласия пользователя на сохранение файлов cookie, если считаете это необходимым.

DW<hash>

Используется для аутентификации после входа в систему. Содержит необходимые данные для (повторного) входа в систему ранее аутентифицированного пользователя.

Важность: необходимо для всех, кому требуется войти в систему.
Типичное содержимое: зашифрованное имя пользователя и пароль.
Срок действия: через год ¹⁾

DOKU_PREFS

Используется для запоминания полезных пользовательских настроек, таких как размер текстового поля редактора.

Важность: функциональная
Типичное содержимое: пары «имя/значение» в открытом текстовом формате.
Срок действия: в течение года

DokuWiki

Стандартный идентификатор сессии PHP. Используется для хранения временных данных и предотвращения CSRF-атак.

Важность: необходимо
Типичное содержимое: случайный идентификатор
Срок действия истекает: по окончании сеанса браузера.

¹⁾

если при входе в систему был установлен флажок «Запомнить меня», в противном случае: по завершении сеанса браузера.

css

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 22:24:50 +0000

CSS

Итак, как я могу изменить под свои нужды CSS для моего шаблона?

Когда вы пишете или подправляете шаблон, вам не нужно добавлять тэг <link> в хедер вашей страницы. Для добавления вашего собственного CSS к странице, вы должны заглянуть в файл style.ini в директории шаблона.

Обычно, вам следует добавить строку подобную myVeryOwn.css = screen в раздел [stylesheet] файла style.ini.

Зачем так? Я просто могу добавить тэг в свой html-шаблон, разве нет?

Да, можете. Однако, в зависимости от того, где и как вы вставите эту строку вы можете столкнуться с проблемами. Когда вы добавляете CSS в ini файл, wiki принимает это к сведению и подставляет для вас пути в вашем CSS, таким образом, вам самим не нужно следить за этим. Например, если вы хотите добавить logo.gif, расположенный в директории шаблона, просто напишите url(logo.gif) и не заморачивайтесь с путями к нему.

Другое преимущество этого подхода состоит в том, что CSS сжимается для того, чтобы ускорить загрузку страницы, а кроме того, вы можете воспользоваться преимуществом подстановок.

Я попробовал, но это не работает

Наиболее частая ошибка - вы забыли поместить <?php tpl_metaheaders(); ?> в раздел <head> вашей страницы.

database

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 09:07:01 +0000

Можно ли использовать СУБД?

Может ли «Докувики» использовать базу данных вместо текстовых файлов?

Она могла бы использовать базу данных, но по определённым причинам не использует. «Докувики» была разработана для размещения документации любого рода. Что бы вы делали, если бы ваша база данных или веб-сервер отказал, а документация, необходимая для восстановления его работоспособности, хранилась на нём же и была доступна только с работающего сервера? Непростая ситуация. А «Докувики» хранит всю важную (да и вообще всю) информацию в виде простого текста, который всегда можно открыть вручную и прочитать.

На странице о преимуществах использования простых файлов для документации (англ.) приводятся доводы в пользу использования в вики текстовых файлов вместо СУБД при количестве записей до 20 000.

А что вы будете делать, если откажет RAID-массив?

Главная задача «Докувики» — показать текст, т. е. прочитать, отобразить и всё, для этого база данных не нужна. На этой простоте прелести «Докувики» и заканчиваются. А дальше ваш выбор: простота и ограниченность файлового формата или сложность и гибкость SQL-запросов.

См. также

Доступ к содержимому баз данных

Хотя «Докувики» не использует базы данных, она может получать доступ к информации, хранящейся в них.

«Докувики» имеет встроенную поддержку хранения регистрационных данных пользователей в СУБД. См. бэк-энды аутентификации.
Плагин Data добавляет данные в структурированном виде, используя СУБД SQLite.
Посмотрите плагины с тэгом database, дающие доступ к базам данных.

documentation

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 09:10:03 +0000

Чем «Докувики» хороша для документирования?

Легко установить.
Легко начать работу: можно публиковать ещё незаконченные материалы.
Простое и целостное расположение страниц.
Легко создавать и обновлять документы:
- возможна коллективная работа;
- авторизованный или анонимный доступ через веб;
- для работы не нужно знать HTML;
- легко устанавливать связи между страницами;
- простой поиск;
- расширяемость и возможность наполнения материалами с внешних ресурсов.

И это ещё не всё

Простое редактирование:
- редактирование страницы по секциям.
Автоматически:
- помечаются красным ссылки на ещё несуществующие страницы;
- генерируется список всех страниц, ссылающихся на текущую;
- производится внутреняя индексация для полнотекстового поиска;
- сохраняется истории изменений страницы.
Несколько способов выделения кода, примеров и прочих элементов документации.
Страницы хранятся на сервере в обычных текстовых файлах, поэтому:
- они могут быть прочитаны, даже если сервер находится в нерабочем состоянии;
- легко организовать резервное копирование, так же как файлы на обычной файловой системе;
- могут быть легко прочитаны, изменены, сравнены, сгенерированы с помощью внешних (не-вики) программ;
Маленькие и приятные «фишки», делающие документацию лучше: сноски, расшифровка абрревиатур на лету, подсветка синтаксиса кода;
Большое количество плагинов;
Много чего ещё, всё и не вспомнишь ;-)

error500

anonymous@undisclosed.example.com (Anonymous) — Sat, 15 Feb 2025 11:41:02 +0000

Ошибка Apache 500 (внутренняя ошибка сервера)

При загрузке DokuWiki я получаю ошибку 500 (внутренняя ошибка сервера). Что мне делать?

Внутренняя ошибка сервера возникает, когда происходит какая-то фатальная ошибка, которая не позволяет выполнить запрос. Это может иметь множество причин, и нет единого ответа, как это исправить.

Распространенные причины:

Неправильная конфигурация .htaccess или веб-сервера
несовместимая версия PHP
отсутствующие расширения PHP
Неработающий код плагина
права доступа к файлам
Проблемы с SE Linux
и т.д

Самое важное, что вам нужно сделать, это найти дополнительную информацию о том, что именно пошло не так. Веб-сервер запишет дополнительную информацию об ошибке в свой файл журнала ошибок. Пожалуйста, обратитесь к Server/разделу Журналы ошибок сервера/PHP, чтобы узнать, как найти файл журнала.

Смотрите также

faq

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 09:09:26 +0000

Часто задаваемые вопросы

На этой странице собраны вопросы, которые время от времени возникают.

New questions are added by the core developer team only if they really are frequent, so do not add questions here. Instead see the FAQ entry on how to get support.

General

Installation, Configuration, Troubleshooting

Be sure to read the installation instructions for your operating system, web server, or web host here. Additionally, permissions can be a source of problems.

Usage

forgotten_password

anonymous@undisclosed.example.com (Anonymous) — Sat, 19 Aug 2023 15:23:02 +0000

Забытый пароль

Я забыл мой пароль. Что я могу сделать?

Если администратор не отключил какие-либо необходимые функции, вы можете перейти на страницу входа и нажать «Отправить новый пароль» ( дополнительную информацию см. в разделе Как войти в систему ). Если это не сработает, попросите администратора дать вам новый пароль в UserManager .

Но отправка нового пароля не работает, а я администратор и не могу получить доступ к диспетчеру пользователей. Как я могу восстановить свой пароль и вернуть права администратора?

Ты можешь

зарегистрировать нового пользователя
открыть conf/local.php
- измените суперпользователя на нового зарегистрированного пользователя
```
$conf['superuser'] = 'foo';
```
- или если суперпользователь представляет собой группу, например
```
$conf['superuser'] = '@admin';
```
  просто запомни его название
  1. открыть conf/users.auth.php
  2. найдите строку, которая начинается с имени вашего нового зарегистрированного пользователя (она должна быть последней строкой)
  3. и добавьте имя группы суперпользователей в самый конец этой строки, например
```
...:user,admin
```
затем вы можете войти в систему как новый пользователь
сменить пароль старого пользователя
выйти
войдите снова как старый пользователь
и снова удалите новый (не обязательно, но желательно, если вы беспокоитесь о безопасности)

Что если я админ и отключил регистрацию?

открыть conf/users.auth.php
добавить новую строку для временного пользователя user
```
deleteme:$1$4fd0ad31$.cId7p1uxI4a.RcrH81On0:-:-:admin,user 
```
где $1$4fd0ad31$.cId7p1uxI4a.RcrH81On0 хешируется admin
логин для пользователя: deleteme с паролем admin
сменить пароль старого пользователя
выйти
войти под старым пользователем
удалить deleteme пользователя

Смотрите также

Пост на форуме с альтернативным методом

pageprotect

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 22:53:02 +0000

Как запретить редактирование некоторых страниц?

Есть два способа:

использовать списки контроля доступа (рекомендуется);
запретить веб-серверу изменять опредленный файл, например¹⁾:
```
chmod 644 file.txt
```
Убедитесь, что вы понимаете, что такое настройка прав доступа к файлам и их важность (см. статью «Безопасность»).

¹⁾

Применимо только в *nix-системах, предполагается, что веб-сервер не является владельцем файла.

searchindex

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 23:17:49 +0000

Проблемы с индексом поиска

Всякий раз, когда я делаю поиск, не получаю ничего или не все подходящие страницы. Что я могу сделать?

DokuWiki использует индекс, обеспечивающий быстрый полнотекстовый поиск. Поскольку индексирование страницы занимает некоторое время, оно проводится не во время сохранения страницы, а в фоновом режиме при просмотре страницы.

Чтобы убедиться, что индекс не будет поврежден, он автоматически запирается на время индексирования страницы. Это означает, что в индекс добавляется только по одной странице за раз. На оживленных вики это может привести к отставанию индекса от обновлений, так что нужно просто выждать время и вики проиндексируется во время просмотра страниц пользователями.

Процесс индексирования запускается маленькими изображениями, встроеными в шаблон, которые будут вызывать скрипт индексации. Если вы используете шаблон стороннего разработчика, возможно, он забыл добавить «webbug» в шаблоне. Вы должны проверить main.php в вашем шаблоне на предмет существования функции tpl_indexerWebBug().

Есть также некоторые рекламные блокаторы, которые удаляют индексатор webbug в предположении, что он используется для отслеживания посетителей и, таким образом, не дают DokuWiki обновлять поисковый индекс. DokuWiki не использует webbug в подобных целях.

Если вы уверены, что webbug вызывается, но по-прежнему нет годных результатов поиска, необходимо проверить, нет ли ошибки в вызове "http://yourwiki.com/dokuwiki/lib/exe/indexer.php?id=wiki:syntax" (или часто лучше с параметром debug: "http://yourwiki.com/dokuwiki/lib/exe/indexer.php?id=wiki:syntax&debug=1" после включения allowdebug). Если всё правильно, должен быть показан прозрачный GIF размером в 1×1 пиксель.

Если вы используете Microsoft IIS с PHP как CGI, вам нужно включить опцию broken_iua или процесс индексирования не будет работать.

Иногда может быть необходимо перестроить индекс вручную, например, если вы внесли в папку data много страниц. Вы можете сделать это с помощью командного сценария indexer.php или плагина searchindex.

sidebar

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 22:53:03 +0000

Как я могу добавить боковую панель (sidebar)?

Если вы не используете новый стандартный шаблон, существует два способа добавить боковую панель:

Выбрать шаблон, в котором включена боковая панель, смотрите шаблоны с тегом sidebar. (Могут быть некоторые шаблоны, у которых отсутствует тег, так что просмотрите все шаблоны.)
Или установить плагин, который добавляет боковую панель в шаблон, смотрите плагины с тегом sidebar.

Использование шаблона с включённой боковой панелью более предпочтительно, потому как в таких шаблонах расположение боковой панели оптимально для данного шаблона и макета страницы.

Как установить боковую панель для определенного пространства имен?

Одна боковая панель применяется по умолчанию ко всем страницам в пространстве имен, где создается страница боковой панели. Таким образом, вы можете выбрать, где вы хотите отобразить боковую панель, и какой она будет, например:

:sidebar для всех страниц по умолчанию :*
:foo:sidebar для всех страниц в пространстве имен foo:*
:bar:sidebar для всех страниц в пространстве имен bar:*
:foo:bar:sidebar для всех страниц в пространстве имен :foo:bar:*
:foo:bar:baz:sidebar для всех страниц в пространстве имен :foo:bar:baz:*

Я установил шаблон/плагин с функциональностью боковой панели. Как я могу создать и редактировать боковую панель?

Большинство шаблонов используют обычную страницу с именем sidebar для боковой панели. В некоторых шаблонах можно указать имя страницы боковой панели. (Например, в Adora Belle есть конфигурация боковой панели, которую некоторые шаблоны поддерживают.) В других шаблонах у боковой панели может быть своя страница, иногда изменяемая в зависимости от пространства имён.

Вероятнее всего, ваша боковая панель расположена на странице с названием sidebar, вам нужно всего-то создать страницу. Перейдите по адресу http://your-wiki.com/doku.php?id=sidebar, нажмите кнопку «Создать страницу», отредактируйте эту страницу, сохраните, и боковая панель готова. Это всё, сохраненные изменения будут отображаться на боковой панели.

Как я могу сделать автоматическую навигацию на боковой панели

Наилучшее — установить плагины с тегом menu или плагины с тегом navigation.

В большинстве случаев вам нужно будет добавить макрос при использовании плагина для изменения содержимого боковой панели или пространства имён.

Моя боковая панель не обновляется должным образом или подчёркивает неправильные части

Если ваша боковая панель содержит динамические элементы (например, выделение текущей страницы или открытия поддиректорий, как делают большинство навигационных плагинов), вам нужно добавить макрос ~~NOCACHE~~ на страницу, чтобы предотвратить кэширование боковой панели.

Оригинал статьи

toolbar

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 23:16:48 +0000

Нет панели инструментов

Иногда в окне редактора исчезает панель инструментов, и больше не появляется. Что мне делать?

Панель инструментов редактирования построена с помощью JavaScript. Это означает, что если где-то в JavaScript есть ошибка, сценарий будет прерван, и панель инструментов не будет видна. Для устранения этой неполадки выполните следующие действия:

Проблемы с браузером

Убедитесь, что JavaScript включён, и что вы используете современный браузер
Попробуйте перезагрузить страницу
- Очистите кэш браузера
- Используйте Shift-F5, Ctrl-F5, Ctrl-Shift-R или другую комбинацию (в зависимости от браузера), вызывающую перезагрузку страницы
- Проделайте то же в режиме редактирования (игнорируя возможные предупреждения о повторной отправке данных)
Перезагрузите компьютер
Попробуйте другой браузер
Попробуйте отключить дополнения браузера, которые могут влиять на JavaScript

Проблемы с DokuWiki

Также убедитесь, что у вас установлена последняя версия «ДокуВики». ¹⁾
Убедитесь, что JS загружен (через вызов tpl_metaheaders() функции в вашем шаблоне).
- Посмотрите на источник вашей страницы и найдите строку js.php
- Загрузите файл js.php (e.g. http://example.com/dokuwiki/lib/exe/js.php) в новом окне, чтобы увидеть, все ли отображается.
Если вы выполнили обновление с более ранней версии «ДокуВики», убедитесь, что у вас обновленный файл conf/dokuwiki.php.
- всегда помещайте свои изменения в файл local.php
- Undefined config values are known to break the JavaScript, so this is important! (i.e.: make sure $conf['usedraft'] is defined)
Try disabling any installed third party plugins, their JavaScript might be broken (i.e.: remove the old jquery plugin)
- After disabling do the force reload thing again
Try remove your conf/userscript.js if you have any
- After disabling do the force reload thing again
If the gzip_output option is enabled, try disabling it
Disable the JavaScript/CSS compacting option
- Do the force reload thing again of course ;-)
- If this helps, most probably one of your Plugins provides broken JavaScript, go one step back again to find the bad one
If you still have problems, check the JavaScript Error console of Firefox and report errors in the bug tracker
- Make sure you have disabled the compacting option before

If you encounter problems caused by a 3rd party plugin please contact its author and ask her to fix it.

¹⁾

older DokuWiki releases will not work with Google Chrome

uploadsize

anonymous@undisclosed.example.com (Anonymous) — Sat, 19 Aug 2023 13:24:25 +0000

Максимальный объем загружаемого файла

Есть ли простой способ увеличить максимальный размер загружаемого файла (в настоящее время 2 мегабайта)?

Размер загружаемого файла устанавливается в конфигурации PHP, в файле php.ini, с помощью параметра upload_max_filesize.

Параметр может быть изменён в нескольких различных местах, в зависимости от вашего веб-сервера и метода, используемого для запуска PHP.

Если ваш веб-сервер поддерживает изменение настроек через файл .htaccess (Apache + mod_php) добавьте следующие строки в файл .htaccess в каталоге с установленной dokuwiki:

php_value upload_max_filesize 15M
php_value post_max_size 15M

В противном случае, вам нужно внести изменения в файл php.ini (его расположение в большинстве случаев /etc/php5/php.ini; если там его нет, обратитесь к вашему системному администратору или справочной системе ОС/веб-сервера для определения реального расположения этого файла):

upload_max_filesize = 15M
post_max_size = 15M

После внесения изменений в файл php.ini нужно обязательно перезапустить веб-сервер, чтобы применить новые настройки.

Пользователи веб-сервера Apache

Если вы получаете ошибку при загрузке («Upload failed») после установки upload_max_filesize и post_max_size, установите следующий параметр в разумное значение в файле php.ini:

memory_limit = 256M     ;  Максимальный объем памяти, который может использовать скрипт  (по умолчанию: 16MB)

Suhosin Users

Пользователям Suhosin возможно дополнительно потребуется изменить значение параметра suhosin.post.max_value_length.

Red Hat E5 Servers

Red Hat ES users will also want to check (and probably increase) LimitRequestBody in /etc/httpd/conf.d/php.conf, which is set by default to a fairly low value. This directive specifies the number of bytes from 0 (meaning unlimited) to 2147483647 (2GB) that are allowed in a request body.

FCGI Users

An updated default FastCGI restriction, which limited the maximum body size of a HTTP request results in internal server errors. You may set new values in your apache, i.e.

<IfModule mod_fcgid.c>
  FcgidMaxRequestLen 26214400
  FcgidConnectTimeout 60
</IfModule>

for 25 MB and 60 sec timeout.

Пользователи веб-сервера nginx

nginx имеет свой собственный лимит на максимальный размер запроса. Вы можете увеличить его добавив следующую строку в конфигурационный файл nginx.conf (обычно находится в /etc/nginx/:

client_max_body_size 25M;

Смотрите также

Для получения более подробной информации обратитесь к разделу поддержки вашего хостера (если устанавливаете dokuwiki на виртуальном хосте), или к документации вашего веб-сервера и конфигурации PHP (если устанавливаете dokuwiki на выделенном сервере).