Разметка, синтаксис, форматирование Сравнение версий

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
справка:разметка [2012/06/04 03:47]
[Таблицы] - сократил
справка:разметка [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:
 </​колонки>​ </​колонки>​
  
-====== Таблицы ​======+===== Таблицы =====
  
 [[wiki:​DokuWiki]] поддерживает упрощённый синтаксис создания **таблиц**.\\ [[wiki:​DokuWiki]] поддерживает упрощённый синтаксис создания **таблиц**.\\
Строка 221: Строка 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}}