Bill Valaski: moved Man 2 ch08s12 to Highlight Patterns Modification: Title updates (BV)

2010-07-09T00:24:44Z

moved Man 2 ch08s12 to Highlight Patterns Modification: Title updates (BV)

← Older revision	Revision as of 00:24, 9 July 2010
(No difference)

Fal7i at 11:29, 31 December 2009

2009-12-31T11:29:21Z

← Older revision		Revision as of 11:29, 31 December 2009
Line 1:		Line 1:
	~~__NOTOC__~~
	~~__NOEDITSECTION__~~
	{{Man2top		{{Man2top
	\|lang=en		\|lang=en
Line 10:		Line 8:
	\|next=Man 2 ch09		\|next=Man 2 ch09
	}}		}}
	~~== 12. Modifying the highlighting patterns ==~~
	The highlight patterns are build from Perl compatible regular expressions. A pattern has options for coloring and styling the text it matches. Within a match other patterns can be used to color parts of that match. There are three types of patterns:		The highlight patterns are build from Perl compatible regular expressions. A pattern has options for coloring and styling the text it matches. Within a match other patterns can be used to color parts of that match. There are three types of patterns:

Line 102:		Line 100:
	As an exercise you may want to add the highlighting patterns for the xsl stylesheet file type created previously. They will be based on the xml patterns with just small changes.		As an exercise you may want to add the highlighting patterns for the xsl stylesheet file type created previously. They will be based on the xml patterns with just small changes.

			{{note\|text=If you check the force bold weight check box, you should also check that the font you use has a bold variant in the Editor tab of the Preferences panel.}}
	~~[[File:Man2_note.png]]~~ If you check the force bold weight check box, you should also check that the font you use has a bold variant in the Editor tab of the Preferences panel.

Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man2top |lang=en |rev=2.0.0 |st=d |Title=12. Modifying the highlighting patterns |prev=Man 2 ch08s11 |Subtitle=Chapter VIII. Customis…'

2009-12-29T18:42:00Z

Created page with '__NOTOC__ __NOEDITSECTION__ {{Man2top |lang=en |rev=2.0.0 |st=d |Title=12. Modifying the highlighting patterns |prev=Man 2 ch08s11 |Subtitle=Chapter VIII. Customis…'

New page

__NOTOC__
__NOEDITSECTION__
{{Man2top
|lang=en
|rev=2.0.0
|st=d
|Title=12. Modifying the highlighting patterns
|prev=Man 2 ch08s11
|Subtitle=Chapter VIII. Customising Bluefish
|next=Man 2 ch09
}}
== 12. Modifying the highlighting patterns ==
The highlight patterns are build from Perl compatible regular expressions. A pattern has options for coloring and styling the text it matches. Within a match other patterns can be used to color parts of that match. There are three types of patterns:

# Start pattern and end pattern: that is two distinct patterns, match from the start pattern to the end pattern
# Only start pattern: that is a unique pattern that matches from start to end
# Subpattern from parent: that is a subpattern from the parent pattern, specified by the range in the parent pattern.

One specific pattern can also be used within several other parent patterns. The parent-match option is a regular expression that defines all parents for a certain pattern. If empty it will default to ^top$, so basically it will be on the top level.

So how does it work? Lets take a look at a little example text, a piece of PHP code within some HTML code:

<nowiki><p align="center"></nowiki>
<nowiki><?php</nowiki>
// this is a comment ?>
?>

The first thing the highlighting engine does is finding the pattern that has the lowest match. Using the default patterns for PHP, the pattern named HTML:

[[File:Man2_highlighting_pattern1.png|none|frame|The HTML Pattern]]

has a match at position 0:

<nowiki><p align="center"></nowiki>

So now the highlighting engine searches for the lowest match in all subpatterns of HTML, in the region matched by a type 2 pattern. Again, the lowest match will count. The pattern named <nowiki><html> Tags</nowiki>:

[[File:Man2_highlighting_pattern2.png|none|frame|The <html> Tags Pattern]]

has a match at position 1. This pattern is a type 3 pattern, so it matches a subpattern of the parent:

p

The match from subpattern <nowiki><html> Tags</nowiki> ends at position 2 and it does not have any child patterns, so the highlighting engine continues at position 2 with all subpatterns from HTML. A type 2 pattern named HTML Attributes:

[[File:Man2_highlighting_pattern3.png|none|frame|The HTML Attributes Pattern]]

has the lowest match:

align="center"

This pattern does have a child pattern, again a type 3 pattern called HTML Attribute Contents:

[[File:Man2_highlighting_pattern4.png|none|frame|The HTML Attribute Contents Pattern]]

matching:

"center"

The pattern HTML Attribute Contents does not have any child patterns, and subpatterns of HTML Attributes do not have any more matches, and also HTML subpatterns do not have any more matches. So we are back on the main level, the remaining code to highlight is:

<nowiki><?php</nowiki>
// this is a comment ?>
?>

Now a pattern named PHP Block:

[[File:Man2_highlighting_pattern5.png|none|frame|The PHP Block Pattern]]

has the lowest match. This is a type 1 pattern, so the highlight engine continues with all the remaining code, but it will not only search for the lowest match of the child patterns of PHP Block, but it will also ue it for the end pattern of PHP Block. The lowest match in this example is a pattern named Comment (C++/single line):

[[File:Man2_highlighting_pattern6.png|none|frame|The Comment (C++/single line) Pattern]]

As you can see the ?> within the comment does not end the <tt>php</tt> pattern, because it lies within a subpattern of PHP Block:

// this is a comment ?>

The pattern Comment (C++/single line) does not have any child patterns, so the remaining code for the PHP subpatterns is:

?>

It is very obvious now, the lowest match will be the end pattern of the php pattern, so we're back on the main level, and we have matched all of the code!

[[File:Man2_syntax_highlighting_example.png|none|frame|Syntax Highlighting Example]]

The config file for highlighting is a colon separated array with the following content:

mode:
patternname:
case_sensitive(0-on/1-off):
start reg-ex:
end reg-ex:
start & end pattern(1), only start(2), subpattern(3):
parent-match:
foreground-color:
background-color:
don't change weight(0), non-bold(1), bold(2):
don't change style(0), non-italic(1), italic(2):

The same options are found in the syntax highlighting preferences.

As an exercise you may want to add the highlighting patterns for the xsl stylesheet file type created previously. They will be based on the xml patterns with just small changes.

[[File:Man2_note.png]] If you check the force bold weight check box, you should also check that the font you use has a bold variant in the Editor tab of the Preferences panel.

{{Man2bottom
|prev=Man 2 ch08s11
|up=Man 2 ch08
|next=Man 2 ch09
|prevname= 11. Modifying the files filters
|nextname=Chapter IX. Shortcuts available within Bluefish
}}

Highlight Patterns Modification - Revision history

Bill Valaski: moved Man 2 ch08s12 to Highlight Patterns Modification: Title updates (BV)

Fal7i at 11:29, 31 December 2009

Fal7i: Created page with '__NOTOC__ __NOEDITSECTION__ {{Man2top |lang=en |rev=2.0.0 |st=d |Title=12. Modifying the highlighting patterns |prev=Man 2 ch08s11 |Subtitle=Chapter VIII. Customis…'

Fal7i: Created page with 'NOTOC NOEDITSECTION {{Man2top |lang=en |rev=2.0.0 |st=d |Title=12. Modifying the highlighting patterns |prev=Man 2 ch08s11 |Subtitle=Chapter VIII. Customis…'