Documentation for the AscToHTM conversion utility |
This documentation can be downloaded as part of the documentation set in .zip format (370k)
1 IntroductionThe HTML version of this document has - of course - been produced using AscToHTM itself. No post-processing has been done to the HTML pages produced. The contents list, the navigation bar and all the hyperlinks have been generated from a single source file a2hdoco.txt and a number of small configuration files.
The source text file for this manual is over 5,000 lines and still growing having spawned the 6,500 line Policy manual and a 3,800 line Tag manual. See section 6.1 of this document to see a list of the actual files involved.
Any RTF version has been generated by the new text-to-RTF program AscToRTF which uses the same analysis engine as AscToHTM.
This document describes AscToHTM version 4.1, which is available from August 2001 onwards.
1.1 AscToHTM's design objectives2 Installation
1.1.1 Intelligent analysis.1.2 Expected uses of AscToHTM
1.1.2 Human-readable HTML
1.1.3 Simple user input
1.1.4 Standards compliance.
1.3 Other uses of AscToHTM
2.1 VMS installation3 How AscToHTM works
2.2 Windows installation
2.2.1 Install/uninstall version
2.2.2 Simple .ZIP file version
2.2.3 Console application
3.1 The big assumption4 Running AscToHTM
3.2 The analysis pass
3.3 The collating pass
3.4 The output pass
3.4.1 Generating HTML
3.4.2 Generating a contents list
3.4.3 Splitting the document into many HTML pages
3.4.4 Generating a set of FRAMES
3.4.5 Generating HTML for the Windows clipboard
4.1 Windows version5 HTML markup produced
4.1.1 Launching the program4.2 VMS and console application versions
4.1.1.1 Normal activation4.1.2 Using the Windows Interface
4.1.1.2 Execution from a command line
4.1.1.3 Drag'n'Drop execution
4.1.1.4 Output to the Windows clipboard
4.1.2.1 Doing a straightforward conversion4.1.3 Program settings
4.1.2.2 The File menu
4.1.2.3 The Conversion options menu
4.1.2.4 The Settings menu
4.1.2.5 The Language menu
4.1.2.6 The View menu
4.1.2.7 The Help menu
4.1.3.1 Documentation4.1.4 Language support
4.1.3.2 Diagnostics
4.1.3.3 Drag and drop execution
4.1.3.4 Results viewers
4.1.3.5 Use of policy files
4.1.4.1 Existing translations
4.1.4.2 Adding translations using "Language skins"
4.2.1 Command line arguments4.3 Getting the most from AscToHTM
4.2.2 Command line qualifiers
4.2.2.1 The /COMMA qualifier
4.2.2.2 The /CONSOLE qualifier
4.2.2.3 The /CONTENTS qualifier
4.2.2.4 The /DEBUG and /LIST qualifiers
4.2.2.5 The /DOS qualifier
4.2.2.6 The /INDEX qualifier
4.2.2.7 The /LOG[=filespec] qualifier
4.2.2.8 The /OUT=filespec qualifier
4.2.2.9 The /POLICY qualifier
4.2.2.10 The /SILENT qualifier
4.2.2.11 The /SIMPLE qualifier
4.2.2.12 The /TABBED qualifier
4.2.2.13 The /TABLE qualifier
4.3.1 Making your first attempt4.4 Other tips and tricks
4.3.1.1 From the command line4.3.2 Refining your results
4.3.1.2 From Windows
4.3.2.1 Using a policy file4.3.3 Processing several files at once
4.3.2.2 Using a link dictionary
4.3.2.3 Using multiple policy files
4.3.2.4 Creating DOS-compatible files
4.3.2.5 Use the pre-processor and in-line tags
4.3.3.1 Using wildcards4.3.4 Generating log files
4.3.3.2 Using a steering command file
4.4.1 General
4.4.2 Link dictionary
4.4.3 Contents List detection
4.4.4 Using "Send to" in Windows 95/NT
4.4.5 Tables
4.4.6 Using desktop icons and policy files
5.1 Text layout6 Using Document Policy files
5.1.1 Indentation5.2 Text formatting
5.1.2 Hanging paragraph indents
5.1.3 Bullets
5.1.3.1 Bullet chars5.1.4 Centred text
5.1.3.2 Numbered bullets
5.1.3.3 Alphabetic bullets
5.1.3.4 Roman Numeral bullets
5.1.5 Definitions
5.1.5.1 Definition lines
5.1.5.2 Definition paragraphs
5.2.1 Quoted lines5.3 Added hyperlinks
5.2.2 Emphasis
5.2.3 Fonts
5.2.4 Special characters
5.3.1 Contents List lines5.4 Section headings
5.3.2 Cross-references
5.3.3 URLs
5.3.4 Usenet Newsgroups
5.3.5 E-mail addresses
5.3.6 User-specified keywords
5.3.7 Other sections and URLs
5.4.1 Numbered headings5.5 Pre-formatted text
5.4.2 Capitalised headings
5.4.3 Underlined headings
5.4.4 Embedded headings
5.4.5 Key phrase headings
5.4.6 Numbered paragraphs
5.4.7 Mail and USENET headers
5.5.1 Lines and form feeds5.6 Added value markup
5.5.2 User defined pre-formatted text
5.5.3 Automatically detected pre-formatted text
5.5.3.1 Tables
5.5.3.2 Code samples
5.5.3.3 Ascii art and diagrams
5.5.3.4 Text blocks
5.5.3.5 Other formatted text
5.6.1 Document Title
5.6.2 Contents lists
5.6.2.1 Contents lists in default conversions5.6.3 Directory page
5.6.2.2 Contents lists in conversions to a single HTML file
5.6.2.3 Contents lists in conversions to multiple HTML files
5.6.2.4 Contents lists in conversions to frames
5.6.4 Headers, footers and JavaScript
5.6.5 HTML fragments
6.1 An example conversion7 Using the preprocessor
6.2 Analysis policies
6.2.1 Overview ("look for") policies6.3 Output policies
6.2.2 General Layout policies
6.2.3 Bullet policies
6.2.4 Contents analysis policies
6.2.5 File Structure policies
6.2.6 Heading policies
6.2.7 Pre-formatted text policies
6.2.8 Table analysis policies
6.3.1 Added HTML policies6.4 Settings policies
6.3.2 Cascading Style sheet policies (CSS)
6.3.3 Contents generation policies
6.3.4 Document Colour policies
6.3.5 Directory Page policies
6.3.6 File generation policies
6.3.7 Font policies
6.3.8 Frames policies
6.3.9 Hyperlink policies
6.3.10 Link Dictionary policies
6.3.11 Preprocessor policies
6.3.12 HTML styling policies
6.3.13 Table Generation policies
6.3.14 Miscellaneous policies
6.4.1 Error reporting6.5 Saving and loading policy files
6.5.1 Overview
6.5.2 Generating policy files for your document
6.5.2.1 Partial policy files6.5.3 Naming policy files
6.5.2.2 Full policy files
7.1 Directives8 Frames
7.1.1 Marking up sections of text7.2 In-line tags
7.1.2 Commands that influence the <HEAD>..</HEAD> of a file
7.1.3 One line pre-processor commands
7.1.4 The TABLE commands
7.1.5 The CHANGE_POLICY command
7.1.6 Block definition
7.1.7 HTML Fragments
7.2.1 Format of in-line tags
7.2.2 Summary of in-line tags
8.1 Overview9 Purchasing AscToHTM, and contacts on the web
8.2 The frames generated
8.2.1 The master <FRAMESET> document8.3 Using policies to control the frame structure
8.2.2 The "main" frame
8.2.3 The "contents" frame
8.2.4 The "header" and "footer" frames
8.2.4.1 Non-frames use of HTML headers
8.2.4.2 "main" frame header
8.2.4.3 "header" frame
8.4 Using HTML fragments to override frame contents
8.5 NOFRAMES tag and NOFRAMES link
8.5.1 The "NOFRAMES" hyperlink8.6 Hyperlink targets
8.5.2 The <NOFRAMES> tag
8.5.3 Generating frames and non-frames versions
8.7 Splitting large files
8.8 Selecting "Output HTML as a set of FRAMES" in the Windows version
9.1 Purchasing AscToHTM10 Known problems
9.1.1 Why should I purchase AscToHTM?9.2 Contacts on the Web
9.1.2 What happens if I don't register the shareware version of AscToHTM?
9.1.3 Can't I get something for nothing?
9.1.4 I'm convinced. How to I purchase AscToHTM?
9.2.1 The home page
9.2.2 E-mail
9.2.3 Support
10.1 Bug reports11 Change History
10.2 Features
10.3 Coming soon... or not.
11.1 Version 4.1 (August 2001)
11.1.1 New functions11.2 Version 4 (May 2001)
11.1.2 Other Changes
11.2.1 New functions11.3 Version 3.3 (June 2000)
11.2.2 Other changes
11.3.1 New functions11.4 Version 3.2 (October '99)
11.3.2 Other changes
11.4.1 New functions11.5 Version 3.0 (August '98)
11.4.2 Other changes
11.5.1 New functions11.6 Version 2.3 (late April '98)
11.5.2 Other changes
11.6.1 New functions11.7 Version 2.20 (Feb '98)
11.6.2 Other changes
11.7.1 New functions11.8 Version 2.10 (never officially released)
11.7.2 Other changes
11.8.1 New functions11.9 Version 2.00 (October '97)
11.8.2 Other changes
11.9.1 New functions11.10 Version 1.1 (August '97)
11.9.2 Other changes
11.10.1 New functions11.11 Version 1.05 (late July '97)
11.10.2 Other changes
11.11.1 New functions11.12 Version 1.04 (early July '97)
11.11.2 Other changes
11.12.1 New functions11.13 Version 1.01 (April '97)
11.12.2 Other changes
Converted from
a single text file by
AscToHTM © 1997-2001 John A Fotheringham |