DynaWeb Publishers Guide
|2. Publishing DynaText Books Using DynaWeb|
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.
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.
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.
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.
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:
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.