[wiki:syntax] DreamHackers Laboratory::
 

Синтаксис Форматирования

Наша Дримхакерская Wiki поддерживает оч простой язык разметки, на самом деле, который по возможности сохраняет файлы данных как можно более читабельными даже для олигофренов LOL и ногвалистоф 8-). Тута перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. В принципе мона и не исползовать, дело ваше. Просто посмотрите на исходный код этой страницы, нажав кнопку Править страницу вверху или внизу страницы. Круто будет если нажать одновременно ;-). Если хотите поупражняться, бля :-?, заюзайте песочницу. Простую разметку также можно легко сделать с помощью панели инструментов.

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

Наша Wiki поддерживает выделение текста жирным шрифтом, курсивом, подчеркиванием и моноширинным шрифтом. Все эти конструкции можно объединить. Толко нахуй такое нуна, спрашиваецца? 8-O

Наша Wiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, 
__подчеркиванием__ и ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**.

Также можно использовать подстрочный индекс и надстрочный индекс. Поднадстрочный теоретицки тож мона, но практицки нет канеша :-/

Также можно использовать <sub>подстрочный индекс</sub> и <sup>надстрочный индекс</sup>.

Ещё можно зачеркнуть текст. Типа передумавши.

Ещё можно <del>зачеркнуть</del> текст.

Параграфы отбиваются пустой рукой :-D строкой. Если нужно принудительно вставить перенос строки, не создавая параграф, вставьте два обратных слэша и за ним пробел или энтер.
Вставлять в текст есссно, а не туда куда вы сразу подумали!

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

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

Принудительные переносы следует использовать только в случае крайней необходимости. Типа как клизьму :-X.

Рузский пириводт

FIXME Ну типа мну подзаебался малехо переводить-то, буков тут многовасто слишком.
Лучче будет еслиф типа для ползы дела, кажный внесет лепту и переведет хотяб один главу сам.
Вернее даж и переводить нинада http://animesarov.net.ru/wiki:syntax :-D
Нуна лиш аккуратно внимателно вставить текст в правке ;-)
Daedalus 08.08.06 12:00

DELETEME гы, сыночгы, лол. Удивительно, что до сих пор никто не прикос-
нулся к переводу.
а терь поздна, ток править.
Ligth 23.04.2007 12:00

Ссылки

Ссылки в DokuWiki бывают разные, и создавать их можно тоже по-разному.

Внешние

Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com — также можно указывать текст ссылки: Это ссылка на Google. Адреса электронной почты тоже распознаются: andi [at] splitbrain [dot] org.

Внешние ссылки распознаются автоматически: http://www.google.com или
просто www.google.com --- также можно указывать текст ссылки:
[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
тоже распознаются: <andi@splitbrain.org>.

Внутренние

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать wiki:ИмяСтраницы, либо дополнительно прописать Текст ссылки. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[doku>wiki:ИмяСтраницы]], либо дополнительно прописать
[[doku>wiki:ИмяСтраницы|Текст ссылки]]. Имена Wiki-страниц автоматически 
переводятся в нижний регистр, спецсимволы использовать нельзя.

Можно использовать в ссылке namespaces (пространство имён) через двоеточие.

Можно использовать в ссылке [[wiki:namespaces]] (пространство имён) через двоеточие.

Подробней о пространствах имён. wiki:namespaces.

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

Ссылка на [[syntax#внутренние|этот раздел]].

Примечания:

  • Ссылки на существующие страницы отображаются иначе, чем ссылки на несуществующие
  • DokuWiki по умолчанию не использует CamelCase для автоматического создания ссылок, но эту возможность можно включить в файле config. Проверка: Если DokuWiki — ссылка, значит эта возможность включена.
  • Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

Interwiki

DokuWiki поддерживает Interwiki-ссылки. Это короткие ссылки на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: Wiki.

DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]]-ссылки. Это коротые ссылки
на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]].

Виндовые шары

Ссылки на виндовые шары типа этого тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном Intranet.

Ссылки на виндовые шары типа [[\\server\share|этого]] тоже распознаются.

Примечания:

  • Из соображений безопасности непосредственный просмотр виндовых шар работает по умолчанию только в Internet Explorer (и только в “локальной зоне”).
  • В Mozilla и Firefox эту возможность можно включить с помощью опции security.checkloaduri, но делать это не рекомендуется.
  • Подробней читайте здесь.

Подробней читайте

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Сноски

С помощью двойных скобок можно добавить сноску1).

С помощью двойных скобок можно добавить сноску((Это сноска)).

Разбивка на разделы

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

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

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

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

Четыре и более тире преобразуются в горизонтальную черту:


Картинки и другие файлы

С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.

Нормальный размер:

Смасштабированная до заданной ширины:

Смасштабированная до заданных размеров:

Смасштабированная внешняя картинка:

Нормальный размер:                      {{wiki:php-powered.png}}
Смасштабированная до заданной ширины:   {{wiki:php-powered.png?100}}
Смасштабированная до заданных размеров: {{wiki:php-powered.png?100x100}}
Смасштабированная внешняя картинка:     {{http://de3.php.net/images/php.gif?100x100}

Поставив слева или справа пробел можно задать выравнивание картинки:

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).

Название

{{ wiki:dokuwiki-128.png |Название}}

Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif,jpeg,png), оно будет отображаться в виде ссылки.

Списки

Dokuwiki поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, или - в случае нумерованного.

  • Это список
  • Второй элемент списка
    • Можно сделать вложенный список
  • Ещё один элемент
  1. Тот же список, только нумерованный
  2. Ещё элемент
    1. Чем больше пробелов в начале, тем глубже вложенность
  3. Всё просто
  * Это список
  * Второй элемент списка
    * Можно сделать вложенный список
  * Ещё один элемент

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
  - Всё просто

Смайлики

DokuWiki переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию smiley и внести изменения в файл conf/smileys.conf. Вот смайлики, которые есть в DokuWiki:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Типографские символы

DokuWiki может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Владимир Владимирович™ — это наше всё © не я”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Владимир Владимирович(tm) --- это наше всё (c) не я"

Примечание: Это конвертирование можно отключить в файле конфигурации. config option & pattern file.

Цитирование

Иногда вам необходимо отметить текст, как ответ на предыдуший комментарий. Используйте следующий синтакс:

Я думаю, мы должны это сделать

> Нет не должны

>> Ну, я бы сказал, что должны

> Правда что ли?

>> Ага!

>>> Тогда погнали!

Я думаю, мы должны это сделать



> Нет не должны



» Ну, я бы сказал, что должны



> Правда что ли?



» Ага!



»> Тогда погнали!

Таблицы

DokuWiki поддерживает упрощённый синтаксис создания таблиц.

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

Нормальные ряды должны начинаться и заканчиваться символом |, а заголовки — ^.

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

Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым!

Вертикальные заголовки тоже можно сделать.

Заголовок 1 Заголовок 2
Заголовок 3 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Заголовок 4 Объединения нет
Заголовок 5 Ряд 2 Колонка 2 Ряд 2 Колонка 3

Как легко увидеть, разделитель стоящий перед клеткой определяет форматирование:

|              ^ Заголовок 1       ^ Заголовок 2      ^
^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
^ Заголовок 4  | Объединения нет   |                  |
^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |

Примечание: Вертикальное объединение (rowspan) не поддерживается.

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру.

Таблица с выравниванием
вправо по центру влево
влево вправо по центру
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Вот код:

^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

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

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в предыдущих примерах), либо используя тэги code или file.

Это неформатированный текст, в котором сохранены все пробелы: вот             <- так. 
В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла. 

Чтобы парсер полностью проигнорировал некий текст (т.е. не форматировал его), либо заключите его в тэги nowiki, либо ещё проще — в двойные знаки процента %%.

Это просто текст, в котором есть адрес http://www.splitbrain.org и **форматирование** --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код страницы.

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

DokuWiki может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека GeSHi — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке code в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например <code java>.

/** 
 * 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.
    }
}

На данный момент распознаются следующие языки: 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, 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, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml

Вставка HTML и PHP

Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html или php:

<html>
Тут вставлен <font color="red" size="+1">HTML-код</font>
</html>

Тут вставлен HTML-код

<php>
echo 'Логотип, сгенерированный PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
</php>

Логотип, сгенерированный PHP:Логотип PHP!

Примечание: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.

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

Синтакс DokuWiki может быть расширен с помощью Plugins. Как используются установленные плагины описано на соответсвующей странице. Следующий синтаксиальный плагин доступен в этой определенной DokuWiki:

1) Это сноска
 
wiki/syntax.txt · Последние изменения: 24.03.07 12:26 81.222.223.34 [просмотров:1998]