C The structure of a converted hypertext document

Star2HTML bases the structure of the hypertext version of a LATEX document on the original structure defined by commands like \section. However, it changes the format of the title page, adds buttons and links to aid navigation within the document, and adds identification information to each page. It does this automatically.

It splits a document up into pages. Each section, subsection, and so on, is stored in its own page. Each page is divided into bands, separated by a horizontal line. The top-level page is the Title Page. This is the first page you see when you start reading the document.

The Title Page is divided into the following bands:

(1)

A Navigation Band. This contains a row of navigation buttons (some of which are blanked out), followed by a line containing a link to the document Abstract (by default).

(2)

A Title Band. This contains information from the title page of the paper document (title, document number, author, date, etc.), but presented in a different order and style. References to CCLRC/RAL, PPARC, and Starlink are converted into links to their associate web pages. A button is added to help people copy the document.

(3)

A Contents Band. This looks like two bands because a horizontal line appears between the heading “Contents” and the list of section titles (which are links to the section pages).

(4)

A Navigation Band. This is a duplicate of the band at the top of the page. It only appears in long pages.

(5)

An Identification Band. Shows the document title, code, author, date, and e-mail address.

The other pages are made up of similar bands, some of which don’t always appear.

(1)

A Navigation Band. The lines below the navigation buttons show the titles of the Next, Up, and Previous pages. “Up” means the next level up in the structural hierarchy, thus if the page is a subsection, it will point to the containing section.

(2)

A Text Band. This contains the author’s text for the section.

(3)

A Structure Band. This shows the titles of the subsections in this section, with links to the pages containing the text. If the section has no subsections, this band won’t appear.

(4)

A Navigation Band. This is a duplicate of the band at the top of the page. It only appears in long pages.

(5)

An Identification Band. Same as for the Title Page.

If your document has an index it will be converted to an index page with links from each entry to the indexed entry. The last page in the hypertext document will be called “About this document …”. This gives details about how and when the hypertext document was produced. It has no equivalent in the paper version.