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

Редактирование

  • Это полностью редактируемый сайт. Для того, чтобы принять участие в работе надо нажать на кнопку «Править» рядом с интересующим вас фрагментом или кнопку «Править страницу» в левом верхнем углу.
  • Некоторые страницы становятся доступны только после регистрации на этом сайте. После этого вы сможете войти на сайт (кнопка внизу страницы).
  • Документы поделены на две логические части - собственно текст и обсуждение. В первой части находится содержимое документа, а вторая предназначена для комментариев и ведения дискуссий.
  • Вы можете использовать различное <hi>форматирование</hi> - выделять жирным, курсивом, подчёркиванием, оформлять текст в виде таблиц, или нумерованных и ненумерованных списков. Более подробную информацию вы можете получить в документации по синтаксису и опробовать полученные знания в специальном разделе.

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

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

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

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

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

Имена страниц

Имена страниц в DokuWiki автоматически преобразуются в нижний регистр. Допустимыми символами являются буквы, цифры и специальные символы ».», »-» и «_»1) (допускаются только внутри имён2)). Все остальные специальные символы (не буквы и не цифры) преобразуются в подчёркивания3). Двоеточия используются для определения или, при необходимости, создания пространств имён.4)

Когда включен параметр конфигурационного файла config:deaccent (включен по умолчанию) местные и акцентированные символы преобразуются в их ASCII-эквиваленты (ü превращается в ue) или просто теряют акценты (á превращается в a).

An implicit constraint on length and beginning of pagenames is set by backlinks (first three characters must be letters).

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

Имена страниц и пространства имён

Пространства имён можно представлять себе как каталоги, а страницы − как файлы внутри них.

Например, расположение страницы с именем a:b:c в дереве пространств имён может быть изображено следующим образом:

   корневое пространство имён (всегда существует)
     |
     +-- пространство имён 'a'
           |
           +-- пространство имён 'b'
                 |
                 +-- страница 'c'

Внутри любого простанства имён могут одновременно существовать как страница, так и вложенное пространство имён с тем же самым именем. Возвращаясь к предыдущему примеру, можно изобразить страницу с именем a:b следующим образом:

   корневое пространство имён (всегда существует)
     |
     +-- пространство имён 'a'
           |
           +-- пространство имён 'b'
           |     |
           |     +-- страница 'c'
           |
           +-- страница 'b' pagename (не смотря на существование пространства имён 'b')

Это не приводит к конфликтам, поскольку DokuWiki всегда считает последнюю лексему в имени страницы (часть имени после последнего двоеточния) как собственно имя страницы, а все остальные лексемы − как названия пространств имён

  • В записи a:b:c, a и b − названия пространства имён, а c − имя страницы.
  • В записи a:b, a − название пространства имён, а b − имя страницы.

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

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

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

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

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

Удаление страниц

Если при редактировании страницы удалите всё её содержимое, то соответствующая страница будет также удалена (однако будет доступна в «истории изменений»).

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

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

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

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

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

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

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

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

Самый простой вариант

<note> Самый простой вариант </note>

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

<note tip>Это текст заметки</note>

Или вот такой текст

<note important> Или вот такой текст</note>

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

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

<note warning>Никогда, **никогда не используйте** программу **MS Notepad**((он же Блокнот)) для редактирования файлов в **UTF-8** кодировке!</note>

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

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

Заголовок

таких
<box 80% round orange|Заголовок> таких</box>
вот таких синеньких пятидесятипроцентных с «подвалом»

Подвал




<box 50% left blue>вот таких синеньких пятидесятипроцентных с "подвалом"</box|Подвал>

Заголовок

или даже вот таких

Подвал

<box 60% round #f99 #fc9 #fcc #f60|Заголовок>или даже вот таких</box|Подвал>

Выделение текста цветом

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

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

<color blue>использовать</color>
<color blue/lightblue>цветной</color>
<color red/lightgrey>текст</color>

Проблемы

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

Ошибка сохранения файла. обратитесь к администратору ресурса.

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

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

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

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

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

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

вместо:

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

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

Если хочется знать больше

Узнать больше о особенностях работы с DokuWiki можно на русской сайте DokuWiki или у отцов-основателей

1) На самом деле, для пользователя только ».» и »-» могут быть полезны, т. к. в случае с «_» будет непонятно, добавлены они пользователем или системой; см. следующее предложение в тексте.
2) Если эти символы встретятся в начале или конце имени, они будут ликвидированы.
3) или в дефисы, если вы изменили параметр config:sepchar в конфигурационном файле.
4) Вы можете получить сообщение об ошибке «Доступ запрещён», если попытаетесь использовать двоеточие в имени страницы; это будет результатом непреднамеренной попытки создать пространство имён и/или страницу там, где вы не имеете права этого делать.
5) , 6) он же Блокнот

Свои инструменты