Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия | |||
wiki:syntax [2012/04/27 10:02] |
wiki:syntax [2012/06/13 15:24] старая ревизия восстановлена |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Синтаксис форматирования ====== | ====== Синтаксис форматирования ====== | ||
- | |||
- | <note important>Наиболее актуальная версия всегда находится [[http://help.ubuntu.ru/wiki/syntax|здесь]].</note> | ||
DokuWiki поддерживает простой язык разметки, который по возможности сохраняет исходный текст как можно более читабельным. Здесь перечислены все доступные синтаксические конструкции, которые можно использовать при редактировании страниц на данном ресурсе. Если хотите поупражняться в использовании разметки, используйте специально предназначенную для этого [[playground:playground|«песочницу»]]. Большинство элементов разметки также можно добавить с помощью панели инструментов, которая появляется при редактировании над областью изменения текста. | DokuWiki поддерживает простой язык разметки, который по возможности сохраняет исходный текст как можно более читабельным. Здесь перечислены все доступные синтаксические конструкции, которые можно использовать при редактировании страниц на данном ресурсе. Если хотите поупражняться в использовании разметки, используйте специально предназначенную для этого [[playground:playground|«песочницу»]]. Большинство элементов разметки также можно добавить с помощью панели инструментов, которая появляется при редактировании над областью изменения текста. | ||
Строка 7: | Строка 5: | ||
===== Основные конструкции форматирования ===== | ===== Основные конструкции форматирования ===== | ||
- | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: | + | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: |
<code> | <code> | ||
- | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, | + | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ |
- | вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: | + | и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**. |
</code> | </code> | ||
Строка 30: | Строка 28: | ||
перенести текст на новую строку. | перенести текст на новую строку. | ||
</code> | </code> | ||
+ | |||
===== Ссылки ===== | ===== Ссылки ===== | ||
Строка 35: | Строка 34: | ||
==== Внешние ==== | ==== Внешние ==== | ||
- | Внешние ссылки распознаются автоматически: http://www.ubuntu.ru или просто www.ubuntu.ru. Можно использовать и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. Также можно добавлять адреса электронной почты: andi@splitbrain.org: | + | Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Можно использовать |
+ | и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. | ||
+ | Кроме того можно добавлять адреса электронной почты: <andi@splitbrain.org>: | ||
<code> | <code> | ||
- | Внешние ссылки распознаются автоматически: http://www.ubuntu.ru или просто www.ubuntu.ru. | + | Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Можно использовать |
- | Можно использовать и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. | + | и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. |
- | Также можно добавлять адреса электронной почты: andi@splitbrain.org. | + | Кроме того можно добавлять адреса электронной почты: <andi@splitbrain.org>. |
</code> | </code> | ||
+ | |||
==== Внутренние ==== | ==== Внутренние ==== | ||
Строка 53: | Строка 55: | ||
</code> | </code> | ||
- | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:loco:главная|ссылка с использованием относительных путей]]: | + | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:terms:главная|ссылка с использованием относительных путей]]: |
<code> | <code> | ||
Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | ||
- | [[.:..:loco:главная|ссылка с использованием относительных путей]]. | + | [[.:..:terms:главная|ссылка с использованием относительных путей]]. |
</code> | </code> | ||
Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | ||
+ | |||
==== Ссылки на профили пользователей форума ==== | ==== Ссылки на профили пользователей форума ==== | ||
Строка 93: | Строка 96: | ||
==== Картинки-ссылки ==== | ==== Картинки-ссылки ==== | ||
- | Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку [[http://www.dokuwiki.org/ru:dokuwiki|{{wiki:dokuwiki-128.png?20}}]], которая будет внутренней или внешней ссылкой: | + | Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку [[http://www.dokuwiki.org/ru:dokuwiki|{{:wiki:button-dw.png}}]], которая будет внутренней или внешней ссылкой: |
<code> | <code> | ||
Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку | Совместив синтаксис ссылки и [[#картинки и другие файлы|картинки]], можно вставить в текст картинку | ||
- | [[http://www.dokuwiki.org/ru:dokuwiki|{{wiki:dokuwiki-128.png?20}}]], которая будет внутренней или внешней ссылкой. | + | [[http://www.dokuwiki.org/ru:dokuwiki|{{:wiki:button-dw.png}}]], которая будет внутренней или внешней ссылкой. |
</code> | </code> | ||
- | Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. | + | Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. |
==== Сноски ==== | ==== Сноски ==== | ||
Строка 195: | Строка 199: | ||
===== Картинки и другие файлы ===== | ===== Картинки и другие файлы ===== | ||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. | + | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. |
- | Для загрузки файла на вики в режиме редактирования статьи одна из кнопок над формой редактирования вызывает менеджер закачки файлов. | + | Для закачки файла на вики в режиме редактирования статьи одна из кнопочек над формой редактирования вызывает менеджер закачки файлов. |
По желанию можно указать их размер. | По желанию можно указать их размер. | ||
- | Полный размер: {{wiki:dokuwiki-128.png}} | + | Нормальный размер: {{wiki:dokuwiki-128.png}} |
Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | ||
Строка 210: | Строка 214: | ||
<code> | <code> | ||
- | Полный размер: {{wiki:dokuwiki-128.png}} | + | Нормальный размер: {{wiki:dokuwiki-128.png}} |
Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | ||
Отмасштабированная до заданных размеров: {{wiki:dokuwiki-128.png?200x50}} | Отмасштабированная до заданных размеров: {{wiki:dokuwiki-128.png?200x50}} | ||
Строка 216: | Строка 220: | ||
</code> | </code> | ||
- | Поставив слева или справа пробел, можно задать выравнивание картинки: | + | Поставив слева или справа пробел можно задать выравнивание картинки: |
- | {{wiki:dokuwiki-128.png |Первая строка кода (см. ниже)}} | + | {{wiki:dokuwiki-128.png }} |
- | {{ wiki:dokuwiki-128.png|Вторая строка кода (см. ниже)}} | + | {{ wiki:dokuwiki-128.png}} |
- | {{ wiki:dokuwiki-128.png |Третья строка кода (см. ниже)}} | + | {{ wiki:dokuwiki-128.png }} |
- | <code> | + | <code>{{wiki:dokuwiki-128.png }} |
- | {{wiki:dokuwiki-128.png |Первая строка кода (см. ниже)}} | + | {{ wiki:dokuwiki-128.png}} |
- | {{ wiki:dokuwiki-128.png|Вторая строка кода (см.ниже)}} | + | {{ wiki:dokuwiki-128.png }} |
- | {{ wiki:dokuwiki-128.png |Третья строка кода (см.ниже)}} | + | |
</code> | </code> | ||
Строка 234: | Строка 237: | ||
<code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | <code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | ||
- | Если задать имя файла (внутреннее или внешнее), которое не является картинкой (''gif'', ''jpeg'', ''png''), оно будет отображаться в виде ссылки. | + | Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки. |
+ | |||
+ | Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]]. | ||
- | Узнать, как вставить картинку со ссылкой, можно в [[#картинки-ссылки|разделе выше]]. | ||
===== Смайлики ===== | ===== Смайлики ===== | ||
Строка 433: | Строка 437: | ||
==== Cинтаксический плагин Keyboard ==== | ==== Cинтаксический плагин Keyboard ==== | ||
- | Заключите название клавиши или комбинацию клавиш, разделённых дефисом (**''-''**), в тег //key//, как здесь: | + | Enclose the name of a key, or a combination of keys, separated by a dash (**''-''**), in a //key// tag, like this: |
- | <key>Клавиша</key> или <key>C-x</key> | + | <key>Key</key> or <key>C-x</key> |
- | * Текст внутри тега **''key''** делится на позициях **''-''** (дефиса). | + | * The text inside the **''key''** tag is split at the occurrences of **''-''** (dash). |
- | * Каждая часть //обрезается// (удаляются окружающие пробелы), а известные сокращения клавиш //заменяются// на полные варианты. Например, **''C''** становится **''Ctrl''**, **''Left''** становится **''%%←%%''**, и т.п. | + | * Each part is //trimmed// (surrounding whitespace removed) and known shortcuts or key names are //substituted//. E.g. **''C''** becomes **''Ctrl''**, **''Left''** becomes **''%%←%%''** etc. |
- | * Замена сокращений //зависит от языка//. Например, в немецком, **''C''** становится **''Strg''**, а **''Del''** становится **''Entf''**. На данный момент поддерживаются только английсткий и немецний. Вы можете помочь, написав дополнительные заголовочные файлы и отправив их для включения. | + | * The substitutions are //language specific//. So, e.g. in German, **''C''** becomes **''Strg''** and **''Del''** becomes **''Entf''**. Only English and German are supported at the moment. Feel free to write additional language files and send them in for inclusion. |
- | * Если замены не найдено, первая буква становится //заглавной//, а специальные HTML-символы заменяются сущностями. | + | * If no substitution was found, the first letter is //capitalized// and special HTML chars are replaced with entities. |
- | * Заменяются только клавиши, начинающиеся с заглавной буквы. Строчные буквы не заменяются. Например, **''C-c''** становится **''Ctrl-C''** | + | * The substitution table only has key aliases that begin with a capital letter. So lower letters will not be substituted, only capitalized and, for example, **''C-c''** becomes **''Ctrl-C''** |
- | * Если вы хотите выразить дефисную (**''-''**) клавишу, используйте **''Minus''**. | + | * If you want to express the dash (**''-''**) key, use **''Minus''**. |
- | * Если вы не хотите обрезки, замены, языковой поддержки или перевода букв в верхний регистр, заключите название клавиши в //одинарные// кавычки. | + | * If you don't want any trimming, alias or language substitution, or capitalization, enclose your key name in //single// quotes. |
+ | |||
+ | **Examples:** | ||
+ | |||
+ | * <key>C-A-del</key> to reboot. (''%%<key>C-A-del</key>%%'') | ||
+ | * <key>C-c</key> to copy text to the clipboard. (''%%<key>C-c</key>%%'') | ||
+ | * <key>C-x</key> to cut text and put it into the clipboard. (''%%<key>C-x</key>%%'') | ||
+ | * <key>C-v</key> to paste text from the clipboard. (''%%<key>C-v</key>%%'') | ||
+ | * <key>C-enter</key> to insert a page break. (''%%<key>C-enter</key>%%'') | ||
+ | * <key>C-S-Right</key> to select from current cursor position to end of a word. (''%%<key>C-S-Right</key>%%'') | ||
+ | * <key>C-S-Left</key> to select from current cursor position to the beginning of a word. (''%%<key>C-S-Left</key>%%'') | ||
+ | * <key>C-PageUp</key> to go one screen page up. (''%%<key>C-PageUp</key>%%'') | ||
+ | * <key>C-Minus</key> (''%%<key>C-Minus</key>%%'') | ||
+ | * <key>'any key'</key> to exit. (''%%<key>'any key'</key>%%'') | ||
- | **Примеры:** | ||
- | * Используйте <key>C-A-del</key> для перезагрузки. (''%%<key>C-A-del</key>%%'') | ||
- | * Используйте <key>C-c</key> для копированя текста в буфер обмена. (''%%<key>C-c</key>%%'') | ||
- | * Используйте <key>C-x</key> для удаления текста и помещения его в буфер обмена. (''%%<key>C-x</key>%%'') | ||
- | * Используйте <key>C-v</key> для вставки теста из буфера обмена. (''%%<key>C-v</key>%%'') | ||
- | * Используйте <key>C-enter</key> для вставки разрыва страницы. (''%%<key>C-enter</key>%%'') | ||
- | * Используйте <key>C-S-Right</key> для выделения от текущей позиции курсора до конца слова. (''%%<key>C-S-Right</key>%%'') | ||
- | * Используйте <key>C-S-Left</key> для выделения от текущей позиции курсора до начала слова. (''%%<key>C-S-Left</key>%%'') | ||
- | * Используйте <key>C-PageUp</key> для прокрутки на одну страницу вверх. (''%%<key>C-PageUp</key>%%'') | ||
- | * Используйте <key>C-Minus</key> для увеличения масштаба. (''%%<key>C-Minus</key>%%'') | ||
- | * Используйте <key>'any key'</key> для выхода. (''%%<key>'any key'</key>%%'') | ||
==== Синтаксический плагин Columns ==== | ==== Синтаксический плагин Columns ==== | ||
Строка 502: | Строка 508: | ||
~~INFO:syntaxplugins~~ | ~~INFO:syntaxplugins~~ | ||
+ |