29.3.7 Considering an example of browse navigation

Suppose your project involves a DITA document named TechGuide.book that consists of three files: Intro.fm, Examples.fm, and Summary.fm; and suppose you want Prev and Next links at the top of each HTML file generated from TechGuide.book.

In the [Inserts] section of the configuration file you would specify where on each page of HTML output the links should appear (see §29.3.6 Specifying where to invoke a browse macro). For Examples, at the top of each HTML page:

[Inserts]
Top = <$_prev><br /><br /><$_next>

Suppose DITA2Go splits the files in TechGuide.book as follows (see §27.3 Splitting files):

Intro.fm:  Intro.htm  aa100002.htm  aa100003.htm
Examples.fm:  Examples.htm  bb200002.htm  bb200003.htm  bb200004.htm
Summary.fm:  Summary.htm  cc300002.htm

Figure 29-1 shows the positions of these files with respect to the differences in default definitions of <$_prev> and <$_next> (see Table 29-3).

 

Positions of HTML files generated for for each FrameMaker file in Essays.book

Figure 29-1 Positions of files in TechGuide.book

Table 29-8 shows the values that <$_prev> and <$_next> macros would use in each HTML file; in particular:

Previous Topic:  29.3.6 Specifying where to invoke a browse macro

Next Topic:  30. Mapping text formats to HTML/XML

Parent Topic:  29.3 Creating a browse sequence

Sibling Topics:

29.3.1 Understanding how browse macros work

29.3.2 Choosing buttons versus text links for a browse sequence

29.3.3 Formatting browse-link labels

29.3.4 Modifying macros <$_prev>, <$_next>, and <$_top>

29.3.5 Understanding browse keyword scope and default values

29.3.6 Specifying where to invoke a browse macro