# html.map -- map file for html.mmf filter
#
# EXPLANATION
#
# This map file tells the mmf filter how to do its job. It reads this file
# in upon starting. The filter looks for this file first in the
# installation directory, then in the current directory. Thus, you can
# copy the file to your current directory and override only as necessary.
#
# To override, simply keep the changes you need, and delete everything
# else (maintaining valid perl syntax :-).
#
# Note, don't override anything unless you really have need to; most of
# the common changes can be specified on the command line, and hence
# there is no need for making a copy of this file.
#
#---------------------------------------------------------------------------
#---------------------------------------------------------------------------
#
# DEFAULT VALUES
#
# These variables control how the filter converts anchored frames to
# images. Command line options are given where applicable.
#
# This is the algorithm that the html.mmf filter uses for images:
#
# if noimages isn't specified ($noimages == 0)
# if inline images are specified ($inline isn't "" or "none")
# if external images are specified ($external isn't "" or "none")
# inline images are hyperlinked to external images
# else
# inline images are not hyperlinked to anything
# else
# if external images are specified ($external isn't "" or "none")
# if linktext is specified ($linktext isn't "" or "none")
# linktext "(here)" is hyperlinked to external images
# else
# images are left out altogether
# else
# images are left out altogether
# else
# images are left out altogether
#
# The variables below are the defaults, and can be overridden on the
# command line, or by a local html.map file. The current defaults
# specify that inline and external images are to be used; inline
# graphics will be in gif format and should be hyperlinked to the
# external images, which will be in ps format. Got it?
#
#---------------------------------------------------------------------------
$alttext = "(Figure)" ; # text to display by line-mode browsers
$linktext = "(Figure)" ; # hypertext to external image w/o inline
$inline = "" ; # filename suffix of inline graphics
$external = "ps" ; # filename suffix of external graphics
$Entities = "html.ent" ; # filename to read for Frame 2 HTML entites
$noimages = 0 ; # yes, we want images (-noimages to turn off images)
$paged = 0 ; # process text as a single textflow (not by page)
$directory = "./graphics";# directory to dump graphics...
$Delay = 10 ; # delay (seconds) between fmprintdriver and psconvert
$Named = 0 ; # if TRUE, causes generated graphic files to be
# named after original Frame file.
$PSargs = "" ; # Additional arguments to pass to psconvert script
# See psconvert script to see how it is used
$TOCFILE = "toc.html" ;
$TOCTITLE = "MifMucker Generated TOC" ;
%TOC = (
"", "<H1>",
"<H1>", "<PRE> ",
"<H2>", "<PRE> ",
);
#---------------------------------------------------------------------------
#
# CHARACTER TAGS:
#
# Each Character Tag on the left maps to the corresponding HTML tags
# on the right. You can map to multiple HTML tags by separating them with
# a colon. If you combine tags, be forewarned that some tags override
# others, so the order can make a difference. For example, specifying
# something as strong:code will not get bold monospace text. But
# specifying it as code:strong will (code overrides previous settings).
#
# Some common HTML tags are defined below:
# strong : important, usually bolded
# em : emphasized, usually italicized
# code : monospaced
# kbd : keyboard, usually monospaced
# cite : reference, usually italicized
# sub : subscripted, usually itlaicized and subscripted if possible
# sup : superscripted, same thing only superscripted
#
#---------------------------------------------------------------------------
%formatting = (
"B", "STRONG",
"b", "STRONG",
"Bold", "STRONG" ,
"Bold10pt", "STRONG" ,
"BoldUnderline", "STRONG" ,
"BookTitle", "CITE",
"<c\\>", "CITE",
"<c>", "CITE",
"Citation", "CITE",
"Code", "CODE",
"Definition", "DFN",
"ElementName", "CODE:STRONG",
"Emphasis", "EM",
"FixedWidth", "TT",
"Italic", "I",
"Italic10pt", "EM",
"I", "EM",
"i", "EM",
"<I>", "EM",
"<I\\>", "EM",
"Hyperlink", "",
"KeyCap", "KBD",
"KeyBoard", "KBD",
"Mono", "CODE",
"Monospaced", "CODE",
"MonospacedInput", "CODE:STRONG",
"MonoBold", "CODE:STRONG",
"M", "CODE",
"m", "CODE",
"<M\\>", "CODE",
"<M>", "CODE",
"ProductTitle", "STRONG",
"Strong", "STRONG",
"Subscript", "EM",
"Superscript", "EM",
"TagName", "STRONG",
"Variable", "VAR",
);
#---------------------------------------------------------------------------
#
# PARAGRAPH TAGS:
#
# Each Paragraph Tag on the left maps to the corresponding HTML tags
# on the right. You can specify various conditions when mapping frame's
# tags to HTML tags.
#
# Currently the syntax for the HTML mapping is as follows (stuff on right):
#
# Syntax: [+][-]<TAG[ [(+|-)n]>[pre][::post]
#
# Where :
# + Indicates not to convert tabs to spaces. See NOTE ABOUT DLs.
# - Indicates not to convert autonumbering
# TAG One of the valid HTML tags
# -n Level of list item (intended for multi-level lists)
# +n Level of paragraph within a list (doesn't start new list item)
# pre Additional text that is inserted before para (can use HTML)
# post Additional text that is inserted after para (can use HTML)
#
# The pre and post data can contain almost anything. Obviously, they
# cannot contain extra ::s because that'll get interpreted as the
# separator. I can't see why anyone would want to print ::s normally,
# so I don't see it as a problem. Also, if you want to use newlines
# in your pre or post data, be sure to protect the slash. So use:
#
# "<ASIS>\\n<P>::</P>\\n"
#
# to simulate the way P's will behave in HTML+.
#
#
#
# NOTE ABOUT DLs:
#
# Currently the initial + sign (don't convert tabs) should
# only be used with the DL tag. That is, if you have paras
# that are glossary-lists, where the term is separated from
# the definition by a tab, then specify "+<DL>" as the
# conversion. This says, leave the tab (it'll be used to
# split the term and def automagically), and convert to a DL.
#
# If you're using separate Paras for the Term and Def, then
# specify the Term as a DT and the Def as a DD. If you want
# multiple Paras in the Def, they'll need to be tagged DD too.
#
#
# HTML CURRENTLY SUPPORTED:
#
# <OMIT> Skip paragraph (but still allows pre and post data
# <ASIS> Print paragraph without being wrapped (pre & post ok)
# The ASIS tag is rather powerful. It would enable you
# to completely define how any element is wrapped. For
# example <ASIS><FOO></FOO> would enable you to specify
# a Paragraph Tag to be wrapped by element FOO, which
# of course need not be in the original HTML specification.
#
# <HR> Heading rule (HTML extension; not recommended)
# <BR> Break line
# <P> Standard paragraph
#
# <TITLE> Title of document (REQUIRED!)
# <H1> H1 heading
# <H2> H2 heading
# <H3> H3 heading
# <H4> H4 heading
# <H5> H5 heading
# <H6> H6 heading
#
# <PRE> Preformatted text (leave as is in monospace font)
#
# <UL-1> Unordered list first level (Bulleted list)
# <UL-2> Unordered list second level
# <UL-n> Unordered list nth level
# <UL+1> Unordered list para (no bullet; keep level 1 list going)
# <UL+2> Unordered list para (no bullet; keep level 2 list going)
# <UL+n> Unordered list para (no bullet; keep level n list going)
#
# <OL-1> Ordered list first level (Numbered list)
# <OL+1> Ordered list para (no number; keep level 1 list going)
#
# <DL> Definition List (Term and Def are separated by a tab)
# <DT> Definition Term
# <DD> Definition Definition
#
# <ADDRESS> Used to specify the authors email/postal address
# <BLOCKQUOTE> Indented paragraph, as in long quotation
#
# <COMMENT> Comment block (doesn't appear in browser)
#
#---------------------------------------------------------------------------
%tags2tokens = (
"aa.first", "<P>",
"aa.normal", "<P>",
"bb.bull", "<UL-1>",
"bb.bullfirst", "-<OL-1>",
"bb.bullnum", "-<OL-1>",
"bb.bullseq", "-<OL-1>",
"dd.sec0", "<H2>",
"dd.sec0TOC", "<H2>",
"dd.sec1", "<H2>",
"dd.sec1TOC", "<H2>",
"dd.sec2", "<H2>",
"dd.sec2TOC", "<H2>",
"dd.sec3", "<H3>",
"dd.sec3TOC", "<H3>",
"dd.xercises", "<H2>",
"dd.xercisesTOC", "<H2>",
"dd.xercises1", "<H3>",
"oo.chapnonum", "<H1>",
"oo.chapnonumTOC", "<H1>",
"oo.chapter", "<H1>",
"oo.chapterTOC", "<H1>",
"zz.part", "<H1>",
"zz.partTOC", "<H1>",
"Address", "<ADDRESS>",
"BarTop", "<P><HR>",
"BarBottom", "<P><HR>",
"Body", "<P><HR>",
"Book Title", "<H1><HR>",
"Bullet", "-<UL-1>",
"Bullet Para", "-<UL+1>",
"Bullet1", "-<UL-1>",
"Bullet1Para", "-<UL+1>",
"Bullet2", "-<UL-2>",
"Bullet2Para", "-<UL+2>",
"Bullet3", "-<UL-3>",
"Bullet3Para", "-<UL+3>",
"Catagory", "<TITLE>",
"Caution-head", "<BLOCKQUOTE><strong>Caution</strong>",
"ChpNum", "<omit>",
"ChpTitle", "<TITLE>",
"CmdFull", "<TITLE>",
"CmdAbbrev", "<P>Abbr:",
"CmdAlias", "<P>Alias:",
"Definition", "<P><H1>Definition</H1>",
"DescriptionHead", "<P><H1>Description</H1>",
"Edition", "<P>",
"Example", "<P>",
"ExamplesHead", "<P><H1>Examples</H1>",
"Figure", "<P>",
"FigTitle", "<P>",
"FigTitleL", "<P>",
"FigTitleS", "<P>",
"FixedWidth", "<PRE>",
"FootnoteBody", "<P>",
"FootnoteTable", "<P>",
"GlossaryDef", "-<DD>",
"GlossaryTerm", "-<DT>",
"H1", "<H1><HR>",
"H2", "<H2>",
"H3", "<H3>",
"H4", "<H4>",
"H5", "<H5>",
"H6", "<H6>",
"H4 no toc", "<H4>",
"H1para", "<P>",
"H3/H4para", "<P>",
"HRule", "<HR>",
"InputL", "<PRE>",
"InputS", "<PRE>",
"LB1", "-<UL-1>",
"LB2", "-<UL-2>",
"LB3", "-<UL-3>",
"LB1para", "-<UL+1>",
"LBitem", "-<UL-1>",
"LDef", "+-<DL>",
"LNum", "-<OL-1>",
"LNum+", "-<OL-2>",
"LNumpara", "-<OL+1>",
"LNumPara", "-<OL+1>",
"New Book Title", "<H1><HR>",
"Note-head", "<BLOCKQUOTE><strong>Note</strong>",
"Note", "<BLOCKQUOTE>",
"Note/Caution", "<BLOCKQUOTE>",
"OrderInfo", "<P>",
"OutputL", "<PRE>",
"OutputS", "<PRE>",
"Para", "<P>",
"Paragraph", "<P>",
"Parameters", "<PRE>",
"ParametersHead", "<PRE>",
"PartInfo", "<P>",
"Product Descrip", "<P>",
"ProdDesc Title", "<H1>",
"ProdDesc Bullet", "-<UL-1>",
"Quote", "<BLOCKQUOTE>",
"ResponseLine", "<PRE>",
"RelatedLine2", "<PRE>",
"RelatedCommands", "<P><H1>Related Commands</H1>",
"RelatedConcepts", "<P><H1>Related Concepts</H1>",
"RelatedParameters", "<P><H1>Related Parameters</H1>",
"Rev Book Title", "<H1><HR>",
"Screen", "<PRE>",
"ShellPrompt", "<PRE>",
"StepNum", "-<OL-1>",
"StepNum+", "-<OL-1>",
"SyntaxHead", "<P><H1>Syntax</H1>",
"SyntaxLine2", "<P>",
"Table", "<P>",
"TBhead", "<P>",
"TBitem", "<P>",
"TBtitleL", "<P>",
"TBtitleS", "<P>",
"Title", "<TITLE>",
"Warn-head", "<BLOCKQUOTE><strong>Warning</strong>",
"WriterNote", "<COMMENT>",
) ;
#---------------------------------------------------------------------------
#
# FRAME ENTITIES
#
# Frame uses the following special entity references for certain
# special characters (such as a tab). The default translations for
# these characters is in fonts.pl. This table overrides those default
# translations for special use with HTML.
#
# For example, Frame uses HardSpace for a non-breaking space in your
# Frame file. If HTML offered an entity for non-breaking spaces, such
# as we would include that translation here like so:
#
# %html_characters (
# "HardSpace", " " # Non-breaking space
# );
#
# If you just don't like the default behavior, change fonts.pl rather
# than overriding it just for the HTML filter.
#
# For more information, refer to fonts.pl in the installation directory.
#
#---------------------------------------------------------------------------
%html_characters = (
"Tab", "\\t",
"HardSpace", " ",
"SoftHyphen", "", # hyphened by Frame
"DiscHyphen", "-",
"NoHyphen", "",
"Cent", " cents",
"Pound", " lbs",
"Yen", " yen",
"EnDash", "-",
"EmDash", "--",
"Dagger", "+",
"DoubleDagger", "++",
"Bullet", "o",
"HardReturn", "<BR>\n",
"EndOfPara", "P",
"EndOfFlow", "$",
"NumberSpace", " ",
"ThinSpace", " ",
"EnSpace", " ",
"EmSpace", " ",
);
1;