40
41
<context symbols="><&; 	 ">
41
42
<element id="e.comment" pattern="<!--" highlight="comment" starts_block="1">
42
43
<context id="c.comment" symbols="-> 	 " highlight="comment">
43
<element pattern="-->" ends_block="1" blockstartelement="e.comment" highlight="comment" mayfold="1" ends_context="1" />
44
<element pattern="-->" ends_block="1" blockstartelement="e.comment" highlight="comment" ends_context="1" />
46
47
<element id="e.entity" pattern="&[a-z0-9#]+;" is_regex="1" highlight="entity" />
47
<tag name="bflang" highlight="tag" autocomplete_append="name="" version="1">" attributes="name,version,table,matches,contexts" attribhighlight="attribute" attrib_autocomplete_append="=""" >
48
<tag name="bflang" highlight="tag" attributes="name,version,table,matches,contexts" attribhighlight="attribute" attrib_autocomplete_append="=""" >
49
<autocomplete append="name="" version="1">" />
48
50
<reference>the <i>bflang</i> tag is the root tag of the bluefish language file. It should have attribute <i>name</i> and <i>version</i>.</reference>
49
51
<context symbols="><&; 	 ">
50
52
<element idref="e.comment"/>
51
53
<element idref="e.entity" />
52
<tag name="header" highlight="tag" autocomplete_append=">" >
54
<tag name="header" highlight="tag" >
55
<autocomplete append=">" />
53
56
<reference>The <i>header</i> tag is the region of the language file that is always loaded, regardless if the language is used or not. </reference>
54
57
<context symbols="><&; 	 ">
55
58
<element idref="e.comment"/>
56
59
<element idref="e.entity" />
57
<tag name="mime" highlight="tag" autocomplete_append=" type="" />" attributes="type" attribhighlight="attribute" attrib_autocomplete_append="=""">
58
<reference>The <i>mime</i> tag should have attribute <i>type</i> which has the mime type. The mime type is used to find the correct language definition for a file in the editor. There can be multiple mime tags in the heading section.</reference>
60
<tag name="option" highlight="tag" autocomplete_append=" name="" />" attributes="default,description,name" attribhighlight="attribute" attrib_autocomplete_append="=""">
61
<reference></reference>
63
<tag name="highlight" highlight="tag" autocomplete_append=" name="" style="" />" attributes="name,style" attribhighlight="attribute" attrib_autocomplete_append="=""">
64
<reference>The <i>highlight</i> tag should have attributes <i>name</i> and <i>style</i>. The tag links the types of elements that can be highlighted (called <i>highlights</i>) and <i>styles</i> that are used by multiple languages. Default styles are hardcoded in bftexdtview2_langmgr.c A user may override each highlight / style combination in the configuration and may change the looks of each style.</reference>
60
<tag name="mime" highlight="tag" attributes="type" attribhighlight="attribute" attrib_autocomplete_append="=""">
61
<autocomplete append=" type="" />" />
62
<reference>The <i>mime</i> tag should have attribute <i>type</i> which has the mime type. The mime type is used to find the correct language definition for a file in the editor. There can be multiple mime tags in the heading section.</reference>
64
<tag name="option" highlight="tag" attributes="default,description,name" attribhighlight="attribute" attrib_autocomplete_append="=""">
65
<autocomplete append=" name="" />" />
66
<reference>A boolean (0 or 1) option that can be changed by the user. Each <i>class</i> or <i>notclass</i> used in the language file can be set by the user if defined as an option. Each block with a <i>block-name</i> used in the language file can be made <b>not foldable</b> if <i>`block-name`_foldable</i> is defined as an option. The default value defines the behavior if the user previously did not have this option, and the description is a human readable description on what the option does.</reference>
68
<tag name="highlight" highlight="tag" attributes="name,style" attribhighlight="attribute" attrib_autocomplete_append="=""">
69
<autocomplete append=" name="" style="" />" />
70
<reference>The <i>highlight</i> tag should have attributes <i>name</i> and <i>style</i>. The tag links the types of elements that can be highlighted (called <i>highlights</i>) and <i>styles</i> that are used by multiple languages. Default styles are hardcoded in bftexdtview2_langmgr.c A user may override each highlight / style combination in the configuration and may change the looks of each style.</reference>
68
<tag name="properties" highlight="tag" autocomplete_append="> </properties>" autocomplete_backup_cursor="13">
74
<tag name="properties" highlight="tag">
75
<autocomplete append="> </properties>" backup_cursor="13" />
69
76
<context symbols="><&; 	 " >
70
77
<element idref="e.comment"/>
71
78
<element idref="e.entity" />
72
<tag id="t.tagcomment" name="comment" highlight="tag" attributes="type,start,end,id" autocomplete_append=" type="" start="" />" attribhighlight="attribute" attrib_autocomplete_append="=""">
73
<reference>The comment tag specifies which comment syntax is possible in this language. This is used by the 'toggle comment' feature. In some languages this is context specific (for example Javascript inside HTML has a different comment than HTML). The id attribute can be used to set a certain comment type for a certain context.</reference>
79
<tag id="t.tagcomment" name="comment" highlight="tag" attributes="type,start,end,id" attribhighlight="attribute" attrib_autocomplete_append="=""">
80
<autocomplete append=" type="" start="" />" />
81
<reference>The comment tag specifies which comment syntax is possible in this language. This is used by the 'toggle comment' feature. In some languages this is context specific (for example Javascript inside HTML has a different comment than HTML). The id attribute can be used to set a certain comment type for a certain context.</reference>
75
83
<tag name="smartindent" highlight="tag" attributes="characters" autocomplete_append=" characters="" />" attribhighlight="attribute" attrib_autocomplete_append="="""/>
76
84
<tag name="smartoutdent" highlight="tag" attributes="characters" autocomplete_append=" characters="" />" attribhighlight="attribute" attrib_autocomplete_append="="""/>
77
<tag name="default_spellcheck" highlight="tag" attributes="enabled,spell_decode_entities" autocomplete_append=" enabled="1" />" attribhighlight="attribute" attrib_autocomplete_append="="1""/>
85
<tag name="default_spellcheck" highlight="tag" attributes="enabled,spell_decode_entities" attribhighlight="attribute" attrib_autocomplete_append="="1"">
86
<autocomplete append=" enabled="1" />" />
80
90
<tag name="definition" highlight="tag" autocomplete_append=">">
82
92
<context symbols="><&; 	 " >
83
93
<element idref="e.comment"/>
84
94
<element idref="e.entity" />
85
<tag name="context" id="t.context" highlight="tag" autocomplete_append=" symbols="" >" attributes="id,idref,symbols,highlight,commentid_block,commentid_line" attribhighlight="attribute" attrib_autocomplete_append="=""">
95
<tag name="context" id="t.context" highlight="tag" attributes="id,idref,symbols,highlight,commentid_block,commentid_line" attribhighlight="attribute" attrib_autocomplete_append="=""">
96
<autocomplete append=" symbols="" >" />
86
97
<reference>Every definition starts with a context. The most important attribute of a context are the symbols. Symbols is a string with all characters that may be at the start or end of a pattern (for example whitespace in most programming languages, or < and > in XML, SGML and HTML), or characters that are a pattern themselves (for example a bracket [ ).</reference>
87
98
<context symbols="><&; 	 ">
88
99
<element idref="e.comment"/>
89
100
<element idref="e.entity" />
90
<tag id="t.element" name="element" highlight="pattern-tag" autocomplete_append=" pattern="" />" attributes="id,idref,pattern,starts_block,ends_block,ends_context,highlight,blockstartelement,stretch_blockstart,blockhighlight,class,notclass,is_regex,case_insens,autocomplete,autocomplete_append,autocomplete_string,autocomplete_backup_cursor,mayfold,identifier_mode" attribhighlight="attribute" attrib_autocomplete_append="=""" autocomplete_backup_cursor="4">
91
<reference>Element is an actual language element that is syntax highlighted, autocompleted or has reference information. The most important attribute is pattern. The pattern may be a keyword (such as <b>function</b>) or a regular expression pattern (such as <b>[0-9]+</b>) if attribute is_regex is set to 1. </reference>
101
<tag id="t.element" name="element" highlight="pattern-tag" attributes="id,idref,pattern,starts_block,ends_block,block_name,ends_context,highlight,blockstartelement,stretch_blockstart,blockhighlight,class,notclass,is_regex,case_insens,identifier_mode" attribhighlight="attribute" attrib_autocomplete_append="=""" >
102
<autocomplete append=" pattern="" />" backup_cursor="4"/>
103
<reference>Element is an actual language element that is syntax highlighted, autocompleted or has reference information. The most important attribute is pattern. The pattern may be a keyword (such as <b>function</b>) or a regular expression pattern (such as <b>[0-9]+</b>) if attribute <i>is_regex</i> is set to 1.
104
Several attributes of an element define the block behavior. An element may start a block (<b>starts_block</b>="1"), in which case <b>block_name</b> may give a name to this block. A named block can be made optionally unfoldable by the user (see options/properties), and it can be specified in the expand/collapse popup menu. An element may also end a block, in which case <b>ends_block</b>="1" and <b>blockstartpattern</b> should specify the id of the block that starts this block.
105
An element may also end one or more contexts, the value of the attribute <b>ends_context</b> defines the number of contexts that will closed.
92
107
<context id="c.innerpattern" symbols="><&; 	 ">
93
108
<element idref="e.comment"/>
94
109
<element idref="e.entity" />
95
<tag name="reference" highlight="tag" autocomplete_append="></reference>">
110
<tag name="reference" highlight="tag" block_name="Reference block">
111
<autocomplete append="></reference>" />
96
112
<reference>reference is a tag that can be added to tag or to element. The text within the reference opening/closing is the reference information about the pertinent tag or element. Simple layout is available because the string is passed to Pango. <i>i</i>, <b>b</b>, <tt>tt</tt>, <small>small</small>, <big>big</big>, <s>s</s>, <u>u</u>, <sub>sub</sub>
97
113
<sup>sup</sup> tags are permitted. <span foreground="blue"><span foreground="blue"></span> is also permitted, see Pango Text Attribute Markup Language.</reference>
114
<context symbols="><&; 	 ">
115
<group highlight="markup-tag">
125
<tag name="span" attribhighlight="attribute" attrib_autocomplete_append="=""" attrib_autocomplete_backup_cursor="1" attributes="font,font_desc,font_family,face,font_size,size,font_style,style,font_weight,weight,font_variant,variant,font_stretch,stretch,fireground,fgcolor,color,background,bgcolor,underline,underline_color,rise,strikethrough,strikethrough_color,fallback,lang,letter_spacing,gravity,gravity_hint " />
99
<tag name="autocomplete_append" highlight="tag" attributes="autocomplete_backup_cursor,class,notclass">
100
<reference>autocomplete_append strings that are defined using an autocomplete_append tag inside a element tag override the autocomplete_append attribute on the element tag itself. The class and notclass attributes can be used to use different autocomplete_append settings dependiong on the users preferences</reference>
129
<tag name="autocomplete" id="t.autocomplete" highlight="tag" attributes="append,backup_cursor,class,notclass,enable,string" attribhighlight="attribute" attrib_autocomplete_append="=""" attrib_autocomplete_backup_cursor="1">
130
<reference>autocomplete strings that are defined using an autocomplete tag inside a element tag override the autocomplete attribute on the element tag itself. The class and notclass attributes can be used to use different autocomplete settings dependiong on the users preferences</reference>
102
132
<tag idref="t.context" />
105
<tag id="t.tag" name="tag" highlight="pattern-tag" autocomplete_append=" name="" />" attributes="id,idref,name,highlight,class,notclass,attributes,autocomplete,autocomplete_append,autocomplete_backup_cursor,attribhighlight,attrib_autocomplete_append,attrib_autocomplete_backup_cursor,case_insens,sgml_shorttag,no_close" attribhighlight="attribute" attrib_autocomplete_append="=""">
106
<reference>tag is added for convenience. Everything within tag is possible with a combination of multiple element and context tags. </reference>
135
<tag id="t.tag" name="tag" highlight="pattern-tag" attributes="id,idref,name,highlight,class,block_name,notclass,attributes,autocomplete,autocomplete_append,autocomplete_backup_cursor,attribhighlight,attrib_autocomplete_append,attrib_autocomplete_backup_cursor,case_insens,sgml_shorttag,no_close" attribhighlight="attribute" attrib_autocomplete_append="=""">
136
<autocomplete append=" name="" />" />
137
<reference>tag is added for convenience. Everything within tag is possible with a combination of multiple element and context tags. A tag automatically is a block with its own end-tag, and a tag automatically creates a new context for all attributes and autocompletes them. Most attributes are the same as <i>element</i>.</reference>
107
138
<context idref="c.innerpattern" />
109
<tag name="group" id="t.group" highlight="tag" autocomplete_append=">" attributes="highlight,autocomplete,autocomplete_append,autocomplete_backup_cursor,class,notclass,case_insens,is_regex,attrib_autocomplete_append,attrib_autocomplete_backup_cursor,attribhighlight,no_close,sgml_shorttag" attribhighlight="attribute" attrib_autocomplete_append="=""">
140
<tag name="group" id="t.group" highlight="tag" attributes="highlight,class,notclass,case_insens,is_regex,attrib_autocomplete_append,attrib_autocomplete_backup_cursor,attribhighlight,no_close,sgml_shorttag" attribhighlight="attribute" attrib_autocomplete_append="=""">
141
<autocomplete append=">" />
110
142
<reference>group is a tag that can be used to group multiple tags or multiple elements that share the same attribute values for the attributes highlight, autocomplete, autocomplete_append, class, case_insens, is_regex, attrib_autocomplete_append or attribhighlight. These attributes are then only set for the group tag, and not for the elements or tags immediately within this group tag.</reference>
111
143
<context id="c.group" symbols="><&; 	 ">
112
144
<element idref="e.comment"/>
added
removed
data/bflang/bflang2.bflang2
