Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
справка:разметка [2012/06/04 03:11] [Таблицы] - перенесено |
справка:разметка [2013/03/19 22:40] (текущий) заметки |
||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ======== Wiki: Разметка, синтаксис, форматирование ======== | + | ====== Разметка, синтаксис, форматирование ====== |
| - | <note>Создана сокращённой заменой действующей [[wiki:syntax|статьи о синтаксисе]]. </note> | + | [[http://www.dokuwiki.ru|DokuWiki]] поддерживает простой язык разметки, который по возможности сохраняет исходный текст((необработанный системой код страницы - именно в нём содержится вся статья, исключая изображения, но включая все элементы оформления и пр.)) как можно более читабельным. |
| - | [[http://www.docuwiki.ru|DokuWiki]] поддерживает простой язык разметки, который по возможности сохраняет исходный текст((необработанный системой код страницы - именно в нём содержится вся статья, исключая изображения, но включая все элементы оформления и пр.)) как можно более читабельным. Ниже следует описание доступных параметров, большинство из которых можно комбинировать. | + | Ниже следует описание доступных параметров, большинство из которых можно комбинировать. |
| - | ====== Форматирование текста ====== | + | ===== Форматирование текста ===== |
| | ^Название ^^Внешний вид ^Способ использования ^ | | ^Название ^^Внешний вид ^Способ использования ^ | ||
| Строка 15: | Строка 15: | ||
| ^ ::: | ::: |Надстрочный | <sup>Пример</sup> | <code><sup>Пример</sup></code> | | ^ ::: | ::: |Надстрочный | <sup>Пример</sup> | <code><sup>Пример</sup></code> | | ||
| ^ ::: |Сноска || ((Это - сноска;-)))| <code>((Это - сноска;-)))</code> | | ^ ::: |Сноска || ((Это - сноска;-)))| <code>((Это - сноска;-)))</code> | | ||
| + | ^ ::: |Комбинация клавиш || <key>C-A-Del</key>| <code><key>C+A+D</key></code> | | ||
| - | ====== Абзацы и переносы ====== | + | ===== Абзацы и переносы ===== |
| **Абзац** формируется пустой строкой. Перенос строки без создания абзаца - ''\\''. | **Абзац** формируется пустой строкой. Перенос строки без создания абзаца - ''\\''. | ||
| - | ====== Ссылки ====== | + | ===== Ссылки ===== |
| | ^^^^Внешний вид ^Способ использования ^ | | ^^^^Внешний вид ^Способ использования ^ | ||
| ^Ссылки |Внутренние |Простые ||[[инструкция]] |<code>[[инструкция]]</code> | | ^Ссылки |Внутренние |Простые ||[[инструкция]] |<code>[[инструкция]]</code> | | ||
| Строка 28: | Строка 29: | ||
| ^::: |::: |::: |С указанием раздела документа |[[#ссылки]] или [[wiki:nano#ссылки]] |<code>[[#ссылки]] или [[wiki:nano#ссылки]]</code> | | ^::: |::: |::: |С указанием раздела документа |[[#ссылки]] или [[wiki:nano#ссылки]] |<code>[[#ссылки]] или [[wiki:nano#ссылки]]</code> | | ||
| ^::: |[[#Интер-ссылки]] ||Википедия |[[wpru>Википедия]] или [[wp>Wikipedia]] |<code>[[wpru>Википедия]] или [[wp>Wikipedia]]</code> | | ^::: |[[#Интер-ссылки]] ||Википедия |[[wpru>Википедия]] или [[wp>Wikipedia]] |<code>[[wpru>Википедия]] или [[wp>Wikipedia]]</code> | | ||
| - | ^::: |::: ||[[wiki:Launchpad|]] Bug |[[lpbug>645818]] или [[lpbug>645818|Фича]] |<code>[[lpbug>645818]] или [[lpbug>645818|Фича]]</code> | | + | ^::: |::: ||[[wiki:Launchpad]] Bug |[[lpbug>1]] или [[lpbug>1|Bug]] |<code>[[lpbug>645818]] или [[lpbug>645818|Bug]]</code> | |
| - | ^::: |::: ||Профиль [[wiki:forum|Форума]] |[[user>D]] или [[user>D|User]] |<code>[[user>D]] или [[user>D|User]]</code> | | + | ^::: |::: ||Проект на Launchpad |[[lpproj>ubuntu-ru-portal]] или [[lpproj>ubuntu-ru-portal|ubuntu.ru]] |<code>[[lpproj>ubuntu-ru-portal]] или [[lpproj>ubuntu-ru-portal|ubuntu.ru]]</code> | |
| + | ^::: |::: ||Команда на Launchpad |[[lpteam>ubuntu-ru]] или [[lpteam>ubuntu-ru|Ubuntu Russian LoCo]] |<code>[[lpteam>ubuntu-ru]] или [[lpteam>ubuntu-ru|Ubuntu Russian LoCo]]</code> | | ||
| + | ^::: |::: ||Профиль на Launchpad |[[lpuser>malamut]] или [[lpuser>malamut|Malamut]] |<code>[[lpuser>malamut]] или [[lpuser>malamut|Malamut]]</code> | | ||
| + | ^::: |::: ||Профиль [[wiki:forum|Форума]] |[[user>forekko]] или [[user>forekko|User]] |<code>[[user>forekko]] или [[user>forekko|User]]</code> | | ||
| + | ^::: |::: ||Ссылка на приложение из [[wiki:центр_приложений_ubuntu|Центра приложений]] |[[app>firefox]] или [[app>firefox|Веб-браузер Firefox]] |<code>[[app>firefox]] или [[app>firefox|Веб-браузер Firefox]]</code> | | ||
| ^::: |Внешние |Распознаваемые |С указанием протокола |http://www.ubuntu.ru |<code>http://www.ubuntu.ru</code> | | ^::: |Внешние |Распознаваемые |С указанием протокола |http://www.ubuntu.ru |<code>http://www.ubuntu.ru</code> | | ||
| ^::: |::: |::: |Без указания протокола |www.ubuntu.ru |<code>www.ubuntu.ru</code> | | ^::: |::: |::: |Без указания протокола |www.ubuntu.ru |<code>www.ubuntu.ru</code> | | ||
| ^::: |::: |Прямо указанные || [[http://www.ubuntu.ru|Это ссылка HTTP]] | <code>[[http://www.ubuntu.ru|Это ссылка HTTP]]</code> | | ^::: |::: |Прямо указанные || [[http://www.ubuntu.ru|Это ссылка HTTP]] | <code>[[http://www.ubuntu.ru|Это ссылка HTTP]]</code> | | ||
| ^::: |::: |::: || [[user@example.com|Это ссылка на email]] | <code>[[user@example.com|Это ссылка на email]]</code> | | ^::: |::: |::: || [[user@example.com|Это ссылка на email]] | <code>[[user@example.com|Это ссылка на email]]</code> | | ||
| - | ^::: |::: |::: || К сожалению, указать прямую ссылку на пакет через <nowiki>apt://</nowiki> \\ временно невозможно. [[http://forum.ubuntu.ru/index.php?topic=190808.0|Тема на Форуме]] || | + | ==== Интер-ссылки ==== |
| - | + | ||
| - | + | ||
| - | ===== Интер-ссылки ===== | + | |
| Префиксальные ссылки, параметры отображения и функционирования которых заведомо заданы [[http://forum.ubuntu.ru/index.php?action=groups;sa=members;group=1|администратором]]. | Префиксальные ссылки, параметры отображения и функционирования которых заведомо заданы [[http://forum.ubuntu.ru/index.php?action=groups;sa=members;group=1|администратором]]. | ||
| - | ====== Обработка текста ====== | + | ===== Обработка текста ===== |
| | ^^^ Внешний вид ^Способ использования | | | ^^^ Внешний вид ^Способ использования | | ||
| ^Необраба- \\ тываемый |Параметр <<<nowiki>%%</nowiki>>> ||%%http://ubuntu.ru%% |<code>%%http://ubuntu.ru%%</code> | | ^Необраба- \\ тываемый |Параметр <<<nowiki>%%</nowiki>>> ||%%http://ubuntu.ru%% |<code>%%http://ubuntu.ru%%</code> | | ||
| Строка 53: | Строка 55: | ||
| Кроме того, для подсветки синтаксиса доступно множество иных параметров, подробнее см.плагин [[http://qbnz.com/highlighter/|GeSHi]]((На данный момент распознаются следующие языки: ''actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml'')). | Кроме того, для подсветки синтаксиса доступно множество иных параметров, подробнее см.плагин [[http://qbnz.com/highlighter/|GeSHi]]((На данный момент распознаются следующие языки: ''actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml'')). | ||
| - | ====== Преобразуемые сочетания символов ====== | + | |
| - | ===== Смайлики ===== | + | ==== Заметки ==== |
| + | Вики поддерживает создание блоков с заметками. | ||
| + | |||
| + | <колонки> | ||
| + | <note> Обратите внимание. Это нужно запомнить! </note> | ||
| + | <note important> Внимание! Вы можете потерять рассудок. </note> | ||
| + | <note tip> Подсказки находятся на изображениях. </note> | ||
| + | <note warning> Остерегайтесь собаки, когда открываете дверь! </note> | ||
| + | |||
| + | <новаяколонка> | ||
| + | |||
| + | <note> Обратите внимание. Это нужно запомнить! </note> | ||
| + | |||
| + | <note important> Внимание! Вы можете потерять рассудок. </note> | ||
| + | |||
| + | <note tip> Подсказки находятся на изображениях. </note> | ||
| + | |||
| + | <note warning> Остерегайтесь собаки, когда открываете дверь! </note> | ||
| + | |||
| + | </колонки> | ||
| + | ==== Цитирование ==== | ||
| + | Цитирование текста происходит при помощи тега ''%%<quote></quote>%%'' | ||
| + | <колонки 100%> | ||
| + | <quote>В цитатах действует оформление текста.\\ | ||
| + | //Эта строка написана курсивом.//</quote> | ||
| + | <новаяколонка> | ||
| + | <code><quote>В цитатах действует оформление текста.\\ | ||
| + | //Эта строка написана курсивом.//</quote></code> | ||
| + | </колонки> | ||
| + | |||
| + | ==== Колонки ==== | ||
| + | В вики поддерживается простая организация колонок. Для этого используется тег ''<nowiki><колонки [параметры]></nowiki>''. Например, ''<nowiki><колонки 100% 25% 25% 50%></nowiki>'', где первый показатель - ''100%'' - процент занимаемой всеми колонками ширины страницы, по ''25%'' и ''50%'' - процент ширины каждой колонки, то есть две по четверти и одна - половина ширины от данных нами ''100%''. Вместо указания процентов можно использовать прочерк, ширина колонки будет подобрана системой зависимо от степени наполнения. Каждая новая колонка должна начинатся тегом ''%%<новаяколонка>%%''. Пример использования колонок представлен ниже: | ||
| + | |||
| + | <колонки 100% 25% *-* *- > | ||
| + | Это просто текст в выравниванием по левой стороне. В этом случае звёздочка не нужна. | ||
| + | <новаяколонка> | ||
| + | А здесь текст выровнен по центру! | ||
| + | <новаяколонка> | ||
| + | Такой же бесполезный текст, как и два предыдущих, но с выравниванием по правой стороне. | ||
| + | </колонки> | ||
| + | <code> | ||
| + | <колонки 100% 25% *-* *- > | ||
| + | Это просто текст в выравниванием по левой стороне. В этом случае звёздочка не нужна. | ||
| + | <новаяколонка> | ||
| + | А здесь текст выровнен по центру! | ||
| + | <новаяколонка> | ||
| + | Такой же бесполезный текст, как и два предыдущих, но с выравниванием по правой стороне. | ||
| + | </колонки> | ||
| + | </code> | ||
| + | ===== Преобразуемые сочетания символов ===== | ||
| + | ==== Смайлики ==== | ||
| <note tip>Все перечисленные здесь символы доступны для простой вставки с [[инструкция:панель инструментов|панели инструментов окна редактирования]].</note> | <note tip>Все перечисленные здесь символы доступны для простой вставки с [[инструкция:панель инструментов|панели инструментов окна редактирования]].</note> | ||
| [[wiki:DokuWiki]] преобразовывает наиболее употребляемые сочетания символов в их графические эквиваленты. | [[wiki:DokuWiki]] преобразовывает наиболее употребляемые сочетания символов в их графические эквиваленты. | ||
| Строка 89: | Строка 141: | ||
| </колонки> | </колонки> | ||
| - | ===== Типографские символы ===== | + | ==== Типографские символы ==== |
| <колонки> | <колонки> | ||
| * ''%%->%%'' -> | * ''%%->%%'' -> | ||
| Строка 187: | Строка 239: | ||
| </колонки> | </колонки> | ||
| - | ====== Таблицы ====== | + | ===== Таблицы ===== |
| - | + | ||
| - | DokuWiki поддерживает упрощённый синтаксис создания таблиц. | + | |
| - | + | ||
| - | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
| - | | Ряд 1 Колонка 1 | Ряд 1 Колонка 2 | Ряд 1 Колонка 3 | | + | |
| - | | Ряд 2 Колонка 1 | Объединение колонок (обратите внимание на двойную вертикальную черту) || | + | |
| - | | Ряд 3 Колонка 1 | Ряд 2 Колонка 2 | Ряд 2 Колонка 3 | | + | |
| - | + | ||
| - | Нормальные ряды должны начинаться и заканчиваться символом |, а заголовки — ^. | + | |
| + | [[wiki:DokuWiki]] поддерживает упрощённый синтаксис создания **таблиц**.\\ | ||
| + | Объединение символов границ позволяет объединить ячейки. | ||
| + | Используемые символы или их комбинации:\\ | ||
| + | * %%^%% и %%^^%% - выделение заголовка и горизонтальное объединение заголовков\\ | ||
| + | * %%|%% и %%||%% - граница ячейки и две спаренные границы - пропуск одной ячейки горизонтально\\ | ||
| + | * %%:::%% - параметр вертикального объединения ячейки с верхней ячейкой\\ | ||
| + | <note tip>Положение текста в ячейке определяется парами (и более) пробелов. \\ | ||
| + | В ячейках возможно применение многих конструкций форматирования текста.</note> | ||
| + | <колонки> | ||
| + | | Центр ^^Лево ^ Право^ | ||
| + | ^Заголовок \\ строки ||Одна ячейка | Вторая ячейка| | ||
| + | ^ ::: ||::: | <= вертикальное объединение ячеек| | ||
| + | ^ ||Горизонтально объединённая ячейка|| | ||
| + | ^ Сверху пробел |Куда? |Туда-> |Раз. | | ||
| + | ^ ::: | ::: |Сюда-> |Два. | | ||
| + | <новаяколонка> | ||
| <code> | <code> | ||
| - | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | | Центр ^^Лево ^ Право^ |
| - | | Ряд 1 Колонка 1 | Ряд 1 Колонка 2 | Ряд 1 Колонка 3 | | + | ^Заголовок \\ строки ||Одна ячейка | Вторая ячейка| |
| - | | Ряд 2 Колонка 1 | Объединение колонок (обратите внимание на двойную вертикальную черту) || | + | ^ ::: ||::: | <= вертикальное объединение ячеек| |
| - | | Ряд 3 Колонка 1 | Ряд 2 Колонка 2 | Ряд 2 Колонка 3 | | + | ^ ||Горизонтально объединённая ячейка|| |
| + | ^ Сверху пробел |Куда? |Туда-> |Раз. | | ||
| + | ^ ::: | ::: |Сюда-> |Два. | | ||
| </code> | </code> | ||
| - | + | </колонки> | |
| - | Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым! | + | |
| - | + | ||
| - | Вертикальные заголовки тоже можно сделать. | + | |
| - | + | ||
| - | | ^ Заголовок 1 ^ Заголовок 2 ^ | + | |
| - | ^ Заголовок 3 | Ряд 1 Колонка 2 | Ряд 1 Колонка 3 | | + | |
| - | ^ Заголовок 4 | Объединения нет | | | + | |
| - | ^ Заголовок 5 | Ряд 2 Колонка 2 | Ряд 2 Колонка 3 | | + | |
| - | + | ||
| - | Как легко увидеть, разделитель стоящий перед клеткой определяет форматирование: | + | |
| - | + | ||
| - | <code> | + | |
| - | | ^ Заголовок 1 ^ Заголовок 2 ^ | + | |
| - | ^ Заголовок 3 | Ряд 1 Колонка 2 | Ряд 1 Колонка 3 | | + | |
| - | ^ Заголовок 4 | Объединения нет | | | + | |
| - | ^ Заголовок 5 | Ряд 2 Колонка 2 | Ряд 2 Колонка 3 | | + | |
| - | </code> | + | |
| - | + | ||
| - | DocuWiki поддерживает вертикальное объединение ячеек (rowspan). Для этого в присоединяемых ячейках (ниже доминирующей, которая выше) нужно поместить три двоеточия подряд - ':::'. | + | |
| - | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
| - | ^ Ещё один | Ячейка 1 | Ячейка 2| | + | |
| - | ^ И ещё. | Ячейка большая || | + | |
| - | ^ Вертикальное \\ объединение ячеек | 23 || | + | |
| - | ^ ::: |1|2| | + | |
| - | Обратите внимание на ручной перенос - <nowiki>\\</nowiki>. | + | |
| - | + | ||
| - | <code> DocuWiki поддерживает вертикальное объединение ячеек (rowspan). Для этого в присоединяемых ячейках (ниже доминирующей, которая выше) нужно поместить три двоеточия подряд - ':::'. | + | |
| - | ^ Заголовок 1 ^ Заголовок 2 ^ Заголовок 3 ^ | + | |
| - | ^ Ещё один | Ячейка 1 | Ячейка 2| | + | |
| - | ^ И ещё. | Ячейка большая || | + | |
| - | ^ Вертикальное \\ объединение ячеек | 23 || | + | |
| - | ^ ::: |1|2| | + | |
| - | Обратите внимание на ручной перенос - <nowiki>\\</nowiki>.</code> | + | |
| - | + | ||
| - | Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру. | + | |
| - | + | ||
| - | ^ Таблица с выравниванием ^^^ | + | |
| - | | вправо| по центру |влево | | + | |
| - | |влево | вправо| по центру | | + | |
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
| - | + | ||
| - | ^ Таблица с выравниванием ^^^ | + | |
| - | | вправо| по центру |влево | | + | |
| - | |влево | вправо| по центру | | + | |
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | + | |
| - | + | ||
| ===== Управляющие макросы ===== | ===== Управляющие макросы ===== | ||
| Строка 259: | Строка 273: | ||
| | %%~~NOTOC~~%% | Если этот макрос присутствует на странице, оглавление не будет создано | | | %%~~NOTOC~~%% | Если этот макрос присутствует на странице, оглавление не будет создано | | ||
| | %%~~NOCACHE~~%% | DokuWiki помещает все выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синаксис %%<php>%%), добавление этого макроса заставит DokuWiki обрабатывать страницу при каждом вызове | | | %%~~NOCACHE~~%% | DokuWiki помещает все выводимое в кэш по умолчанию. Иногда это нежелательно (например, когда выше был использован синаксис %%<php>%%), добавление этого макроса заставит DokuWiki обрабатывать страницу при каждом вызове | | ||
| - | + | | %%~~REDIRECT>перенаправление~~%% | Этот макрос позволяет автоматически перенаправить пользователя со страницы, на которой он размещен, на страницу, указанную в параметре макроса. | | |
| - | ====== См.также ====== | + | ===== См.также ===== |
| - | {{topic> Служебная:Синтаксис }} | + | {{topic> Справка:Синтаксис }} |
| <style float-right> тэг: Служебная:Синтаксис </style> | <style float-right> тэг: Служебная:Синтаксис </style> | ||
| - | {{tag> Служебная_статья Служебная:инструкция Незаконченная_статья Незавершенная_статья Незавершённая_статья FIXME}} | + | {{tag> Справка Служебная_статья Справка:инструкция Справка:FIXME}} |
