>21 5 : Detailed policy descriptions  A 
F

The "Policy Manual" for the JafSoft text conversion utilities

DThis documentation can be downloaded as part of the Ldocumentation set in .zip format



\ Previous page $F Back to Contents List#  


 '

5 Detailed policy descriptions

" 

Active Link Colour

/, P        W   $     0   $    #   
Possible values
: HTML colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6J

Identifies the colour of "active" hyperlinks, that is the colour of theDhyperlink just as it is being selected. This value is a HTML colourDthat is used to set the ALINK attribute of the <BODY> tag.



See also :-
>Unvisited Link Colour
:Visited Link Colour


+ *

Add <BR> to lines with URLs

/,         Y   $     *   $    #   
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



=Indicates that lines that are detected as having URLs in themLshould have <BR> markup added to the end. This is useful in documentsDthat have a list of URLs, one per line, as the URLs usually make theGlines quite long (avoiding short line detection), and you would want to preserve the line structure.

C

However, this is less useful where URLs occur in the middle of aLparagraph of text, as it inserts a <BR>, and breaks the paragraph.

J

Prior to V3.0 this was default behaviour, but now it is switched off by default.

J

In later versions we may attempt to make this policy auto-detected.


. '

Add contents frame if possible

/,         W   $     &   $    #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

M

This specifies that, if possible, a contents frame should be placed on theFleft of the screen to hold a generated contents list. Alternatively a/CONTENTS_FRAME HTML fragment can be defined

I

Generated contents lists are only possible when the program recognisesNheadings inside your text file, so you may need to get that working first.

I

If no content for the contents frame is possible, a WARNING message isgenerated.


! 

Add contents list

/,         W   $     -   $    #   
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: /CONTENTS
Related directives
: n/a
6



FSpecifies that the program should generate a contents list or index toCmatch all the section heading that it marks up. This contents listCwill consist of hyperlinks to take you to the corresponding sectionand HTML file.

4

The placement of the contents list depends on


L

Whenever you elect to have a contents list generated, any lines perceivedHby the program as being part of a contents list in the original documentwill be discarded.

@

You can enable this option from the command line by using the|/CONTENTS qualifier (see Changing policies by using command line options)

M

The default location for the contents list

G

If you are simply generating a single HTML page, then any contents1 list will be placed at the top of the page.

B

If you decide to split your HTML into several files, then theK contents list is placed at the bottom of first page. Any text before theH first section in your document will be placed before the contents list in this first page.


J Placing the contents list in separate file

N

If you want, you can chose to place the contents list in a separate file.L If you choose this option a "Tables of Contents" link will be added to thek top of your file. See Generate external contents file


P Changing the contents list placement in the HTML

F

From V3.2 onwards you can place a contents list wherever you wantI by inserting a $_$_CONTENTS_LIST directive at the desired location (seek Changing policies by using preprocessor directives). WhenB these tags are detected no default contents list is created.




Add Frame border

/,         W   $     &   $    #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

Q

This specifies whether or not you want visible borders on your frames. If theMborders are visible then users will be able to select and move them to resize)the frames to a size that suits them.

V
*NOTE:
If you disable this policy the attribute "BORDER=0" will be used.D This will cause your FRAMESET document to fail to validate, but isF necessary at present if you want truely invisible borders in current browsers*
1 *

Add mail headers to contents list

/,         W   $     :   $    #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



ISpecifies whether or not mail headers should be included in any generatedNcontents list. For a mail digest this should be yes, but for larger documents<with only a couple of mail headers the answer may be no.


" 

Add navigation bar

/,     <    W   $ "    /   $    #   
Possible values
: Yes/No
Default value
: Yes (when splitting HTML into many files)
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



GThis policy is only relevant if you have elected to split your documentTinto a number of smaller HTML files (see split level)

I

In such cases this policy allows you have a navigation bar inserted atDthe foot of each HTML page, before any standard footer is added.

%

The navigation bar consists of

M

This policy is enabled by default whenever file splitting is selected.


" 

Add NOFRAMES links

/,         W   $     &   $    #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

M

Specifies that a NOFRAMES link should be added to the Contents frame. Youkcan choose the target of this link using the NOFRAMES link URL policy.

M

The NOFRAMES link will target the "_top" browser window, thereby replacingMthe current FRAMESET by the single page selected without creating new browser windows.

K

NOFRAMES links are useful courtesy to users who dislike FRAMES, and they$are also search-engine friendly.

X

Note, this link is a visible NOFRAMES link. In addition to this theSsoftware will in any case create a non-visible <NOFRAMES> tag that will allowFusers whose browsers do not support FRAMES to access your content.



See also :-
6NOFRAMES link URL


( !

Allow automatic centring

n/s,      a t  h[ h ; $     % f : $   n # i  n
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



:GIndicates that automatic detection of centred text should be attempted. MThe indentation and length of each line is compared to the nominal page widtht˜within a specified tolerance (see page width and Automatic centring tolerance)

N

If the line appears centred (and meets a few other conditions) then it will&be rendered centred in the output.

N

This option is normally left switched off, as it is still too prone to giveJerrors (i.e. centring lines that shouldn't be). This has been improved inElater versions, but is still not robust enough to be relied upon.


, %

Allow definitions inside PRE

/O,  o T    C  Y d o $   i  ,   $   0 #   4
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Preprocessor
Command line option
: n/a
Related directives
: n/a
6



Highlight definition text policy is enabled.

tO

Sometimes lists of definitions appear like pre-formatted text, especially if-the definitions are aligned on the right.

T2 +

Allow email beginning with numbers

T/ ,   >   T T  TY R > $  T T  *  a $   r # u  
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



EIndicates whether or not email addresses that start with a number aretpermitted or not.

G

Often USENET and mail headers reference message IDs which are of the=Qform <number>@<domain name>. As such they will often look like validGemail addresses. This policy may be used to control how such addressesCare interpreted.


( !

Attempt TABLE generation

>//,  m     T  /Y   $  R >  0  o $   t # u  o
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: n/a
6



tKIndicates that the program should attempt automatic table generation on anynMapparently pre-formatted text it encounters. Text that appears pre-formattedeBto the program can turn out to be a number of different things


O

The program will attempt to distinguish between these, but it's a blank art._ITable generation may not be appropriate for the document being converted,tGor alternatively the table generated may be so flawed that you'd preferARto use <PRE>...</PRE> markup, in which case you can use this policy toswitch that feature off.

L

When switched off the program will still look for pre-formatted text, butTwill default to outputting it in <PRE> ... </PRE> markup as it did prior to v2.2.


, %

Automatic centring tolerance

/p, 0  v    u  >[ T n $   u  % t y $   i # i  i
Possible values
: number of characters 0,1,2...
Default value
: 2
Policy scope
: Dynamic analysis policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



eISpecifies the tolerance used (expressed as a number of characters offset)M when detecting centred text.

L

Given that the detection of centred text depends on its position relativeJto the calculated page width, which itself may not be accurate, increasingHthis value may give better results. Equally, it may wrongly detect moretext as centred.

H

The default value is 2, which is also used as a minimum regardless ofthe value you enter.



See also :-
EAllow automatic centring.

t
! 

Background Colour

/t, P  T   E e  tW t  $  s e  0  > $   A #   
Possible values
: HTML colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6



>=Identifies the background colour of the HTML page(s) created.oHThis value is a HTML colour that is used to set the BGCOLOR attribute ofJthe <BODY> tag. If omitted, AscToHTM defaults to a white background(I find Gray too dull)




Background Image

W/,,  /1 d u   l i e  >W G o p $ ' o e   .  t $   c i #   s i
Possible values
: URL of
image file (e.g. a .jpg or .gif)
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: Added HTML
Menu location
: Output
-> Title, description etc.
Command line option
: n/a

Related directives
: n/a

6



i>Identifies the URL of any image to be placed in the BACKGROUND&attribute of the <BODY> tag.


% c

Bottom margin (in cm)

/>,  e t s    l e  rW  B C $   l e  6  < $   T R # e  l e
Possible values
: Text
string
Default value
: (see
below)
Policy scope
: Fixed output policy

Policy file section
: RTF

Menu location
: Output -> RTF Settings
Command line option
: n/a

Related directives
: n/a

6.

Only applies to RTF generation

N

For conversions to RTF only, this specifies size of margin at the bottom ofLthe page. If omitted the Word default of 1 inch (2.54 cm) will be used.


( !

Break up long HTML lines

/o,  A c    r  rY z r $ "  h  / t t $    # >  n
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



yHSpecifies that long HTML lines should be broken into smaller ones. ThisSattempts to make the HTML more readable, should you need to edit it afterwards.

R

However, there is the possibility that the insertion of newline characters intoKthe output could affect how the HTML is displayed. This is because most of.Hthe browsers have bugs in their parsing of newlines. These problems are>most pronounced when using non-standard (12pt) font sizes.

B

If you experience such problems, try disabling this policy.


 

Bullet char

/R, F  p      sY e  $   t  ) = > $   > # e  f
Possible values
: '<character>'. One policy line per character
Default value
: '*'
Policy scope
: Fixed analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



=MThis policy will probably be replaced in future versions

N

This species a character that can occur at the start of a line to representIa bullet point. Special attention is paid to '-' and 'o' characters, butFany character will do.

N

The program should detect such characters (e.g. special character codes for:bullets that are generated when saving from Word etc.)

)

Use one line for each bullet char.

o
( !

Check domain name syntax

e/,  i     e  Y v  $  L e  *   $    #   !
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

J

Indicates whether or not potential URLs should have their "domain name"Kchecked against the known domain name structures, (e.e. ends in .com, .org,>G.co.uk etc). Having this switched on reduces the likelyhood of invalid.EURLs being turned into clickable links that don't go anywhere. Note,yXthe software doesn't check the domain exists, only that the domain nameobeys the known rules.

H

You might want to switch this off if your document contains URLs thatGdon't use standard domain names (e.g. they are inside an Intranet).

B
1 e*

Check indentation for consistency

/P,  h d    g  M[ h l $  e   ,   $   < # t  a
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Output -> HTML styling
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

J

Specifies that when checking headings the indentation should be checkedIfor consistency. This can help reduce the error rate when numbered listslJand numbered headings are both in the same document, but on the other handMcan cause problems in documents where the headings are centred, and thereforel"at all different indentations.




Colour data rows

B/>,  T T   R >  TY  / $  T R  0  : $    # e] h <
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_COLO(U)R_ROWS"
6



IIIndicates that where AscToHTM detects and generates HTML tables, the dataHrows (as opposed to the Header rows) should be alternatively be colouredHdifferently. This helps highlight the different rows, especially if thetable has no border.



See also :-
LDefault TABLE odd row colour
NDefault TABLE even row colour


1 O*

Column boundaries have zero width

/T,   i   t "  [ T T $     :  v $   a # <  e
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

d

When a Default TABLE layout is set, this specifies whether orKnot the boundaries between columns have zero size. By default the softwareKassumes there is a single-character boundary (either a space or a delimitericharacter) between columns.

^

Sometimes data comes from a source with no character between data columns.,This policy should be set in such cases.


% o

Column merging factor

/T,  c o    T  /[ / T $  r   0  a $   t # t  t
Possible values
: 1-10
Default value
: 5
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Analysis -> Table Analysis
Command line option
: n/a
Related directives
: n/a
6



&FWhen analysing preformatted regions to look for tables, this indicatesDthe degree to which potential columns should be "merged" if there is#any doubt as to their validity.

=O

A value of 10 means almost all "suspicious" columns will be merged together.tKThis is suitable when the analysis is producing too many false columns, andNLmay happen when the table contains a lot of free form text that just happensto line up.

J

A value of 1 means that no "suspicious" columns will be eliminated.

M

Note, it is still possible that the number and position of columns will beDHcalculated incorrectly. In such cases you may need to explicitly supplyQa table layout. See Default table layout

o
' o

Comment generation code

/<,   a    p  eY t t $     A m t $   d # t  p
Possible values
: 0,1 or 2
Default value
: 0
Policy scope
: Dynamic output policy
Policy file section
: n/a
Menu location
: Output -> Added HTML -> Advanced Options
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

J

Used to control the placing of comment in the code advertising the factDthat AscToHTM was used to generate the file. By default the programIwill add a META tag marking ASCTOHTM as the generator and comments at the 7top and bottom of the file identifying the program.

t)

The value should be set as follows

t
/n,  ,  b   R    
0
META tag and comments added
1
META tag added
2
neither added
6
2O

This policy is only available in the registered version of the software.


0 )

Contents frame background colour

R//, P  -   < c  aW e c $  h t  :  e $   n #   l
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

f

See discussion in Header frame background colour.


* #

Contents frame text colour

l/, P  <   > t  cW  T $  <   :  b $   t #   c
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

f

See discussion in Header frame background colour.


$ 

Contents Frame width

/D, 4  >    t  W D T $  n t  &  e $   / # B  i
Possible values
: Size in pixels or as a percentage
Default value
: 200
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

N

If a contents frame is generated, this specifies its width. The default isO200 pixels. To specify a percentage, add the % sign on the end, e.g. "30%"



See also :-
8Header Frame depth
8Footer Frame depth


# >

Contents style code

/,  / /    t  Y   $  > l  :  r $    # o  l
Possible values
: 0, 1
Default value
: 0
Policy scope
: Dynamic output policy
Policy file section
: Contents
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



ISpecifies a "style" to be applied to the contents list. There aren't tooEmany options at present.



Possible values are

/T,  = a m  *  o
0
AscToHTM "Classic". Contents line is bolded
1
As above, but not bolded.
6


- e&

Convert TABLE X-refs to links

/R,  d a   e n  lY r  $  a o  0  u $   g # ] A u
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_CONVERT_XREFS"
6



EIndicates whether or not cross-references to numbered sections shouldCbe converted into hyperlinks to those sections. Unfortunately, the>Dprogram cannot differentiate between section references and ordinaryEnumbers in the source text (unless you place the number inside a TEXTE;in-line tag). This leads to occasional errors, for example/>when software version numbers are discussed in a document.

I

This problem proved to be particularly acute inside tables of numbers.0independently from the rest of the document.

E

By default this policy is disabled. Users should only switch thistCbehaviour on if they have a table of section numbers (such an indexoor contents list)

t


Create FTP links

c/i,   c    d  UY H o $  T E  *  B $   T # >  _
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



lThis indicates that probable FTP references such as ftp.microsoft.comFshould be converted into active hyperlinks. Sometimes text is assumedFto be an ftp link when it isn't. If you find that happening, use this%policy to prevent the conversion.

/
# L

Create Gopher links

/s,  h o    i  Y a t $  h u  *  s $   M #   e
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



PBThis indicates that probable gopher references should be convertedinto active hyperlinks.

/


! >

Create NEWS links

/H,  l <    c  HY <  $  > a  *   $   l #   e
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



d@This indicates that probable USENET newsgroup references such as‚alt.games.mornington.cresent (sic) are to be converted into active hyperlinks.


# B

Create Telnet links

/>,       o  /Y   $  <     < $   E # L  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: n/a
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

E

This indicates that probable telnet references should be convertedsinto active hyperlinks.


! 

Create a log file

/.,  # a   B M  : Fixed output policy
u
T $   <  /  o $ (  h # >  
Possible values
: Yes/No
Default value
: No
Policy scope
Policy file section
: n/a
Menu location
: Output -> File Generation
Command line option
: /LOG=<filespec>
Related directives
: n/a
6



OSpecifies that a .log file should be created. This will contains copies of all

See also :-
:Output log filename


! T

Create hyperlinks

/E,  l       iY < c $   A  *  t $   > #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



iLThis indicates that all candidate http, www and ftp URLs should be convertedinto active hyperlinks.

/
# e

Create mailto links

/o,  > >      >Y p e $  o u  *  m $   h # s  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



opThis indicates that all candidate email addresses such as info@jafsoft.com6are to be converted into active mailto hyperlinks.


# p

Cross-refs at level

/<, *      v  /Y T T $  . c  *  > $   p # >  >
Possible values
: Headings level, 0,1,2..
Default value
: 2
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



aHFor documents with numbered section headings, this indicates the sectionGlevel at which and above which all cross-references are to be converteds-to hyperlinks to the sections themselves.

aC

For example a value of 2 means all n.n, n.n.n etc references aredAconverted. A value of "1" might seem desirable, but is liable to Cgive many false references. This is because the error rate becomesm9too high on single numbers/letters or roman numerals.

s-

This may be refined in later releases.

AG

A value of "0" means "don't add hyperlinks to cross-references".

E

See also :-
EExpect numbered headings.

R
 

Default Font

D/e, L  o   l(  3  W l T E $   > a   i  p $    i # >  t T
Possible values
: "<face>, <Type>, <font_size>"
Default value
: "Times
New Roman, Regular, 12"
Policy scope
: Fixed output policy

Policy file section
: Style

Menu location
: Output
-> Fonts
Command line option
: n/a

Related directives
: n/a

6I

This tells the program what font should be used. The value is a comma>!separated list which contains

'>,  O4  E L u>   t o P E " *  e
<face>
The font family name (e.g. "Arial")
<Type>

Whether or not it's bold etc. The possible values
 are




Regular
m Bold
 Italic
 BoldItalic
<font_size>
Font size in points (pts)
.

' >

Default TABLE alignment

/2, 6  T    o  T[ e > $  a t  0  r $   " # M o a
Possible values
: L[eft],R[ight],C[enter],A[utomatic]
Default value
: Automatic
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_ALIGN"
6



HSpecifies how the table should be aligned with respect to the page. TheIdefault behaviour is "automatic", which usually means left-justified, butT6taking into account any indentation the table has.


+ $

Default TABLE border colour

/, P  >      /Y s - $  A c  0  t $   o # BY > a
Possible values
: HTML colours
Default value
: ""
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_BORDERCOLOR"
6



c<This tells AscToHTM what colour to use for the table border."Not all browsers support this.


) "

Default TABLE border size

/<,  D  /       Y n T T $   T R   >&  l $    e # eO   H
Possible values
: A size
(in pixels)
Default value
: 0

Policy scope
: Dynamic output policy

Policy file section
: Tables

Menu location
: Output
> Table generation
Command line option
: n/a

Related directives
: "TABLE_BORDER"

6



TJThis policy sets the default value for the <TABLE> BORDER attribute.#A value of 0 means "no border".

r
% =

Default TABLE caption

/!,   <   a <  RY _ n $  e <  :  b $    # Q e >
Possible values
: Text string
Default value
: ""
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: "TABLE_CAPTION"
6



eMSpecifies the caption to be applied to generated tables. However, since thisfIwill be applied to all generated tables, this is less useful that placing <individual TABLE_CAPTION directives in your source text.


, %

Default TABLE cell alignment

e/s, 6  e  9 b p  fY e  $  m h  0  / $   P # bW R 
Possible values
: L[eft],R[ight],C[enter],J[ustified]
Default value
: "(none)" - meaning auto-detect.
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_CELL_ALIGN"
6



ALSpecifies the default cell-alignment to be applied to table cells. NormallyIthe program will try to auto-detect a suitable cell alignment on a columnn!by column, cel by cell basis.

L

You can use this to (rather crudely) set all cells to be aligned the same-way if the results are not to your taste.


* #

Default TABLE cell padding

/a,  =  t     f  tY r > p $  E N A   o&  u $    H # mY  > 
Possible values
: A size
(in pixels)
Default value
: 2

Policy scope
: Dynamic output policy

Policy file section
: Tables

Menu location
: Output
> Table generation
Command line option
: n/a

Related directives
: "TABLE_CELLPADDING"

6



RIThis tells AscToHTM what value to use for the TABLE CELLPADDING attribute/Uof the table. Browsers that support this will add space inside eachT cell.

e#

A value of "0" means "none".

e
* #

Default TABLE cell spacing

c//,  A  L    / D  aY  c 2 $  > l <   >&  p $   R  # >Y E > R
Possible values
: A size
(in pixels)
Default value
: 2

Policy scope
: Dynamic output policy

Policy file section
: Tables

Menu location
: Output
> Table generation
Command line option
: n/a

Related directives
: "TABLE_CELLSPACING"

6



:CThis tells AscToHTM what value to use for the CELLSPACING attributeaVof the table. Browsers that support this will add space between each cell.

r#

A value of "0" means "none".

c
$ 

Default TABLE colour

=/T, P  2   R >  Y  T $  <   0   $   o # oQ  c
Possible values
: HTML colours
Default value
: ""
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_BGCOLOR"
6



AThis tells AscToHTM what colour to use for the background to each)cell. Not all browsers support this.

Q

If omitted the table with take on the background colour of the whole page.



See also :-
7Background Colour.

E
- i&

Default TABLE even row colour

/<, P  t   B   LY t i $  t g  0  = $   e # e  o
Possible values
: HTML colours
Default value
: "E0F0E0"
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_EVEN_ROW_COLO(U)R"
6



lLWhen AscToHTM is to colour odd and even rows in the tables that it generatesddifferent colours (see Colour data rows), this identifies the colourof the even numbered rows.



See also :-
MDefault TABLE odd row colour.

R
) "

Default TABLE header cols

/>, + s -    t  [  t $  E =  :  a $   > # mY  R
Possible values
: Number of columns 0,1...
Default value
: 0
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: "TABLE_HEADER_COLS"
6



e

Normally this is 0.


) u"

Default TABLE header rows

/d, ) i     H  [ <  $  a <  1  p $   T # >Y > -
Possible values
: Number of rows 0,1....
Default value
: 0
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_HEADER_ROWS"
6



EThis policy tells AscToHTM how many lines should be treated as header/9lines and placed in <TH> .. </TH> markup.

oP

The program will treat a small number of lines of text above a line as header>automatically, so you only need this if that doesn't work.

D

If set, this value will apply to all tables.


$ 

Default TABLE layout

l/u, - g s    e  d[ e s $  > a  :  = $   , # O T a
Possible values
: <layout description>
Default value
: 0
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: "TABLE_LAYOUT"
6



>IThis policy tells the program what the column structure is for any tables/Zin the file. This will only work if all tables in the file have the samestructure.

4

The <layout description> takes the form

K

<number of columns>,"<col 1 spec>","<col 2>",.....

p

where,

>
' , ' >*   d h1  r  L8    (2  T  B4  a
<Number_of_cols>
Integer number of columns
<col_n_spec>

Specification of the nth column. The
a8 specification must be contained in quote.

Currently the specification consists of

- the end position of the column.

More may be added in later versions
.



An example would be

/

Default TABLE layout : 3,"6","21","32"

/K

which describes a 3-column table with column boundaries at the 6th, 21stn!and 32nd character positions.

/Z

If the policy is used the layout will apply to all tables in the file.yFor this reason it is normally better to place an equivalent "TABLE_LAYOUT"PJpre-processor directive between BEGIN_TABLE...END_TABLE directives for thetable it applies to.


, %

Default TABLE odd row colour

</D, P  a   - e  Y a t $  _ "  0  < $    # lc = t
Possible values
: HTML colours
Default value
: "F0F0F0"
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_ODD_ROW_COLO(U)R"
6



lLWhen AscToHTM is to colour odd and even rows in the tables that it generatesddifferent colours (see Colour data rows), this identifies the colourof the odd numbered rows.

>

See also :-
ODefault TABLE even row colour.

e
# 2

Default TABLE width

/T, B  R   <   tY < / $  u B  0  o $   A # tM > >
Possible values
: Table width in pixels or as a % of screen width
Default value
: ""
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: Output -> Table generation
Command line option
: n/a
Related directives
: "TABLE_WIDTH"
6



OThis tells AscToHTM what value to use for the WIDTH attribute of the table.

BK

The WIDTH is specified either as a number (of pixels) or as a percentagepG(of screen width). Thus "400" and "75%" are both valid values (without the quotes)

X
Note:
If you use this policy, all your tables will be the9 same width. If you wish to switch it on for individualu- tables, place $_$_TABLE_WIDTH commands (seeR Changing policies by using preprocessor directives) in your source file instead.T
 g

Definition char

/, I b a   n   AY   $  T T  0   $   > # f  a
Possible values
: One line per character in the form 'char' weak/strong}
Default value
: '-' (weak)
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General Layout
Command line option
: n/a
Related directives
: n/a
6

T



v
IThis policy will probably be replaced in future versionso



TIThis specifies the characters used to detect "definitions". A definition>Jline is a single line that appears to be defining something. Usually thisKis a line with either a colon (:) or an equals sign (=) in it. For examples

*
b#        IMHO = In my humble opinione-        Address : Somewhere over the rainbow.d
1E
H

The character can be marked as "Strong" or "weak". Strong means suchWcharacters always signal a definition. Weak means they only sometimesA\do this, depending on the position relative to the Page Width.

L

The user interface presents this more cleanly than the text in the policy?file does, and the latter may be changed in later versions.


% T

Directory Description

/_,      t b  >W > i $   L  .  > $    # o  
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



cdWhen you have elected to create a directory file (see Make Directory),Kthis indicates the description of your document that is added to a META tag3Ninserted into the <HEAD> section of the Directory page as follows :-

C

<META NAME="description" CONTENT="your description">

/
G

This tag is often used by search engines (e.g. AltaVista) as a brief>Cdescription of the contents of your page. If omitted the first fewoAlines may be shown instead, which is often less satisfactory.

"


" 

Directory Keywords

>//, 3 > u   R   W g E $   i  .  h $   a # <  n
Possible values
: Comma-separated list of keywords
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



edWhen you have elected to create a directory file (see Make Directory),Ithis allows you to specify keywords that are added to a META tag inserted>Einto the <HEAD> section of the Directory page as follows :-

E

<META NAME="keywords" CONTENT="your list or keywords">

i
aI

This tag is often used by search engines when indexing your HTML page.yCYou should add here any relevant keywords possibly not contained infthe text itself.


% 

Directory Script file

/T, O i B   i _  >W  : $     .  e $   e # y  T
Possible values
: Local file containing JavaScript fragment you want embedding
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6g

When you have elected to create a directory file (see Make Directory),/Fthis identifies the name of a text include file to be transcribed intoJthe <HEAD> ... </HEAD> portion of the generated HTML page.

H

This allows you to place JavaScript in your pages (though you'll be a-little limited as to what it can act on).

G

If omitted, this will default to any script file used in the rest of Ythe HTML pages as set by the HTML Script file policy.

o
 R

Directory Title

/n,   >   t o  uW l P $     .  ! $   E # <  c
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6g

When you have elected to create a directory file (see Make Directory),sOthis specifies the text to be used as the HTML title of the Directory page.

t


B" 

Directory filename

/>, C / T   t _  VW B u $   t  .  i $   H # A  B
Possible values
: Local file to be created with directory contents
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6g

When you have elected to create a directory file (see Make Directory),AJthis specifies the name of the Directory page html file to be created.

L

If omitted, this will default to "dirindex.html" in the output directory.KPrior to V3.2 this used to be "index.html", but people complained when thatH.overwrote their existing index.html files.


% >

Directory footer file

/>, G / >   T H  sW d r $   l  .  s $   s #   L
Possible values
: Local file containing HTML code to be used as footer
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



sdWhen you have elected to create a directory file (see Make Directory),Fthis identifies the name of a text include file to be transcribed intoPthe HTML file at the bottom of the <BODY> ... </BODY> portion of thegenerated HTML page.

C

This can be used to add "return to home page" links, and contacts!addresses to your HTML pages.

TG

If omitted, this will default to any header file used in the rest of Ythe HTML pages as set by the HTML header file policy.


% 

Directory header file

//, G s   "  a  W   $   l  .   $   R # B  T
Possible values
: Local file containing HTML code to be used as header
Default value
: "dirindex.html"
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



odWhen you have elected to create a directory file (see Make Directory),Fthis identifies the name of a text include file to be transcribed intoMthe HTML file at the top of the <BODY> ... </BODY> portion of theoDirectory page.

iG

If omitted, this will default to any header file used in the rest ofHTML header file policy.

T
/ U(

Directory return hyperlink text

/,   f    &  mY w > $   =  .  u $    # n  f
Possible values
: Text string
Default value
: "Directory"
Policy scope
: Dynamic output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6g

When you have elected to create a directory file (see Make Directory),>Kthis specifies the text to be shown on the hyperlink linking each HTML pageback to the Directory page.

m'

The default value is "Directory"

/


Display messages

L/B,  l l    P  aY p q $   c  :  = $   - #   L
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: n/a
Menu location
: (only available by editing policy file)
Command line option
: /SILENT
Related directives
: n/a
6



uKSpecifies that all display and informational messages should be suppressed.>FIf selected, you will get no messages displayed at all, although theseScan still be directed to a .log file (e.g. by using the /LOG command qualifier)

"B

This policy is equivalent to the /SILENT command qualifier.


 B

Document Author

/-,      m t  WW r > $   t  0  e $   E # B  B
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

N

For conversions to RTF only, this specifies the Author name to be placed in2the generated file's document details section.


! 

Document Base URL

/, ; > l   > >  tW   $  > E  A  T $    # TG  n
Possible values
: Absolute URL (i.e including domain name)
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Added HTML -> Advanced Options
Command line option
: n/a
Related directives
: "BASEHREF"
6(

New in version 4

P

This policy allows you to specify a URL that will be placed in a <BASE>Wtag inserted into the <HEAD> section of the output HTML page(s) as follows :-

o

<BASE HREF="URL">

F

This tag is used to specify the base URL against which all relativeEURLs should be resolved. You might want to use this if you are goingiIto copy the page to a mirror location, but not copy the pages referred toR:in the relative links (like images, style sheets etc.)

"

Ignored in RTF conversions.


! }

Document Category

/a,   y    R  W R  $     0  ! $   S # n  
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

J

For conversions to RTF only, this specifies the document category to be<placed in the generated file's document details section.


! 

Document Comments

/d,   n   i a  dW T n $   t  0  H $   _ # >  <
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

K

For conversions to RTF only, this specifies any comments to be placed ina2the generated file's document details section.


% 

Document Company name

/t,   /   D T  !W c e $   i  0  g $   T # n  P
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

O

For conversions to RTF only, this specifies the Company name to be placed inc2the generated file's document details section.


$ 

Document Description

L/L,         AW   $  T T T 2   $   ! # uM  #
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Title, description etc.
or
, Output -> Document Details
Command line option
: n/a
Related directives
: "DESCRIPTION"
6



a@This policy allows you to specify a description of your documentIthat is added to a META tag inserted into the <HEAD> section of thew output page(s) as follows :-

A

<META NAME="description" CONTENT="your description">

G

This tag is often used by search engines (e.g. AltaVista) as a briefyCdescription of the contents of your page. If omitted the first fewMAlines may be shown instead, which is often less satisfactory.

J

Any DESCRIPTION pre-processor command(s) present in the source documentwill override this policy/

M

In a RTF conversion the description will be placed in the document detailso header.

i
! a

Document Keywords

/o, ? <    o >  : Fixed output policy

 $  T > i 2  f $   . # pG y a
Possible values
: Comma-separated list of keywords and phrases
Default value
: ""
Policy scope
Policy file section
: Added HTML
Menu location
: Output -> Title, description etc.
or
, Output -> Document Details
Command line option
: n/a
Related directives
: "KEYWORDS"
6



tGThis policy allows you to specify keywords that are added to a META tag Sinserted into the <HEAD> section of the output HTML page(s) as follows :-

y
E

<META NAME="keywords" CONTENT="your list or keywords">

EI

This tag is often used by search engines when indexing your HTML page. CYou should add here any relevant keywords possibly not contained in<the text itself.

H

Any KEYWORDS pre-processor command(s) present in the source file willoverride this policy.

eO

In an RTF conversion this will be placed in the document details header.

l


Document Manager

/;,   T   c >  BW _ " $     0  a $   E # o  
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

Q

For conversions to RTF only, this specifies the name of the Document's managerEBto be placed in the generated file's document details section.


$ 

Document Style Sheet

t/o,  C B    i E e  eW e o t $   t t   i  i $   o < # uM b  
Possible values
: URL of
a .CSS file to be used as the external style sheet
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: Style

Menu location
: Output
-> CSS
Command line option
: n/a

Related directives
: "STYLE_SHEET"

6



LThis specifies the URL of a style sheet file, usually with a .css extension.IStyle sheet files are a new HTML feature that allow you specify fonts and.Gcolours to be applied to your document. By placing this information inf5a separate file, the same style can be applied to

/M

The resulting HTML is inserted into the <HEAD> section of the outputspage(s) as follows :-

>
A

<LINK REL="STYLESHEET" HREF="URL" TYPE="text/css">


B 

Document Subject

d/>,   e   T t  ;W t g $   i  0  _ $   e # >  A
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> Document details
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

K

For conversions to RTF only, this specifies the document's Subject to be <placed in the generated file's document details section.


 

Document Title

/F,      D L  >W i B $  l d  2  t $   g # rA  h
Possible values
: Text string
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Title, description etc.
or
, Output -> Document Details
Command line option
: n/a
Related directives
: "TITLE"
6



lOIdentifies the text to be placed in the <TITLE> ... </TITLE> markup>in the document header.

xK

If omitted, the default title will be "Converted from <filename>".PPWe did consider defaulting to the first line of text, but that rarely works.

~

However you can get this effect by using either of the Use first heading as titleOor Use first line as title policies.

tL

The title can also be specified via the TITLE preprocessor command placedIin the source document, which will override this policy when present.

T/

If order the preference for the title is

 r
r! o

DOS filename root

/<,  /,  B   > <   >W y  A $  >  y  9  o $   t T # T   /
Possible values
: Text
string (up to 5 characters)
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: File
generation
Menu location
: Output -> File generation
Command line option
: n/a

Related directives
: n/a

6



-BWhere DOS filenames are used this allows you to specify an up-to-5<character root to which any section numbers will be appended1(see Split level).

J

If splitting a document at 2 levels we normally recommend a 3-characterfilename root.

F

Thus MYDOC.TXT given a root of MYD would produce MYD.HTM, MYD_1.HTM@MYD_1_1.HTM etc... which are all less than 8 characters and thusmaintain some readability.

?

If no root were specified, MYDOC_1_1.HTM would be renamed tovAMYDnnnnn.HTM where "nnnnn" would be a generated 5-digit code.

=

See Use DOS Filenames


% 

Error reporting level

//, @  l      Y  a $  > P  5 e n $   t #   E
Possible values
: 1 (not many messages) - 10 (lots of messages)
Default value
: 5
Policy scope
: Dynamic output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



>FSpecifies the level of error reporting you want during the conversion.LThe program can generate a variety of messages of varying severity to informKyou of the decisions it's made. These messages can be useful in explaining.Mwhy a conversion has gone wrong, but are less interesting at other times.

eQ

Whilst all of these messages are copied into any diagnostic .lis files createdoj(see Generate diagnostics files) regardless of severity, you canTuse this policy to choose the level of reporting you want to see on your screen.

I

The value is nominally in the range 1-10 with a value of 1 showing fewEDmessages and a value of 10 showing almost all messages. The defaultvalue is 5.

e
+ T$

Expect Capitalised Headings

/d,  R >      l[ t  $  c   *  C $   = # T  T
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6



>DIndicates whether or not a line that is wholly capitalised should beOregarded as a section heading. Capitalised headings will normally only be usedDCif there do not seem to be any numbered or underlined headings.



See also :-
DExpect numbered headings
HExpect underlined headings


$ 

Expect Contents List

//!,  e     a  >[ y  $   o  - l R $   d # t[ R 
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: n/a
Related directives
: "BEGIN/END_CONTENTS"
6



uPIndicates whether or not the source file contains an existing contents list.

J

This should be detected automatically, but sometimes the analysis failsJin which case you should either set this manually, or mark up the contentsGlist in the source file using using the BEGIN_CONTENTS ... END_CONTENTSopre-processor commands.

o

See also :-
6Add contents list


( !

Expect Embedded Headings

H/d,  > >      >[ d o $     *  n $    # >  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

H

Indicates whether or not a line that begins with capitalised text mayNbe regarded as an "embedded" section heading. Embedded headings will normallyPonly be used if there do not seem to be any numbered or underlined headings.



See also :-
DExpect numbered headings
IExpect underlined headings.

s
( !

Expect Numbered Headings

D/A,  T f    I  T[ m l $  > <  *  _ $    # B  s
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6



dHIndicates whether or not lines that begin with section numbers should beIregarded as section headings. Checks will be made to ensure that numbersTKare in a valid sequence, occur at the correct indentation, and are properlytMplaced in the file. This reduces the error rate that would occur by assumingnJthat every line beginning with a number is a heading.




mSee also :-
nJExpect capitalised headings
HExpect underlined headings


' o

Expect Numbered bullets

/E,  r r    >  T[  > $     )  p $    # o  T
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



NIndicates that numerical bullets are expected (but you probably guessed that).LNormally detected during analysis. Numbered bullets are often just numberedlists in the source file.

fJ

Sometimes numbered bullets and numbered headings get confused and it is2necessary to enable one and disable the other.



See also :-
DExpect numbered headings
FExpect alphabetic bullets
LExpect roman numeral bullets


, %

Expect Roman Numeral bullets

r/n,   e    B  >[  e $   e  ) i > $   R # o  ;
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



LIndicates that roman numerals bullets/lists are to be expected. The program0supports both upper and lower case variants.



See also :-
FExpect alphabetic bullets
BExpect numbered bullets


+ $

Expect Second Word Headings

/o, .  b   f   D[ D R $  l e  *  > $   / #   T
Possible values
: Yes/No (but don't use this)
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6



T7reserved, and liable to be removed


* #

Expect Underlined Headings

T/R,   e    f  .[ t t $  t   *  H $   c # 3  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6M

Indicates whether or not a line that is underlined should be regarded as a/section heading.

[

A line is deemed to be "underlined" if the next line in the source file;Jconsists solely of "line" characters like "-_+=~", and is a similar lengthLto the previous line. If the lengths are not similar, then such a line willIbe treated as a line in its own right, becoming a <HR> in HTML.

>

See also :-
DExpect numbered headings
JExpect capitalised headings


) >"

Expect alphabetic bullets

/n,  e e      t[  s $   a  ) B  $   B # l  e
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



GIndicates that alphabetic bullets/lists are expected. The program willpIrecognises (and distinguishes between) upper and lower case variants.

oJ

Sometimes lines that begin with a single letter are wrongly interpretedKas an alphabetic bullet point, especially if it's followed by a punctuation>Jcharacter. In such cases you can either disable this policy, or edit yourSsource code so that the single letter no longer appears at the start of a line.

l

See also :-
BExpect numbered bullets
LExpect roman numeral bullets


0 )

Expect blank lines between paras

r/i,  T c    u  p[ >  $  f b  0  ( $    # M  >
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



BNIndicates that paragraphs are expected to have blank lines before them. WhereJthis isn't true (e.g. on a text file dumped from Word) different paragraphOdetection algorithms have to be applied, which tend to be more error prone.

>
# e

Expect code samples

/o,  /    o >  [ R  $   /  0  u $   f # tS P t
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: "BEGIN/END_CODE"
6



IIndicates that the document is liable to contain samples of program code.YJThe program will attempt to detect such code fragments, and preserve theirKlayout so that the code remains comprehensible, however this process can benAflawed, and often code samples are rendered as ordinary text.

oA

Where the program fails to detect the full extent of your code?

You can choose how code fragments are marked up by using the>wUse <CODE>..</CODE> markup policy, although this is not generallya$suitable for multi-line samples.


$ 

Expect sparse tables

c/y,  T T   e >  n[ B  $  e E  0  s $   o # s] t m
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Analysis -> Table Analysis
Command line option
: n/a
Related directives
: "TABLE_MAY_BE_SPARSE"
6



eLIndicates that tables within the source document may be sparse, that is theyImay contain a large number of "empty" cells. This fact will then be usede2to adjust the analysis of any tables detected.

L

For example, by default columns which appear to have little or no data inEthem are usually eliminated by merging them with their more populateduneighbours.

BM

If you set this policy, this process is relaxed, meaning that you will getBI

This policy can be toggled for individual tables via the pre-processor>Mcommand TABLE_MAY_BE_SPARSE placed between BEGIN_TABLE ... END_TABLE commands&placed before and after the table.


/ c(

External contents list filename

/T, C     T R  BY B u $  p s  - e e $   - # e  H
Possible values
: Local file to receive any external contents list
Default value
: ""
Policy scope
: Fixed analysis policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: n/a
Related directives
: n/a
6



MvWhen you select to Generate external contents file, this is the name of7the external content file generated by the program.

>I

By default the file will be called contents_<filename>.html.

TS

The contents file should be in the same directory as the created HTML files.

e
$ 

First Section Number

a/T, / n t      [ " D $  e E  *  n $    # e  u
Possible values
: 1,2,3... but best left alone
Default value
: 1
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6



EDIndicates the chapter number of the first numbered section in a filehcontaining numbered sections (see Expect numbered headings).

L

Normally this starts at 0 or 1, but if it starts higher, then the programLwill reject headers as being out of sequence, and fail to detect to presence+or absence of contents lists correctly.

,

Only for the advanced/foolhardy user.


' o

First frame page number

/ , &  u    n  RW  / $  s -  &  e $   E # i  b
Possible values
: Integer - 1,2, etc.
Default value
: 1
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

P

This specified the "page number" of the main document that you initially want,shown in the main frame of the FRAMESET.

Q

When converting large documents you can choose to split them into many smallersLpages. Often such documents have a contents list as the sole content of theLfirst page, and inside a FRAMES document his has the unfortunate side-effectNof displaying a contents list in the main frame next to a contents list in theEcontents frame. In such cases you might choose to start by initiallyecdisplaying the second page in the main frame. That's what this policy is for.

T

See also :-
*split level


2 +

First line indentation (in blocks)

B/e, A e d    e  aY m t $   R  :  x $   e # m  t
Possible values
: Size in "blocks" of indent (aka tab positions)
Default value
: 0
Policy scope
: Dynamic output policy
Policy file section
: RTF
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



HSpecifies the size in tab positions of the indentation of the first lineEof a paragraph with respect tho the left margin of the paragraph.

K

This policy was originally intended for use in RTF where such styling isl<commoner, but is now applied to HTML generation as well.


0 )

Font stretch factor (in percent)

/-,   >    >  BW u  $   s  :  d $   - # e  H
Possible values
: -nn, 0, +nn
Default value
: 0
Policy scope
: Fixed output policy
Policy file section
: Style
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6L

Specifies a scaling factor to be applied when calculating the space takenOup by text rendered in the prevailing font. The software attempts to calculatebIthis from the text and the font size and bolding, but in reality there isRLquite a variety which means sometimes these calculations are inaccurate.

L

In normal text, this isn't a problem, but inside tables - especially whenMgenerating RTF - getting the width wrong can force lines to wrap, or generate>Ktoo much white space. The same problem can occur when setting pixel widths>:in HTML (which is a bad idea for exactly this reason).

M

If the table widths are looking wrong, use this policy to adjust the spaceIallowed for text. A value of +10 will increase the space by 10%, a valuen#of -10 will decrease the space.

<
. '

Footer frame background colour

;/E, P  B   e >  pW x n $   R  :   $   B # o  p
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

f

See discussion in Header frame background colour.


" 

Footer Frame depth

i/T, 4      s  AW e R $  u >  &  H $    # <  /
Possible values
: Size in pixels or as a percentage
Default value
: 100
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

L

If a footer frame is generated, this specifies its depth. The default isO100 pixels. To specify a percentage, add the % sign on the end, e.g. "20%"

e

See also :-
8Header Frame depth
<Contents Frame width


( !

Footer frame text colour

+/ , P  _   p h  >W H - $  = D  :  l $   e # 2  y
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

f

See discussion in Header frame background colour.


* #

Generate diagnostics files

!/>,  n e   s i  rW r n $   a  /  # $ # m e # B  e
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: Output -> File generation
Command line option
: /LIST and /DEBUG
Related directives
: n/a
6



y@This policy specifies whether or not diagnostics files should beCproduced. This has exactly the same effect as the /DEBUG qualifiero!has in command line versions.

T

The files created are:-

 RJ

This file gives the best explanation of how the conversion proceeded.

 n
n/ h(

Generate external contents file

/A,  o B   v <  RW  y $  n y  - T s $   s #   <
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: Output -> Contents list
Command line option
: n/a
Related directives
: n/a
6



/>Specifies whether any generated contents list should be placedDin a separate file, as opposed to at the top of the output file.

D

This option is not always possible, specifically when an existingCcontents list is being used, or when the source is being split intoi2many files. In such cases it will be ignored.



See also :-
RExternal contents list filename


e# W

Heading key phrases

/a, J  n   . &  [  > $  - E  *  e $   B # o  p
Possible values
: Comma-separated list of key words and phrases in quotes
Default value
: ""
Policy scope
: Dynamic analysis policy
Policy file section
: Headings
Menu location
: Analysis -> Headings
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

F

If specified, then any line that begins with one of the key phrases"will be regarded as a heading.

N

Each phrase is treated as a different level of heading than the one before,Ii.e. the first phrase is level 1, the second is level 2 etc. For examplee the value

s

Part, Chapter, Section

_M

would treat lines beginning with the words "Part", "Chapter" and "Section">Oas level 1,2, and 3 headings (although in HTML <H1> markup probably won'ta be used).

J

The key phrases are case-sensitive in order to reduce the likelihood ofLfalse matches with lines that just happen to have these phrases at the startFof the line. If false matches occur, edit the source text so that the9offending word is no longer at the start of the line.

a


HTML Script file

P/e,  G _    r l   iW A  R $   i e  A >  $   e . # R  < 
Possible values
: Local
file containing JavaScript fragment you want embedding
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: Added
HTML
Menu location
: Output -> Title, description etc.
Command line option
: n/a

Related directives
: n/a

6



>EIdentifies the name of a text include file to be transcribed into thenF<HEAD> ... </HEAD> portion of the generated HTML page.

H

This allows you to place JavaScript in your pages (though you'll be a-little limited as to what it can act on).

uD

You could also use this to embed a style sheet in the header.




HTML footer file

/r,  ? B M    y   EW b B  $   T s  A " D $     # s   o
Possible values
: Local
file containing HTML code to be used as footer
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: Added
HTML
Menu location
: Output -> Title, description etc.
Command line option
: n/a

Related directives
: n/a

6



eJIdentifies the name of a text include file to be transcribed into the HTMLWfile at the bottom of the <BODY> ... </BODY> portion of each generated HTMLuOpage. Because this file is just copied into the HTML, the file should normallyA.include HTML tags, rather than plain text.

C

This can be used to add "return to home page" links, and contactaEaddresses to your HTML pages. Again, this helps to give a consistentnG"look and feel" when breaking your document up into a number of smalleryHTML files.



See also :-
4HTML header file


# 

HTML fragments file

/ , B  T    p  dW  m $  p F  A   $   ! # u®  u
Possible values
: Local file containing HTML fragment definitions
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Added HTML -> Advanced Options
Command line option
: n/a
Related directives
: "DEFINE_HTML_FRAGMENT" and "RESET_HTML_FRAGMENT"
6(

New in version 4

M

Identifies the name of a text file which defines HTML "fragments" that maysIbe used in the HTML generation. These fragments can be used to customizeFHelements such as horizontal rules and page navigation features generatedNby the software. The definitions must be written as HTML inside pre-processor styled HTML fragment blocks.

V

See the Tag manual section on Using HTML fragments%and the pre-processor commands :-
sP"DEFINE_HTML_FRAGMENT"
N"RESET_HTML_FRAGMENT"




HTML header file

L/v,  ? T s   _ u /  >W t T  $   T T  A   $   i  # e  m t
Possible values
: Local
file containing HTML code to be used as header
Default value
: ""

Policy scope
: Fixed output policy

Policy file section
: Added
HTML
Menu location
: Output -> Title, description etc.
Command line option
: n/a

Related directives
: n/a

6



uAIdentifies the name of a text include file to be transcribed intowMthe HTML file at the top of the <BODY> ... </BODY> portion of therEgenerated HTML page. Because this file is just copied into the HTML,uGthe file should normally include HTML tags, rather than plain text.

>H

This can be used to add standard headers, logos, contact addresses toDyour HTML pages, and is especially useful to give a consistent "lookAand feel" when breaking your document up into a number of smaller2HTML files.

.

See also :-
4HTML footer file


- &

Hanging paragraph position(s)

/<, T C t s    i  Y n d $  h l  *  p $    #   x
Possible values
: A space-separated increasing series of tab positions,
R+ starting at 0 (e.g. "0 4 8")
Default value
: 0
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> Analysis
Command line option
: n/a
Related directives
: n/a
6



QThese values indicate the offsets at which definition paragraphs are expected

e
 c

Headings Colour

/o, P  T   _ h  : Dynamic output policy

 $   "  % o > $    # o  
Possible values
: HTML colours
Default value
: ""
Policy scope
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



TQIndicates what colour to use for all the headings marked up in <Hn> markup.d"Not all browsers support this.

K

In HTML 4.0 this is better handled via CSS, rather than placing explicitF"colour markup on each heading.


. '

Header frame background colour

/_, P  <      W E _ $     :  T $   i #   i
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

P

The program allows you to independently set the background and colour of eachMframe in a FRAMESET. The default behaviour is that each frame will match thec8colours set for the main document using the policies

;

Background Colour
H, Text Colour

>I

You can override this behaviour using the frame colouring policies

+
U

Header frame background colour
TF Header frame text colour
R Contents frame background colourJ Contents frame text colour
R Footer frame background colour
F Footer frame text colour


D" 

Header Frame depth

u//, 4  T    e  NW  d $  r u  &  f $    # >  >
Possible values
: Size in pixels or as a percentage
Default value
: 100
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

L

If a header frame is generated, this specifies its depth. The default isO100 pixels. To specify a percentage, add the % sign on the end, e.g. "20%"

o

See also :-
<Contents Frame width
8Footer Frame depth


( !

Header frame text colour

R/l, P  f   t /  lW < f $  I   :  o $   / # o  .
Possible values
: HTML Colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames -> Frame colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

f

See discussion in Header frame background colour.


) r"

Highlight Definition Text

/R,  R >   u #  BY D R $   B  % <  $    #   >
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



sHSpecifies whether or not the definition term of each definition detectedW(the part marked up in <DT> ... </DT>) should be placed in bold for greater, emphasis.

u
+ i$

HTML version to be targeted

/E, h   E  *    W  o $ "  i  :   $   i # n  
Possible values
: "HTML 3.2",
!" "HTML 4.0 Transitional",
"HTML 4.0 Strict"
Default value
: "HTML 4.0 Transitional"
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



K

Depending on the version of HTML selected, different features may or mayeGnot be supported. For example the implementation of fonts inside tableslIcannot simultaneously support version 3 and 4 browsers in all flavours ofaLHTML. Also the use of certain entities (like the Euro symbol) is disallowed in earlier versions of HTML.

@

The generation of "HTML 4.0 Strict" is not yet supported.


% s

Hyperlinks on numbers

/t,      M c  /W E = $   c  - e u $   T # p  "
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: n/a
Related directives
: n/a
6



oLWhenever a file has numbered sections, and a contents list is being created,Othis indicates whether the hyperlink taking you to the section should be placed;;on the number or the section title in the contents list

>B

The default is to place the hyperlink on the section title.


+ /$

Ignore multiple blank lines

/i,  i    g   iY c  $   f  % u r $   < # i  d
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



"KSpecifies whether or not multiple blank lines ("white space") in the sourceDfile should be ignored.

_I

Normally HTML ignores white space, but if this policy is disabled then/Padditional blank lines will be marked up as <BR>. That means that a largeJgap in the source file will translate to a large gap in the HTML file.

E

If you wish to eliminate white space from your output, switch this |off. You should also review the Use <P> markup for paragraphs policy


3 B,

Ignore table header during analysis

/<,  Y &   i   u[ e o $  h i  0  l $   > # <] B E
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Analysis -> Table Analysis
Command line option
: n/a
Related directives
: "TABLE_IGNORE_HEADER"
6



aKIndicates that when analysing a table to determine the column positions theTJtable header should be ignored. Some tables have complex headers that canNaffect the analysis when looking for column boundaries. By setting this valueGthe first few lines are ignored during the analysis (if the header sizee6if set, then this is the number of lines ignored).

I

This policy can be toggled for individual tables via the pre-processor&Mcommand TABLE_IGNORE_HEADER placed between BEGIN_TABLE ... END_TABLE commandsR&placed before and after the table.


+ T$

Include document section(s)

/ , 8    2  "  MW e e $  e   .  E $   : # tE l m
Possible values
: Space-separated list of SECTION names
Default value
: "" (which is the same as "ALL")
Policy scope
: Fixed output policy
Policy file section
: Preprocessor
Menu location
: Analysis -> Preprocessor
Command line option
: n/a
Related directives
: "SECTION"
6



LThe program allows pre-processor commands to divide a document into sectionsIusing the SECTION command. (This is quite separate from the detection ofl-section headings in the source document).

>L

The point of the SECTION command is to mark up parts of the document thatHmay optionally be included or omitted from the conversion, e.g. to allowCthe same source document to generate different output for differentlaudiences.

H

This policy tells the programs which section types are to be includedIin the conversion. The name(s) supplied should match that in the SECTION>)directive(s), and should be one-word.

M

A value of "all" indicates that all section types should be converted.

oJ

The value may be a space-separated list of section names. Each section@name must be a single word (underscores are allowed though).

=

For more details, read the main program documentation.

>
, %

Indent headings in Directory

P/t,  T     y  eW r e $   d  .  e $   ) # H  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



OIIf a contents list is being generated, then this Specifies whether or notiAthe contents list should be shown at multiple indent levels, with)3sub-sections indented relative to sections etc.

RK

If disabled, all the contents hyperlinks will be at the same indentation3level, one level in from any file titles shown.

"
" 

Indent position(s)

l/ , G <     R  Y s i $  r   *   $   > # "  R
Possible values
: A series of increasing integer values, starting at 0
Default value
: 0
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> Analysis
Command line option
: n/a
Related directives
: n/a
6F

These are the positions of the major indent levels in the document.DThis should be a list of ascending space-separated numbers, with "0""usually being the first value.

N

Text in the source file will be output at a level of indentation calculatedIby comparing the source line's left margin with the values set here. The [TAB Size may form part of this calculation if tabs are present.

N

For example a line with 6 spaces at the start will be placed as follows

/a,    P  8  d  C  A  &  D
"0"
- left margin
"0 4 8"
- one level of indent (>4 but 6<)
"0 2 4 6"
- three levels of indent (>2, >4 and >=6)
"0 8"
- left margin (<8)
6
23

In practice a little rounding up is allowed.

RI

The program will attempt to calculate the correct indentation pattern,Mand will reject consecutive positions, e.g. "0 1 2" wouldn't be accepted.

#R

Note, a value of "0" by itself will suppress all indentation in the output.


 /

Input directory

/;, B  >    a  T[ e a $   n    w $ 9 b _ # =  >
Possible values
: Local input directory (don't normally use this)
Default value
: ""
Policy scope
: Dynamic analysis policy
Policy file section
: n/a
Menu location
: Main screen
Command line option
: the first argument of the command line
Related directives
: n/a
6



pIIn principle this policy allows the source directory to be specified. In"Jpractice the source directory is usually implied from the source file.

J

In the Windows version the input directory can be explicitly set on themain screen.

N

It is nor recommended that you include this policy line in any policy filesyou create.

>
+ f$

Input file has page markers

/o,  t y   E =  : Fixed analysis policy
l
R $  /   0  T $    # T  
Possible values
: Yes/No
Default value
: No
Policy scope
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



/JSpecifies that the input file has page markers. Such pages are assumed tobe form feeds <FF>.

o

Together with the Page marker size (in lines) policy, you can get Jthe program to ignore the next few lines after a page marker. This can beOused to remove lines at the top of each page from the source document as viewedeby the program.

i;

This removal, however is far from perfect given that

o
 l
F

It is hoped to improve these algorithms after V4.0 is released.


* #

Input file has change bars

/A,   R   e o  eY  < $   T  0  e $   e # n  d
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



tOIndicates that the input file contains change bars. Change bars indicate thoseeJlines which have had text changed since the last version. THis is usually@indicated by a vertical bar '|' in the left or right border.

N

Where such characters are detected, they will be removed (as they will makeHno sense in HTML) and the "changed" text will be highlighted in red.

L

The program may auto-detect the presence of change bars, but if this getsIconfused (e.g. by quote characters in email, or .signature files) you may>%need to set this policy manually.

T
2 +

Input file contains DOS characters

R/s,  > R   t t  .Y _ o $  c c  0  T $   i #   
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



TNIndicates that the input file contains DOS characters, especially line-drawingJcharacters. When set, the program will convert these characters into lineFcharacters (i.e. "=", '-', '|' or '+') that may then be interpreted asparts of table or diagrams.


7 0

Input file contains Japanese characters

/e,  u B    s  iY . P $   p  0  o $    # i  e
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

Q

Indicates that the input file contains Japanese, Chinese or Korean characters.TOThe program is designed to convert and understand ASCII characters. As such itT)is best suited to European languages.

K

If this policy is set, the program will avoid certain types of characterItransformations, and will adjust - where possible - its analysis to allowt3for the presence of 2-byte oriental characters.

=F

Please note, AscToHTM's understanding of Japanese text structure isEvirtually non-existent, we don't really advocate the program's use in- this way.

i
+ o$

Input file is double spaced

//,  P h   n ,  tY n P $   N  0  y $    # T  
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



NIndicates that, as seen by the program, the input file is double spaced. That#is, every second line is blank.

c

This can be the case if


eN

The conversion will look quite different if every second line is thought toObe blank. If you set this policy, every second blank line will be ignored.

lL

Eventually it is hoped to make detection of such files automatically, but*currently (V4.0) this is not the case.


1 *

Input file contains MIME encoding

/a,  o a   ; k  >Y y  $  C L  0   $   T # p  "
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



oNIndicates that the input file contains some MIME encoding. This will commonlyFbe the case in text saved or copied from mail messages. Mime encodingIwill appear as "=" characters protecting special characters, and breaking>Olong lines into shorter lines less likely to be rejected by mail protocols.

.=

The presence of Mime encoding should be auto-detected.

/
- E&

Input file contains PCL codes

/l,   i      dY o  $  d B  0  e $   m # E  N
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

K

Indicates that the input file contains PCL printer codes. When set, the Mprogram will make whatever sensible use it can of these codes, otherwise they will be removed.

L

Please note that the PCL printer codes offer a rich command language thatMmay be used to drive graphical printers. As such the emulation possibilities ]in a text converter are limited, and it is quite likely that files that make>heavy use of such codes will fail dramatically to convert.


 

Keep it simple

/<,  r o   s E  [  o $  o  e   l $   e # >  -
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Main screen, or
t, Analysis -> File Structure
Command line option
: /SIMPLE
Related directives
: n/a
6



tSThis tells the program to suppress much of its advanced searches for structure.

nM

This should be used when converting short documents that don't really have Jnumbered sections, bullets, tables etc but which might look to the programGas though they do (e.g. because they contain addresses, lists or tables!of consecutive numbers)

LL

A simple conversion will preserve much of your line structure and convert3URLS to hyperlinks, but it won't add much else.

G

This option is equivalent to adding /SIMPLE to the command line.


' A

Language (for proofing)

/e,     ,  <  W  o $   i  ,  t $   < # r  t
Possible values
: Text string
Default value
: "English (United States)"
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> RTF Settings
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

M

For conversions to RTF only, this specifies the document's language. ThisR0is relevant for spell checking and the like.


( '

Largest allowed <Hn> tag

B/R, - F y    <  W T R $   >  % R > $   t # n  n
Possible values
: 1 (largest) - 5 (smallest)
Default value
: 2
Policy scope
: Fixed output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



xrTogether with Smallest allowed <Hn> tag these policies allow you toXcontrol the heading sizes <Hn> used to mark up any headings that are detected.

V

By default <H2> is used for main level headings, with each subsequent headingHlevel being one size smaller, down to <H3> (normal text size).

K

The software will ignore these values if out of range, or if the largestTMvalue represents a smaller heading (larger Hn) that the "smallest" value.

8
# t

Left margin (in cm)

/h,  t     > r l  PW  n 0 $   n   6  l $    s # i   
Possible values
: Text
string
Default value
: (see
below)
Policy scope
: Fixed output policy

Policy file section
: RTF

Menu location
: Output -> RTF Settings
Command line option
: n/a

Related directives
: n/a

6.

Only applies to RTF generation

L

For conversions to RTF only, this specifies size of margin at the left ofCthe page. If omitted the Word default of 3.17 cm will be used.


. '

Lines to ignore at end of file

R/o, "  T    d  W s e $ "  i  :  c $   a # a  d
Possible values
: Number or lines
Default value
: 0
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

O

Specifies how many lines should be ignored at the end of the input file.

TH

Use this if you are converting files from a source that adds a footer@to each file that you don't want included in the conversion.



See also :-
TLines to ignore at start of file


0 )

Lines to ignore at start of file

T/R, "  !      mW t F $ "  r  :   $   o # P  L
Possible values
: Number or lines
Default value
: 0
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

O

Specifies how many lines should be ignored at the top of the input file.

nK

Use this if you are converting files from a source that adds a header to<=each file that you don't want included in the conversion.

h

See also :-
PLines to ignore at end of file


$ 

Link Dictionary file

-/ , D  >   # .  Y / T $ "  R  / > > $   e # -  h
Possible values
: Local file containing Link Dictionary definitions
Default value
: ""
Policy scope
: Dynamic output policy
Policy file section
: Link Dictionary
Menu location
: Output -> Link Dictionary
Command line option
: n/a
Related directives
: n/a
6/

reserved for future use

a
0 )

Look for MAIL and USENET headers

W/o,  m e    t  l[ s r $  y   2  R $   < # >  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



>MSpecifies that the program should attempt to detect, (and re-format) any MAILsLor USENET headers. These will be present if the file you are converting

 >
AK

Where such headers are detected, the Author, Subject and Date are lookedJfor. If these are detected, the header is replaced by a Heading with this/information formatted in a standard manner.

rQ

Where this occurs the new heading becomes available for any contents list thatnis generated.




Look for bullets

n/a,  = >      [ p u $  T T < - < / $   / # /  /
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
< or
% Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



NLSpecifies that the program should look for, and format, bullets and numbered lists.

N

Disable this only if the program is wrongly formatting as bullets and listsMthings that are not. In such cases you could also consider reformatting yourhIsource file so that the "bullet" text no longer appears at the start of af line.

a
! s

Look for diagrams

/ ,  p u    A  >[ N T $     2  t $   / # y  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

J

Specifies whether or not regions of preformatted text that are detected/should be considered as candidate diagrams.

iA

If you find the program is wrongly treating tables as diagramsethen disable this policy.

B

See also :-
DAttempt TABLE generation
:Expect code samples
HLook for preformatted text


* #

Look for horizontal rulers

f/i,  i f    y  l[  i $  > H  2  B $    #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



AKSpecifies that the program should look for, and format, horizontal lines asyOseparators. Such lines will be marked up as Rules, rather than as the original/character sequence.



See also :-
<Minimum ruler length


+ $

Look for hanging paragraphs

//,   i    n  s[  s $  P e  2  < $   L # =  >
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



aLSpecifies whether or not the program should look for, and attempt to format,hanging paragraphs.


$ 

Look for indentation

D/R,  l r    T  [ o  $  P s  2   $   o # m  o
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



vK

The program can detect the character positions used for different levels!Kof indentation, and then use tags to implement this in the output. If this Jgoes wrong, then text will be wrongly indented and (because of the taggingMinvolved) unwanted vertical white space will often appear wherever the changeDEin indent occurs. This can be especially true for the first lines of=Nparagraphs (see new paragraph offset).

M

If you have such problems, disable this policy and the whole document willbe left justified.


* #

Look for preformatted text

g/T,       E  t[ u d $  ,   2  s $    # e  n
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



mMSpecifies whether or not regions of preformatted text should be searched for.>/If found, the program may attempt to detect

y

uL

If it decides the region is one of these, then special formatting will be applied.

M

If you find the program is wrongly treating text as formatted (this can beoPchecked by looking for comments in the HTML code), then disable this policy.



See also :-
DAttempt TABLE generation
:Expect code samples
6Look for diagrams


$ 

Look for quoted text

A/c,  m g    A  [  R $  > >  2  < $   p # u  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



LSpecifies whether or not the program should attempt to detect "quoted" text.QQuoted text will be placed in <EM> markup to emphasise the quoted text.

/L

Quoted text is commonly found in email and USENET posts. If you find theGprogram wrongly placing text in italics, try disabling this policy.

B
$ 

Look for short lines

l/o,  g d    i  t[ T e $  B M  2  u $   b #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



BOSpecifies whether or not the program should look for "short lines". By defaultlNthe line structure of the source is not preserved, rather the program attemptsNto preserve the paragraph structure. This results in a document that responds'better to changes in browser width.

TI

However, the program recognises that lines that are short are probablyiKintentionally so, and so it attempt to detect such lines and add a break on>4the end so that the line structure is preserved.



See also :-
6Short line length


$ 

Look for white space

>/,  t c    /  /[ A  $  > T  2  e $    # T  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



LSpecifies whether or not the program should look for white space, especially/when trying to detect paragraph boundaries.

/M

You should usually leave this enabled, unless you want to explicitly place<;tags in the source text to markup paragraph boundaries.

t
 

Make Directory

/t,      - H  >W l  $   t  .   $ ,  < # B  c
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: /INDEX=[<filename>]
Related directives
: n/a
6



KSpecifies whether or not you want a Directory page built. A Directory page/Gwill contain hyperlinks to all files and sections within files that areyconverted at the same time.

N

This normally only makes sense if you're using wildcard file specifications&to convert multiple files at once.

V

This policy is equivalent to adding /INDEX=<filename> on the command line


1 /*

Maximum level to show in contents

/e,   n    i  AW d A $   s  - T R $    # >  e
Possible values
: 0,1,2...
Default value
: 0 (= "all")
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: n/a
Related directives
: n/a
6



fLSpecifies the number of levels of headings to show in any generated contentsGlists. A value of "1" would only show chapter headings, a value of "2"/0would also show the major sections etc, etc.


" 

Min HTML file size

e/, &  _      uW <  $ "  <  / u # $   > # s  
Possible values
: Any number of lines
Default value
: -1 (none)
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



GThis policy is only relevant when splitting the document into multiple,TFsmaller output files (see split level).

L

When a large source file is being split into many output HTML files, thisFpolicy specifies a minimum output HTML size in lines (although this isonly approximate).

D

This can be useful for documents that have chapters where all the?content is in the sub-sections. In such documents you'd end up Awith a virtually empty chapter heading file if this policy is not used.

F


Min chapter size

C/ , &  n    m  n[  m $  A   0  a $   o # l  a
Possible values
: Any number of lines
Default value
: 8
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



KThis specifies the minimum chapter size expected in the source document (incInumbers of lines). This is used by the program during analysis to ignore>Aany apparent Chapter headings that appear too close together.

>M

In this way the program attempt to distinguish between 2 chapter headings,e#and 2 items on a numbered list.


' o

Minimise HTML file size

/s,  a b    i  tW l i $ "  -  / > > $    # y  E
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



RNThis indicates that the created HTML file should be made as small as possible,"e.g. to reduce download times.

E

By default AscToHTM attempts to layout the created HTML code in antEeasy-to-read manner. This was done so that the created HTML would be+easier to manually edit after creation.

BM

To make the code easier to read, the program inserts white space to indenteFthe code to match the output indentation levels. It also outputs each$cell of a TABLE on its own line.

@

All this white space adds up, particularly the indentation ofBlargely-empty cells in TABLES. If you select this option, all the$extra white space is eliminated.

L

Depending on the file contents, this can make the file 5-20% smaller (and8hence faster to download), at a cost of readability.

T

Of course, this benefit is only really worth it when converting larger files.


/ r(

Minimum TABLE column separation

/ , H      l  m[  R $  t T  0  o $   s # m s k
Possible values
: Min. number of space characters between columns 1,2,3
Default value
: 1
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Analysis -> Table Analysis
Command line option
: n/a
Related directives
: "TABLE_MIN_COLUMN_SEPARATION"
6



sCSpecifies the minimum number of spaces that may be interpreted as aS column separator in a table.

H

The default value is 1, but in small tables this can lead to too manyM"columns" being detected. If you experience this problem try increasing thisyvalue to 2 or higher.

-
S
Note,
if the value becomes too large, you may experience the opposite @ problem, i.e. too few columns being detected.


, +

Minimum automatic <PRE> size

./s, '  n    n  R[ R L $  h  3  N $   t # BQ  /
Possible values
: Any number of lines.
Default value
: 1
Policy scope
: Dynamic analysis policy
Policy file section
: Pre-formatted
Menu location
: Analysis -> Preformatted text
Command line option
: n/a
Related directives
: "BEGIN/END_PRE"
6



T
BSpecifies the minimum number of consecutive lines that must appear_pre-formatted before they can be placed in their own <PRE> ... </PRE> sections.

TD

Pre-formatted text, once detected is analysed to see if it is


O
Note:
Only values in the range 1-20 are likely to have an effect.u; Values above 20 are likely to simply disable this featurep6 entirely. This limitation is due to the size of the$ readahead buffer the program uses.


See also :-
DAttempt TABLE generation


$ 

Minimum ruler length

/e, .  e    a  >[ l f $  p e A +  B $   T # >  _
Possible values
: Number of characters > 0
Default value
: 4
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
L or
. Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
6



>NSpecifies the minimum length of any line to be considered as a horizontal ruleywhen the program is looking for such lines (see Look for horizontal rulers)

nL

Lines in the source text that consist only of "rule-like" characters, andKwhich exceed this minimum length will be marked up as Rules, rather than aso$the original character sequence.



See also :-
<Minimum ruler length


 

Mirror Margins

</,      , c  W  g $     ,  c $    # u  o
Possible values
: yes/no
Default value
: no
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> RTF Settings
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

.

Only applies to RTF generation

F

For conversions to RTF only, this specifies that the left and right@margin sizes should be swapped on odd and even page numbers.


& 

Monitor tag generation

/i,   -    t  W / ! $   h  :  r $   m # a  ,
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Tagging
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



>OA diagnostic policy that specifies that HTML tag generation should be monitoredTMfor correctness. This will check that each tag has a matching end tag (where<8required), and that tags are not incorrectly nested.

K

This shouldn't normally be necessary, but can sometimes help locate HTMLiCerrors when extra HTML is embedded in the source file and interacts.9unfavourably with the HTML generated by the software.

>
$ 

New Paragraph Offset

M/ , )        E[  B $  r e  0  n $   t # n  n
Possible values
: A number of characters
Default value
: -1 (none)
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



SHThis specifies the size of any hanging indent expected on the first lineIof each paragraph. It is quite common, e.g. when saving Word for WindowsHfiles, to find the first line of each paragraph indented relative to the>rest of the text. This specifies the size of that indent.

N

Although this is normally detected automatically, in smaller documents thisLcan sometimes fail, with the result that the first line may be indented withMrespect to the rest of the paragraph. Unfortunately, this can also introduce>La blank line between the first and subsequent lines. If this happens eitherDchange this value, or cancel all indentation by setting the value of8Indent position(s)



See also :-
Npreserve new paragraph offset


'

New browser window name

/<,   P      uY 3 - $  E =  *   $   > # l  F
Possible values
: Text string
Default value
: "other"
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



sm

See the discussion in Open links in new browser window


* #

New frame link window name

/s, G i s   o   cW i = $  t _  &  e $    # ,  
Possible values
: Name of browser window to open clicked hyperlinks in
Default value
: _top
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

N

When an "external" hyperlink is clicked on from inside a generated FRAMESEToand the policy Open frame links in new window is enabled, this isTIthe name of the browser window to be used as the target for the link.

<M

You can specify any name you like, but the default is the reserved browserTJwindow name "_top" which will cause the current window to be used, therebyKreplacing all the FRAMESET currently on display (this will re-appear if younpress the BACK button)



See also :-
POpen frame links in new window


! e

NOFRAMES link URL

/ , (  T  :  >  EW > > $  <   &  # $   > # s  
Possible values
: URL of NOFRAMES links
Default value
: Defaults to URL of first page generated
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

k

When the Add NOFRAMES links policy is enabled, this is the URL that islGused in the visible NOFRAMES hyperlink added to the contents frame.

tO

If left blank (the default) this link will point to the first HTML page thatp2would normally be displayed in the main frame.

M

You should only really need to use this if you have created an independentt?set on non-FRAMES pages that you'd like to link to instead.

"

See also :-
8Add NOFRAMES links


2 +

Number of levels in contents frame

/ ,  l l      W l ; $  R   &  / $   u # m  h
Possible values
: 0,1,2,3 or 4
Default value
: 0 (= "all")
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

L

When a generated contents list is placed in a contents frame, this policy>specifies how many levels of heading you want shown there.

N

In large, complex documents there can be up to 4 levels of heading. WhilstOin a normal contents list you'd want to see most of these, in a FRAMES documentlKspace (width) is tight and you don't really want to have to scroll the leftaPframe. In such cases you may want to limit the amount of detail in the contents frame.

P

The default value "0" is interpreted as "all", i.e. a full contents list willbe generated.


6 /

Number of words to include in filename

R//,  e v    u  >W p  $  y r  :  u $   a #   l
Possible values
: 1,2,3...
Default value
: 4
Policy scope
: Fixed output policy
Policy file section
: Headings
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

H

When splitting a large document into files a new file will be createdIeach time a suitable heading is reached. If the heading is underlined or Hcapitalised (as opposed to numbered), the first few words of the heading%will be included in the filename.

>K

This policy determines how many words from the title should be used.

i
2 7

Omit <HEAD> and <BODY> from output

A/B,  a w   a T  TW " a $ "  T  :  i $   / #   <
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

F

The policy specifies that the HTML generated should not contain anyV<BODY> and <HTML> tags, nor should it contain a <HEAD> section. TheIresulting file won't be a proper HTML file, but it can be copied directlys8into and existing HTML file without further editing.

J

This policy is set automatically in the Windows version of the softwareGwhenever the clipboard is used as the output destination. That way thea<generated HTML can be directly pasted wherever you want.


- /&

Only allow explicit FTP links

/i,   o    n  >Y = a $     *  > $    # R  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



aHIndicates whether or not only ftp links with an explicit "ftp://" should%be converted into FTP hyperlinks.

EM

The program can detect web addresses that don't begin with http:// or www.vCSuch addresses are often - but not always - FTP sites. This policytEdetermines whether or not such addresses should be taken as FTP sitest or now.

B

If enabled then "penguin.mit.edu" would become an FTP link.


% 

Only use known groups

/,  f     T  eY p e $  n >  *  B $    # >  l
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



/?Indicates whether or not only newsgroups from known hierarchiesm.should be converted into news: hyperlinks.

G

The program can detect possible newsgroups by looking for words like/a"something.like.this" and "news.answers". However assuming these<)are newsgroups often leads to errors.

aC

Consequently if this policy is enabled then candidate newsgroupsRChave to belong to either a standard USENET hierarchy such as "alt",e:"comp", "sci" etc, or to a user-specified USENET hierarchyK(see Recognised USENET groups).

pT

If disabled then "something.like.this" will be turned into a news: hyperlink.

f

This policy only takes effect if Create NEWS links is enabled.


. '

Open frame links in new window

e/r,   g    3  W l T $  R   &  = $   g # >  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

Q

This specifies that whenever the user clicks on an "External" hyperlink insidedEa set of generated FRAMES, a new window should be opened, rather thano=displaying the selected page inside the current FRAMESET.

/M

Note, the program distinguishes between "internal" links to other parts ofgJthe same converted document (be they in a different HTML page or whatever)Mand "external" links to URLs nothing to do with the current conversion. Thusm¢a link to www.jafsoft.com will create a new window, but a link to section 3.2 will not.

T

See also :-
HNew frame link window name


0 )

Open links in new browser window

!/ ,  c R      >Y a e $  i T  *   $   / # ,  M
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



bLSpecifies that where hyperlinks are added to the HTML, the target window forLthese links should be a new window. This means that when you click on theseNlinks a new window is opened, and the original window continues to display theNoriginal document. If you don't select this policy, the new document replaces3the old document in the current browser window.

>

See also :-
BNew browser window name




Output directory

//<, C  o      TW -  $        $ (   # A  
Possible values
: Local output directory (don't normally set this)
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: Main Screen
Command line option
: /OUT=<filespec>
Related directives
: n/a
6



tIIn principle this policy allows the output directory to be specified. InUIpractice the output directory usually defaults to the input directory, orsBis set by the user via the user interface or the command line.

K

In the Windows version the output directory can be explicitly set on thetmain screen.

N

It is nor recommended that you include this policy line in any policy filesyou create.

>
% >

Output file extension

/t, @    $  /  2W y t $ "  T  / t T $   D # >  t
Possible values
: File extension to be used for generated files
Default value
: ".html" or ".rtf"
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



IThis policy specifies an alternative extension to be used for the createdPJfiles. For example you may want the program to create ".shtml" files.

i

If present, this policy overrides that set in the Use .HTM extensioni policy.

e
! 

Output frame name

/o, 1 R   = u #  BW D R $  <   &   $    # T  w
Possible values
: name of main FRAMESET document
Default value
: Input filename with "_frame.html" appended
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

K

This specifies the name of the HTML file which will contain the FRAMESETnGtags that define the layout and contents of the FRAMES. If omitted theuEdefault behaviour is to append "_frame" to the filename. For example myfile.txt would generate

s
/ , "  K / + i,   ) M*   ) A* 
myfile_frame.html
! FRAMESET
myfile_contents_frame.html
! (optional) contents frame
myfile_header_frame.html
! (optional) header frame
myfile_footer_frame.html
! (optional) footer frame
6
<

and then

e
/>,  (    4  l  3 i <
myfile.html
! first main frame page
myfile_1.html
! (optional) second main frame page
myfile_2.html
! (optional) third main frame page
6
/

# 

Output log filename

/ , = M /  ! S k  PW m i $     :  a $ (  l #   
Possible values
: Local file to contain log of conversion(s)
Default value
: "AscToHTM.log"
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: (only available by editing policy file)
Command line option
: /LOG=<filespec>
Related directives
: n/a
6



L5Specifies the name of any log file to be created.



See also :-
6Create a log file


" 

Output policy file

e/#,   >   T t  >W > i $   o  =   $ ' s n #   h
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: Output -> File Generation -> General
Command line option
: /POLICY=<file>
Related directives
: n/a
6



dIThis policy allows you to specify that you want the program to output the Bfile policy that is being used. This will be a combination of theBpolicy calculated by the program during the analysis pass, and anyuser-supplied policy lines.

Q

The output policy file will have a .pol extension in the output directory.

M

This policy has the same effect as the command line qualifier /POLICY.

d
( & 

Output policy filename

/>, P  >   F u  >W  u $     = T  $   u # <  /
Possible values
: Local file to be generated with calculate policies documented
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: Output -> File generation -> General
Command line option
: n/a
Related directives
: n/a
6
"

reserved

.

NOT YET IMPLEMENTED?



i 

Page Width

/ , :  t   B =  [ l R $  /   0  T $    # >  i
Possible values
: Number of characters. Typically 65-100
Default value
: 80
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6F

Used to set the nominal page width of the input text. This doesn'tEaffect the output directly, but the page width is used in a number of![calculation used to determine other effects which do affect the rendering.>These include

p=+ $

Page marker size (in lines)

/e, 1 / D    y  Y  o $  T   0  d $    # d  T
Possible values
: Number of Lines in page header
Default value
: 0
Policy scope
: Fixed analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6



dOSpecifies the size of any "headers" that occur after new page characters in theoJsource text. These headers can be ignored for the purposes of conversion,7although the process is currently far from perfect.

>c

See the discussion in Input file has page markers

d
( !

Place document in FRAMES

/>,  s /   n u  >W  e $  B   &  e $    # B  
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: /FRAMES
Related directives
: n/a
6(

New in version 4

J

This policy allows you to specify that you want your document output inDHTML frames. The program will create a HTML page with the necessary<FRAMESET> tags.

J

Once selected, a large number of supporting policies offer control overEthe FRAMES-generation process. In addition you can use the program'scSHTML fragments feature to control what gets placed<in each frame.

+

FRAMES policies available include :-

p
 E
l?

FRAMES production is only applicable to HTML generation.


3 a2

Preserve file structure using <PRE>

/d,   o      oY u # $ "  e  / R  $   e # /  e
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed analysis policy
Policy file section
: File Generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



aJIndicates that the whole file structure should be preserved by placing theTfile inside <PRE>...</PRE> markup. This will result in very little fileconversion occurring.

oI

You should only want to use this if the file has lots of pre-formattednHtext which the program is interpreting wrongly. Examples might be emailJdigests of RFC's, although in both cases good results can be achieved witha little work.


' s

Preserve line structure

/y,   s   o t  [ >  $ "  /  / T T $    # O  /
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: File Generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



HIndicates that the line structure of the file should be preserved. ThisJwill be done by adding a <BR> to each line from the source file.

J

Use this if you want the output program to have the same line structureKas the original, instead of allowing paragraphs of text to wrap. You mightNwant to do this if you want to preserve an "A4" look and feel to the page.


- n&

Preserve new paragraph offset

/e,  = C      Y f > $  c 2  0  o $   l #   
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

E

This specifies that if a hanging indent is found on the first lineu;of each paragraph it should be preserved in the output.

h

See also :-
<new paragraph offset


0 )

Preserve underlining of headings

d/e,  A l    N  RY l R $  / T  ,  d $   < #   T
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Headings
Menu location
: Output -> HTML styling
Command line option
: n/a
Related directives
: n/a
6



oOSpecifies that those headings that are underlined should keep their underliningvJin the output. Sometimes you want the underlining to signify the previousLline is a heading, but don't necessarily want that heading underlined in the output.

l
) e"

Recognise '-' as a bullet

/F,  " o    >  u[ R  $   >  ) i _ $   T # A  m
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



eKSpecifies that the hyphen character by itself at the start of a line shouldc,be treated as signifying a bullet point.


) m"

Recognise 'o' as a bullet

/1,  T T    -  r[ f H $   =  )  o $    #   /
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Bullets
Menu location
: Analysis -> Bullets
Command line option
: n/a
Related directives
: n/a
6



>ESpecifies that the letter 'o' by itself at the start of a line should Kbe treated as signifying a bullet point. This is a fairly common practise,>Gespecially in text documents exported from other software packages.


( !

Recognised USENET groups

/T, A e    o >  lW # B $  > >  *   $   u # /  
Possible values
: Space separated list or USENET hierarchy roots
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Hyperlinks
Menu location
: Output -> Hyperlinks
Command line option
: n/a
Related directives
: n/a
6



TEThis policy allows you to specify USENET hierarchies that you wish toGGrecognise in addition to the standard hierarchies. The value is a spaceEseparated list of the top level hierarchy names. So, for example, toa[ensure that uk.telecom and demon.ip.support are recognised aslAvalid newsgroup hyperlinks, set the policy value as follows:-

s
,

Recognised USENET groups : uk demon

ef

This policy only takes effect if Create NEWS links is enabled.


$ 

Right margin (in cm)

v/,  l o i   m t -  AW w i n $      6   $   / > # <  n n
Possible values
: Text
string
Default value
: (see
below)
Policy scope
: Fixed output policy

Policy file section
: RTF

Menu location
: Output -> RTF Settings
Command line option
: n/a

Related directives
: n/a

6.

Only applies to RTF generation

M

For conversions to RTF only, this specifies size of margin at the right ofCthe page. If omitted the Word default of 3.17 cm will be used.


* #

Scope COLOUR tags globally

/ ,  A       W o e $   y  :  / $   n # T  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: n/a
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



TmSpecifies whether the "COLOUR" tags should scope globally or locally.eo"Global" scope means the colour won't change until another "COLOUR" tag Lis encountered. "Local" means the colour will only scope as far as the nextfont change.


& 

Search for definitions

h/ ,  E _    a  [ g e $  o h e +  _ $   d r#     H  i
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
r and
a. Analysis -> What to look for
Command line option
: n/a
Related directives
: n/a
T or
. Analysis -> What to look for
See also
: Definitions
6E

This policy can be used to disable the search for definitions (see>;Definitions).
KUse this whenever your file contains no definitions, but the program thinks it does.


# o

Search for emphasis

/v,  B <    c  rY m < $   e  % H o $   B # T  T
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



KThis policy specifies whether or not the program should look for emphasisedTBtext. Text can be emphasised by placing asterisks (*) either sideFof it, or underscores (_). The program will convert the enclosed text$to bold and italic respectively.

P

Both single words and phrases can be detected, however phrases spanning blank;lines, or nested emphasis may not be correctly handled.


>! i

Short line length

/o, (  u    e  [ n r $  " g  0  e $   O # =  e
Possible values
: Number of characters.
Default value
: -1 (none)
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



IFThis policy determines what constitutes a short line. The program may6add a line break to any line it deems to be short.

C

If omitted, a "short" line is determined as some fraction of theA[calculated page width. The fraction varies from 50-75% according>-to the conversion type being carried out.

oG

If you set this value large, then all lines may be treated as short,rEpreserving the line structure of the original. Conversely if you set=7it small, then very few lines will acquire a break.


- n&

Show file Titles in Directory

/m,  /     o  EW A e $   H  .  f $   A # f  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Directory
Menu location
: Output -> Directory List
Command line option
: n/a
Related directives
: n/a
6



IcWhen generating a directory page (see Make Directory), this specifiesLLwhether or not there should be a hyperlink to the top of each file converted((as opposed to just their contents).

`

If selected, the HTML file's title (see Document Title) will beMshown as a hyperlink. If the file has no title, then the original filename isshown instead.


) (

Smallest allowed <Hn> tag

/B, - f o    T  pW > > $     % c  $   y # P  i
Possible values
: 1 (largest) - 5 (smallest)
Default value
: 5
Policy scope
: Fixed output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6s

Together with Largest allowed <Hn> tag these policies allow you to Xcontrol the heading sizes <Hn> used to mark up any headings that are detected.

V

By default <H2> is used for main level headings, with each subsequent headingHlevel being one size smaller, down to <H3> (normal text size).

K

The software will ignore these values if out of range, or if the largest>Mvalue represents a smaller heading (larger Hn) that the "smallest" value.


 T

Split level

/m, 4  /    a  TW  s $ "  T  / d r $   l # p  c
Possible values
: Section level. Usually 0,1 or 2.
Default value
: -1 (none)
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



JIdentifies the heading level (or depth) at which the generated HTML should be split into smaller files.

=

A value of "none" will put all the HTML into one file.

/,  D  <  @  l  D  e
"1"
creates a new HTML file for each new major section.
"2"
creates a new HTML file for each new subsection
"3"
creates a new HTML file for each new sub-subsection
6K

The first file created normally has a name that matches the source file.>JSubsequent files append either the section number (for numbered sections),Cor the first word (for underlines or capitalised section headings),>Mseparated by underscores. If duplicate filenames are detected, then an extrar"number is appended to the name

M

Thus a file called MYDOC.TXT with numbered sections and this policy set tor""2" will generate files called



MYDOC.HTML,
 MYDOC_1.HTML,
A MYDOC_1_1.HTML etc...
> MYDOC_2.HTML
...


n* #

Suppress all colour markup

A/B,  l    N   >W R > $  T   0   $    # /  !
Possible values
: Yes/No
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

O

Specifies that all colour markup should be suppressed. This means all othereJcolour policies will be ignored, and no default colours will be added.

L

This can be useful when wanting to generate a page suitable for access byLpeople with impaired vision. Selecting this option produces HTML which they0can set the colours on using their browsers.


( !

Suppress all font markup

e/a,  a m      W l ; $   /  :  > $   c # t  e
Possible values
: Yes/No
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

J

Specifies that all font markup should be suppressed. This means eitherLthat no <FONT> tags will be generated, or that the FONT portion of any.generated CSS style sheet will be omitted.

H

This can be useful when wanting to generate a page which allows usersHto select their own fonts, e.g. because people have impaired vision.


& 

Suppress INFO messages

i/>,   m   T T  >W >  $  o t  5 c p $   o #   A
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



oKSuppresses all "INFO" messages from the display. These are messages deemedoto be "informational"

TX

The severity (reporting level) will match how important/useful the seriousness of the warning.

x

Together with the Error Reporting Level policy, similar suppression policies andGthe /SILENT command qualifier, you have a fair degree of control of the>6level of reporting made visible during conversion.


+ n$

Suppress TAG ERROR messages

/v,  B <    t  rW o m $  . r  5 U P $   l # "  .
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



ISuppresses all "TAG ERROR" messages from the display. These are messagesCLreporting failure to implement inline tags and directives (if any) placed inyour source text.

iI

However, you should really fix up all your tag errors if possible.

ex

Together with the Error Reporting Level policy, similar suppression policies andGthe /SILENT command qualifier, you have a fair degree of control of the6level of reporting made visible during conversion.


% /

Suppress URL messages

/S,  / >      !W o > $  g h  5 u o $   e # P  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



TOSuppresses all "URL" messages from the display. These are messages that reporty:the detection of URLs in the document being converted.

x

Together with the Error Reporting Level policy, similar suppression policies andGthe /SILENT command qualifier, you have a fair degree of control of thei6level of reporting made visible during conversion.


) /"

Suppress WARNING messages

/T,   H   o l  uW c  $  / >  5 y  $    # o  
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



yOSuppresses all "WARNING" messages from the display. These are messages usuallyaNreporting that the program has possibly done something you may not have wantedIit to, or not done something you might have wanted it to. For example if>Jlines that could contain emphasis or headings are rejected, a warning willbe issued.

C

The severity (reporting level) will match the seriousness of them warning.

x

Together with the Error Reporting Level policy, similar suppression policies andGthe /SILENT command qualifier, you have a fair degree of control of the6level of reporting made visible during conversion.


/ /(

Suppress program ERROR messages

/ ,   e    /  sW v B $  T T  5   $   # # /  o
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Messages
Menu location
: Settings -> Diagnostic messages
Command line option
: n/a
Related directives
: n/a
6



uMSuppresses all "PROGRAM ERROR" messages from the display. These are messages Hindicating that the program itself thinks it's done something wrong.

S

There's not much you can do about such errors, other than ignore them, or report!2them to the author so he can fix the software.

x

Together with the Error Reporting Level policy, similar suppression policies andGthe /SILENT command qualifier, you have a fair degree of control of the 6level of reporting made visible during conversion.


& 

Table Extending factor

/a,  > A    =  b[ l R $  o D  0   $   D # R  G
Possible values
: 1-10
Default value
: 5
Policy scope
: Dynamic analysis policy
Policy file section
: Tables
Menu location
: Analysis -> Table Analysis
Command line option
: n/a
Related directives
: n/a
6



GWhen detecting preformatted regions, this indicates the degree to which=4lines adjacent should be included in the region.

K

A value of 10 means almost all adjacent lines will be included up to theeEnearest page break of heading. A value of 1 means virtually no lineseBwill be included unless they too are clearly heavily formatted


 

TAB size

t/i, :        i[ s t $  = C  0   $   T #   t
Possible values
: Tab size. Usually a multiple of 2 or 4
Default value
: 8
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



HSpecifies the size of TABs in your source document. During analysis theGprogram converts all tabs to spaces assuming using this tab size. This Gbecomes important only when comparing lines that use tabs to lines thatT9use spaces for alignment. If problems occur you may find?indentations appear strange, or tables are not quite right.

a
Q
Note,
text that is all tabs or all spaces should experience no such# problems.y
M

If you know your source file uses a different TAB size (e.g. Notepad filesf1use a value of 4), try adjusting this policy.

t
4 -

Tables could be blank line separated

e/h,  > a      LY B  $     :  i $   T # >  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



>FSpecifies whether or not blank lines inside a table should be taken toGbe row separators. If they are, and there are enough of them, then theiFtable will have all adjacent lines merged into single multi-line rows.BIf they're not, then each line will become a row in the table.

P

This policy is usually determined on a case-by-case basis for each table.


 l

Text Colour

/e, P  h   N t  W N T $  r T  0  > $   o #   l
Possible values
: HTML colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6



eHIdentifies the text colour of the HTML page(s) created. This value is aOHTML colour that is used to set the TEXT attribute of the <BODY> tag.

/
" 

Text justification

>/e, 6      m  [  f $  <   0  > $   e # d  t
Possible values
: "left", "right", "center" or "none"
Default value
: "left"
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> File Structure
Command line option
: n/a
Related directives
: n/a
6@

This policy is important in detecting pre-formatted text.

H

If text is centered then padding spaces may be added. This has to be.ignored when detecting pre-formatted text.

K

Somewhat confusingly "center" here means what most word processors woulducall "justified".

X
" 

Top margin (in cm)

/ ,  M r >   c  R  TW T <  $   p u  6  < $   > > # /  R 
Possible values
: Text
string
Default value
: (see
below)
Policy scope
: Fixed output policy

Policy file section
: RTF

Menu location
: Output -> RTF Settings
Command line option
: n/a

Related directives
: n/a

6.

Only applies to RTF generation

K

For conversions to RTF only, this specifies size of margin at the top ofiLthe page. If omitted the Word default of 1 inch (2.54 cm) will be used.


. '

Treat each line as a paragraph

d/e,   h   s t  a[  N $     0  o $   u #   
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic analysis policy
Policy file section
: Analysis
Menu location
: Analysis -> General layout
Command line option
: n/a
Related directives
: n/a
6



GIndicates that each line of text in the file should be treated as a new>Hparagraph. This should only ever be set to "yes" if the source file wasGcreated in a text editor that relies on word wrap to set the line size./QSuch files usually don't have much structure above and beyond the paragraphs.

N
% a

Unvisited Link Colour

/g, P  o   o   W > B $  > >  0  R $   h # >  >
Possible values
: HTML colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6M

Identifies the colour of "unvisited" hyperlinks, that is the colour of the Dhyperlink before it is selected for the first time. This value is aOHTML colour that is used to set the LINK attribute of the <BODY> tag.

D

See also :-
8Active Link Colour
:Visited Link Colour


" 

Use .HTM extension

a/i,  g r   d L  dW  s $ "  l  /  s $   a #   o
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: n/a
Related directives
: n/a
6



oIThis policy specifies whether or not the generated HTML files should haveDa .HTM extension. The default is to use a ".html" extension, unless'DOS-compatible files are requested.

sd

This will be enabled whenever Use DOS filenames is selected.

z

Note this policy may be overridden by the more general Use .HTM extension policy.


* /

Use <CODE>..</CODE> markup

/t,  y r   r l  Y c  $  N r  :   $   R #   <
Possible values
: Yes/No
Default value
: No
Policy scope
: Dynamic output policy
Policy file section
: Tables
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



EThis policy specifies that where a code fragment has been detected or/7marked up, what sort of HTML markup should be used.

oQ

HTML provides a special <CODE> .. </CODE> markup that is suited toT

For this reason, AscToHTM defaults to <PRE> .. </PRE> markup for codeEfragments. The only reason for reversing this might be if you needednEthe <CODE> tag for a particular style sheet to take effect.

l
/ o.

Use <DL> markup for defn. paras

/r,  m H    E  Y  < $     % >  $   D # R  D
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



>AThis policy specifies whether or not definition paragraphs shouldvbbe marked up using <DL><DT>..<DT> <DD>..</DD></DL> markup.

K

The default is "yes", but if you find that too much text is being markedltup this way, either disable this policy of disable search for definitions.


, 1

Use <EM> and <STRONG> markup

/.,  < e    o  lW c . $   r  :  L $    # <  /
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Style
Menu location
: (only available by editing policy file)
Command line option
: n/a
Related directives
: n/a
6



mVSpecifies whether <EM> and <STRONG> markup should be used in preference toG<I> and <B> when placing text in italic or bold markup.

T[

Strictly speaking <EM> and <STRONG> should be used as these are "logical" asT!opposed to "physical" markup.

<O

The preference has become a near religious decision which I avoid, by giving/:you this policy so you can choose (if you really care)


- R,

Use <P> markup for paragraphs

/a,  e n      rY L n $   i  % H x $   E # >  >
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic output policy
Policy file section
: Style
Menu location
: Output -> Style
Command line option
: n/a
Related directives
: n/a
6



TOThis policy specifies whether <P> or <BR> markup should be used forEHparagraphs. In most browsers <P> markup produces more white spaceGwith apparently a "blank line" placed between paragraphs. A <BR>ldoesn't have this effect.

G

You should use this policy if you wish to reduce the amount of whiteVthe ignore multiple blank lines policy.

N

This policy is switched on by default. We don't recommend you change this,Gespecially if you plan to use the font and CSS abilities being added inhV4.0 and above.

i
* #

Use CSS to implement fonts

d/a,  f /    c  BW T i $   u  % D T $   > #   s
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Style
Menu location
: Output -> Fonts
Command line option
: n/a
Related directives
: n/a
6



-JThis tells the program that Cascading style sheets (CSS) should be used toAimplement any font markup. CSS is new in HTML 4.0, and is a more Mefficient way of implementing fonts than using the <FONT> tag (which isu,being phased out from HTML 4.0 onwards).

H

You should leave this policy unchanged, unless you experience troublewith your fonts.

W

Note, CSS is incompatible with HTML 3.2, whilst the <FONT> tag is incomparable Iwith "HTML 4.0 Strict". Both may be used in "HTML 4.0 Transitional".


! a

Use DOS filenames

/<,  w r   a ,  >W p 3 $ "  A  /   $   o # c  n
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: File generation
Menu location
: Output -> File generation
Command line option
: /DOS
Related directives
: n/a
6



'/DOS qualifier on the command line.

oE

If selected the filenames will all have a ".HTM" extension, and be given upper case names.

>D

Any file name whose root exceeds 8 character will be shortened byBkeeping the first 3 characters, and adding a unique 5-digit number!derived from the longer name.

e

See also :-
6DOS filename root




Use Preprocessor

w/w,  N _      C[ u # $  u >  .  l $    #   /
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Dynamic analysis policy
Policy file section
: Preprocessor
Menu location
: Analysis -> preprocessor
Command line option
: n/a
Related directives
: n/a
6



rGThis policy tells the program whether or not the preprocessor should beTEused. If it isn't used, then all preprocessor directives are ignored @and a straight conversion from input to output files occurs.

K
Note:
If this policy is set to "no", all related preprocessorp policies will have no effect.
3

We don't normally recommend you change this.

;
. '

Use any existing contents list

m/E,  " <    B  iW i / $  T s  - ; u $   > # a  >
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Contents
Menu location
: Output -> Contents List
Command line option
: n/a
Related directives
: n/a
6



uJThis policy specifies whether or not you wish to use any existing contentsClist found in the source document. If you disable this option, any Econtents found will be discarded. A contents list will only be addedsOif you select the add contents list policy

X
* #

Use first heading as Title

t/=,  B    e c  W . o $  i e  7 o > $    # /  
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Title, description etc.
Command line option
: n/a
Related directives
: n/a
6



TGSpecifies that the first heading in the document may be considered as aE%candidate for the document title.

RJ

See the discussion in Document title.


' h

Use first line as Title

/e,  e B   v <  RW  y $  m i  7 s  $   n # T  
Possible values
: Yes/No
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Title, description etc.
Command line option
: n/a
Related directives
: n/a
6



TJSpecifies that the first meaningful line in the document may be consideredJas a candidate for the document title. "Meaningful" in this context meansCa line recognised by the program as a headings which is more that 2e>characters long once trimmed of all leading and trailing white space.

J

See the discussion in Document title.


y" 

Use Landscape mode

</t,      < T  aW  A $     ,   $   < # i  <
Possible values
: Text string
Default value
: No
Policy scope
: Fixed output policy
Policy file section
: RTF
Menu location
: Output -> RTF Settings
Command line option
: n/a
Related directives
: n/a
6.

Only applies to RTF generation

J

For conversions to RTF only, this specifies whether or not the documentEshould be placed in Landscape mode. If omitted document will defaultito portrait mode.

i
/ e(

Use main footer in footer frame

/n,  u x    e  W B  $     &  . $   e # <  e
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

v

This has exactly the same effect as Use main header in header frame,Dbut this time for footers. See the discussion in that section.



See also :-
RUse main header in header frame


/ v(

Use main header in header frame

/ ,  N _    /  LW v < $  <   &  E $   / # <  
Possible values
: Yes/No
Default value
: Yes
Policy scope
: Fixed output policy
Policy file section
: Frames
Menu location
: Output -> Frames
Command line option
: n/a
Related directives
: n/a
6(

New in version 4

N

Only applies to FRAMES production when HTML is being generated

L

When this policy is set the software will attempt to move any HTML headerLdefined for each page into a header frame. This allows the same policy file9to be used for both FRAMES and non-FRAMES generation.

gN

In non-FRAMES generation the supplied header will be included at the top ofeach page generated.

D

If this policy is enabled, then in FRAMES generation the suppliedNheader will be placed in a header frame, and omitted from each page generated.HThis means the header will always be visible in the header frame, as theAgenerated pages are displayed and scrolled in the main frame.

eB

Further modification of this behaviour is possible by using theEHTML fragments feature to define
gspecific HTML fragments
eJto be used in particular frames. See the section on HTML Fragments in theTag Manual.

k

See also :-
RUse main footer in footer frame


# 

Visited Link Colour

/T, P     o i  W u < $  o e  0   $   B # c  t
Possible values
: HTML colours
Default value
: ""
Policy scope
: Fixed output policy
Policy file section
: Added HTML
Menu location
: Output -> Document colours
Command line option
: n/a
Related directives
: n/a
6



gHIdentifies the colour of "visited" hyperlinks, that is the colour of theDhyperlink after is has been selected at least once. This value is aPHTML colour that is used to set the VLINK attribute of the <BODY> tag.



See also :-
8Active Link Colour
>Unvisited Link Colour


t2

B
\ Previous page $8 Back to Contents List#l 


B > 
Valid HTML 4.0!Converted from a single text file by HREF="http://www.jafsoft.com/asctohtm/">AscToHTM
K© 1997-2000 John A. Fotheringhamh
su