ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

CSS Comments

by brenopolanski ST2/ST3

CSS comments snippets for Sublime Text

Details

  • 2015.12.24.15.08.52
  • github.​com
  • github.​com
  • 2 years ago
  • 2 hours ago
  • 3 years ago

Installs

  • Total 12K
  • Win 8K
  • OS X 3K
  • Linux 1K
Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1
Windows 8 4 3 12 12 6 14 15 7 7 7 6 5 8 7 8 7 9 16 17 21 9 8 9 9 15 16 13 19 11 10 19 10 13 8 2 7 7 12 11 8 10 12 6 6 14
OS X 4 0 0 2 6 2 1 3 1 2 4 2 3 2 1 2 2 3 6 1 0 2 0 1 0 4 5 2 2 1 2 3 3 9 8 0 0 1 0 2 4 5 3 1 0 3
Linux 0 0 0 0 1 2 2 1 0 0 0 2 1 1 1 3 0 2 0 0 1 2 0 0 0 2 0 1 0 0 1 3 1 0 3 0 0 1 2 2 1 0 3 0 0 0

Readme

Source
raw.​githubusercontent.​com

CSS Comments snippets Build Status

CSS Comments snippets

CSS comments snippets for Sublime Text.

Well commented code is extremely important. Take time to describe components, how they work, their limitations, and the way they are constructed. Don't leave others in the team guessing as to the purpose of uncommon or non-obvious code.

Comment style should be simple and consistent within a single code base.

To install through Package Control, search for CSS Comments. If you still don't have Package Control in Sublime Text, go get it. If you insist to not install it, you can download the package and put it manually inside your Pacakages directory. It should work but will not update automatically.

Snippets

Works for CSS/LESS/Sass/SCSS/Stylus & PHP.

To trigger a comment just put a c- followed by it's name, like so:

image snippets

Basic Comment

trigger: c-basic⇥

/* Basic comment */

Long Comment

trigger: c-long⇥

/*
 * Long comment
 */

Section Comment

trigger: c-section⇥

/* ==========================================================================
   Section comment block
   ========================================================================== */

Sub-section Comment

trigger: c-subsection⇥

/* Sub-section comment block
   ========================================================================== */

Multiple Comment with TODO

trigger: c-multi⇥

/**
 * Short description using Doxygen-style comment format
 *
 * The first sentence of the long description starts here and continues on this
 * line for a while finally concluding here at the end of this paragraph.
 *
 * The long description is ideal for more detailed explanations and
 * documentation. It can include example HTML, URLs, or any other information
 * that is deemed necessary or useful.
 *
 * @tag This is a tag named 'tag'
 *
 * TODO: This is a todo statement that describes an atomic task to be completed
 *   at a later date. It wraps after 80 characters and following lines are
 *   indented by 2 spaces.
 */

Summary Comment

trigger: c-summary⇥

/**
 * Description: Short description.
 * Version: 1.0.0
 * Last update: YYYY/MM/DD
 * Author: User Name <username@gmail.com>
 *
 * Summary:
 *
 *    0. ELEMENT
 *        - 0.1. TYPE ELEMENT
 *        - 0.2. TYPE ELEMENT
 *    1. ELEMENT
 *        - 1.1. TYPE ELEMENT
 *        - 1.2. TYPE ELEMENT
 */

/* ==========================================================================
   0. ELEMENT
   ========================================================================== */

/* 0.1. TYPE ELEMENT
   ========================================================================== */

/* 0.2. TYPE ELEMENT
   ========================================================================== */

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m "Add some feature"
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :)

English is the universal language nowadays, so please don't create or comment on issues using another language.

History

For detailed changelog, see Releases.

Credits

Comment format based on Idiomatic CSS by Nicolas Gallagher.

License

MIT License © Breno Polanski