Обычный для DokuWiki способ - ввести имя новой страницы в поле для поиска, в результатах поиска нажать на кнопку «Создать страницу».
}}
Другой способ - ввести имя страницы после URL. Например: http://mysite.ru/ Новый шедевр
Система сообщит, что такая страница ещё не существует. После этого нужно нажать на кнопку "Создать страницу".
Самый грамотный способ - создать страницу, связанную с другими страницами сайта. Для этого нужно отредактировать подходящую уже существующую страницу, вставив ссылку на новую страницу. После сохранения страницы появится ссылка красного цвета, пройдя по которой нужно нажать на кнопку «Создать страницу».
А просто кнопка «Создать страницу» добавляется с помощью плагина. Но он подглючивает в разных браузерах. И кроме кнопки требует ввода названия страницы. И созданная страница получается непривязанной к другим (страница-одиночка).
Имена страниц в DokuWiki автоматически преобразуются в нижний регистр. Допустимыми символами являются буквы, цифры и специальные символы ".", "-" и _ckgedit_QUOT"1)). Все остальные специальные символы (не буквы и не цифры) преобразуются в подчёркивания2). Двоеточия используются для определения или, при необходимости, создания пространств имён.3)
Когда включен параметр конфигурационного файла 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
в дереве пространств имён может быть изображено следующим образом:
<file>
корневое пространство имён (всегда существует)
|
+– пространство имён 'a'
|
+– пространство имён 'b'
|
+– страница 'c'
</file>
Внутри любого простанства имён могут одновременно существовать как страница, так и вложенное пространство имён с тем же самым именем.
Возвращаясь к предыдущему примеру, можно изобразить страницу с именем a:b
следующим образом:
<file>
корневое пространство имён (всегда существует)
|
+– пространство имён 'a'
|
+– пространство имён 'b'
| |
| +– страница 'c'
|
+– страница 'b' pagename (не смотря на существование пространства имён 'b')
</file>
Это не приводит к конфликтам, поскольку DokuWiki всегда считает последнюю лексему в имени страницы (часть имени после последнего двоеточния) как собственно имя страницы, а все остальные лексемы − как названия пространств имён
* В записи a:b:c
, a
и b
− названия пространства имён, а c
− имя страницы.
* В записи a:b
, a
− название пространства имён, а b
− имя страницы.
==== Какими внешними редакторами рекомендуется пользоваться? ====
Внимание! Никогда не используйте программу MS Notepad4) для редактирования файлов в 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>
<code><note> Самый простой вариант </note></code>
<note tip>Это текст заметки</note>
<code><note tip>Это текст заметки</note></code>
<note important> Или вот такой текст</note>
<code><note important> Или вот такой текст</note></code>
Или вывести текст предупреждения:
<note warning>Никогда, никогда не используйте программу MS Notepad5) для редактирования файлов в UTF-8 кодировке!</note>
<code><note warning>Никогда, никогда не используйте программу MS Notepad6) для редактирования файлов в UTF-8 кодировке!</note></code>
Также можно выделить текст с помощью "бокса":
<box>Данный плагин позволяет оформлять «боксы» в самых различных цветовых комбинациях. </box>
<code><box>Такой код вставляется для простого бокса</box></code>
<box 80% round orange|Заголовок> таких</box>
<code><box 80% round orange|Заголовок> таких</box></code>
<box 50% left blue>вот таких синеньких пятидесятипроцентных с "подвалом"</box|Подвал>
<code><box 50% left blue>вот таких синеньких пятидесятипроцентных с GESHI_QUOTподваломGESHI_QUOT__</box|Подвал></code>
<box 60% round #f99 #fc9 #fcc #f60|Заголовок>или даже вот таких</box|Подвал>
<box 60% round #f99 #fc9 #fcc #f60|Заголовок>или даже вот таких</box|Подвал>
==== Выделение текста цветом ====
Плагин color позволяют выделять и раскрашивать сам текст:
<color blue>использовать</color> <color blue/lightblue>цветной</color> <color red/lightgrey>текст</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 или у отцов-основателей