问题
in .tmTheme files the scope key defines how a element is highlighted:
<dict>
<key>name</key>
<string>HTML: Attribute Values</string>
<key>scope</key>
<string>meta.tag string.quoted, meta.tag string.quoted constant.character.entity</string>
<key>settings</key>
<dict>
<key>background</key>
<string>#FFFFFF</string>
<key>fontStyle</key>
<string></string>
<key>foreground</key>
<string>#2aa198</string>
</dict>
</dict>
where can I find a list of all scopes supported by these apps, so I can create my own style?
回答1:
Unfortunately there doesn't seem to be any such comprehensive list.
However, if you press Shift+Ctrl+P in SublimeText 2, the status bar at the bottom of the screen will display a comprehensive list of all the scope keys that apply to the character immediately following your cursor position.
You can use this method to find the scope keys for anything you need from within SublimeText.
回答2:
Copy/pasting (but converting HTML to Markdown) from the current version of the "Naming Conventions" section of the TextMate Language Grammar Guide:
comment
— for comments.line
— line comments, we specialize further so that the type of comment start character(s) can be extracted from the scope.double-slash
—// comment
double-dash
—-- comment
number-sign
—# comment
percentage
—% comment
- character — other types of line comments.
block
— multi-line comments like/* … */
and<!-- … -->
.documentation
— embedded documentation.
constant
— various forms of constants.numeric
— those which represent numbers, e.g.42
,1.3f
,0x4AB1U
.character
— those which represent characters, e.g.<
,\e
,\031
.escape
— escape sequences like\e
would beconstant.character.escape
.
language
— constants (generally) provided by the language which are “special” liketrue
,false
,nil
,YES
,NO
, etc.other
— other constants, e.g. colors in CSS.
entity
— an entity refers to a larger part of the document, for example a chapter, class, function, or tag. We do not scope the entire entity asentity.*
(we usemeta.*
for that). But we do useentity.*
for the “placeholders” in the larger entity, e.g. if the entity is a chapter, we would useentity.name.section
for the chapter title.name
— we are naming the larger entity.function
— the name of a function.type
— the name of a type declaration or class.tag
— a tag name.section
— the name is the name of a section/heading.
other
— other entities.inherited-class
— the superclass/baseclass name.attribute-name
— the name of an attribute (mainly in tags).
invalid
— stuff which is “invalid”.illegal
— illegal, e.g. an ampersand or lower-than character in HTML (which is not part of an entity/tag).deprecated
— for deprecated stuff e.g. using an API function which is deprecated or using styling with strict HTML.
keyword
— keywords (when these do not fall into the other groups).control
— mainly related to flow control likecontinue
,while
,return
, etc.operator
— operators can either be textual (e.g.or
) or be characters.other
— other keywords.
markup
— this is for markup languages and generally applies to larger subsets of the text.underline
— underlined text.link
— this is for links, as a convenience this is derived frommarkup.underline
so that if there is no theme rule which specifically targetsmarkup.underline.link
then it will inherit the underline style.
bold
— bold text (text which is strong and similar should preferably be derived from this name).heading
— a section header. Optionally provide the heading level as the next element, for examplemarkup.heading.2.html
for<h2>…</h2>
in HTML.italic
— italic text (text which is emphasized and similar should preferably be derived from this name).list
— list items.numbered
— numbered list items.unnumbered
— unnumbered list items.
quote
— quoted (sometimes block quoted) text.raw
— text which is verbatim, e.g. code listings. Normally spell checking is disabled formarkup.raw
.other
— other markup constructs.
meta
— the meta scope is generally used to markup larger parts of the document. For example the entire line which declares a function would bemeta.function
and the subsets would bestorage.type
,entity.name.function
,variable.parameter
etc. and only the latter would be styled. Sometimes the meta part of the scope will be used only to limit the more general element that is styled, most of the time meta scopes are however used in scope selectors for activation of bundle items. For example in Objective-C there is a meta scope for the interface declaration of a class and the implementation, allowing the same tab-triggers to expand differently, depending on context.storage
— things relating to “storage”.type
— the type of something,class
,function
,int
,var
, etc.modifier
— a storage modifier likestatic
,final
,abstract
, etc.
string
— strings.quoted
— quoted strings.single
— single quoted strings:'foo'
.double
— double quoted strings:"foo"
.triple
— triple quoted strings:"""Python"""
.other
— other types of quoting:$'shell'
,%s{...}
.
unquoted
— for things like here-docs and here-strings.interpolated
— strings which are “evaluated”:date
,$(pwd)
.regexp
— regular expressions:/(\w+)/
.other
— other types of strings (should rarely be used).
support
— things provided by a framework or library should be belowsupport
.function
— functions provided by the framework/library. For exampleNSLog
in Objective-C issupport.function
.class
— when the framework/library provides classes.type
— types provided by the framework/library, this is probably only used for languages derived from C, which hastypedef
(andstruct
). Most other languages would introduce new types as classes.constant
— constants (magic values) provided by the framework/library.variable
— variables provided by the framework/library. For exampleNSApp
in AppKit.other
— the above should be exhaustive, but for everything else usesupport.other
.
variable
— variables. Not all languages allow easy identification (and thus markup) of these.parameter
— when the variable is declared as the parameter.language
— reserved language variables likethis
,super
,self
, etc.other
— other variables, like$some_variables
.
回答3:
There are a couple of sublime text packages you can use to do this.
Installing Package Control
Go to https://sublime.wbond.net/ and click "Installation" and follow the instructions to install sublime text package manager.
Packages Which Display the Current Scope
I know of a couple of sublime text packages which display the current scope in the status bar.
- ScopeStatus (Sublime Text 2 Only)
- ScopeHunter
- ScopeAlways (Created By Me)
- CurrentScope(Sublime Text 2 Only)
Installing One of the Above Packages
To install a package with sublime text package manager open sublime text's command palette (ctrl+shift+p
) and choose the command Package Control: Install Package
and then select one of the above packages.
回答4:
Scopes are from tmLanguage files which are different for each syntax. You can find a list of scope naming conventions at http://manual.macromates.com/en/language_grammars
回答5:
In addition to the excellent answers already posted, the Scopes Stats tab of TMTheme Editor displays a useful list of all the scopes in its 236 colour themes, with the most commonly-supported scopes at the top.
回答6:
See a reference guide on the sublime site below:
- https://www.sublimetext.com/docs/3/scope_naming.html
回答7:
Each syntax can name their own scopes, but they are based off of this list. For instance your syntax might specify that function
is storage.type.function.js
scope. If your theme supports that directly it will use that color, otherwise it will fallback to storage.type.function
then storage.type
then finally storage
trying to find a color in your theme.
Since you are creating your own style, I would recommend installing ScopeStatus (CTRL+SHIFT+P, then Install Package, then ScopeStatus). Looking at a file using the syntax you want to concentrate on, do CTRL+SHIFT+P, then "Scope: Show in Status Bar". Now you can move the cursor to various elements to see what scope they give and you can use those to define colors.
You can check your themes to see what they do, go to "Preferences->Browse Packages" to open the folder where your packages are stored. I installed "Theme - Phoenix" which has a folder and a "Color Scheme" folder underneath. In one of the theme files I found 16 colors that were used for various scopes:
keyword.operator.class, constant.other, source.php.embedded.line
variable, support.other.variable, string.other.link, entity.name.tag, entity.other.attribute-name, meta.tag, declaration.tag
constant.numeric, constant.language, support.constant, constant.character, variable.parameter, punctuation.section.embedded, keyword.other.unit
entity.name.class, entity.name.type.class, support.type, support.class
string, constant.other.symbol, entity.other.inherited-class, markup.heading
keyword.operator, constant.other.color
entity.name.function, meta.function-call, support.function, keyword.other.special-method, meta.block-level
keyword, storage, storage.type, entity.name.tag.css
invalid
meta.separator
invalid.deprecated
markup.inserted.diff, markup.deleted.diff, meta.diff.header.to-file, meta.diff.header.from-file
markup.inserted.diff, meta.diff.header.to-file
markup.deleted.diff, meta.diff.header.from-file
meta.diff.header.from-file, meta.diff.header.to-file
meta.diff.range
Different themes might have different settings, for keyword.operator.class in the first group might have its own color or be the same as meta.diff.range.
来源:https://stackoverflow.com/questions/10834765/where-to-find-a-list-of-scopes-for-sublime2-or-textmate