search

guillermooo / sublime-undocs

Sublime Text Unofficial Documentation
http://docs.sublimetext.info
Other
605 stars 333 forks source link

Documentation of Syntax Naming Conventions #101

Open leoheck opened 10 years ago

leoheck commented 10 years ago

Hi, its possible to update the documentation with the _Naming Conventions_ for syntax files? You can search the some information here (I believe that is the same for sublime): http://manual.macromates.com/en/language_grammars

FichteFoll commented 10 years ago

Check the Textmate online manual for guidance on scope names.

This section is actually in the documentation and has initially led me to browse the docs in order to find scope names for my first syntax, but I agree that this is definitely not enough. We might as well mirror the TM docs and add a few other conventions like the punctuation thing.

I think we should add a separate doc about scopes and scope selectors for this purpose that we can also link from syntax definitions and color schemes.

leoheck commented 10 years ago

A separate doc should be fine. Thanks.

jcrben commented 9 years ago

As far as #69 this seems to be covered in more detail at http://sublimetext.info/docs/en/extensibility/syntaxdefs.html#scopes-and-scope-selectors - the equivalent page here might be http://sublime-text-unofficial-documentation.readthedocs.org/en/latest/reference/syntaxdefs.html but it is more limited.

FichteFoll commented 8 years ago

ed6fba5288bdd7e9f28b9f3a74e8f32acb8e5de8 adds a reference to the official docs in our color scheme docs.

I will take a look at our syntax docs at another time.