20.4.4.1 Redefining text-link browse macros

When UseNavButtons=No (the default) you can redefine browse macros for text links by changing the code assigned to the keywords listed in this section.

Do not try to duplicate <$_prev> and <$_next> logic by using the predefined macro variable components outside of the definitions for <$_prev> and <$_next>. The browse sequence would fail on inter-file links, because you would be missing some critical internal code that is required to handle such links.

Note:  In your configuration file each code assignment must be all on one line, even if it does not look that way here.

To redefine macros for text links between HTML files split from a FrameMaker file, change the following default definitions:

[NavigationMacros]

; PrevMacro = content to put out for <$_prev>

PrevMacro = <a href="<$$_prevfile>"><$$_prevtitle></a>

; NextMacro = content to put out for <$_next>

NextMacro = <a href="<$$_nextfile>"><$$_nexttitle></a>

For a previous text link in the first and a next text link in the last HTML file split from a FrameMaker file, change the following default definitions:

[NavigationMacros]

; PrevFSMacro = <$_seqprev>, macro to use for <$_prev>

; at start of file

PrevFSMacro= <a href="<$$_seqprevfile>"><$$_seqprevtitle></a>

; NextFSMacro = <$_seqnext>, macro to use for <$_next> at end of file

NextFSMacro= <a href="<$$_seqnextfile>"><$$_seqnexttitle></a>

For a previous text “link” in the first and a next text “link” in the last HTML file in the entire sequence, change the following default definitions:

[NavigationMacros]

; StartingPrevFSMacro = <$_prev> to use at start of first file in book

StartingPrevFSMacro = <$$_seqstarttitle>

; EndingNextFSMacro = <$_next> to use at end of last file in book

EndingNextFSMacro = <$$_seqendtitle>

For a text link to the top of the current page, change the following default definition:

[NavigationMacros]

; TopMacro = content to put out for <$_top>,

; link to top of current file

TopMacro = <a href="<$$_currfile>"><$$_toptitle></a>

To change a macro definition, modify or replace the macro code assigned to the appropriate keyword. For example, to add a title attribute to the <$_prev> link for WAI purposes (the definition must be all on the same line):

PrevMacro =

  <a href="<$$_prevfile>" title="<$$prevtitle>"><$$_prevtitle></a>

For the first and last HTML files in the entire sequence, <$_prev> and <$_next> do not use links at all, but only label content. If you want static labels for the other links, you could redefine the text-link macros as follows:

[NavigationMacros]

PrevMacro = <a href="<$$_prevfile>">Prev</a>

NextMacro = <a href="<$$_nextfile>">Next</a>

PrevFSMacro = <a href="<$$_prevfile>">Prev</a>

NextFSMacro = <a href="<$$_nextfile>">Next</a>

To make the first and last links to reference places outside the document (for example):

[NavigationMacros]

StartingPrevFSMacro = <a href="<$$HomeURL>">Home</a>

EndingPrevFSMacro =< a href="<$$Plan2URL>">Plan 2</a>

[MacroVariables]

HomeURL = http://www.oursite.org/index.htm

Plan2URL = http://www.oursite.org/greatplans/plan2.htm

---

> 20 Providing navigation in HTML > 20.4 Creating a browse sequence > 20.4.4 Modifying macros <$_prev>, <$_next>, and <$_top> > 20.4.4.1 Redefining text-link browse macros