SiteLite Documentation


Tagging


Tagging

SiteLite is conceptually a very simple program. It basically does some organising of a sites structure as stated in the script-file and looks for tags in the pages where it places fixed or composed content. All pages are treated the same way and one way to understand a template file is to consider it as a way to distribute tags.

The "standard" templatefiles distributed with SiteLite is only one way to compose a site. The most important tags that SiteLite recognises are listed below. There are a few additional tags for frame structure templates that are commented in the templates. Remember that all tags are written as html-comments in the html-code. The comment brackets necessary, <!-- and --> , as in <!--TAG--> are omitted here.

Tag(pairs)

Description

Placement of values from the scriptfile

SITEAUTHOR
ENDOFSITEAUTHOR

The value of the AUTHOR= line in the script is placed between these tags.

PAGEAUTHOR
ENDOFPAGEAUTHOR

The value of the author parameter on a page line is placed here. If no such parameter is given, the pageaouthor is supposed to be the same as the siteauthor.

AMESSAGE
ENDOFAMESSAGE

The value of the message parameter on a page line is placed here. If no such parameter is given, the value of MESSAGE= line in the script is placed between these tags.

SITENAME
ENDOFSITENAME

The value of the SITENAME= line in the script is placed between these tags.

ORG
ENDOFORG

The value of the ORG= line in the script is placed between these tags.

PAGENAME
ENDOFPAGENAME

SiteLite puts the page's name between these tags. This tagpair is not used in the original templates that are distributed with SiteLite.

Prepared for your convenience

TOTOP

This tag is all ways replaced with a small graphics, up.gif, and a reference to the TopOfPage anchor which are assumed to be present on all pagetops. Page templates should include this anchor. You may insert this tag anywhere you like in templates or blocks.

NOTICE
ENDOFNOTICE

SiteLite does not produce any contents for this tag pair. It is introduced as a easy way to give temporary messages. You simply use a replace-line in the script, like:
RDOUBLE=< !--NOTICE-->< !--ENDOFNOTICE-->, Under construction

PRINTBLOCK
ENDOFPRINTBLOCK

SiteLite extracts all pageparts between those tags and uses them to build one big page of the whole site, menu:Tools-Make Printable page. It has no effect on other pages.

Insertion of composite values calculated by SiteLite

DATE
ENDOFDATE

Todays date are placed between these tags. The form of the date is:
January 16, 2000

CONLIST
ENDOFCONLIST

SiteLite produce a page relevant table of contents and place the result between these tags. The page relevant table of contents includes all pages on level 1, all pages leading down to the current page, all the current pages siblings and its children.

BASEDON
ENDOFBASEDON

The commaseparated values of the pages BASED_ON:-line(s) are placed between these tags.

NOLOCALTOC

If this tag exists in a page, SiteLite will suppress building of a local table of contents for this page. This toc will otherwise be based on h2-entries and will be placed immediately below the first h1-entry found in the page. If you want to place the local toc somewhere else on the page you may introduce the next tag pair.

LOCALTOC
ENDOFLOCALTOC

If this tag pair exists and the tag NOLOCALTOCdoes not exists in a page, SiteLite will attempt to build a local table of contents for this page. This toc will be based on h2-entries and will be placed between the tag pair.

TOCCOLn
ENDOFTOCCOLn

If at least the tag pair TOCCOL0 - ENDOFTOCCOL0 exists in a page, SiteLite will attempt to build a complete table of contents that includes all pages in the site. SiteLite will attempt to distribute the total sitemap in a number of columns matching tag pairs TOCCOL0 - ENDOFTOCCOL0 , TOCCOL1 -ENDOFTOCCOL1 etc. SiteLite will first try to distribute the sitemap such that each column will start on a level 1 page. If this gets too unbalanced, it will make an even distribution of entries. Inspect the original file nf_c_template.html as an example.

TOC
ENDOFTOC

Enclosing the sitemap as specified above.

INX:

A single tag that sets keywords that should be included in a siteindex, see below. A tag like <!--INX:sitelite-->, marks the word sitelite as a candidate for the siteindex.

INXCOLn
ENDOFINXCOLn

If at least the tag pair INXCOL0 - ENDOFINXCOL0 exists in a page, SiteLite will attempt to display an indextable. SiteLite will attempt to distribute the total siteindex in a number of columns matching tag pairs INXCOL0 - ENDOFINXCOL0, INXCOL1 - ENDOFINXCOL1 etc. Inspect the original file nf_ix_template.html as an example. The index is collected according from tagged keywords: <!--INX:keywrd-->

The keywords in the final indextable has paragraph style inx, so a line like
P.inx{ font-weight: bold;}
is included in the stylesheet.

INX
ENDOFINX

Enclosing the siteindex as specified above.

Routing blocks into templates, see also page: Routing

BLOCKS
ENDOFBLOCKS

All blocks that are not marked with an other address, see PUTME below, are placed between these tags on a page. You may control block routing completely by using combination of the next tags

xxxBLOCKS
ENDOFxxxBLOCKS

All blocks, that are marked with tag PUTME:xxx are placed between these tags on a page. xxx may be any string of max 5 characters.

PUTME:xxx

When this tag is present in a block, SiteLite attempts to put this block between tags xxxBLOCKS - ENDOFxxxBLOCKS on the page. xxx may be any string of max 5 characters.

STUFF
ENDOFSTUFF

Used in blocks. SiteLite extracts everything between these tags and consider this the content that should be transferred to a page. If this tags are not present, the whole blockfile is transferred.

WRAPME

Used in blocks. When this tag is encountered, SiteLite wraps the block in template wrapper_template.html.

These tags are not valid any more.

BLOCK1
ENDOFBLOCK1

Use instead:BLOCKS ENDOFBLOCKS.
(if you have used the old BLOCKS- ENDOFBLOCKS tags, these could be replaced by WIDEBLOCKS - ENDOFWIDEBLOCKS)

COMPLETE

Use instead:nothing.

UNCOMPLETE

Use instead:WRAPME.

REMOVEONPRINTALL
ENDOFREMOVEONPRINTALL

Used to mask out pieces of a page from assembly of one big page of the whole site, menu:Tools-Make Printable page. It has no effect anymore. The building strategy is changed, see tags PRINTBLOCK, ENDOFPRINTBLOCK above

The predefined tags listed above constitutes the tags considered the minimum necessary to produce reasonable pages. All these tags are used in the "standard" templates distributed with SiteLite.

In addition to the Sitelite-spesific tags, SiteLite utilises the html-formats for keywords and title, to set in the value form the KEYWORDS=-line in the scriptfile and the pagname from the actual page-line respectively.

In addition to this you may introduce any tag or tag pair that you want, in content blocks or in templates. The tags that you introduce should be a blockroutingtagset or they should be matched with a REPLACE-line in the script. Since a REPLACE-line may grab a complete file, the possibilities should be rather large for customising the functionality of SiteLite.