27.8.4 Specifying extracts: an example

This example delimits figures, sidebars, and procedures to be extracted from the parent file, and specifies macros to be inserted in the extracts.

Assign extract properties and macros to paragraph formats:

[HTMLParaStyles]
; Extract figures and sidebars:
ArtAnchor=ExtrStart LEnd
SideBarAnchor=ExtrStart LEnd

; Extract procedures:
ProcHead=ExtrStart Title CodeAfter CodeBefore LEnd

; Put titles on the figure and sidebar extracted pages:
SideBarHeading=Title CodeBefore
ArtCaption=Title CodeBefore

; End extracts:
Body=ExtrEnd LEnd
Heading3=ExtrEnd LEnd

Call macros to put a Close Window button before the topic:

[ParaStyleCodeBefore]
SideBarHeading=<$CWbutton>
ArtCaption=<$CWbutton>

In the parent file, substitute links to the extracts for the extracted material:

[ExtrReplace]
; Replace extracted sidebars with "See..." links:
SideBarAnchor=<a href="<$$_extrfile>">See...</a>
; Replace extracted figures with "Figure..." links:
ArtAnchor=<a href="<$$_extrfile>">Figure...</a>
; Replace extracted procedures with links to the procedures:
ProcHead=<img src="c.gif"> <a href="<$$_extrfile>"><$$_extrtitle></a>

Assign macros to specify links from and within the extract files:

[ExtrTop]
; Place a link at the top to the More Topics section at the bottom:
ProcHead=<$MoreTopicsJump>
SideBarAnchor=<$MoreTopicsJump>
ArtAnchor=<$MoreTopicsJump>
[ExtrBottom]
; At the bottom add links back to the parent doc and to other topics:
ProcHead=<br><br><$NavListExtract><$BackToTop>
SideBarAnchor=<br><br><$NavListExtract><$BackToTop>
ArtAnchor=<br><br><$NavListExtract><$BackToTop>
[ExtrHead]
; Add a link to the style sheet that overrides selected formats:
ProcHead=<link rel="stylesheet" href="Ovr.css" type="text/css">
SideBarAnchor=<link rel="stylesheet" href="Ovr.css" type="text/css">
ArtAnchor=<link rel="stylesheet" href="Ovr.css" type="text/css">    

Previous Topic:  27.8.3.3 Supplying properties for extracted graphics

Next Topic:  28. Creating HTML links

Parent Topic:  27.8 Customizing and replacing extracts

Sibling Topics:

27.8.1 Using PI markers for extract processing

27.8.2 Customizing title text for extracts

27.8.3 Replacing extracts with links in the parent file