Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
wiki:syntax [2012/04/26 20:01] [Cинтаксический плагин Keyboard] перевод |
wiki:syntax [2012/06/13 15:24] старая ревизия восстановлена |
||
---|---|---|---|
Строка 5: | Строка 5: | ||
===== Основные конструкции форматирования ===== | ===== Основные конструкции форматирования ===== | ||
- | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: | + | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: |
<code> | <code> | ||
- | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, | + | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ |
- | вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: | + | и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**. |
</code> | </code> | ||
Строка 28: | Строка 28: | ||
перенести текст на новую строку. | перенести текст на новую строку. | ||
</code> | </code> | ||
+ | |||
===== Ссылки ===== | ===== Ссылки ===== | ||
Строка 33: | Строка 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> | ||
+ | |||
==== Внутренние ==== | ==== Внутренние ==== | ||
Строка 51: | Строка 55: | ||
</code> | </code> | ||
- | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:loco:главная|ссылка с использованием относительных путей]]: | + | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:terms:главная|ссылка с использованием относительных путей]]: |
<code> | <code> | ||
Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | ||
- | [[.:..:loco:главная|ссылка с использованием относительных путей]]. | + | [[.:..:terms:главная|ссылка с использованием относительных путей]]. |
</code> | </code> | ||
Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | ||
+ | |||
==== Ссылки на профили пользователей форума ==== | ==== Ссылки на профили пользователей форума ==== | ||
Строка 91: | Строка 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> | ||
- | Учтите: форматирование картинок --- это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. | + | Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки. |
==== Сноски ==== | ==== Сноски ==== | ||
Строка 193: | Строка 199: | ||
===== Картинки и другие файлы ===== | ===== Картинки и другие файлы ===== | ||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. | + | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. |
- | Для загрузки файла на вики в режиме редактирования статьи одна из кнопок над формой редактирования вызывает менеджер закачки файлов. | + | Для закачки файла на вики в режиме редактирования статьи одна из кнопочек над формой редактирования вызывает менеджер закачки файлов. |
По желанию можно указать их размер. | По желанию можно указать их размер. | ||
- | Полный размер: {{wiki:dokuwiki-128.png}} | + | Нормальный размер: {{wiki:dokuwiki-128.png}} |
Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | ||
Строка 208: | Строка 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}} | ||
Строка 214: | Строка 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> | ||
Строка 232: | Строка 237: | ||
<code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | <code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | ||
- | Если задать имя файла (внутреннее или внешнее), которое не является картинкой (''gif'', ''jpeg'', ''png''), оно будет отображаться в виде ссылки. | + | Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки. |
+ | |||
+ | Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]]. | ||
- | Узнать, как вставить картинку со ссылкой, можно в [[#картинки-ссылки|разделе выше]]. | ||
===== Смайлики ===== | ===== Смайлики ===== | ||
Строка 431: | Строка 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> or <key>C-x</key> | ||
+ | |||
+ | * The text inside the **''key''** tag is split at the occurrences of **''-''** (dash). | ||
+ | * Each part is //trimmed// (surrounding whitespace removed) and known shortcuts or key names are //substituted//. E.g. **''C''** becomes **''Ctrl''**, **''Left''** becomes **''%%←%%''** etc. | ||
+ | * 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. | ||
+ | * If no substitution was found, the first letter is //capitalized// and special HTML chars are replaced with entities. | ||
+ | * 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''** | ||
+ | * 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. | ||
- | <key>Клавиша</key> или <key>C-x</key> | + | **Examples:** |
- | * Текст внутри тега **''key''** делится на позициях **''-''** (дефиса). | + | * <key>C-A-del</key> to reboot. (''%%<key>C-A-del</key>%%'') |
- | * Каждая часть //обрезается// (удаляются окружающие пробелы), а известные сокращения клавиш //заменяются// на полные варианты. Например, **''C''** становится **''Ctrl''**, **''Left''** становится **''%%←%%''**, и т.п. | + | * <key>C-c</key> to copy text to the clipboard. (''%%<key>C-c</key>%%'') |
- | * Замена сокращений //зависит от языка//. Например, в немецком, **''C''** становится **''Strg''**, а **''Del''** становится **''Entf''**. На данный момент поддерживаются только английсткий и немецний. Вы можете помочь, написав дополнительные заголовочные файлы и отправив их для включения. | + | * <key>C-x</key> to cut text and put it into the clipboard. (''%%<key>C-x</key>%%'') |
- | * Если замены не найдено, первая буква становится //заглавной//, а специальные HTML-символы заменяются сущностями. | + | * <key>C-v</key> to paste text from the clipboard. (''%%<key>C-v</key>%%'') |
- | * Заменяются только клавиши, начинающиеся с заглавной буквы. Строчные буквы не заменяются. Например, **''C-c''** становится **''Ctrl-C''** | + | * <key>C-enter</key> to insert a page break. (''%%<key>C-enter</key>%%'') |
- | * Если вы хотите выразить дефисную (**''-''**) клавишу, используйте **''Minus''**. | + | * <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 ==== | ||