Silva follows the W3C HTML 4.0.1 standards for accessibility. The major goal of these standards is to promote accessibility. That is to make Web content available for all users whether they are using a desktop browser, a voice browser, a mobile phone, or an automobile-based personal computer, etc. It aims also to take into account constraints they may be operating under such as noisy surroundings, under or over-illuminated rooms, in a hands-free environment, etc.
Following these W3C standards Silva default allows navigation through a Silva site with browser based links. These accessibility links have a number of uses:
Fig. 1 Accessibility links in Mozilla 1.6
The following browsers can access Silva's accessibility aids:
For Mozilla, access these aids by clicking on View/ShowHide/SiteNavBar/Show Always.
There are four methods available for Silva accessibility links. The first three methods are included in the default version of Silva and can be found in the default layout_template. The fourth is not included because it is memory intensive.
Description:
For creating navigation links (next, previous, last, first) in a compliant web browser. This method only indexes documents and folders in the current level, it excludes Indexers, AutoTOCs from the links.
Optional attributes:
None
Example:
Fig. 2
If you're looking at document (K) for example (Fig.1), you only get
'next' and 'last' links that are pointing to document
(L). If you're looking at document (P), you don't get
'next', 'previous', 'first' and 'last' links back, because
there is no other document in this current level. The only
link you get is 'up', which points to Folder (N) and
'first', which points to publication root (A).
Note that O in this example is a Folder.
Example Page Template code:
<tal:block define="surround here/get_document_navigation_links|nothing">
<tal:repeat repeat="link surround/keys">
<link tal:attributes="rel link; href python:surround[link].absolute_url()"
tal:on-error="nothing"/>
</tal:repeat>
<link rel="up" tal:condition="python:surround.has_key('up')" tal:attributes="href
surround/up" />
</tal:block>
Description:
Indexes for every level the available folders, ghost folders, publications and returns URLs in a dictionary. The dictionary itself contains a dictionary for each book element. The value of a book element is a list containing urls.
Fig. 3
Available for:
Mozilla Navigator or Firefox with Extension installed
Optional attributes:
Example page template code:
<tal:block define="types here/get_document_chapter_links|nothing">
<tal:repeat repeat="item types/chapter"
tal:condition="types/chapter|nothing">
<link rel="chapter" tal:attributes="title item/title; href item/url;"/>
</tal:repeat>
<tal:repeat repeat="item types/section" tal:condition="types/section|nothing">
<link rel="section" tal:attributes="title item/title; href item/url;" />
</tal:repeat>
<tal:repeat repeat="item types/subsection"
tal:condition="types/subsection|nothing">
<link rel="subsection" tal:attributes="title item/title; href item/url;" />
</tal:repeat>
<tal:repeat repeat="item types/subsubsection" tal:condition="types/subsubsection|nothing">
<link rel="subsubsection" tal:attributes="title item/title;
href item/url;" />
</tal:repeat>
</tal:block>
Description:
Looks for the first Silva Indexer and Silva AutoTOC in a publication. It returns a dictionary with a link to the Indexer or AutoTOC, if there is one available in a publication.
Available for:
Mozilla Navigator or Firefox with Extension installed
Optional attributes:
Example page template code:
<tal:block define="doclinks here/get_document_index_links|nothing">
<link rel="index" tal:attributes="href doclinks/index" tal:condition="doclinks/index | nothing" />
<link rel="contents" tal:attributes="href doclinks/contents" tal:condition="doclinks/contents | nothing" />
</tal:block>
Note: this method is not included in the Silva default. This method is memory intensive. To add the method to Silva, place this method in the layout_macro.
Description:
For creating navigation links (next, previous, last, first) in a compliant web browser. The method is looking for eg. next, previous etc objects in document order. This means, that the next object can be a document, folder or whatever comes next in the tree. If the next object is the first document in a subfolder, it dives into the subfolder and returns this as the next object. It indexes the entire site.
Fig. 4
Example:
The method indexes the documents and Folders like reading a
book. The letters on Fig. 2 above are indicating the
indexing order of the method. If you're looking at Folder
(B) you'll get the following links: (Fig. 4)
next: points to (C)
last: points always to document (P)
previous: points to (A)
top and first: are pointing always to (A)
up: points to (A)
Another case will be, if you're looking at Folder (G), which then
returns the following links:
next: points to folder (H)
last: points always to document (P)
previous: points Indexer (F)
top and first: are pointing always to (A)
up: points to folder (B)
Available for:
Mozilla Navigator, Firefox with Extension installed, Opera
Optional attributes:
None
© Copyright 2002-2004 Infrae.
All rights reserved. 
