Синтаксис DokuWiki

Это перевод официальной страницы syntax.

Основное форматирование текста

внешний вид исходный текст комментарий
жирный текст
**жирный текст**
курсив
//курсив//
подчёркнутый текст
__подчёркнутый текст__
моноширный текст
''моноширный текст''
Тестподстрочный текст
Тест<sub>подстрочный текст</sub>
Тестнадстрочный текст
Тест<sup>надстрочный текст</sup>
перечёркнутый текст
<del>перечёркнутый текст</del>
1)
((Сноска))
Явный
перенос \\строки
Явный\\ перенос\\строки
www.google.ru
%%www.google.ru%%
<nowiki>www.google.ru</nowiki>
не форматировать
текст

Новый абзац начинается пустой строкой перед текстом.

Пример нового абзаца. Если надо просто начать текст с начала строки, то лучше воспользоваться
явным переносом, для этого надо в нужном месте текста вставить \\и добавить после этого пробел, иначе новой строки не будет.

Новый абзац начинается пустой строкой перед текстом.

Пример нового абзаца. Если надо просто начать текст с начала строки, то лучше воспользоваться \\ явным переносом, 
для этого надо в нужном месте текста вставить \\и добавить после этого пробел, иначе новой строки не будет.

Четыре ---- подряд в строке создают разделительную горизонтальную линию.


Четыре ---- подряд в строке создают разделительную горизонтальную линию.

Четыре %%----%% подряд в строке создают разделительную горизонтальную линию.
----
Четыре %%----%% подряд в строке создают разделительную горизонтальную линию.

Ссылки

внешний вид исходный текст комментарий
Внутренние DokuWiki-ссылки
Синтаксис DokuWiki
[[syntax_ru]]
syntax
[[wiki:syntax]]
Данный подраздел
[[wiki:syntax_ru#ssylki|Данный подраздел]]
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
Изображения-ссылки
Внешние interwiki-ссылки
Сайт DokuWiki
wiki:interwiki
[[doku>wiki:interwiki]]
Interwiki
[[doku>wiki:interwiki|Interwiki]]
en.Wikipedia.org
Wiki
[[wp>Wiki]]
Wikipedia
[[wp>Wiki|Wikipedia]]
Внешние ссылки
http://www.google.com
http://www.google.com
www.google.com
www.google.com
Гуугл
[[http://www.google.com|Гуугл]]
Адрес электронной почты
andi@splitbrain.org
<andi@splitbrain.org>

Изображения

внешний вид исходный текст комментарий
{{wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png?50}}
{{wiki:dokuwiki-128.png?200x50}}
{{http://de3.php.net/images/php.gif?200x50}}
Всплывающая подсказка
{{wiki:dokuwiki-128.png |Всплывающая подсказка}}
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Встроенные изображения

Встроенные изображения-иконки
внешний вид исходный текст комментарий внешний вид исходный текст комментарий
8-)
8-)
:-O
:-O
8-O
8-O
:-X
:-X
:-(
:-(
:-
:-|
:-)
:-)
;-)
;-)
=)
=) 
^_^
^_^
в таблице не отображается
:-/
:-/
:?:
:?:
:-\
:-\
:!:
:!:
:-?
:-?
LOL
LOL
:-D
:-D
FIXME
FIXME
:-P
:-P
DELETEME
DELETEME
Типографские символы
внешний вид исходный текст комментарий внешний вид исходный текст комментарий
->
«
<<
<-
--
<->
---
=>
640×480
640x480
<=
©
(c)
<=>
(tm)
»
>>
®
(r)

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

Содержание генерируется автоматически из заголовков, если содержание не требуется, от него можно отказаться вставив в любом месте текста страницы: ~~NOTOC~~

Заголовок 3 уровня

Заголовок 4 уровня

Заголовок 5 уровня
==== Заголовок 3 уровня ====
=== Заголовок 4 уровня ===
== Заголовок 5 уровня ==

Списки

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

Простой список

  • Уровень 1
  • Уровень 1
    • Уровень 2
    • Уровень 2
      • Уровень 3
  • Уровень 1
  * Уровень 1
  * Уровень 1
    * Уровень 2
    * Уровень 2
      * Уровень 3
  * Уровень 1

Пронумерованный список

  1. Уровень 1
  2. Уровень 1
    1. Уровень 2
    2. Уровень 2
      1. Уровень 3
      2. Уровень 3
        1. Уровень 4
        2. Уровень 4
        3. Уровень 4
    3. Уровень 2
  3. Уровень 1
  4. Уровень 1
  - Уровень 1
  - Уровень 1
    - Уровень 2
    - Уровень 2
      - Уровень 3
      - Уровень 3
        - Уровень 4
        - Уровень 4
        - Уровень 4
    - Уровень 2
  - Уровень 1
  - Уровень 1

Смешанный список

  • Уровень 1
  1. Уровень 1
    1. Уровень 2
    2. Уровень 2
    • Уровень 2
  2. Уровень 1
  • Уровень 1
  1. Уровень 1
  * Уровень 1
  - Уровень 1
    - Уровень 2
    - Уровень 2
    * Уровень 2
  - Уровень 1
  * Уровень 1
  - Уровень 1

Таблицы

Ячейки в таблице разделяются символами: | - для обычной ячейки и ^ - для заголовка (в заголовке цвет фона другой и текст выводится жирным шрифтом).

Можно объединять соседние ячейки, для этого необходимо ввести несколько разделителей ячеек подряд: ||.
По вертикали ячейки не объединяются, только по горизонтали.

Заголовок 1 Заголовок 2 Заголовок 3
Строка 1 Столбец 1 Строка 1 Столбец 2 Строка 1 Столбец 3
Строка 2 Столбец 1 объединение ячеек - два разделителя подряд
Заголовок 4 данные ячейки не объединяются
Строка 3 Столбец 1 Строка 2 Столбец 2 Строка 2 Столбец 3
^ Заголовок 1  ^ Заголовок 2     ^Заголовок 3  ^
| Строка 1 Столбец 1  | Строка 1 Столбец 2     |Строка 1 Столбец 3  |
| Строка 2 Столбец 1  | объединение ячеек - два разделителя подряд ||
^ Заголовок 4    | данные ячейки не объединяются |                    |
| Строка 3 Столбец 1  | Строка 2 Столбец 2     |Строка 2 Столбец 3  |

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

Пример выравнивания в таблице
по правому краю по центру по левому краю
по левому краю по правому краю по центру
xxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxx
^                       Пример выравнивания в таблице                    ^^^
|         по правому краю|  по центру             |по левому краю          |
|по левому краю          |         по правому краю|             по центру  |
| xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx |

Неформатируемые блоки

В данных блоках полностью сохраняется внешний вид текста (выводятся все отступы и пробелы), Wiki форматирование к данному тексту не применяется. Первый способ создать такой блок - делать отступы из двух пробелов в начале каждой строки.

Пример
первого     варианта
.

PS Ниже приведён вводимый при этом текст со всем форматированием:

  Пример
  первого     варианта
  .

Второй вариант - использовать теги <code>...</code> (для текста кода) или <file>...</file> (для текста файла), разница между code и file в цвете фона.

Пример тега code:               <-this
Пример тега file:               <-this

PS ниже приведён исходный текст:

<code>
Пример тега code:               <-this
</code>
<file>
Пример тега file:               <-this
</file>

Подсветка кода

В блок <code></code> можно добавить подсветку элементов. Для этого в открывающий тег надо добавить тип подсветки, пример для java: <code java>...</code>

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

Список поддерживаемых типов подсветки:

<code ...>
actionscript
actionscript-french
ada
apache
applescript
asm
asp
autoit

bash
blitzbasic

caddcl
cadlisp
c
c_mac
cfm
cpp
csharp
css
delphi
diff
d
div
dos

eiffel

freebasic

gml
groovy

html4strict

ini
inno

java
java5
javascript
lisp
lua

matlab
mpasm
mysql

nsis

objc
ocaml
ocaml-brief
oobas
oracle8

pascal
perl
php-brief
php
python

qbasic
reg
robots
ruby

scheme
sdlbasic
smalltalk
smarty
sql

tcl
text
tsql

vb
vbnet
vhdl
visualfoxpro

winbatch

xml

Диалоги

Дурак
Сам дурак
Серьёзно?
Да!
Ну вот и поговорили.
> Дурак

>> Сам дурак

> Серьёзно?

>> Да!

>>> Ну вот и поговорили.
1) Сноска

wiki/syntax_ru.txt · Последние изменения: 2007-01-03 13:44 mif-2004
Personal Tools