>2% 4 : Running AscToHTM  A 8
AscToHTM 

Documentation for the OAscToHTM conversion utility



9

This documentation can be downloaded as part of the  documentation set in .zip format (370k)




V Previous page $@ Back to Contents List#R Next page 


 &

4 Running AscToHTM

 

4.1 Windows version

 $

4.1.1 Launching the program

 "

4.1.1.1 Normal activation

I

Just run the program as you would any other Windows program, i.e. by@ clicking on its icon, or launching it from the Start menu.


 .

4.1.1.2 Execution from a command line

;

From a Windows console command prompt you can type




C:> AscToHTM



or


:

C:> AscToHTM <file1> <file2> ...


;

In the first case, AscToHTM is launched as normal.

J

In the second case AscToHTM will convert the specified files, brieflyB displaying a status window, and then exiting. In this case, one3 of the named files can be a .pol policy file.

G

Note, a console version of AscToHTM (A2hCONS) exists that can only@ be run from the Command line prompt. The Windows version also= supports this command syntax, but users wanting to do largeE conversions, or conversions from within a batch file are advised toG use the console version. Currently the console version is only being) made available to registered users.


 &

4.1.1.3 Drag'n'Drop execution

G

Create an Icon for AscToHTM, and simply drag'n'drop files onto it.> The results are identical to those obtained by typing in theG filenames as described in 4.1.1.2.

F

Alternatively, run the program as normal and then drag files ontoD the running program. You can configure the program's behaviour inE drag'n'drop operation by using the Settings | Drag'n'Drop menu.

C

One useful suggestion is to add AscToHTM to your "SendTo" menuD (shown when you right-click on a file). See the Windows help file for more details.

\

See 4.4.6 for more suggestions on using desktop icons.


 0

4.1.1.4 Output to the Windows clipboard

*

New in version 4

E

You can use the program to convert the file to HTML, and to copyC the HTML into the Windows clipboard, ready for pasting into other+ applications (such as a HTML editor).

B

To do this, launch the Windows program as normal, and set theG Conversion Type on the main screen to "Output HTML to clipboard".

W

The HTML copied to the clipboard will be without the <HEAD> and <BODY>N tags to make the HTML more suited to pasting into an existing HTML page.


 *

4.1.2 Using the Windows Interface

L

The Windows interface was re-vamped in version 3.0 and further enhanced' in version 3.2. The main changes are


 
 3

4.1.2.1 Doing a straightforward conversion

G

To do a simple conversion, simply enter the name of the file to beN converted or use the "Browse" button to locate the file to be converted.

1

Then press the "Convert file(s)" button.

G

A status screen is displayed whilst the conversion is in progress.G For small files this may flash up so fast you can't actually read it.M (If you want to see what it said go to the View...Messages menu option)

K

To view the HTML, press the "View results" button. This should launchD your preferred HTML viewer to display the newly created HTML page.A If you want to automate that process, edit the program's viewer< settings (see 4.1.2.4).


 

4.1.2.2 The File menu

-

The File menu has the following options:

 
K

Initiates the conversion. If you already have a file selected, thisD file is converted. If you don't, then a browse window will open1 allowing you to choose a file to convert.

K

This option is identical to pressing the "Convert files" button.



 
K

This option allows you to load a set of policies previously saved toK a policy file. This allows a conversion to be repeatedly done the sameo way, or a set of conversions to be done the same way (see 6.5)

d

Note, you can set a policy file to be used by default see 4.1.3.


 
N

This option allows you to save your current set of policies to a policyH file for later re-use. It is recommended that only a partial set ofJ policies (i.e. any loaded policies and manually set policies) be savedN to allow the program maximum flexibility when converting future files.

See section 6.5 and the discussion in 6.5.2.1


 


Exits the program



 ,

4.1.2.3 The Conversion options menu

I

AscToHTM offers the advanced user a large number of program options.G These are called policies, and may be saved in policy files for laterD re-use. Policy files are described in detail in Chapter 6 of this document.

,

Policies broadly come in two sorts.

 E

The Conversion Options menu has options to allow you to view and= change many of the program's policies (but not all, see theB Policy manual for details).

!

The menu also has options to

 
J

These options allow you to browse for and open the policy file thatG you want to use. Essentially they are identical to the load optionA on the File menu (see 4.1.2.2)


 
E

This allows you to reload the policy file (e.g. because you've just edited it by hand)


 
E

This allows you to save the current policies to file for later reuse.


 
K

This option forces AscToHTM to re-analyse the current source file to) (re-)calculate the analysis policies.


 
M

This option forces all policies back to their AscToHTM defaults. ThisK will negate the effect of any manually set policies, or policies loaded from a policy file.



 "

4.1.2.4 The Settings menu

H

The Settings menu allows you to tailor the way in which the programE executes. These settings will usually be saved in your Registry so- that they are remembered for next time.

+

The Settings menu includes options for

 
D

Specifies the location of the program's documentation on your? hard disk (see 4.1.3.1).


 
D

Specifies the level and type of error reporting wanted during? the conversion (see 4.1.3.2)


 
G

Specifies the program's behaviour when invoked by dragging filesJ onto the program's icon (see 4.1.3.3.).


 
I

Specifies the browser to be used to view results files, and how itG should be invoked (see 4.1.3.4).


 
e

Specifies any default policy file to be used (see 4.1.3.5).



 "

4.1.2.5 The Language menu

I

The language menu allows you to change the language used in the userG interface. These translations are provides by a group of volunteers.% Currently translations exist for :-

 F

The software supports the concept of language "skins" which allowA the user interface to be exported to an external file which mayA be edited and then re-loaded. This allows users to offer theirJ own translations, or to correct errors in the existing translations.

K

You can read more in Language support


 

4.1.2.6 The View menu

 
M

This option allows you to re-view the Messages window displayed duringF file conversion. On small files this window can sometime be shown) too briefly to view the messages.


 
F

This option will launch the preferred browser for the last fileG converted. If a wildcard conversion was done, the last file in theA group is shown. This option has the same effect as the "View results" button.



 

4.1.2.7 The Help menu

 
I

This option brings up the Windows help file. This offers a lot ofD context-sensitive help which can usually be accessed by pressing- F1 or "Help" anywhere in the program.

L

Over time the Windows Help file has adopted a secondary role compared" to the HTML documentation.


 
J

This option takes you to the web page offering registration detailsA or (if you've already registered) listing recent updates.

)

Currently the registration page is http://www.jafsoft.com/asctohtm/register_online.html?from=doco


 
N

This option allows you to view the HTML documentation for the software.D You can either view your local copy from your hard disk, or readG the version on the web site (you'll need to connect to the Internet in that case).

L

Each installation of AscToHTM comes complete with HTML documentation.I Should you decide to move your copy of the documentation, you'll needB to alter the settings (see 4.1.3)


T 
I

A list of web pages describing other JafSoft Limited products thatT may be of interest to you.


D n
H

This option launches the About screen. This gives program versionI information, shows your registration status, and provides a couple ofTC buttons to access the home page and other pages on the Web.

w

T
O -

4.1.3 Program settings

o
G

These settings allow you to customize the program's behaviour to a{ limited extend.

n
g P

4.1.3.1 Documentation

I

Allows you to specify the location of the HTML documentation for theNF program on your machine. By default this is the same as the programH directory, and you should only need to change this if you move it.


N t

4.1.3.2 Diagnostics

F

Allows you to select the level of detail you want in the messagesG displayed during conversion. You can also elect to suppress messagesn by type.


 (

4.1.3.3 Drag and drop execution

H

Allows you to specify how you want the program to behave when it isA launched by dropping files into the program, or its icon on the" desktop.


c t

4.1.3.4 Results viewers

J

Allows you to specify the HTML browser to be used to view the createdJ HTML. You can elect to always invoke a results viewer after conversion,% and to use DDE to achieve this.

oO

DDE allows the program to tell an existing browser to display the results. H

If the DDE call fails for any reason, a new instance of the defaultD browser is launched, so you should ensure this is the same browser! as that identified for DDE.

EL

This dialog also allows an RTF viewer to be selected. This may be usedD for viewing RTF files, although it's possible that at present your6 version of the program doesn't require this yet.


R
NOTE:
On some systems DDE doesn't always work properly. This wouldC cause the program to hang when it attempted to display results. B In such cases you would need to stop the program from the task7 manager. The program will now detect when this hasi? happened and disable use of DDE next time it runs. You can4B re-enable it using the Settings | Viewers menu optionR
NOTE:
Whereas DDE works fine with Netscape versions up to andi including 4.7, it doesn't work with Netscape 6.0 since initiale< versions of that browser don't support DDE under Windows

m >$

4.1.3.5 Use of policy files

H

Allows a default policy file to be specified. This is not normallyB desirable, but if you always use the same policy file, this will? save you having to load it each time you run the program.

K

You can also elect to always reload the policy file during conversion.wH This should only be necessary if you're repeatedly changing the policyM file in a text editor between conversions while the program is running.

iE

Note, an alternative to using a default policy file is to definetC a desktop icon with the policy file specified on the command lineo. (see 4.4.6)


 m

4.1.4 Language support

t
M

There is an ongoing effort to make AscToHTM available in more languages.eB This effort is being undertaken by a number of volunteers. It'sI unlikely that full translations of User Interface, error messages, help E files and documentation will be available in all languages, but theC hope is to make the program a little easier for those whose firste language is not English.

M

Please note that the author only speaks English, and thus can only offera support in English.

.

Elements that may be converted include :-

 u(

Less likely to be translated are :-

 c
. n&

4.1.4.1 Existing translations

I

Depending on how far the process has gone (and how many changes have>H been made recently) not all text may be in your selected language.

(

Currently translations exist for :-

 tL

My thanks to all those involved. If you'd like to get involved in this effort, visit

i
|

http://www.jafsoft.com/products/translations.html



E
c n;

4.1.4.2 Adding translations using "Language skins"

i
K

The program now supports the concept of language "skins". This allowsnA the existing translation to be exported to a text file called anB "language skin". This file consists of one line per translationE per line, with a unique number at the start of the line identifying ) the text, and then the text itself.

iG

You can edit this file - conventionally with a .lng extension - toiE contain your own versions of the strings, and then reload this backnJ into the program via the Language menu. The changes will take immediate? effect, and are remembered next time you run the program.

rH

Using this technique we can now offer via and American spellcheckery and the translation services of http://babelfish.altavista.com/ three new  languages :-


 e
uF

These translations are not expected to be ideal, but they offer aD starting point. If anyone cares to mail me corrected version I'llI happily make these available... with full credit to the translator.

H_

Mail updates to translations@jafsoft.com

e
t .3

4.2 VMS and console application versions

A
L

The VMS version and windows console version behave identically in terms( of their use of command arguments.

3

A Linux version has also been beta tested.

/L

The Windows console version performs identically to the Windows versionH (which supports the command line operation), but is more suited to useE inside batch operations. For example the Windows version is likely ? to gain focus when it executes, which can be distracting.

tJ

The Windows console version is called A2HCONS (to distinguish it fromK the fully windowed version AscToHTM), but is only available to registeredw users of the software.


 %

4.2.1 Command line arguments

m
/

The command line should be of the form

e
P

AscToHTM <filespec> [<policy_file>] [</qualifiers>]


e

Where



F
Filespec
Any valid file specification for the system0 you're using. This can include wildcards.

s
t4, s : R c


In the Windows version, this can also be space
' separated lists of files
;h





t
Policy_file
The name of any policy file (see Using Document Policy files) you7 want to use for the conversion. Policy files are>; recognised by having a .pol file extension. For thiso3 reason you cannot convert .pol files to HTML.bV
Qualifiers
Extra commands that may be passed in via the command< line. In most cases these are equivalent to policies,9 they're just made available on the command line forl your convenience.a


a
t y&

4.2.2 Command line qualifiers

E

Certain aspects of AscToHTM's behaviour can be changed by addinglK qualifiers to the command line. Qualifiers must begin with the slash (/)oG character but may be of mixed case and may be shortened provided they>I remain unique. So /H will get you help, whereas you can't use /S sincea& that could be /SILENT or /SIMPLE


l n%

4.2.2.1 The /COMMA qualifier

*

New in version 4

H

Specifies that the source file is a comma-delimited table. In thisG case each line will become a row in a table, and each value separatedl1 by a comma will become a cell in the table.

l
> '

4.2.2.2 The /CONSOLE qualifier

/
G

Specifies that the HTML generated should be directed to the output G stream, rather than to an output file. This is a step towards makinglJ the program more suited for use inside a web server, e.g. to dynamicallyF convert text to HTML on demand, although it is expected this process" has some distance to go yet.


T o(

4.2.2.3 The /CONTENTS qualifier

v

This has exactly the same effect as the "add contents list" policy line.


c 0

4.2.2.4 The /DEBUG and /LIST qualifiers

M

These qualifiers cause AscToHTM to generate some diagnostic files, which  have extensions

t
c

/,  1  i  l0  p  "  C
.LIS1
an analysis before policy is set
.LIS
an analysis after policy is set
.STATS
a statistics file
6
n
U
L

The list files can assist in understanding how AscToHTM has interpretedF your file. The .stats file is neither pretty, nor easy to read, butE can in extreme cases assist in diagnosing faults should you wish top report them.

E

If the /LIST qualifier is used, only the list files are created.OF If the /DEBUG qualifier is used the .stats file is also created.


e .#

4.2.2.5 The /DOS qualifier

U

This has exactly the same effect as the "Use DOS filenames" policy line


E %

4.2.2.6 The /INDEX qualifier

This has exactly the same effect as the "Make Directory" policy line


e c.

4.2.2.7 The /LOG[=filespec] qualifier

J

This specifies that a .log file should be created. This will containG a copy of all messages generated during the conversion, together withi) some that may have been suppressed.

eH

You can specify the log filespec. This can include wildcards, withD the input file being used to replace any parts of the filename not specified.

>

If omitted, the default log file name is AscToHTM.log


P ,

4.2.2.8 The /OUT=filespec qualifier

F

This specifies where the output file(s) should be placed. It canB include wildcards, with the input file being used to replace any* parts of the filename not specified.

H

Thus "/OUT=*.shtml" will result in a file with the same name, but aD .shtml extension. In VMS "/OUT=[.sub]" will place the output in a! sub-directory called "sub".

nI

If omitted, the output file is given the same name as the input filetI but with a .html extension. That behaviour may change dependant on ther+ values of a number of other policies.

e
i &

4.2.2.9 The /POLICY qualifier

This has exactly the same effect as the "Output Policy file" policy line.

i
. '

4.2.2.10 The /SILENT qualifier

o
H

This specifies that no messages should be displayed on the console.c When used with the /CONSOLE qualifier (see 4.2.2.2) this makes thewD program suitable for use in a web server, although you may need to$ use redirection under Windows.


r '

4.2.2.11 The /SIMPLE qualifier

n

This has exactly the same effect as the "Keep it simple" policy line.

p
a '

4.2.2.12 The /TABBED qualifier

C
*

New in version 4

F

Specifies that the source file is a tab-delimited table. In thisG case each line will become a row in a table, and each value separateds/ by a tab will become a cell in the table.

e
u &

4.2.2.13 The /TABLE qualifier

*

New in version 4

C

Specifies that the source file is a plain text table. In thisCB the program will do its best to analyse the table structure, and reproduce it.

O
i o-

4.3 Getting the most from AscToHTM

 e(

4.3.1 Making your first attempt

 =&

4.3.1.1 From the command line

$

To run AscToHTM simply type


#

AscToHTM Input_file.name


U

at the command line.

n

This will create a file :- 

 L
E

An output file which will have the same file name with a .htmld extension


wC

The program may display a number of status messages indicating/H source lines that it rejects because they "fail policy". Source linesD that fail policy are usually simply copied to the output file withC no markup applied. These messages are largely informational, and3D can be ignored if the conversion worked okay. If it didn't, theseC messages may give a clue as to where the analysis went wrong.


t T

4.3.1.2 From Windows

.
J

Enter the name of the file to be converted in the text field. If youI wish, use the browse button to search for the file to be converted.

oJ

Once you've chosen the file, the output filename and input and outputC directories are inferred from the filename. If you wish, you maye- edit the output filename and directory.

CZ

Press the Convert file(s) button. The Messages window will briefly display.J If you wish to view these messages later, select the View | Show9 Messages from last conversion menu option.

<O

To view the last file converted, select the View | Results of lastlN conversion menu option. This should launch your default browser forF the file types (.htm or .html) just created. If you get the messageS "cannot detect default browser", use the Settings menu to set up3< the path to the browser you wish to use and try again.


e e$

4.3.2 Refining your results

H

If all goes well the resultant HTML will be satisfactory and all inC one file. You can further refine the conversion by creating yourH own document policy.

E

In the Windows version, this is done by editing policies via thedK Conversion Options menu, which is fully described in the B context-sensitive Windows Help file (press F1 at any point).

M

However, in all versions the policies can be saved to a text policy fileoG and it is the format of that file that is shown and discussed in thise document.

r
e P$

4.3.2.1 Using a policy file

K

If your initial results are a little strange, then review the policiescC calculated by the program, and create a "policy file" to tell thes3 program how to do the conversion differently.

P&

You can do this as follows :-


    t
  1. 4 By creating a "sample" policy file
  2. 
n
K

You can create a sample .pol policy file that documents the policiesb7 used. Do this either by using the command line

h+

AscToHTM Input_file.name /policy

e

or by ticking

*

"Generate a sample policy file"

H

on the Conversion Options->File Generation tabbed dialogue

D

When this is done then the next time you convert the file, inE addition to the .html file generated, you will now have an output D policy file "input_file.POL" which describes the document policyl file calculated by AscToHTM (see 3.2) and used by it during the conversion.

DI

This file will contain one line each for all the program policies, 9 most of which should be correct.

AN

Review the contents of this file, deleting all lines that look correct,6 and editing all lines that appear to be wrong.

F

Save the modified .POL file which should only contain lines for? those policies you think are wrong or want to override.

lj

You'll may need to review the Policy manual in order to understand" the policies to do this fully.


e
    r
  1. * By re-analysing the file
  2. 
g
E

Under Windows a slightly easier option is to select ConversiongF Options -> Re-analyse the file. This will analyse the file andF change all the policy values currently on display to be the valuesD calculated by the program. You can then review and change these* values using the tabbed dialogues.

J

Once you're happy with your changes, select "Save policies to file"D from the menu, saving only the changed policies. You can review* this file in a normal text editor.


@

Once you've produced your new input policy file, re-run theF conversion using the new policy file. The program will now overrideA aspects of the calculated document policy with the input policya you've supplied.

E

Each document policy file consists of a number of lines of data.o Each line has the form

E.

*

Keywords : Data value(s)


/
1


? For clarity a number of section headers are added like this : 




Q [Analysis]


H

.@ Such headings are ignored, as are any lines whose keywords are& not recognised or not yet supported.



G The order of policies within the file is usually unimportant, and theK placement relative to the "headings" is ignored. The Headings are simplyB9 there to make the file easier to read in a text editor./



>@ A sample fragment from a calculate policy file looks like this

M*
e                [Hyperlinks]                -------------                Create hyperlinks       : Yes/-                Create mailto links     : Yesc-                Create NEWS links       : YesL Q                [Added HTML]                ------------0                Document Title          : (none)
1c


s



nE These are all default values used by AscToHTM. If, for example you D want to add a title to your page and prevent email addresses beingD turned into hyperlinks, simply create a policy file containing the lines 

f*
l                [Hyperlinks]                ------------,                Create mailto links     : No o                [Added HTML]                ------------F                Document Title          : Title text for the HTML page
1i


n



oD (Remember the insertion of section headings is optional, as is the( ordering of policies within the file).



B By refining the input policy file, you can greatly influence the output that AscToHTM generates


T d(

4.3.2.2 Using a link dictionary



rA In addition to adding hyperlinks for all URLs, email addresses,eE section references and contents list entries, AscToHTM allows users ? to specify key phrases that should be turned into hyperlinks.A



>B This is achieved by adding lines to the input policy of the form

o*
n      [Link Dictionary]v      ----------------- J      Link definition    :   "[AV]" = "AltaVista" + "Using_AltaVista.html"
1o


e



n The syntax used here ism

t*
 K      Link definition    :   "match phrase" = "replacement phrase" + "link" 
1v

B

In this case the string "[AV]" is replaced by a link to a webN page "Using_AltaVista.html" with the text "AltaVista" being highlighted.

C

The link dictionary used for this documentation can be seen ing7 the file a2hlinks.dat.

b
B i,

4.3.2.3 Using multiple policy files

G

If you wish to use AscToHTM to support several text files e.g. for H a set of Intranet documentation, it may be useful to share some commonF document policies, e.g. colour, headers and footers and particularly the link dictionary.

E

To support this AscToHTM allows two special types of line in theL policy file.


    
  1.  Include files
  2. 
W
.

4

include file : Link_Dictionary.dat


B
B1>

F

If a line of this type is encountered, the contents of the fileF Link_dictionary.dat are included in the current policy file. This@ is the best way of sharing data across many converted files.


i
    o
  1.  "daisy-chain" files
  2. 
i.

6

switch to file : Other_policy_file.dat


i
m1>

C

If a line of this type is encountered, the processing of themA current file terminates, and continues in the named file.

TD

This is a way of "daisy-chaining" policy files together whichN may be useful if you wish to group files together at different levels.



r
 u.

4.3.2.4 Creating DOS-compatible files

E

Occasionally it may be necessary to create files consistent withhI

AscToHTM supports this. There are two ways to achieve this. Either use the command

e
b.

,

AscToHTM input_file.name /DOS


t1h


f% Alternatively, simply add the lines 

*
 !                [File generation]h!                ----------------- -                Use DOS filenames       : YesL-                DOS filename root       : A2HH
1T

G

to your policy file. AscToHTM will then create a base file calledo (in this case) A2H.HTM.

.K

If you're splitting a large document into many files, subsequent filesh have the form

a
;

<filename_root>_<section number>.HTM

m
Q

When this name becomes two long, AscToHTM will create a name of the form

-


AAANNNNN.HTM


EL

Where AAA comes from the file root, and NNNNN is a 5-digit code derived% from the rest of the file name.

R
B e7

4.3.2.5 Use the pre-processor and in-line tags

S
K

AscToHTM has a built-in pre-processor. This allows you to add specialiG codes to your source file that tell the program what you'd like it toO do.

G

Examples include delimiting tables, embedding raw HTML or adding a, timestamp to the file being converted.

See Using the preprocessor and In-line tags for more details.


e l1

4.3.3 Processing several files at once

 =

4.3.3.1 Using wildcards

H

You can convert multiple files at one time by specifying a wildcardJ describing the files to be converted. The wildcard has to be meaningful; to the operating system you are using, and is expanded in2M alphabetical order. Under Windows this ordering may be case-sensitive.

aI

At present we recommend that wildcards are only used on the contentsrC of a single directory. Indeed wildcards spanning directories areN> probably not supported (let's just say it's untested :-)

M

Note, the same policies will apply to all files being converted. If youdp wish different policies to apply, use a steering command file (see 4.3.3.2)


P
Note:
In the shareware version, wildcard conversions are limited to only 10 files

a I.

4.3.3.2 Using a steering command file

Q

In the console version you can convert several files at the same time in theeD order and manner of your choosing. To do this use the command


5

AscToHTM @List.file [rest of command line]

e
p

yH Where the file "list.file" is a steering file which contains a list ofE AscToHTM command, and the "@" in front indicates it is a list file, % rather than a file to be converted. 



e& An example list file might look like

*
a+                ! this is the main documentd0                DOCO.TXT        IN_DOCO.POL /DOS                #B.                # These are the other chapters                CHAPTER2.TXT'                CHAPTER3.TXT    /SIMPLEa
1.

G

Note the use of "!" or "#" at the start of a line signifies it's aA! comment line to be ignored.

>B

Any qualifiers used on the original AscToHTM line are used asC defaults for each conversion, but are overridden by any listed iniG the list file. In this way it would be possible to specify a defaulti5 policy file for a bunch of similar conversions.

r
M
Note:
In the shareware version, batch conversions are limitedM to only 10 files

/ a#

4.3.4 Generating log files

H

If you want a log of what has been done, you can create a log file.- This can be done in a number of ways :-

 N
E

On the command line you can use to launch the program, add thetU the /LOG=<filespec> qualifier (see 4.2.2.7).s


l 1
o

Use the "Create a log file" policy. You will need I to manually edit this into your .pol file, as it can't be set via the  user interface.a


c .
N

In the Windows version, the Status Dialog now contains a "Save to file"D option to save the displayed messages. This dialog is currently% limited to 32,676 characters.



e
K _$

4.4 Other tips and tricks

 

4.4.1 General

 
L

This makes it easier for AscToHTM to place things in context, reducesH ambiguity and increases the chances of correct HTML being generated.


W 
G

On the output pass AscToHTM rejects lines that "fail policy", sooA any inconsistencies are liable to lead to errors in the HTML.i


h n
D

Where a number has to be at the start of a line, try using anD indentation level that doesn't match that used by your headings.


u >
L 3

4.4.2 Link dictionary

 f
F

If you can't avoid this, then list the longer entries first


t 
4

This means avoiding overly short match words.


h l
U l&

4.4.3 Contents List detection

H

Contents list detection is tricky at the best of times. It becomes even trickier if


    
  1.  There isn't one :-)O

  2. 
  3. < The list only contains chapters and no sub-sections
  4. 
UK

If the program wrongly determines that there is/isn't a contents list,c# use the following policy line

i
5

Expect Contents List : No


iC

to tell AscToHTM how it has gone wrong. The usual error is to 8 decide there is a contents list where none exists.


o r/

4.4.4 Using "Send to" in Windows 95/NT

n
K

AscToHTM can be invoked (without policy file) from windows in a numberd# of additional ways as follows

y 
<

If you want a policy file, drag that at the same time


N e
I

If you want a policy file, add it as an argument to the shortcut's  command line.

>
eG

Better still, create a .BAT file to invoke AscToHTM with a default @ policy file - e.g. with your favourite colour scheme, and someu standard link definitions (see Link dictionary policies) - and add thisd the "SendTo" folder.

C

In this way you can easily convert text files in any number ofg pre-defined manners.


s >

4.4.5 Tables

h
J

AscToHTM does a reasonable job of detecting and analysing Tables, but# the following tips can be useful. 

 i

If the table extent is wrong, try adjusting the "Table extending factor"K (shown as "Extend preformatted regions" on the Conversion Options ->// Analysis policies -> Tables menu option.u


T 2
> <3

4.4.6 Using desktop icons and policy files

y
*

New in version 4

J

AscToHTM can support arguments being passed on the command line. OneJ useful way to use the program is to add an icon to the desktop, allowing> you to "drop" files onto the icon to get them converted.

B

If you use policy files, edit the icon properties so that the' command line reads something like

-
J

"c:\program files\jafsoft\asctohtm.exe" "c:\mydir\mypolicy.pol"


dM

This will ensure the policy file mypolicy.pol is used in the conversion.eK You may also need to set the working directory to something suitable.

>N

If you have multiple policy files (e.g. different colour schemes), simply: create additional icons with different policy files.


> 2

t
V Previous page $@ Back to Contents List#Next page 


BA& 
Valid HTML 4.0!Converted from 6 a single text file by A AscToHTM
QJ© 1997-2001 John A Fotheringham