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

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

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

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

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

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

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

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

Внимание! Никогда не используйте программу MS Notepad1 он же Блокнот для редактирования файлов в 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 организовать не получится. Для этого надо использовать специальные платформы, которые изменения пользователей транслируют в реальном времени всем участникам. В скайпе, например, есть такие приложения (плагины) для совместной правки документов и рисования картинок. Реально несколько курсоров одновременно работают.

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

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

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

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

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

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

<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.

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

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

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

bold text

italic text

underline

deleted

monospace

<?php echo $text;

Esthers Kaffeehaus Blog esther@kaffeehaus.ch

attribute: 1, a, A, i or I

attribute: numeric value (px, em, %, …) or keywords like small attribute: color name, #fff[fff] or rgb(255,255,255)

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

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

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

вместо:

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

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