Большие комментарии с Sublime Text 2 - PullRequest
21 голосов
/ 24 сентября 2011

Я хотел бы сделать такие комментарии в Sublime Text 2:

/********************
* This is a comment *
********************/

Есть ли простой способ сделать это автоматически?

Кроме того, где я могу найти хорошую документацию о таких вещах. Я люблю Sublime, но чувствую, что это плохо документировано!

Ответы [ 4 ]

41 голосов
/ 29 сентября 2011

Вы можете создать фрагмент для этого.

Перейдите на Tools -> New Snippet и откроется новый файл. Вставьте это в это:

<snippet>
<content>
<![CDATA[

/********************
* $0 *
********************/

]]>

</content>
<tabTrigger>bigcom</tabTrigger>
</snippet>

Сохраните это в Packages\User -Folder (который должен быть установлен автоматически при сохранении). Теперь вы можете просто набрать bigcom (как определено в элементе <tabTrigger> -) и нажать tab. Появится комментарий, и курсор будет установлен в положение, в котором во фрагменте указано $0.

Дополнительно, вы можете добавить scope -элемент внутри <snippet> -блока, так что этот фрагмент будет работать только в определенной области синтаксиса, например:

<scope>source.python</scope> 

Невзрачно, я не знаю, как вы могли бы добавить символ * по обеим сторонам строки, в которую вы пишете автоматически, когда вы переходите на новую строку, поэтому я не знаю, подходит ли это вашему необходимо. Вы должны добавить их вручную. Тем не менее, я надеюсь, что это поможет каким-то образом.

Edit: Нашел что-то для этого в другом вопросе о stackoverflow. Посмотрите на этот ответ . При этом добавляется как минимум символ * в начале новой строки. Я посмотрю, смогу ли я заставить его добавить символ в конце строки.


Когда дело доходит до документации, я согласен, там немногое. Конечно, есть официальная документация: Sublime Doc и, конечно, форум: Sublime Forum (который в некоторый момент является хорошим ресурсом, не похожим на плохо заполненный Doc). С другой стороны, я всегда рекомендую прочитать пост на net.tutsplus , что является хорошей отправной точкой.

Я в значительной степени наткнулся на самые интересные детали, которые поставляются со стандартной установкой, просматривая файлы Global Settings и Key Bindings, которые вы можете открыть через Preferences - Меню

16 голосов
/ 06 августа 2012

Предупреждение, самоподключение.

Плагин DocBlockr может автоматически «украсить» ваш комментарий.Прямо сейчас это работает только на встроенные комментарии, но это делает работу.Сочетание клавиш Ctrl + Enter

// foo bar baz

Становится

/////////////////
// foo bar baz //
/////////////////

И работает также для последовательных комментариев:

// foo
// bar baz quux

Становится

//////////////////
// foo          //
// bar baz quux //
//////////////////
3 голосов
/ 14 мая 2012

Вы также можете попробовать использовать плагин DocBlockr

0 голосов
/ 04 июля 2015

Используйте этот удобный плагин для возвышения https://packagecontrol.io/packages/Comment-Snippets

...