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.