====== syntax ======

Если у тебя есть права на редактирование, перед их применением стоит прочесть [[:writeguide|это руководство]].

Для тестирования синтаксических конструкций и плагинов используй [[playground:ns_index|песочницу]]. Также о синтаксисе на [[doku>ru:wiki:syntax|сайте DokuWiki]]


===== Основные конструкции форматирования =====

==== Текст ====

<code>
**жирный**

//курсив//

__подчёркнутый__

''моноширинный''

подстрочный <sub>индекс</sub>

надстрочный <sup>индекс</sup>

<del>зачеркнутый</del> текст

принудительный переход\\ на новую строку\\
без создания нового абзаца
</code>

==== Ссылки ====

<code>
авто-внешняя ссылка http://www.google.com или www.google.com

[[http://www.google.com|внешняя ссылка]]

внутренняя ссылка на [[:syntax]]

внутренняя [[:syntax|ссылка]] с именем

ссылка на [[#Заголовок 3 уровня|заголовок]]

интервики ссылка [[wp>Wiki]]

ссылка-картинка [[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]

сноска((Сноска —
помещаемые внизу страницы примечание, ссылка, перевод.))
</code>

==== Заголовки ====

<code>
====== Заголовок 1 уровня ======
===== Заголовок 2 уровня =====
==== Заголовок 3 уровня ====
=== Заголовок 4 уровня ===
== Заголовок 5 уровня ==
</code>

==== Списки ====

<code>
  * ненумерованный список
    * строка
    * строка
      * строка

  - нумерованный список
    - строка
    - строка
      - строка
</code>

==== Цитирование ====

<code>
> ответ на это!

>> ответ на ответ

> второй ответ

>> ответ на второй ответ

>>> ответ на ответ на второй ответ
</code>

==== Таблицы ====

<code>
^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| вертикальное объединение  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
| :::              | Ряд 3 Колонка 2     | Ряд 3 Колонка 3        |
</code>

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

<code>неформатированный **блок**</code>
<code cpp>
std::cout << "неформатированный блок с подсветкой синтаксиса на основе GeSHi";
</code>

++поддерживаемые языки | 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript3, actionscript, ada, aimms, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, batch, bf, biblatex, bibtex, blitzbasic, bnf, boo, caddcl, cadlisp, ceylon, cfdg, cfm, chaiscript, chapel, cil, c_loadrunner, clojure, c_mac, cmake, cobol, coffeescript, c, cpp, cpp-qt, cpp-winapi, csharp, css, cuesheet, c_winapi, dart, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, d, ecmascript, eiffel, email, epc, e, erlang, euphoria, ezt, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html, html4strict, html5, icon, idl, ini, inno, intercal, io, ispfpanel, java5, java, javascript, jcl, j, jquery, julia, kixtart, klonec, klonecpp, kotlin, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, mathematica, matlab, mercury, metapost, mirc, mk-61, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nginx, nimrod, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, perl6, perl, per, pf, phix, php-brief, php, pic16, pike, pixelbender, pli, plsql, postgresql, postscript, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, qbasic, qml, q, racket, rails, rbs, rebol, reg, rexx, robots, rpmspec, rsplus, ruby, rust, sas, sass, scala, scheme, scilab, scl, sdlbasic, smalltalk, smarty, spark, sparql, sql, standardml, stonescript, swift, systemverilog, tclegg, tcl, teraterm, texgraph, text, thinbasic, tsql, twig, typoscript, unicon, upc, urbi, uscript, vala, vbnet, vb, vbscript, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xojo, xorg_conf, xpp, yaml, z80, zxbasic++

<file>неформатированный **блок**</file>
<file cpp example.cpp>
std::cout << "блок, доступный для скачивания как файл";
</file>
<file cpp "пример.cpp">
std::cout << "не английские имена файлов следует оборачивать двойными кавычками";
</file>

==== Прямые вставки ====

<code>
<html>
<p>прямая вставка html</p>
</html>

<php>
echo ' (прямая вставка php).';
</php>
</code>

==== Игнорируемый текст ====

<code>
<nowiki>__полностью__ игнорируемый парсером текст</nowiki>
%%полностью //игнорируемый// парсером текст%%
</code>

==== Вставки RSS/ATOM ====

| any number | Отображается максимальное количество элементов, по умолчанию 8 |
| reverse | Сначала отобразите последние элементы в ленте |
| author | Показывать имена авторов элементов |
| date | Показывать даты элементов |
| description | Покажите описание элементов. Если HTML отключен, все теги будут удалены |
| nosort | Не сортируйте элементы в ленте |
| //n//[dhm] | Период обновления, где d=дни, h=часы, m=минуты. (например 12h = 12 часов) |

<code>
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
</code>

==== Управляющие макросы ====

| <code>~~NOTOC~~</code> | Если этот макрос присутствует в статье, оглавление не будет создано. |
| <code>~~NOCACHE~~</code> | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синтаксис <php>), добавление этого макроса заставит «Докувики» обрабатывать статью при каждом вызове. |

===== Синтаксические плагины =====

==== folded ====

[[doku>plugin:folded]]

Сворачиваемые блоки.

<code>
++text | some inline folded text++

++++ Title |
some folded in block
++++
</code>

==== plaintext ====

[[doku>plugin:plaintext]]

Переиначивание логики переноса строк.

<code>
<text>
как nowiki, но переносы строк сохраняются
</text>

<TEXT>
как code, но текст любой длины будет обернут
</TEXT>

<file plaintext>
неформатированный текст
</file>
</code>

==== color ====

[[doku>plugin:color]]

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

<code>
<color green>text</color>
<color blue/lightgrey>text</color>
<color #FF0000>text</color>
<color /#FFff00>text</color>
<color rgb(80%,0%,0%)/rgb(100%,80%,100%)>text</color>
<color hsl(120,100%,30%):hsl(180,50%,90%)>text</color>
</code>

==== comment ====

[[doku>plugin:comment]]

Текст, не отображаемый на странице (вернее он вообще не рендерится).

<code>
/*комментарий, не отображаемый на странице*/

/*
многострочный комментарий
*/
</code>

==== note ====

[[doku>plugin:note]]

Заметки в рамочках. Большие и броские.

<code>
<note>обычная заметка</note>
<note tip>подсказка</note>
<note warning>внимание</note>
<note important>очень важно</note>
</code>

==== tag ====

[[doku>plugin:tag]]

Добавляет теги для страницы.

<code>
{{tag>tag1 tag2 "tag3 with spaces"}}
</code>

==== textinsert ====

[[doku>plugin:textinsert]]

Макросы. Просто макросы.

<code>
#@MACRO_NAME_EXAMPLE@#
</code>

==== latex ====

  * ''$...$'' - синтаксис отображается inline, так же как в LaTeX
  * ''$$...$$'' - синтаксис отображается на собственной строке, так же как в LaTeX
  * ''\begin{displaymath}...\end{displaymath}'' - синтаксис
  * ''\begin{eqnarray}...\end{eqnarray}'' - синтаксис
  * ''\begin{eqnarray*}...\end{eqnarray*}'' - синтаксис
  * ''\begin{equation}...\end{equation}'' - синтаксис
  * ''\begin{equation*}...\end{equation*}'' - синтаксис
  * Special: ''<latex>...</latex>'' - отображается встроенно вне математического режима. Это полезно для ввода окружений, таких как picture и т.п.