[Inso Home Page] [Home] [Collection] [Book] [Expand] [Collapse] [Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] [Preferences] [Print] [Help]

 inside  Expand Search


   Equations   [Table of Contents]    TCL() PVF

DynaWeb Publishers Guide

[-] 2. Publishing DynaText Books Using DynaWeb
[-] Hyperlinks

Hyperlinks

Overview

DynaWeb automatically recognizes hyperlinks contained in DynaText books and translates them into HTML anchors. Once the dynaweb.wv stylesheet is completed, links within the same book will work without any further manipulation of the stylesheet.

Referencing Stylesheets

Sometimes stylesheets will designate another stylesheet to be used when displaying the target of a link. This stylesheet could be a revelatory stylesheet, or specify another stylesheet. When creating a dynaweb.wv stylesheet, check to make sure that you are not referencing any stylesheets that do not provide the correct HTML tags for your document.

Change the stylesheet reference in your link style to point to the dynaweb.wv stylesheet or an HTML version of the revelatory stylesheet. If you use an alternate stylesheet for displaying the target of a link, you can repeat the steps for creating your dynaweb.wv stylesheet to create an HTML version of the specified stylesheet.

Creating a New Window

One attribute of the ebt-link property is the window attribute. This attribute determines whether the target of the hyperlink is shown in a new window or replaces the contents of the current window. If you choose to have the target open in a new window, be aware that Netscape and Microsoft both open new browser instances to display the target. If you have a link-heavy book or collection, these multiple browser instances may bog down the client machine. If you remove the window=new attribute from your links, the target will appear in the Content pane of the current browser.

Linking across Books

In order for DynaWeb to successfully create HTML equivalents for cross-book links, you will need to replace all occurences of idmatch in your dynaweb.wv with xidmatch. For example, when setting up a hyperlink style such as <EXTREF>, after copying the style into the dynaweb.wv stylesheet, modify the style so that the idmatch attribute is changed to xidmatch as in the second example below.

<style name="EXTREF">
    ...
    <script>   ebt-link root=idmatch(ID, attr(RID)) book=attr(book)  window=new  stylesheet=link.rev  </>
 </style>
- - - - - - - - - - - - - - -
<style name="EXTREF">
    ...
    <script>   ebt-link root=xidmatch(ID, attr(RID)) book=attr(book)  window=new  stylesheet=link.rev  </>
</style>

Note: xidmatch only needs to be present in styles that deal with links that cross between books. Links that travel within the confines of a single book do not need to be altered.

Using query() in ebt-link Expressions

In addition to substituting xidmatch for idmatch in your dynaweb.wv stylesheet, you will also need to substitute xquery for query in your ebt-link attributes. Follow the instructions for xidmatch to replace query with xquery in your stylesheet.

Linking Inside a DynaText Book through a URL

DynaWeb allows publishers to link to specific places inside their DynaText books in the URL of the request. After the book name in the URL, add the following line:

@ebt-link?target=idmatch(ID,[ID#])

where [ID#] is a valid ID or REFID inside the book.

This allows publishers to embed links to specific pages or sections inside their DynaText books and be able to display that section in DynaWeb.


   Equations   [Table of Contents]    TCL() PVF