Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog
Enhancements | Fixes | Incompatibilities
There are lots of new things in this version including:
Details are given below.
SDF can now generate a set of HTML topics, rather than a single HTML file. The command is:
sdf -2topics myfile.sdf
If you want to manually control how a document is split into topics, simply include other sdf files which contain headings. These manual topics, if any, can be supplemented with automatically generated topics. By default, level 1 headings are used as topic breaks, in addition to the manual ones. The -n option can be used to change this:
To make it easy to navigate around the topics, SDF generates a default header and footer for a topic which supports jumping to the:
These macros give you total control over the headers and footers used:
The default implementation of these macros is in html.sdm in the kernel library. The default versions of these macros use the variables below, if they are set. On most occasions, useful headers and footers can be obtained by simply setting these variables:
To fine tune HTML output, the following variables are useful:
To set a colour, use the RGB (red-green-blue) value as used by HTML. For example:
!define HTML_BG_COLOR "ffffff"
For convenience, a number of variables are defined for common colours:
These are used as follows:
!define HTML_BG_COLOR COLOR_WHITE
Macros can now be used inside tables. In particular:
For example:
!block table Code Description BTW By the way !block changed RTFM Read the (fine) manual !endblock !if ALL_TERMS SOS Save our souls !endif !endblock
The table filter now supports a new attribute called wide. When it is used, the table spans the side-head in addition to the text column.
The import macro now supports an align attribute, which is passed into the generated HTML. This can be used in combination with the clear macro to control how figures are aligned with text in HTML.
For example:
!import "mylogo"; align="right" Some text. !clear
HTML's alt attribute is now also supported by the import macro.
Special characters can now be entered using {{CHAR:xxx}} where xxx is either:
The symbolic names supported are given below.
Name | Description |
bullet | |
c | copyright symbol |
cent | |
dagger | |
doubledagger | |
emdash | a hyphen which is the width of the point size |
endash | a hyphen which is half the width of the point size |
emspace | a space which is the width of the point size |
enspace | a space which is half the width of the point size |
nbdash | a non-breaking hyphen |
nbspace | a non-breaking space |
nl | newline |
pound | |
r | registered trademark |
tab | tab character |
tm | trademark |
yen |
For convenience, variables with the same name are predefined. This makes it easy to include a special character. For example:
Copyright [\[c]\] 1996, Us Pty Ltd.
Cross-references are now supported via the xref phrase attribute. For example:
Refer to page {{N[xref="pagenum"] Samples}} for more samples.
The value specifies the cross-reference style to use. The phrase text is used to find the target location. The predefined styles are given below.
Name | Value |
pagenum | the page number |
paratext | the paragraph text |
paratag | the (FrameMaker) paragraph tag |
paranum | the paragraph number (e.g. Appendix A) |
paranumonly | the paragraph number only (e.g. A) |
section | section paranumonly, paratext, on page pagenum |
New styles can be added by using the xrefs configuration filter. See mif.sdm in the kernel directory for examples.
New macros include:
New filters include:
The current directory is now searched first for the configuration library, i.e. if OPT_CONFIG is abc, sdf first looks for ./abc.sdm before searching for abc.sdm in a directory called abc on the search path.
The copy number field on the mincom cover page has been fixed.
The Limitations & Future Directions heading in sdfget.sdm has been changed to Limitations and future directions.
The objects attribute of the table filter is now called tags.
The sections filter now generates SECT jumps for each paragraph within the block, provided the output is html or hlp. To include sub-topics (sub-sections), use the new topics filter.
When pretty-printing files using sdf, use the -N option to control line numbering. The -n option is now used to specify the level when autosplitting into HTML topics.
The message macro has been simplified - the message type is now an optional second parameter.
The obj* configuration filters have been renamed to phrase* to better reflect their purpose. (This shouldn't affect normal documents.)
The cfg_lang configuration filter has been renamed to langdefs.
Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog