Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
справка:разметка [2012/06/04 03:01] разбиение на отдельные статьи. |
справка:разметка [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: | ||
</колонки> | </колонки> | ||
- | ===== Типографские символы ===== | + | ==== Типографские символы ==== |
<колонки> | <колонки> | ||
* ''%%->%%'' -> | * ''%%->%%'' -> | ||
Строка 117: | Строка 169: | ||
===== Списки ===== | ===== Списки ===== | ||
- | Dokuwiki поддерживает нумерованные, ненумерованные, с определениями и многоуровневые нумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, - в случае нумерованного или ~ в случае многоуровневого нумерованного. Для списка с определениями после двух пробелов поставьте ? для определения или : для элемента с описанием. | + | [[wiki:Dokuwiki]] поддерживает нумерованные, ненумерованные, с определениями и многоуровневые нумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, - в случае нумерованного или ~ в случае многоуровневого нумерованного. Для списка с определениями после двух пробелов поставьте ? для определения или : для элемента с описанием.\\ |
+ | Кроме того, элементы списков (кроме определений) можно разрывать на [[#абзацы]]. Для этого у нужного элемента вместо одного специального символа необходимо поставить два, а новый абзац начать с .. после двух пробелов. | ||
- | Кроме того, элементы списков (кроме определений) можно разрывать на абзацы. Для этого у нужного элемента вместо одного специального символа необходимо поставить два, а новый абзац начать с .. после двух пробелов. | + | <колонки> |
<code> | <code> | ||
- нумерованный список | - нумерованный список | ||
Строка 134: | Строка 187: | ||
</code> | </code> | ||
+ | <code> | ||
* Это список | * Это список | ||
* Второй элемент списка | * Второй элемент списка | ||
Строка 157: | Строка 211: | ||
:: Различных вариантов очень много | :: Различных вариантов очень много | ||
.. Можно очень красиво структурировать материал | .. Можно очень красиво структурировать материал | ||
- | + | </code> | |
- | <code> | + | <новаяколонка> |
* Это список | * Это список | ||
* Второй элемент списка | * Второй элемент списка | ||
Строка 182: | Строка 236: | ||
:: Различных вариантов очень много | :: Различных вариантов очень много | ||
.. Можно очень красиво структурировать материал | .. Можно очень красиво структурировать материал | ||
- | </code> | ||
+ | </колонки> | ||
+ | |||
+ | ===== Таблицы ===== | ||
+ | |||
+ | [[wiki:DokuWiki]] поддерживает упрощённый синтаксис создания **таблиц**.\\ | ||
+ | Объединение символов границ позволяет объединить ячейки. | ||
+ | Используемые символы или их комбинации:\\ | ||
+ | * %%^%% и %%^^%% - выделение заголовка и горизонтальное объединение заголовков\\ | ||
+ | * %%|%% и %%||%% - граница ячейки и две спаренные границы - пропуск одной ячейки горизонтально\\ | ||
+ | * %%:::%% - параметр вертикального объединения ячейки с верхней ячейкой\\ | ||
+ | <note tip>Положение текста в ячейке определяется парами (и более) пробелов. \\ | ||
+ | В ячейках возможно применение многих конструкций форматирования текста.</note> | ||
+ | <колонки> | ||
+ | | Центр ^^Лево ^ Право^ | ||
+ | ^Заголовок \\ строки ||Одна ячейка | Вторая ячейка| | ||
+ | ^ ::: ||::: | <= вертикальное объединение ячеек| | ||
+ | ^ ||Горизонтально объединённая ячейка|| | ||
+ | ^ Сверху пробел |Куда? |Туда-> |Раз. | | ||
+ | ^ ::: | ::: |Сюда-> |Два. | | ||
+ | <новаяколонка> | ||
+ | <code> | ||
+ | | Центр ^^Лево ^ Право^ | ||
+ | ^Заголовок \\ строки ||Одна ячейка | Вторая ячейка| | ||
+ | ^ ::: ||::: | <= вертикальное объединение ячеек| | ||
+ | ^ ||Горизонтально объединённая ячейка|| | ||
+ | ^ Сверху пробел |Куда? |Туда-> |Раз. | | ||
+ | ^ ::: | ::: |Сюда-> |Два. | | ||
+ | </code> | ||
+ | </колонки> | ||
===== Управляющие макросы ===== | ===== Управляющие макросы ===== | ||
Строка 191: | Строка 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}} |