Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
|
wiki:syntax [2012/04/26 18:24] [Картинки-ссылки] исправление отстутствующей картинки и грамматич. ошибки |
wiki:syntax [2012/04/27 10:02] |
||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| ====== Синтаксис форматирования ====== | ====== Синтаксис форматирования ====== | ||
| + | |||
| + | <note important>Наиболее актуальная версия всегда находится [[http://help.ubuntu.ru/wiki/syntax|здесь]].</note> | ||
| DokuWiki поддерживает простой язык разметки, который по возможности сохраняет исходный текст как можно более читабельным. Здесь перечислены все доступные синтаксические конструкции, которые можно использовать при редактировании страниц на данном ресурсе. Если хотите поупражняться в использовании разметки, используйте специально предназначенную для этого [[playground:playground|«песочницу»]]. Большинство элементов разметки также можно добавить с помощью панели инструментов, которая появляется при редактировании над областью изменения текста. | DokuWiki поддерживает простой язык разметки, который по возможности сохраняет исходный текст как можно более читабельным. Здесь перечислены все доступные синтаксические конструкции, которые можно использовать при редактировании страниц на данном ресурсе. Если хотите поупражняться в использовании разметки, используйте специально предназначенную для этого [[playground:playground|«песочницу»]]. Большинство элементов разметки также можно добавить с помощью панели инструментов, которая появляется при редактировании над областью изменения текста. | ||
| Строка 5: | Строка 7: | ||
| ===== Основные конструкции форматирования ===== | ===== Основные конструкции форматирования ===== | ||
| - | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: | + | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: |
| <code> | <code> | ||
| - | DokuWiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, __подчеркнутый текст__ | + | DokuWiki поддерживает выделение текста **полужирным шрифтом**, //курсивом//, __подчеркнутым__, |
| - | и вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**. | + | вывод текста ''моноширинным шрифтом''. Все эти конструкции можно **__//''объединить''//__**: |
| </code> | </code> | ||
| Строка 28: | Строка 30: | ||
| перенести текст на новую строку. | перенести текст на новую строку. | ||
| </code> | </code> | ||
| - | |||
| ===== Ссылки ===== | ===== Ссылки ===== | ||
| Строка 34: | Строка 35: | ||
| ==== Внешние ==== | ==== Внешние ==== | ||
| - | Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Можно использовать | + | Внешние ссылки распознаются автоматически: http://www.ubuntu.ru или просто www.ubuntu.ru. Можно использовать и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. Также можно добавлять адреса электронной почты: andi@splitbrain.org: |
| - | и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. | + | |
| - | Кроме того можно добавлять адреса электронной почты: <andi@splitbrain.org>: | + | |
| <code> | <code> | ||
| - | Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com. Можно использовать | + | Внешние ссылки распознаются автоматически: http://www.ubuntu.ru или просто www.ubuntu.ru. |
| - | и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. | + | Можно использовать и явный синтаксис, который позволяет указывать текст ссылки: [[http://ubuntu.ru|Это ссылка на Ubuntu.ru]]. |
| - | Кроме того можно добавлять адреса электронной почты: <andi@splitbrain.org>. | + | Также можно добавлять адреса электронной почты: andi@splitbrain.org. |
| </code> | </code> | ||
| - | |||
| ==== Внутренние ==== | ==== Внутренние ==== | ||
| Строка 55: | Строка 53: | ||
| </code> | </code> | ||
| - | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:terms:главная|ссылка с использованием относительных путей]]: | + | Имена Wiki-страниц автоматически переводятся в нижний регистр, и пробел заменяется на подчёркивание, спецсимволы использовать нельзя. Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и [[.:..:loco:главная|ссылка с использованием относительных путей]]: |
| <code> | <code> | ||
| Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | Вот ещё пару интересных примеров: [[#внутренние|ссылка на подраздел текущего документа]] и | ||
| - | [[.:..:terms:главная|ссылка с использованием относительных путей]]. | + | [[.:..:loco:главная|ссылка с использованием относительных путей]]. |
| </code> | </code> | ||
| Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | Кстати, ссылки на [[syntax|существующие страницы]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | ||
| - | |||
| ==== Ссылки на профили пользователей форума ==== | ==== Ссылки на профили пользователей форума ==== | ||
| Строка 198: | Строка 195: | ||
| ===== Картинки и другие файлы ===== | ===== Картинки и другие файлы ===== | ||
| - | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. | + | С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. |
| - | Для закачки файла на вики в режиме редактирования статьи одна из кнопочек над формой редактирования вызывает менеджер закачки файлов. | + | Для загрузки файла на вики в режиме редактирования статьи одна из кнопок над формой редактирования вызывает менеджер закачки файлов. |
| По желанию можно указать их размер. | По желанию можно указать их размер. | ||
| - | Нормальный размер: {{wiki:dokuwiki-128.png}} | + | Полный размер: {{wiki:dokuwiki-128.png}} |
| Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}} | ||
| Строка 213: | Строка 210: | ||
| <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}} | ||
| Строка 219: | Строка 216: | ||
| </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>{{wiki:dokuwiki-128.png }} | + | <code> |
| - | {{ wiki:dokuwiki-128.png}} | + | {{wiki:dokuwiki-128.png |Первая строка кода (см. ниже)}} |
| - | {{ wiki:dokuwiki-128.png }} | + | {{ wiki:dokuwiki-128.png|Вторая строка кода (см.ниже)}} |
| + | {{ wiki:dokuwiki-128.png |Третья строка кода (см.ниже)}} | ||
| </code> | </code> | ||
| Строка 236: | Строка 234: | ||
| <code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | <code>{{ wiki:dokuwiki-128.png |Название картинки}}</code> | ||
| - | Если задать имя файла (внутреннее или внешнее), который не является картинкой (''gif, jpeg, png''), оно будет отображаться в виде ссылки. | + | Если задать имя файла (внутреннее или внешнее), которое не является картинкой (''gif'', ''jpeg'', ''png''), оно будет отображаться в виде ссылки. |
| - | + | ||
| - | Узнать, как вставить картинку со ссылкой можно в [[#картинки-ссылки|разделе выше]]. | + | |
| + | Узнать, как вставить картинку со ссылкой, можно в [[#картинки-ссылки|разделе выше]]. | ||
| ===== Смайлики ===== | ===== Смайлики ===== | ||
| Строка 436: | Строка 433: | ||
| ==== Cинтаксический плагин Keyboard ==== | ==== Cинтаксический плагин Keyboard ==== | ||
| - | Enclose the name of a key, or a combination of keys, separated by a dash (**''-''**), in a //key// tag, like this: | + | Заключите название клавиши или комбинацию клавиш, разделённых дефисом (**''-''**), в тег //key//, как здесь: |
| - | <key>Key</key> or <key>C-x</key> | + | <key>Клавиша</key> или <key>C-x</key> |
| - | * The text inside the **''key''** tag is split at the occurrences of **''-''** (dash). | + | * Текст внутри тега **''key''** делится на позициях **''-''** (дефиса). |
| - | * Each part is //trimmed// (surrounding whitespace removed) and known shortcuts or key names are //substituted//. E.g. **''C''** becomes **''Ctrl''**, **''Left''** becomes **''%%←%%''** etc. | + | * Каждая часть //обрезается// (удаляются окружающие пробелы), а известные сокращения клавиш //заменяются// на полные варианты. Например, **''C''** становится **''Ctrl''**, **''Left''** становится **''%%←%%''**, и т.п. |
| - | * 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. | + | * Замена сокращений //зависит от языка//. Например, в немецком, **''C''** становится **''Strg''**, а **''Del''** становится **''Entf''**. На данный момент поддерживаются только английсткий и немецний. Вы можете помочь, написав дополнительные заголовочные файлы и отправив их для включения. |
| - | * If no substitution was found, the first letter is //capitalized// and special HTML chars are replaced with entities. | + | * Если замены не найдено, первая буква становится //заглавной//, а специальные HTML-символы заменяются сущностями. |
| - | * 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''** | + | * Заменяются только клавиши, начинающиеся с заглавной буквы. Строчные буквы не заменяются. Например, **''C-c''** становится **''Ctrl-C''** |
| - | * If you want to express the dash (**''-''**) key, use **''Minus''**. | + | * Если вы хотите выразить дефисную (**''-''**) клавишу, используйте **''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 ==== | ||
| Строка 507: | Строка 502: | ||
| ~~INFO:syntaxplugins~~ | ~~INFO:syntaxplugins~~ | ||
| - | |||
