Home
What is Pike?
License
Download
How to Update
Rules
Firewalls
Discuss
Mail
|
|
|
|
How rules work in Pike
Pike is an outliner
| As you know, Pike is an outliner. It allows you to work with hierarchic structures of text, headlines and sub-headlines. You can browse outlines by expanding and collapsing, or reorganize using the mouse or keyboard commands.
|
Rendering and Rules
| When a Pike outline is converted into HTML it's "rendered" according to rules you specify in XML in the outline itself.
|
| Outlines are rendered by the server when you save the outline.
|
| The rules specify various formatting options, according to a range of levels. If you specify no rules, the text is rendered as tab-indented, carriage-returned delimited lines with no extra formatting. Every rule you add, adds style to that basic rendering.
|
| You can include a <rules> section anywhere you like. It applies relative to the level at which it is included.
|
| Each <rules> section contains one or more <rule>s. Each rule can have an optional "level" and/or "to" attribute that defines the scope of the rule. If the level attribute is not specified, it defaults to 1. If the to attribute is not specified it defaults to infinity (ie the rule applies to all subordinate text).
|
| Each <rule> can have as many value tags as you like, chosen from this set: textStyle, textColor, textSize, textFace, outlineSpacing, leftIndent, labeling.
|
Example
Legal tags
| Each of the tags has an effect on the way the text in the outline is rendered. This section explains how each of the tags works.
|
| If the value contains "bold" the text is displayed in boldface; if the value contains "italic", the text is displayed in italic.
|
| Possible values: Any string that makes sense as the color attribute of an HTML <font> tag.
|
| Possible values: smallest, smaller, medium, larger, largest.
|
| For each of these, except medium, we generate a font tag, with size set to "-2", "-1" or "+1" or "+2"
|
| Generate a font tag with the indicated text face.
|
| Possible values: 1, 1.5 or 2.
|
| Adds either 1, 2, or 3 <br> tags after each headline.
|
| The number of pixels to indent for each level.
|
| MORE has a labeling feature: you could choose between Leader characters, Harvard, Numeric, Legal, Bullets, and None. Numeric has been implemeted here, so far.
|
| This is a new feature, added 6/27/00.
|
| Each headline renderered under this rule gets a left-arrow to the right of its headline, which is a name tag pointing to the permanent link for the headline.
|
| The value of the element is the URL for the page in the archives.
|
| For an example of its use, see Scripting News; here's a recent archive. Click on the blue arrows to see what they do.
|
| And a screen shot of the rules section of the outline for that day.
|
|