The Source bundle doesn’t contain any style settings, but it does have some settings that determine what counts as a word character for purposes of code completion (as explained in this article) as well as word selection and navigation, so you might want to be careful with the distinctions being made here. Diff bundle: markup.changed, leted, markup.inserted, ,.If you use or enable other bundles, keep your eyes peeled for settings that may perform scope styling. I have also disabled these settings in my copy of TextMate, but you can’t rely on every user to do that. It’s called TextMate, after all.) To avoid having your text affected by these settings, avoid these scopes. (If I wanted font and size to vary through my document, I’d be using Microsoft Word, for heaven’s sake. In my opinion, they are among the most horrible side effects of using TextMate 2. These settings affect both the font and size of these scopes. (The underlining imposed by markup.underline is also how the Hyperlink Helper bundle injects underlining onto your URLs.) There are some other settings here, but they affect things like soft wrapping (also something to watch out for). Text bundle: markup.bold, alic, markup.underline. Here are the chief bundle settings to be aware of: Then one day I stumbled on the Text bundle, which contains the responsible setting. I couldn’t find any theme that was doing this. For example, I scratched my head for about two weeks, trying to figure out why my italic text was shown as italic. It turns out that this fact is extremely important. I was stunned to discover that, in addition to themes, a bundle’s settings can style scopes. Here are some of the main general scopes that are styled by the standard themes these are scopes that you generally want to use, because you can rely on the user to have selected a standard theme that will style them for you: comment Unfortunately, different standard themes affect different scopes ideally you should note down every scope listed in every theme, but this would take too long. To save you some time, I will now summarize the information that I gathered in this regard. Since themes and settings are going to have an effect on how your scopes are displayed, you should take some time to examine the existing themes, as well as looking through all settings of all bundles, to get some notion of what this effect might be. Settings can color and style scopes, like miniature one-rule themes. (Fortunately, at the moment, no standard bundle that I use, other than the Themes bundle, contains any themes.) Themes can also be hidden away in other bundles. You have no control over which it is yet upon this choice depends how your grammar will affect the look of a document. The user will probably have selected one of these themes. In TextMate 2, the standard themes are all in the Themes bundle. The rules for how a scope should be colored and styled, however, are to be found, not in the grammar itself, but in themes and also in settings. One of the chief reasons for writing a grammar is syntax coloring - which, like so much else about a grammar, depends on scopes. Here are some git log excerpts: Date: Wed Jan 15 13:59:57 2014 -0800įinally got recursively related match patterns working! (This was mostly because of undocumented things you mustn’t do and things that TextMate can’t do, both of which I tell you about later on this page.) After that, though, it was remarkably smooth sailing, and I was able to finish the entire grammar in a week. It then took me about three weeks of extremely frustrating, difficult work before I got my first two scopes working in the grammar. It took me some weeks just to prepare, collecting information and locating and studying the existing instructions and documentation. Writing a grammar can be a slow business. Having recently managed to write a grammar of my own for the first time, here are some things I learned along the way. Although TextMate has been around for a long time (in computer years) and many language bundles exist, it is startling to find that the process of writing a language grammar remains poorly documented.
0 kommentar(er)
