1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
<!DOCTYPE html>
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<title>test.mss</title>
<meta name="generator" content="KF5::SyntaxHighlighting - Definition (CartoCSS MSS) - Theme (Breeze Light)"/>
</head><body style="background-color:#ffffff;color:#1f1c1b"><pre>
<span style="color:#898887">/* </span><span style="color:#ca60ca">kate:</span><span style="color:#898887"> </span><span style="color:#0095ff">hl</span><span style="color:#bf0303"> CartoCSS</span>
<span style="color:#898887"> This file contains some content coming from</span>
<span style="color:#898887"> https://github.com/gravitystorm/openstreetmap-carto</span>
<span style="color:#898887"> with CC0 license. This file is just for testing</span>
<span style="color:#898887"> katepart highlighting engine.</span>
<span style="color:#898887"> */</span>
<span style="color:#898887">/* This is</span>
<span style="color:#898887">a multiline comment. */</span>
<span style="color:#898887">// This is a single-line comment.</span>
#world <span style="color:#ca60ca">{</span>
<span style="color:#898887">// various styles to define colors (all except the color function are rendered the same way):</span>
<span style="color:#898887">// Numbers are always treated as floating-point and highlighted. This syntax</span>
polygon-opacity<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">50%</span><span style="color:#ca60ca">;</span>
<span style="color:#898887">// is equivalent to</span>
polygon-opacity<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">0.5</span><span style="color:#ca60ca">;</span>
<span style="color:#898887">// This is a coma-separated list of numbers:</span>
line-dasharray<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">6</span><span style="color:#ca60ca">,</span><span style="color:#b08000">3</span><span style="color:#ca60ca">,</span><span style="color:#b08000">2</span><span style="color:#ca60ca">,</span><span style="color:#b08000">3</span><span style="color:#ca60ca">,</span><span style="color:#b08000">2</span><span style="color:#ca60ca">,</span><span style="color:#b08000">3</span><span style="color:#ca60ca">;</span>
<span style="color:#898887">// Also function calls are possible. Function calls like “url” get special highlighting:</span>
shield-file<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#644a9b">url</span><span style="color:#ca60ca">(</span><span style="color:#ff5500">"myfile.svg"</span><span style="color:#ca60ca">);</span>
<span style="color:#898887">// Within function calls, strings can contains fields like [width] which get special highlighting:</span>
shield-file<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#644a9b">url</span><span style="color:#ca60ca">(</span><span style="color:#ff5500">"symbols/shields/motorway_</span><span style="color:#0057ae">[width]</span><span style="color:#ff5500">x</span><span style="color:#0057ae">[height]</span><span style="color:#ff5500">.svg"</span><span style="color:#ca60ca">);</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">white</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// List of known colors</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">#ffffff</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Six-digit hex color</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">#fff</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Three-digit hex color</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> #ffff</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Invalid hex color</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#644a9b">rgba</span><span style="color:#ca60ca">(</span><span style="color:#b08000">255</span><span style="color:#ca60ca">,</span><span style="color:#b08000">255</span><span style="color:#ca60ca">,</span><span style="color:#b08000">255</span><span style="color:#ca60ca">,</span><span style="color:#b08000">1</span><span style="color:#ca60ca">);</span> <span style="color:#898887">// define a color by a special function</span>
<span style="color:#898887">// everything else is simply interpreted as keyword:</span>
line-clip<span style="color:#ca60ca">:</span><span style="font-weight:bold"> false</span><span style="color:#ca60ca">;</span>
line-clip<span style="color:#ca60ca">:</span><span style="font-weight:bold"> abcdef</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#898887">// You can define macros called “CartoCSS variables” with arbitrary values and types.</span>
<span style="color:#898887">// They do not behave much like variable, but more like macros.</span>
<span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">15</span><span style="color:#ca60ca">;</span>
<span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">#123456</span><span style="color:#ca60ca">;</span>
<span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">white</span><span style="color:#ca60ca">;</span>
<span style="color:#006e28">@myothervariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// this variable gets defined by the value of another variable</span>
<span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#644a9b">darken</span><span style="color:#ca60ca">(</span><span style="color:#aa5500">white</span><span style="color:#ca60ca">,</span><span style="font-weight:bold"> </span><span style="color:#b08000">5%</span><span style="color:#ca60ca">);</span> <span style="color:#898887">// A variable defined by the result of a function. The function “darken” gets special highlighting.</span>
<span style="color:#898887">// Variables can also contain strings:</span>
<span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">'abc'</span><span style="color:#ca60ca">;</span>
<span style="color:#898887">// These variables can be used later as values</span>
#world <span style="color:#ca60ca">{</span>
polygon-fill<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#006e28">@myvariable</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#898887">/* Typically, in MSS files you declare filters like “#world[zoom >= 17]”</span>
<span style="color:#898887">followed by curly braces with parameters like “size” for Mapnik symbolizers like “text”. */</span>
<span style="color:#898887">// Each Mapnik symbolizer parameter can be on its own line:</span>
#world<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">17</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
text-wrap-width<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">20</span><span style="color:#ca60ca">;</span>
text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#898887">// Or you can put various of them into the same line:</span>
#world<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">19</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span> text-wrap-width<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">20</span><span style="color:#ca60ca">;</span> text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="color:#ca60ca">;</span> <span style="color:#ca60ca">}</span>
<span style="color:#898887">// It is allowed to omit the final “;” for the last Mapnik symbolizer parameter within a block:</span>
#world<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">19</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span> text-wrap-width<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">20</span><span style="color:#ca60ca">;</span> text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">}</span>
<span style="color:#898887">// Also after an omitted final “;” the following code is nevertheless highlighted correctly:</span>
#world<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">19</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span> text-wrap-width<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">20</span><span style="color:#ca60ca">;</span> text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">;</span> <span style="color:#ca60ca">}</span>
<span style="color:#898887">// “null” and “zoom” are special keywords within filters, and highlighted as such:</span>
<span style="color:#ca60ca">[</span><span style="color:#0057ae">"name" </span><span style="color:#ca60ca">!=</span><span style="font-weight:bold"> null</span><span style="color:#ca60ca">][</span><span style="color:#0057ae">"ref" </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> null</span><span style="color:#ca60ca">][</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">19</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span> text-wrap-width<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">20</span><span style="color:#ca60ca">;</span> <span style="color:#ca60ca">}</span>
#admin-low-zoom<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca"><</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="color:#ca60ca">]</span>, <span style="color:#898887">// You can make coma-separated lists of various filters</span>
#admin-mid-zoom<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="color:#ca60ca">][</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca"><</span><span style="font-weight:bold"> </span><span style="color:#b08000">13</span><span style="color:#ca60ca">]</span>, <span style="color:#898887">// like this one.</span>
#admin-high-zoom<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">13</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> </span><span style="color:#b08000">15</span><span style="color:#ca60ca">]</span> <span style="color:#898887">// “zoom” has special behaviour within filters and gets its own highlighting</span>
<span style="color:#ca60ca">[</span><span style="color:#0057ae">admin_level </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> </span><span style="color:#bf0303">'2'</span><span style="color:#ca60ca">]</span>, <span style="color:#898887">// data fields like “admin_level” can be referenced by their name and get highlighting as data fields</span>
<span style="color:#ca60ca">[</span><span style="color:#0057ae">"admin_level" </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> </span><span style="color:#bf0303">'2'</span><span style="color:#ca60ca">]</span>, <span style="color:#898887">// data fields like “admin_level” can be referenced by their name in quotes and get highlighting as data fields</span>
<span style="color:#ca60ca">[</span><span style="color:#0057ae">admin_level </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> </span><span style="color:#bf0303">'3'</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">4</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
<span style="color:#898887">// You can create additional “Named instances” of Mapnik symbolizers by adding a “myname/” before the symbolizer.</span>
<span style="color:#898887">// The name of the named instance gets special highlighting:</span>
<span style="color:#0057ae">background/</span>line-color<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#aa5500">white</span><span style="color:#ca60ca">;</span>
line-color<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#006e28">@admin-boundaries</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#ca60ca">}</span>
<span style="color:#ca60ca">}</span>
#admin-mid-zoom<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">11</span><span style="color:#ca60ca">][</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca"><</span><span style="font-weight:bold"> </span><span style="color:#b08000">13</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
<span style="color:#ca60ca">[</span><span style="color:#0057ae">admin_level </span><span style="color:#ca60ca">=</span><span style="font-weight:bold"> </span><span style="color:#bf0303">'abc'</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span> <span style="color:#898887">// The string 'abc' is highlighted as a verbatim string, not as an expression string.</span>
<span style="color:#ca60ca">[</span><span style="font-weight:bold">zoom</span><span style="color:#0057ae"> </span><span style="color:#ca60ca">>=</span><span style="font-weight:bold"> </span><span style="color:#b08000">4</span><span style="color:#ca60ca">]</span> <span style="color:#ca60ca">{</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#0057ae">[test]</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// simplified reference to the value of the data field “test”</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"</span><span style="color:#0057ae">[test]</span><span style="color:#ff5500">"</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// another reference to the data field “test”, this time within an expression string</span>
<span style="color:#898887">// A rather complex expression string that will do some math; @zoom is a special runtime value (in spite</span>
<span style="color:#898887">// of the @ it has nothing to do with ordinary variables):</span>
text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"(</span><span style="color:#0057ae">[way_area]</span><span style="color:#ff5500">*pow(4,</span><span style="color:#3daee9">@zoom</span><span style="color:#ff5500">)/24505740000)"</span><span style="color:#ca60ca">;</span>
<span style="color:#898887">// Here the same thing as simple expression:</span>
<span style="color:#898887">// Note that @zoom now is highlighted in another color, because in this context it does not reference to a</span>
<span style="color:#898887">// runtime variable anymore, but to an ordinary CartoCSS variable:</span>
text-size<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">(</span><span style="color:#0057ae">[way_area]</span><span style="color:#ca60ca">*</span><span style="color:#644a9b">pow</span><span style="color:#ca60ca">(</span><span style="color:#b08000">4</span><span style="color:#ca60ca">,</span><span style="color:#006e28">@zoom</span><span style="color:#ca60ca">)/</span><span style="color:#b08000">24505740000</span><span style="color:#ca60ca">);</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"</span><span style="color:#bf0303">'Value: '</span><span style="color:#0057ae">[test]</span><span style="color:#ff5500">"</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// A verbatim string 'Value: ' as part of an expression string.</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">'</span><span style="color:#bf0303">"Value: "</span><span style="color:#0057ae">[test]</span><span style="color:#ff5500">'</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// " and ' are interchangeable. The outer is always the expression string and the inner the verbatim string.</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"</span><span style="color:#0057ae">[field]</span><span style="color:#ff5500">\n"</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Expression strings however do not have escape sequences, so \n gets no special highlighting here. [field] however is highlighted as data field.</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"</span><span style="color:#0057ae">[field]</span><span style="color:#ff5500">+</span><span style="color:#bf0303">'</span><span style="color:#3daee9">\n</span><span style="color:#bf0303">'</span><span style="color:#ff5500">+</span><span style="color:#0057ae">[otherfield]</span><span style="color:#ff5500">"</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Inner strings, here the single-quoted string, are normal strings and highlight escape sequences like \n.</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"</span><span style="color:#0057ae">[field]</span><span style="color:#ff5500">+</span><span style="color:#bf0303">'[testfield]'</span><span style="color:#ff5500">+</span><span style="color:#0057ae">[otherfield]</span><span style="color:#ff5500">"</span><span style="color:#ca60ca">;</span> <span style="color:#898887">// Inner strings, here the single-quoted string, are normal strings and do not highlight any fields like [testfield].</span>
text-name<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#0057ae">[name]</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">+</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">/*</span><span style="font-weight:bold"> Comments are not allowed within expressions</span><span style="color:#ca60ca">,</span><span style="font-weight:bold"> so no special comment highlighting here. </span><span style="color:#ca60ca">*/</span><span style="font-weight:bold"> </span><span style="color:#ff5500">"\n"</span><span style="font-weight:bold"> </span><span style="color:#ca60ca">+</span><span style="font-weight:bold"> </span><span style="color:#0057ae">[ref]</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#ca60ca">}</span>
<span style="color:#ca60ca">}</span>
.nature <span style="color:#ca60ca">{</span> <span style="color:#898887">// .nature references a class, which is similar to a layer like #nature, so both are rendered the same way</span>
<span style="font-weight:bold">::fill</span> <span style="color:#ca60ca">{</span>
<span style="color:#898887">/* The :: syntax defined “attachments” (a sort of sub-layer within normal layers), here “::fill”.</span>
<span style="color:#898887"> Everything that is defined within an attachment is applied in the order of the first occurrence</span>
<span style="color:#898887"> of the attachment, instead of following the normal appliance order. Therefore attachments are</span>
<span style="color:#898887"> highlighted as dsControlFlow by default. */</span>
opacity<span style="color:#ca60ca">:</span><span style="font-weight:bold"> </span><span style="color:#b08000">0.05</span><span style="color:#ca60ca">;</span>
<span style="color:#ca60ca">}</span>
<span style="color:#ca60ca">}</span>
</pre></body></html>
|
