Это старая версия документа!
Содержание
Настройки: useheading
Когда эта опция активирована, ссылка на имя статьи вики будет автоматически использовать первый заголовок в статье для следующего:
- заголовок страницы, который отображается в браузере или в результатах поисковых машин;
- текст для ссылки на статью, если только в определении ссылки не содержится явного названия;
- заголовок новости в RSS-рассылке.
- Тип данных: смешанный
- Значение по умолчанию: 0
- Возможные значения:
- «Никогда» (
0
) — отключено. Будет использоваться имя страницы в тексте ссылки; - «Только содержимое вики» (
content
) — использовать текст первого заголовка в ссылках в текстах статей; - «Только навигация» (
navigation
) — использовать текст первого заголовка в ссылках в строке «Вы посетили:», обратных ссылках, результатах поиска и т. п.; - «Всегда» (
1
) — использовать текст первого заголовка во всех ссылках.
(Обновлено в «Докувики» 2009-02-14. Для обратной совместимости любые другие значения преобразуются в «0
» или «1
» с помощью функции empty())
Предупреждение о безопасности
Если страница имеет ограничения по доступу, в её первом заголовке страницы никогда не пишите ничего конфиденциального.
Первый заголовок страниц с ограниченным доступом для чтения будет раскрыт в других частях вики, которые ссылаются на эту страницу. Даже если вы убедитесь, что на страницах без ограничений нет ссылок на конкретную страницу, редактор страницы без ограничений все равно может создать ссылку на страницу с ограниченным доступом, чтобы открыть первый заголовок.
См. также
Настройки: hidepages
Эта опция задаётся регулярным выражением, позволяющим исключить определённые страницы из автоматически составляемых списков (RSS, последние обновления, результаты поисков, индексы). Весьма полезно вычленить отдельные страницы, которые используются в шаблонах с боковыми панелями. Регулярное выражение сравнивается с полным (с начальным двоеточием) ID статьи, если совпадает, то считается, что статью нужно скрыть. Это только «косметическое» средство, не следует использовать его в безопасности.
- Тип данных: строковый
- Значение по умолчанию:
Пример
Расположение файла для правки Dokuwiki/conf/local.php
Пример для исключения страниц :reports:template
, :reports:sidebar
и страниц, вложенных в них:
$conf['hidepages'] = '^:reports:(?:template|sidebar)';
Еще один пример. Директория /data/pages
содержит следующие страницы:
. ├── admin │ ├── build_notes.txt │ ├── new_software.txt │ └── todos.txt ├── admin_links.txt ├── labels │ └── start.txt ├── playground │ └── playground.txt ├── sidebar.txt ├── software │ ├── dokuwiki │ │ └── start.txt │ ├── kdialog │ │ └── start.txt │ ├── start.txt │ └── __template.txt ├── start.txt ├── templates │ └── start.txt └── wiki ├── dokuwiki.txt ├── syntax.txt └── welcome.txt
Чтобы скрыть страницы admin_links
, sidebar
и все, что находится в пространствах имён :admin
, :labels
, :playground
, :templates
и, :wiki
, используйте:
$conf['hidepages'] = '^:(admin*|sidebar|playground|labels|templates|wiki)';