====== Форматирование текста ====== [[wiki:DokuWiki]] поддерживает некоторые разметочные языки, которые пытаются сделать файлы данных как можно более читабельными. Эта страница содержит все возможные синтаксисы, которыми вы можете пользоваться когда редактируете страницы. Просто просмотрите исходный текст этой страницы нажатием кнопки //Редактировать страницу// вверху страницы. Если вы хотите что-нибудь попробовать, используйте для этой цели страницу [[playground|Песочница]]. Более простая разметка также легко доступна через [[doku>wiki:quickbuttons|быстрые клавиши]]. ===== Основное форматирование текста ===== DokuWiki поддерживает **жирный**, //наклонный//, __подчёркнутый__ и ''monospaced'' тексты. Конечно, вы можете **__//''комбинировать''//__** их всех. DokuWiki поддерживает **жирный**, //наклонный//, __подчёркнутый__ и ''monospaced'' тексты. Конечно, вы можете **__//''комбинировать''//__** их всех. Вы также можете использовать subscript и superscript. Вы также можете использовать subscript и superscript. Вы можете помечать текст также удалённым. Вы можете помечать текст также удалённым. **Параграфы** создаются от пустых строк. Если вы хотите **принудить новую строку** без параграфа, вы можете использовать два бэкслеша с пробелом, следующий за ними, или концом строки. Вот текст с некоторыми linebreaks\\ Заметьте, что два бэкслеша распознаются в конце строки\\ или с последующим\\ пробелом \\это происходит без него. Вот текст с некоторыми linebreaks\\ Заметьте, что два бэкслеша распознаются в конце строки\\ или с последующим\\ пробелом \\это происходит без него. Вы должны использовать принудительный перевод строк только если это действительно необходимо. ===== Ссылки ===== DokuWiki имеет множество способов создания ссылок. ==== Внешние ==== Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com - Вы можете также добавить описание ссылки: [[http://www.google.com|Эта ссылка ведёт к Google]]. E-mail адреса подобно этому: также распознаются. Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com - Вы можете также добавить описание ссылки: [[http://www.google.com|Эта ссылка ведёт к Google]]. E-mail адреса подобно этому: также распознаются. ==== Внутренние ==== Внутренние ссылки создаются в прямоугольных скобках. Вы можете или просто задать [[doku>wiki:pagename]] или как [[doku>wiki:pagename|Заглавный текст]]. Страницы Wiki-ссылок автоматически конвертируются в нижний регистр, особые символы не поддерживаются. Внутренние ссылки создаются в прямоугольных скобках. Вы можете или просто задать [[doku>wiki:pagename]] или как [[doku>wiki:pagename|Заглавный текст]]. Страницы Wiki-ссылок автоматически конвертируются в нижний регистр, особые символы не поддерживаются. Вы можете использовать [[doku>wiki:namespaces]] с помощью двоеточия в страницах ссылок. Вы можете использовать [[doku>wiki:namespaces]] с помощью двоеточия в страницах ссылок. Для подробной информации читайте [[doku>wiki:namespaces]]. Привязка к заданной секции тоже возможна. Просто добавьте её название после хэш-символа #. Эта ссылка к [[syntax#Внутренние|этой Секции]]. Эта ссылка к [[syntax#Внутренние|этой Секции]]. Замечания: * Ссылки к [[wiki:syntax|существующим страницам]] показываются форме, отличной от [[wiki:nonexisting|несуществующих]]. * DokuWiki не использует [[wp>CamelCase]] для автоматического создания ссылок по умолчанию, но это поведение можно разрешить в файле [[doku>config]]. Подсказка: если DokuWiki - это ссылка, то она разрешается. * Когда заголовок секции изменён, его закладка также изменяется. Поэтому не слишком полагайтесь на ссылки секций. ==== Интер-wiki ==== DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]] ссылки. Это быстрые ссылки к другим Вики. Например, эта ссылка к страничке Википедии о Вики: [[wp>Wiki]]. DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]] ссылки. Это быстрые ссылки к другим Вики. Например, эта ссылка к страничке Википедии о Вики: [[wp>Wiki]]. ==== Windows Shares ==== Windows shares, такие как [[\\server\share|эти]], также распознаются. Учтите, что они имеют смысл только гомогенных группах пользователей, как корпоративный [[wp>Intranet]]. Windows shares, такие как [[\\server\share|эти]], также распознаются. Замечания: * Из соображений безопасности прямой просмотр windows shares действует только в Microsoft Internet Explorer per default (и только в "локальной зоне"). * Для Mozilla и Firefox он может быть разрешён через опцию config [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], но это не рекомендуется. * Смотри [[bug>151]] для подробной информации. ==== Ссылки картинок ==== Вы можете также использовать ссылку на другую внутреннюю или внешнюю страницу комбинированием синтаксиса для ссылок и [[#images_and_other_files|картинок]] (смотрите ниже) подобно этому примеру: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Учтите, форматирование картинок осуществляется с помощью синтаксиса форматирования, принятого в именах ссылок. Синтакс [[#images_and_other_files|image]] и [[#links|link]] полностью поддерживается (включая изменением размера картинок, внутренние и внешние картинки, URL'ы и интерwiki ссылки). ===== Сноски ===== Вы можете добавить сноски ((Это сноска)) с помощью двойных скобок. Вы можете добавить сноски ((Это сноска)) с помощью двойных скобок. ===== Секционирование ===== Вы можете использовать до пяти разных уровней заголовков для структуризации вашего содержания. Если у вас есть больше чем три заголовка, автоматически генерируется таблица содержания -- это может быть запрещено включением в документ строки "~~NOTOC~~". ==== Заголовок Уровня 3 ==== === Заголовок Уровня 4 === == Заголовок Уровня 5 == ==== Заголовок Уровня 3 ==== === Заголовок Уровня 4 === == Заголовок Уровня 5 == С помощью четырёх и более тире можно создать горизонтальную линию: ---- ===== Картинки и другие файлы ===== Вы можете включать внешние и внутренние [[doku>images|картинки]] с фигурными скобками. Опционально, вы можете указать их размер. Исходный размер: {{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?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}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} Конечно, вы также можете добавить заголовок (отображается как подсказка большинством броузеров). {{ wiki:dokuwiki-128.png |Это заголовок}} {{ wiki:dokuwiki-128.png |Это заголовок}} If you specify a filename (external or internal) that is not an image (''gif,jpeg,png''), then it will be displayed as a link instead. For linking an image to another page see [[Image Links]] above. ===== Списки ===== Dokuwiki поддерживает упорядоченные и неупорядоченные списки. Для создания элемента списка отступите от начала строки на два пробела и вставьте ''*'' для неупорядоченного списка или же ''-'' для упорядоченного. * Это список * второй элемент * Вы можете иметь различные уровни вложенности * другой элемент - Тот же список, но упорядоченный - другой элемент - Всего лишь отступите на два пробела для более глубокого уровня - Это всё * Это список * второй элемент * Вы можете иметь различные уровни вложенности * другой элемент - Тот же список, но упорядоченный - другой элемент - Всего лишь отступите на два пробела для более глубокого уровня - Это всё ===== Смайлы ===== DokuWiki конвертирует общеиспользуемые [[wp>emoticon|иконки эмоций]] в их графические эквиваленты. Дополнительные смайлы (smiles) могут быть размещены и сконфигурированы в файле ''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]] может конвертировать простые текстовые символы в их типографически корректные аналоги (entities). Вот пример распознаваемых символов: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." Учтите: эти конверсии могут быть отключены в конфигурационном файле. ===== Цитирование ===== Иногда вы хотите пометить некоторый текст, чтобы показать ответ или прокомментировать. Вы можете использовать следующий синтаксис: Я думаю, нам нужно это сделать > Нет, не нужно >> Хорошо, а Я говорю, нужно > Серьёзно? >> Да! >>> Тогда сделаем это! Я думаю, нам нужно это сделать > Нет, не нужно >> Хорошо, а Я говорю, нужно > Серьёзно? >> Да! >>> Тогда сделаем это! ===== Таблицы ===== DokuWiki поддерживает простой синтаксис для создания таблиц. ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | Row 2 Col 1 | some colspan (учтите двойной pipe) || | Row 3 Col 1 | Row 2 Col 2 | Row 2 Col 3 | Табличные строки начинаются и заканчиваются с ''|'' для обычных строк и с ''^'' для заголовков. ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | Row 2 Col 1 | some colspan (учтите двойной pipe) || | Row 3 Col 1 | Row 2 Col 2 | Row 2 Col 3 | Чтобы связать клетки горизонтально, просто оставьте следующую клетку абсолютно пустой как показано выше. Убедитесь, что всегда имеете одинковое количество разделителей клеток! Вертикальные заголовки таблиц также возможны. | ^ Heading 1 ^ Heading 2 ^ ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | ^ Heading 4 | на этот раз нет строчного спана | | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | Как вы видите, этот разделитель клеток до клетки, которая решает форматирование: | ^ Heading 1 ^ Heading 2 ^ ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | ^ Heading 4 | на этот раз нет строчного спана | | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | Учтите: вертикальные спаны (спаны столбцов) невозможны. Вы можете выровнять также содержимое таблицы. Всего лишь добавьте как минимум один пробел в начале и в конце вашего текста: добавьте два пробела слева для выравнивания справа, два пробела справа для выравнивания слева или по крайней мере два пробела с обоих концов для центрированного текста. ^ Таблица с выравниванием ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Как это выглядит в исходном тексте: ^ Таблица с выравниванием ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | ===== Непарсируемые блоки ===== Вы можете включать непарсируемые (необрабатываемые) блоки в ваши документы или отступом как минимум двумя пробелами (как было показано в предыдущих примерах) или с помощью тегов ''code'' или ''file''. Это преформатированный код, в котором все пробелы сохраняются: подобно <-этому Это достаточно похоже, но вы можете использовать его, чтобы показать цитируемый файл. Чтобы позволить парсеру полностью игнорировать (т.е. не форматировать его), обрамите его тегами ''nowiki'', или даже проще, с двойными знаками процента ''%%''. Вот некоторый текст, который содержит адреса подобно этому: http://www.splitbrain.org и **форматирование**, но с ним ничего не происходит. Смотри исходный текст этой страницы, чтобы понять как использовать эти блоки. ===== Подсветка синтаксиса ===== [[DokuWiki]] может подсвечивать исходный текст кода, который облегчает его чтение. Она использует [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- так что любой язык, поддерживаемый GeSHi, поддерживается. Синтаксис похож на блок кода в предыдущей секции, но на этот раз вставляется название используемого языка внутрь тега. Т.е. ''''. /** * 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, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, javascript, lisp, lua, matlab, mpasm, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, ruby, vb, vbnet, vhdl, visualfoxpro, xml// ===== Внедрение HTML и PHP ===== Вы можете внедрить чистый код HTML или PHP в ваши документы с помощью тегов ''html'' или ''php'' вот так: Вот некоторый HTML Вот некоторый HTML echo 'A logo generated by PHP:'; echo 'PHP Logo !'; echo 'A logo generated by PHP:'; echo 'PHP Logo !'; **Учтите**: внедрение HTML и PHP по умолчанию запрещено в конфигурации. Если запрещено, то отображается код вместо исполнения. ===== Плагины Синтаксиса ===== Синтакс DokuWiki может быть расширен [[doku>wiki:plugins|Плагинами]]. Как использовать установленные плагины описано на их соответствующих. Следующий синтакс доступен в этой частной установке: ~~INFO:syntaxplugins~~