Formatting Syntax Сравнение версий

Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
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 keysseparated by a dash (**''​-''​**), ​in a //​key// ​taglike 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 **''​%%&​larr;​%%''​** 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''​** становится **''​%%&larr;%%''​**, и т.п. +  ​<​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 ====