Creating and Modifying a Reference Model Footnote
Some document types use two elements for footnotes:
• The Footnote Content element just contains the footnote body text and can appear anywhere in the document. This element must have an ID attribute, or equivalent.
• The Footnote Reference element references the Footnote Content element. This element generates the reference mark and associated footnote at the place in the document where it appears. This element must have an IDREF, IDREFS, or CDATA attribute.
The examples shown in the section are based on the axdocbook doctype, for example the Arbortext Styler sample document transport.xml, located at Arbortext-path/samples/styler.
Example: Creating a Reference Model Footnote
1. In Arbortext Editor, open your document and use the Styler menu to open a new stylesheet.
2. In Arbortext Styler, select the footnote element in the Elements list.
3. Assign the Footnote style to that element via the > menu option.
4. In the Footnote category, note that the option Generates reference mark and footnote is checked by default. Note also that a new context with the (Footnote Area Properties) prefix has been created for the footnote element - these are default settings that you will change in the next steps.
Note also that a new context for the para element, para (first in its parent) anywhere in footnote has also been created, with a Structure Type of Inline (see the Breaks category) - this special context is added so that Arbortext Styler can make sure that the first paragraph (i.e. that which contains the footnote content) in a footnote element is marked as inline and hence will appear on the same line as the footnote number in the footnote area. If you set formatting for this context, its properties will be reflected in the footnote content.
5. Select the regular context for the footnote element in the Elements list.
6. In the Footnote category, uncheck the Generates reference mark and footnote option. Note that the special (Footnote Area Properties) context for the footnote element is removed from the Elements list. Here you have specified that the footnote element will simply generate the content of the footnote, with a separate element producing the reference mark.
7. Refer to the Description tab for the context - you can see that the footnote element is described as Inline, Footnote (content).
8. Select the footnoteref element in the Elements list.
9. Assign the Footnote style to that element via the > menu option.
10. In the Footnote category, note that the option Generates reference mark and footnote is checked by default and that a new context with the (Footnote Area Properties) prefix has been created for the footnoteref element - these are default settings that you will change in the next steps.
11. Select the regular context for the footnoteref element in the Elements list.
12. In the Footnote category, select the Element references footnote and generates reference mark option. Make sure that the Generates footnote checkbox is checked.
13. Select the linkend attribute from the Reference attribute drop down menu. Here you are specifying the particular IDREF, IDREFS, or CDATA attribute on the target footnote element that will generate the content of this footnote reference.
14. Refer to the Description tab of your Arbortext Styler interface - you can see that the footnoteref element is described as Inline, Footnote (reference).
15. Refer to the Generated text category for the regular context of the footnoteref element. Note that it is set to generate a number in the Before-text field.
16. In Arbortext Editor, locate the first paragraph in the abstract element at the beginning of the document and insert a footnoteref element in the place in the text at which you wish the footnote reference mark to appear. In the Modify Attributes dialog box that appears when you insert the element, give the element the target attribute linkend=”footnote1”.
17. Also in Arbortext Editor, create a footnote in the document by inserting a footnote element anywhere the element is permitted, preferably on a page other than the first one. Give its id attribute the value footnote1. In the footnote tag, add the text that should form the footnote content.
18. Back in Arbortext Styler, choose > . In the print preview window, note that the number 1 has been placed as a footnote reference in the place in the document where you inserted the original footnoteref element. At the bottom of the page that contains the footnote reference, note that the footnote appears, even if you placed the footnote element that contains the footnote content in a page other than the first one.
Modifying a Reference Model Footnote
1. To set general formatting options for the footnotes in your document, select > in Arbortext Styler to open the Footnotes dialog box.
2. Use the options in the Footnotes dialog box to determine the width, style, and scope of your footnotes. You can also specify the amount of space to leave above footnotes and whether there should be a separator rule between the footnotes and the document body text.
You may use this dialog box to elect to have footnote numbering restart within the scope of specified contexts. When Arbortext Styler encounters one of the contexts you have listed in the Contexts that restart footnote numbering field it will restart footnote numbering at 1, with numbering continuing consecutively until it reaches either another listed context or the end of the document.
|
|
If you elect to have footnote numbering start at a particular level of nested element, numbering will be restarted at all contexts of that element at the same level. For example, if you specify that numbering should restart at the section in section context, it will also restart when Arbortext Styler encounters any similar contexts at the same level, for example:
• section in section
• first section in section
• not first section in section
• section in section in preface
|
3. Select the regular context for the footnoteref element in the Elements list.
4. Assign the desired formatting properties for the footnote reference mark. You can assign different properties to different types of output using the Outputs to edit list.
5. Select the special (Footnote Area Properties) context for the footnoteref element in the Elements list.
6. Assign the desired formatting properties for the footnote body. You can assign different properties to different types of output using the Outputs to edit list.
