Table of Contents Demonstration Document for the fm2html filter: part 1
This document is meant to demonstrate the possibilities inherent in the fm2html filter. The document uses all the tag types that are understood by the filter. This should enable you to decide what internal filter tags best correspond to tags in your document.
Seven levels of headings are implemented:
The FrameMaker numbering is copied, so your own headings can use any numbering method you want (including no numbering at all).As you will notice after translating this document, a table of contents is generated based on the headings.
You may want to have headings that are not shown in the table of contents. Then you should use the unlisted headings:
UHEADING0
1 UHEADING1
1.1 UHEADING2
1.1.1 UHEADING3
1.1.2 UHEADING3
1.1.3 UHEADING3
1.1.4 UHEADING3
1.1.4.1 UHEADING4
1.1.4.1.1 UHEADING5
2 UHEADING1
2.1 UHEADING2
2.1.1 UHEADING3
2.1.2 UHEADING3
2.1.3 UHEADING3
2.1.3.1 UHEADING4
2.1.3.1.1 UHEADING5
2.1.4 UHEADING3
2.1.4.1 UHEADING4
2.1.4.1.1 UHEADING5
2.1.4.1.1.1 UHEADING6
Indented headings are as unlisted headings not shown in the table of contents. The difference between unlisted headings and indented headings is that the indented headings are ... indented.
1.1.2.1.1.1 INDENTHEADING6
Nested indenting is possible with or without numbering or bullets.
Indents:
- LISTINDENT1
- LISTINDENT2
- LISTINDENT3
- LISTINDENT4
- LISTINDENT5
- LISTINDENT6
Bullets (use HTML bullets, discard FramMaker paragraph numbering):
Numbered lists (use FrameMaker paragraph numbering).
- a) LISTMARK1
- a) LISTMARK2
- a) LISTMARK3
- b) LISTMARK2
- a) LISTMARK4
- c) LISTMARK2
- a) LISTMARK5
- d) LISTMARK2
- a) LISTMARK6
Numbered lists (use HTML numbering, discard FrameMaker paragraph numbering).
- LISTNUMBER1
- LISTNUMBER2
- LISTNUMBER3
- LISTNUMBER2
- LISTNUMBER4
- LISTNUMBER5
- LISTNUMBER5
- LISTNUMBER5
- LISTNUMBER6
In addition, you can continue any type of lists with the LISTCONTINUE tags:
- LISTBULLET1
LISTCONTINUE1
- LISTBULLET2
LISTCONTINUE2
- LISTBULLET3
LISTCONTINUE3
- LISTBULLET4
LISTCONTINUE4
- LISTBULLET5
LISTCONTINUE5
- LISTBULLET6
LISTCONTINUE6
To enable translation of a list of definitions, six tags are defined, GLOSSARY, GLOSSARY2, GLOSSARY3, COMGLOSSARY, COMGLOSSARY2 and COMGLOSSARY3. The difference between GLOSSARAY and COMCGLOSSARY is that COMGLOSSARY uses <DL COMPACT> in HTML, while GLOSSARY uses <DL>. GLOSSARY2, GLOSSARY3, COMGLOSSARY2 and COMGLOSSARY3 are indented. TABs should be used to distance the term and its definition.
GLOSSARY:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
GLOSSARY2:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
GLOSSARY3:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
COMGLOSSARY:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
COMGLOSSARY2:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
COMGLOSSARY3:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
ACRONYM:
- WWW
- World Wide Web
- TF
- Televerkets Forskningsinstitutt
Notice that if the term is too long, the definition may be moved down in any case, regardless of whether COMPACT is chosen or not. ACRONYM is an alias for the COMGLOSSARY tag.
Two types of reference formatting are provided. REFERENCE[1] and COMREFERENCE[2]. REFERENCE uses <DL>, while COMREFERENCE uses <DL COMPACT> and thus is displayed more compactly.
REFERENCE:
- [1]
- von Tetzchner, Jon Stephenson (1993). Integration and Interface Design of Telecommunication Applications and Functions in a Multi-Service Telecommunication Environment. Kjeller, Norwegian Telecom Research, TF-Document TF U3/93.
COMREFERENCE:
- [2]
- von Tetzchner, Jon Stephenson (1993). Integration and Interface Design of Telecommunication Applications and Functions in a Multi-Service Telecommunication Environment. Kjeller, Norwegian Telecom Research, TF-Document TF U3/93.
Paragraphs of the type "ADDRESS" are shown using the <address> tag in HTML. Example:
Jon Stephenson von Tetzchner
Norwegian Telecom Research
email: jons@hal.nta.no
Paragraphs of the type "AUTHOR" are displayed in the same way as ADDRESS paragraphs, but they are moved to the top of the document, or to the table of contents document, if the document was part of a book. See theTitle file for an example.
Paragraphs of the type "TITLE" are moved to the main table of contents file. See the Title file for an example.
Paragraphs of the type "LOCALTITLE" are displayed directly in the document they appear in. The titlefield of the document shows the local title if no title was specified as a parameter to the converter.
Paragraphs of the type "ABSTRACT" are displayed using the <em> tag in HTML. In most cases, this means that the paragraphs are displayed using italics. Example:
The abstract.
Text which uses the paragraph tag "PROGRAM" is converted to
preformatted text in HTML (<PRE>). Bold, italics and
underline can be used as normal.
The filter recognizes bold, italics and underline. Some viewers (noticably Mosaic), will not display underline. I decided not to translate the underline to something else as I think that what it should be translated to should be decided by the user or viewer.
Paragraph formats that use bold, italics or underline will not retain their formatting unless they are translated to internal filter tags that use the above.
Fm2html will try to convert as many special characters as possible. This includes international language characters as well as a number of others. As HTML can not show a number of characters available in FrameMaker (such as Greek characters), these are either not converted at all or converted to the way I expect HTML+ to show them.
Here are some special characters: å ø Ø Æ æ ' ` ".
Click here to get a list of a few documents that were translated with an earlier version of this converter.
Table of Contents
Next Chapter