DokuWiki.ru

простой и мощный вики-движок

Инструменты пользователя

Инструменты сайта


faq

Содержание

FAQ (Ответы на часто задаваемые вопросы)

Создание и редактирование страниц

Как создать новую страницу?

Обычный для DokuWiki способ - ввести имя новой страницы в поле для поиска, в результатах поиска нажать на кнопку «Создать страницу». }} Другой способ - ввести имя страницы после URL. Например: http://mysite.ru/Новая страница

Система сообщит, что такая страница ещё не существует. После этого нужно нажать на кнопку «Создать страницу».

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

А просто кнопка «Создать страницу» добавляется с помощью плагина. Но он подглючивает в разных браузерах. И кроме кнопки требует ввода названия страницы. И созданная страница получается непривязанной к другим (страница-одиночка).

Какими внешними редакторами рекомендуется пользоваться?

Используйте правильные редакторы, например Notepad++ (Опция «Кодировать в UTF-8 без BOM»), или встроенные в FAR, либо в Total Commander.

:!: Внимание! Никогда не используйте программу MS Notepad1) для редактирования файлов в UTF-8 кодировке!

Эта программа вставляет тройку символов в самое начало файла (EF BB BF), по которым определяет, что это UTF-8 кодировка, что иногда приводит к сбоям в PHP скриптах и порче разметки сайтов.

Конечно, эти символы не есть личная придумка Microsoft - это один из способов отмечать UTF-8 документы. Но MS Notepad не умеет сохранять документы без этого префикса.

Как удалить символы, которые вставляются при редактировании файла в его начало?

Такая ситуация происходит при редактировании плагином к Total Commandery (SynPlus). Потом нормальные редакторы (NotePad++) их не видят.

Решение: открыть текстовый файл в любом шестнадцатиричном редакторе (hex-редактор) и удалить первые три символа. Для этого можно использовать встроенный редактор из FAR Manager.

Можно ли нескольким пользователям одновременно редактировать разные секции одной и той же страницы?

В DokiWiki данные хранятся в обычных файлах (одна страница - один файл). Поэтому блокировки происходят на уровне файлов, а не на уровне отдельных разделов файла, как это сделано, например в MediaWiki, которые хранят свой текст в базе данных.

Совместную (в смысле одновременную) работу в DokuWiki организовать не получится. Для этого надо использовать специальные платформы, которые изменения пользователей транслируют в реальном времени всем участникам. В скайпе, например, есть такие приложения (плагины) для совместной правки документов и рисования картинок. Реально несколько курсоров одновременно работают.

Оформление текста с помощью заметок и "боксов"

Любой текст (заметку, цитату) на странице можно красиво выделить. Например вот так:

Это текст заметки

Или вывести текст предупреждения:

Никогда, никогда не используйте программу MS Notepad2) для редактирования файлов в UTF-8 кодировке!

Чтобы использовать эти возможности необходимо установить плагин http://www.dokuwiki.org/plugin:note

Также можно выделить текст с помощью «бокса»:

Чтобы использовать эти возможности необходимо установить плагин http://www.dokuwiki.org/plugin:boxes Пример оформления «боксов» можно посмотреть здесь: http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorial/boxes

Данный плагин позволяет оформлять «боксы» в самых различных цветовых комбинациях.

Следующие плагины позволяют выделять и раскрашивать сам текст:

BBCode - позволяет использовать в тексте BB-коды (обычно используются на форумах) - http://www.dokuwiki.org/plugin:bbcode

color - позволяет использовать цветной текст - http://www.dokuwiki.org/plugin:color

Highlight - выделяет текст цветом: выделение по умолчанию выделение нужным цветом (red) - http://www.dokuwiki.org/plugin%3Ahighlight

Транслитерация, русские названия файлов

Не могу создать страницу с длинным названием (более 47 символов)

Либо периодически при создании страницы появляется ошибка Writing /var/www/html/dokuwiki/data/meta/%D1%81%D1%81%.meta failed

Скорее всего это из-за того, что у вас используется прямая запись имен страниц (без транслитерации). В таком случае на каждую букву кириллицы в URL добавляется шесть знаков (например %D1%81 - это одна буква). А имя файла не может быть длиннее 256 символов. Итого получается в самом худшем случае 42 символа. И операционка не может создать нужный файл, что приводит к ошибке.

Для исправления надо в настройках DokuWiki установить опцию - «Использовать полную транслитерацию в именах страниц».

Как сделать, чтобы в навигации статья отображалась не в виде «транслитерации», а с русским названием?

Если вы хотите, чтобы в навигационной строке отображалось:

Вы посетили: » Инсталляция DokuWiki

вместо:

Вы посетили: » Instaliacia DokuWiki

Для этого в тексте страницы должен быть использован хоть один заголовок первого уровня. Если такого заголовка нет, то DokuWiki подставляет исходное (транслитерированное) название страницы.

Удобочитаемые ссылки

Как сделать удобочитаемые ссылки на сайте?

Если вы хотите получить ссылки типа:

http://mywebsite.com/playground:playground

вместо:

http://mywebsite.com/doku.php/playground:playground

то сделайте следующее:

  1. Включите в настройках DokuWiki: «Удобочитаемые адреса (URL)» - .htaccess
  2. Отредактируйте файл .htaccess, сняв комментарий со строки «RewriteEngine on…»

Безопасность и обновления

Как убрать сообщение вверху экрана: "Security alert. Local file inclusion bug. More info here dokuwiki…"?

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

Во-вторых, Если вы выполняли обновление в ручном режиме, необходимо увеличить счётчик обновлений в файле conf/msg. У каждого сообщения есть уникальный ID, показываемый в []. Только сообщения с ID, большим, чем указанное опцией conf/msg, будут показаны. Когда вы устанавливаете обновление, значение в conf/msg будет также обновление, таким образом старые сообщения не будут показываться. Если вы не желаете видеть сообщения, не устанавливая вместе с тем обновления, просто увеличьте значение в conf/msg.

При обновлении вашей инсталляции, может случиться так, что DokuWiki продолжает показывать сообщение об обновлении, даже если номер в conf/msg был увеличен обновлением. Это происходит потому что DokuWiki кэширует уже полученные за день сообщения и скачивает их заново только если временная отметка о последнем изменении conf/msg выше, чем у одного из кэшированных файлов. Для прекращения показа устаревших сообщений, вы можете просто подождать день или удалить файл кэша data/cache/messages.txt.

Регистрация в поисковых системах

Чтобы получить дополнительные возможности, например, просмотр подробной статистики по сайту, необходимо подтвердить права пользования на сайт. При работе с такими поисковиками как Яндекс или Google, вы можете подтвердить права двумя способами:

  • разместить текстовый файл в корневом каталоге сайта;
  • разместить мета-тег на главной странице сайта.

Если вы выбираете первый способ, то необходимо включить в файле конфигурации DokuWiki dokuwiki.php опцию:

$conf['send404']     = 1;                //Send a HTTP 404 status for non existing pages?

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

$conf['sitemap']     = 0;                //Create a google sitemap? How often? In days.

Задержка индексирования

В DokuWiki используется один из методов защиты от спама - задержка индексирования новых, а также измененных страниц. Достигается это вставкой в такие страницы мета-тэга:

<meta name=“robots” content=“noindex,nofollow” /> 

По умолчанию установлена задержка в 5 дней. Вы можете изменить эту задержку в настройках DokuWiki - параметр indexdelay.

1) , 2)
он же Блокнот
faq.txt · Последнее изменение: 2021/03/14 15:39 — aleksandr