3. Page navigation
The page-break command .bp ends the current HTML page and start a new one. .bp causes a page-break in both the HTML and the print outputs.
Generally, page-breaks require a different æsthetic in HTML than in print. You can use troff conditionals to express this difference:
causes a page-break only in the HTML, whereas
causes a page-break only in print.
As can be seen, the number register \n[.troff2page] has a true value, i.e., a number greater than zero, only when troff2page processes the document.2
If may be convenient to define a .HBP macro that causes a page-break only for HTML:
.if \n[.troff2page] .bp
..
Note that troff2page, like troff, does not automatically cause a page break at the sectioning commands. Use .bp or a macro like .HBP to explicitly to insert breaks as needed.
Each page in a multiple-page HTML output has a navigation bar at its head and foot. The bar contains links to the first, previous, and next page, and the table-of-contents and index pages. If any of these pages doesn’t exist, or if it is the same as the page containing the navigation bar, then the link for it is disabled.
2 The greater-than-zero number held in the register \n[.troff2page] is in fact the version number of the troff2page program processing the document. This is a number such as 20050327, which would be the version number of the troff2page released on 2005 March 27. \n[.troff2page] could plausibly be used to distinguish not just troff2page from troff, but also between various versions of troff2page. Thus, one could, if the need were dire, write a document that translates differently with different versions of troff2page.