X-Refs

[ Refs in the script ] [ X-Refs on pages ] [ Image Refs ]

A main issue in SiteLite is to keep track of references within a site, and recalculate such references when necessary. The targets for such reference calculations are images and pages. SiteLite accepts a number of referencing strategies, and it is up to you to choose which one suits your needs. The catalog structure and the dynamics of your site is factors to consider.

Refs in the script

Pages and blocks in the script should allways be referenced relative to the sitecatalog or by an absolute address.

1,Pagename,P,pages/page-1.html
1,Pagename,P,pages\page-1.html
1,Pagename,P,../catb/page-1.html
1,Pagename,P,d:\acatalog\page-1.html
1,Pagename,,http://www.x.y/~b/cat/page-1.html,,N

are all legal pagelines.

The same rules apply for filenames in the elements SL_IMPORT and SL_PATCH.

X-Refs on pages

You may reference an other page in the site in two ways:

With normal HTML: <a href="pageid">pagename</a>
With normal the SiteLite tag: <SL_XREF PAGE="pagid"/>

The advantage of the second is that it gives you access to the "PAGETIP"- text witch appears as a title-attribute in HTML. PAGETIP's are specified in the script, se page Script. Details of the SL_XREF-element. Of course all traces of the SL_XREF-element is removed when the page is prepared.

SiteLite has a considerable tolerance in identifing a page from the pageid you use. References to other pages within the site may be:

By pagename. This offers maximum flexibility when you rearrange the file structure of your site. It will fail if you change the pagename, and it will fail when more than one page has the same name. SiteLite will warn you if either of this cases occur.
By correct reference from the block the reference is edited in. In this case SiteLite will recalculate the address to be effective from the page the block is placed in. The advantage of this is that you may use the block as a complete page for other purposes.
By correct reference from the page that the reference will end up in. In this case SiteLite will of do nothing.
By reference relative to the sitecatalog. This reference may be incomplete but must contain so much of the path that the referenced page can be uniquely identified. In this case SiteLite will recalculate the reference to be correct from the page that the reference will appear in.

Note that a reference relative to the sitecatalog may refer to pages outside the sitecatalog.

Image Refs

References to images may be:

By correct reference from the block the reference is edited in. In this case SiteLite will recalculate the address to be effective from the page the block is placed in. The advantage of this is that you may use the block as a complete page for other purposes.
By correct reference from the page that the reference will end up in. In this case SiteLite will of do nothing.
By reference relative to the sitecatalog.

Note that a reference relative to the sitecatalog may refer to images outside the sitecatalog.

Børre Stenseth

November 30, 2004