Зачастую, один и тот же фрагмент текста необходимо вставить в редактируемый текст несколько раз, в разное время. В этом случае на помощь приходят сниппеты, которые позволяют автоматизировать эту задачу.
Сниппет — файл в формате *.xml, имеющий расширение .sublime-snippet. Он содержит информацию о том, какой текст необходимо добавить, где, и когда. Рассмотрим формат данного файла.
content — текст сниппета. Необходимо соблюдать следующие условия:
- необходимо экранировать символ '$', т.е писать '\$'
- для создания отступов используется tab а не пробел
- текст должен быть обернут в теги '<![CDATA[' и ']]>'
- текст сниппета не может содержать ']]>'. Если все же необходимо вставить данные символы, вставьте ']]$NOT_DEFINED>'. Переменная $NOT_DEFINED не существует, поэтому вы получите ']]>' в момент вставки сниппета.
tabTrigger (не обязательный элемент) — последовательность клавиш на клавиатуре для того, чтобы вставить сниппет. Нужно нажать данные клавиши, затем клавишу Tab.
scope (не обязательный элемент) — контекст, где сниппет может быть вставлен и имеет смысл.
description (не обязательный элемент) — описание в меню Tools->Snippets.
Давайте напишем простой сниппет. В WordPress удобно смотреть отладочную информацию в файле debug.log. Наш сниппет будет выводить переменную в этот файл.
1. Выберите Tools->Developer->New Snippet. Замените текст на приведенный ниже:
<snippet>
<!-- печатает var_dump в error.log -->
<content><![CDATA[ob_start(); var_dump($1); error_log(ob_get_clean());]]></content>
<!-- необходимо нажать w+d+tab -->
<tabTrigger>wd</tabTrigger>
<!-- описание сниппета в Tools->Snippets -->
<description>error.log var_dump</description>
<!-- сниппет предназначен для php -->
<scope>source.php</scope>
</snippet>
Наш сниппет имеет один маркер, в который установится курсор сразу после вставки сниппета в php файл.
2. Сохраните файл в директории Packages/User под именем wp_var_dump.sublime-snippet
Готово. Откройте php файл, нажмите w+d+tab. Курсор установится в место первого маркера. Впишите текст переменной и нажмите tab чтобы переместится в конец сниппета.
Статья написана по материалам http://docs.sublimetext.info/en/latest/extensibility/snippets.html
Сниппет — файл в формате *.xml, имеющий расширение .sublime-snippet. Он содержит информацию о том, какой текст необходимо добавить, где, и когда. Рассмотрим формат данного файла.
content — текст сниппета. Необходимо соблюдать следующие условия:
- необходимо экранировать символ '$', т.е писать '\$'
- для создания отступов используется tab а не пробел
- текст должен быть обернут в теги '<![CDATA[' и ']]>'
- текст сниппета не может содержать ']]>'. Если все же необходимо вставить данные символы, вставьте ']]$NOT_DEFINED>'. Переменная $NOT_DEFINED не существует, поэтому вы получите ']]>' в момент вставки сниппета.
tabTrigger (не обязательный элемент) — последовательность клавиш на клавиатуре для того, чтобы вставить сниппет. Нужно нажать данные клавиши, затем клавишу Tab.
scope (не обязательный элемент) — контекст, где сниппет может быть вставлен и имеет смысл.
description (не обязательный элемент) — описание в меню Tools->Snippets.
Маркеры
Маркеры — места в тексте сниппета, по которым можно перемещаться с помощью клавиш tab, shift+tab после того как сниппет вставлен в редактируемый текст.
Давайте напишем простой сниппет. В WordPress удобно смотреть отладочную информацию в файле debug.log. Наш сниппет будет выводить переменную в этот файл.
1. Выберите Tools->Developer->New Snippet. Замените текст на приведенный ниже:
<snippet>
<!-- печатает var_dump в error.log -->
<content><![CDATA[ob_start(); var_dump($1); error_log(ob_get_clean());]]></content>
<!-- необходимо нажать w+d+tab -->
<tabTrigger>wd</tabTrigger>
<!-- описание сниппета в Tools->Snippets -->
<description>error.log var_dump</description>
<!-- сниппет предназначен для php -->
<scope>source.php</scope>
</snippet>
Наш сниппет имеет один маркер, в который установится курсор сразу после вставки сниппета в php файл.
2. Сохраните файл в директории Packages/User под именем wp_var_dump.sublime-snippet
Готово. Откройте php файл, нажмите w+d+tab. Курсор установится в место первого маркера. Впишите текст переменной и нажмите tab чтобы переместится в конец сниппета.
Статья написана по материалам http://docs.sublimetext.info/en/latest/extensibility/snippets.html
Комментариев нет:
Отправить комментарий