====== FAQ (Часто задаваемые вопросы) ======

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

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

Обычный для DokuWiki способ - ввести имя новой страницы в поле для поиска, в результатах поиска нажать на кнопку «Создать страницу».

Другой способ - ввести имя страницы после URL. Например: http://shakuhachi.ru/New

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

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


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

:!: **Внимание! Никогда не используйте** программу **MS Notepad**((он же Блокнот)) для редактирования файлов в **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 tip>Это текст заметки</note>

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

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

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

<box round orange 80%| Пример бокса - The full syntax:>

''**%%<box%%** //width// //classes// **|** title text**>** contents text **%%</box|%%** caption text**%%>%%**''

    * //classes// : any number of classes which use the styles in your template or the plugin's own stylesheet to determine the look of the box. The box plugins comes with the following classes already defined:
    * //round// --- box will have rounded corners
    * //blue// --- blue colour scheme
    * //red// --- red colour scheme
    * //green// --- green colour scheme
    * //orange// --- orange colour scheme
    * //left// --- box is floated left on the page
    * //right// --- box is floated right on the page

  ; //width// : any legal CSS length value.
  ; //title text// : text (including dokuwiki markup) displayed as a title above box contents.
  ; //caption text// : text (without dokuwiki markup) displayed as a caption below box contents.


\\ 
//width// & //classes// can be specified in any order.
</box>


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

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

**BBCode** - позволяет использовать в тексте BB-коды (обычно используются на форумах)

<box round orange 80%|Пример BBCode :>

[b]bold text[/b]

[i]italic text[/i]

[u]underline[/u]

[s]deleted[/s]

[m]monospace[/m]

[code]<?php echo $text;[/code]
[quote="Esther"]DokuWiki is great![/quote]

[url=http://www.kaffeehaus.ch]Esthers Kaffeehaus Blog[/url]
[email]esther@kaffeehaus.ch[/email]
[img]http://www.dokuwiki.org/lib/exe/fetch.php?w=&h=&cache=cache&media=wiki%3Adokuwiki-128.png[/img]

[list][*]item 1[*]item 2[*]item 3[/list]
[list=1][*]item 1[*]item 2[*]item 3[/list]  attribute: 1, a, A, i or I

[size=90%]smaller text[/size]               attribute: numeric value (px, em, %, ...) or keywords like small
[color=red]colored text[/color]             attribute: color name, #fff[fff] or rgb(255,255,255)

</box>


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

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

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

вместо:

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

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