{\rtf1\ansi\ansicpg1252\uc1 \deff100\deflang1033\deflangfe1033 {\fonttbl {\f1\froman\fcharset2\fprq2 Symbol;} {\f2\fmodern Courier New;} {\f4\froman\fcharset0\fprq2 Times New Roman;} {\f5\fswiss\fcharset0\fprq2 Arial;} {\f100\fswiss\fprq2\fcharset0 Times New Roman;} {\f101\fswiss\fprq2\fcharset0 Times New Roman;} {\f111\fswiss\fprq2\fcharset0 Times New Roman;} {\f112\fswiss\fprq2\fcharset0 Times New Roman;} {\f113\fswiss\fprq2\fcharset0 Times New Roman;} {\f114\fswiss\fprq2\fcharset0 Times New Roman;} {\f115\fswiss\fprq2\fcharset0 Times New Roman;} {\f102\fswiss\fprq2\fcharset0 Times New Roman;} {\f103\fmodern\fprq1\fcharset0 Courier New;} {\f104\fmodern\fprq1\fcharset0 Courier New;} {\f105\fmodern\fprq1\fcharset0 Courier New;} {\f106\fswiss\fprq2\fcharset0 Arial;} {\f161\fswiss\fprq2\fcharset0 Arial;} {\f162\fswiss\fprq2\fcharset0 Arial;} {\f163\fswiss\fprq2\fcharset0 Arial;} {\f164\fswiss\fprq2\fcharset0 Arial;} {\f165\fswiss\fprq2\fcharset0 Arial;} {\f166\fswiss\fprq2\fcharset0 Arial;} {\f107\fswiss\fprq2\fcharset0 Times New Roman;} {\f171\fswiss\fprq2\fcharset0 Times New Roman;} {\f172\fswiss\fprq2\fcharset0 Times New Roman;} {\f173\fswiss\fprq2\fcharset0 Times New Roman;} {\f174\fswiss\fprq2\fcharset0 Times New Roman;} {\f175\fswiss\fprq2\fcharset0 Times New Roman;} {\f176\fswiss\fprq2\fcharset0 Times New Roman;} } {\colortbl;\red0\green0\blue0;\red0\green0\blue255; \red0\green255\blue255;\red0\green255\blue0; \red255\green0\blue255;\red255\green0\blue0; \red255\green255\blue0;\red255\green255\blue255; \red0\green0\blue128;\red0\green128\blue128; \red0\green128\blue0;\red128\green0\blue128; \red128\green0\blue0;\red128\green128\blue0; \red128\green128\blue128;\red192\green192\blue192;} {\stylesheet{\widctlpar \f4\fs20\lang1033 \snext0 Normal;} {\s0\sb60\sa60\widctlpar \f100\fs20\kerning28\qj \sbasedon0 Normal;} {\s1\sb60\sa60\widctlpar \f101\fs20\kerning28\qj \sbasedon0 Body;} {\s11\widctlpar \f111\fs20\kerning28\qj \sbasedon1 Short line;} {\s12\sb30\widctlpar \f112\fs20\kerning28\qj \sbasedon1 Bullet;} {\s13\widctlpar \i\f113\fs20\kerning28 \sbasedon1 Quotes;} {\s14\sb60\sa60\widctlpar \f114\fs20\kerning28\qj \sbasedon1 Hanging list;} {\s15\sb120\sa120\widctlpar \f115\fs20\kerning28\qj \sbasedon1 Definition;} {\s2\widctlpar \f102\fs20\kerning28 \sbasedon0 Table;} {\s3\widctlpar \f103\fs16\kerning28 \sbasedon0 Preformatted;} {\s4\widctlpar \f104\fs16\kerning28 \sbasedon0 Diagram;} {\s5\widctlpar \f105\fs16\kerning28 \sbasedon0 Code;} {\s6\sb240\sa120\widctlpar \b\f106\fs20\kerning28 \sbasedon0 All Headings;} {\s61\sb240\sa120\keepn\widctlpar \b\f161\fs28\kerning28 \sbasedon6 Heading 1;} {\s62\sb180\sa120\keepn\widctlpar \b\i\f162\fs24\kerning28 \sbasedon6 Heading 2;} {\s63\sb180\sa120\keepn\widctlpar \b\f163\fs24\kerning28 \sbasedon6 Heading 3;} {\s64\sb180\sa60\keepn\widctlpar \b\i\f164\fs20\kerning28 \sbasedon6 Heading 4;} {\s65\sb180\sa60\keepn\widctlpar \b\i\f165\fs20\kerning28 \sbasedon6 Heading 5;} {\s66\sb180\sa60\keepn\widctlpar \b\i\f166\fs20\kerning28 \sbasedon6 Heading 6;} {\s7\widctlpar \f107\fs20\kerning28 \sbasedon0 All TOC;} {\s71\sb60\widctlpar \b\f171\fs22\kerning28 \sbasedon7 TOC 1;} {\s72\li200\sb30\widctlpar \i\f172\fs20\kerning28 \sbasedon7 TOC 2;} {\s73\li400\widctlpar \f173\fs20\kerning28 \sbasedon7 TOC 3;} {\s74\li600\widctlpar \f174\fs18\kerning28 \sbasedon7 TOC 4;} {\s75\li800\widctlpar \f175\fs18\kerning28 \sbasedon7 TOC 5;} {\s76\li21000\widctlpar \f176\fs18\kerning28 \sbasedon7 TOC 6;} {\*\cs10 \additive Default Paragraph Font;} {\*\cs32 \additive \ul\cf2 \sbasedon10 Hyperlink;} {\*\cs33 \additive \f5\fs20\sbasedon10 footnote reference;} } {\info {\title Converted from "a2hdoco.txt" on 23-Feb-2004 by [[PROGRAM]]} {\operator AscToRTF auto-convert} {\creatim\yr2004\mo1\dy23\hr23\min28} {\version1}{\edmins0}{\nofpages1} } \paperw11906\paperh16838\margl1800\margr1800\margt1440\margb1440\gutter0 \widowctrl\ftnbj\aenddoc\formshade \fet0\sectd \linex0\headery709\footery709\colsx709\endnhere {\*\pnseclvl1\pnucrm\pnstart1\pnindent720\pnhang{\pntxta .}} {\*\pnseclvl2\pnucltr\pnstart1\pnindent720\pnhang{\pntxta .}} {\*\pnseclvl3\pndec\pnstart1\pnindent720\pnhang{\pntxta .}} {\*\pnseclvl4\pnlcltr\pnstart1\pnindent720\pnhang{\pntxta )}} {\*\pnseclvl5\pndec\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}} {\*\pnseclvl6\pnlcltr\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}} {\*\pnseclvl7\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}} {\*\pnseclvl8\pnlcltr\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}} {\*\pnseclvl9\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj{ }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The 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. \par The source text file for this manual is over 5,000 lines and {\b still\b0} growing having spawned the 6,500 line [Policy Manual] and a 3,800 line [Tag Manual]. See section {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0036005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.1}}} of this document to see a list of the actual files involved. \par Any RTF version has been generated by the new text-to-RTF program AscToRTF which uses the same analysis engine as AscToHTM. \par This document describes AscToHTM version 4, which is available from May 2001 onwards. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj{ {\field{\*\fldinst {\kerning0 TOC \\* MERGEFORMAT }}{\fldrslt {\b (Update this field (F9) to get Contents list) }}}\par \par \par}} {\*\bkmkstart Section_1} {\*\bkmkend Section_1} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{1 Introduction\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM is an ASCII to HTML conversion tool. It has, of course, been used to generate the HTML version of this document from the text file a2hdoco.txt (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0036005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 an example conversion}}} for more details). \par The HTML version of this document is presented "as is". That is, {\b no post-production of the HTML has occurred\b0}. This should give you a flavour of what AscToHTM is capable of. \par Any RTF version of this document will have been made by [AscToRTF], the sister product that shares the same text analysis engine. \par AscToHTM is made available for download via the Internet from [download location]. \par \par}} {\*\bkmkstart Section_1_1} {\*\bkmkend Section_1_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{1.1 AscToHTM's design objectives\par}} {\*\bkmkstart Section_1_1_1} {\*\bkmkend Section_1_1_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{1.1.1 Intelligent analysis.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM is designed to analyse a document to determine its structure and layout. This analysis allows AscToHTM to decide how best to mark up the HTML so as to accurately represent the author's original meaning as far as possible. \par This analysis helps AscToHTM to reduce errors by allowing it to spot anomalies in the document source. This is important in minimising the amount of any post-production work required to fix errors. \par \par}} {\*\bkmkstart Section_1_1_2} {\*\bkmkend Section_1_1_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{1.1.2 Human-readable HTML\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM tries to create HTML that can be easily read and modified in an editor. This is useful if corrections are necessary, or further development is required. \par For example AscToHTM \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {a)\tab}produces short (usually <80 character) output lines \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {b)\tab}attempts to indent the HTML to match the output indentation. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {c)\tab}adds comments to the HTML to indicate include files etc. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {d)\tab}uses
tags for indentation, rather than placing the whole file in...
tags. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {e)\tab}produces "clean" HTML without large numbers of unnecessary tags.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Note, later moves to make more standards-compliant and browser-compatible HTML code tend to work against making user-readable code. For example most browsers have rendering problems when newline characters are placed in certain key locations, whereas adding newline characters can make the HTML easier to read. \par \par}} {\*\bkmkstart Section_1_1_3} {\*\bkmkend Section_1_1_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{1.1.3 Simple user input\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Inevitably users have supply additional information to tell AscToHTM where its analysis has gone wrong and to add additional information such as a document title etc. AscToHTM offers a large number of options (also known as "policies") that the user can modify. \par Broadly speaking, these policies fall into two camps \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}{\b Analysis policies\b0}. These policies affect the way AscToHTM analyses your file, and can be used to disable searches for things like bullets, or to specify whether or not underlined headings are to be expected. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}{\b Output policies\b0}. These policies influence the types of HTML markup that are produced. They also allow you add colour, headers footers, background images and much more to your pages.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can save your policies to a file, so that next time you run it you can load this information back from the "policy" file. This also allows you to create different sets of policies (e.g. to use different colour schemes). \par Policies are described fully in the [Policy Manual]. \par You can further refine the conversion by placing special lines and tags into your source file. These are known as pre-processor commands (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Using the preprocessor}}}) and in-line tags (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0037005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 In-line tags}}}). \par The preprocessor tags are described fully in the [Tag Manual] \par To help users formulate and modify their document's policy, AscToHTM can be made to create an output policy file (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_2_2_9" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0032005f0032005f0039000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.2.2.9}}}). Users can then simply edit this file and feed it back into the conversion process. \par A summary of the recognised policy lines is given in the [Policy manual]. \par \par}} {\*\bkmkstart Section_1_1_4} {\*\bkmkend Section_1_1_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{1.1.4 Standards compliance.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Earlier versions of AscToHTM (before version 3.2) made no real attempt to be standards compliance. Now standards compliance is a stated goal or the program. Sadly I can't {\i guarantee\i0} standards compliance because the HTML generation is so complex that errors can and do occur, but it {\i is\i0} a goal, and usually documents will validate with few problems. \par Compliance has proved to be vital to get cross-browser compatability, and to stand a chance of successfully applying CSS to created pages. \par Original versions of AscToHTM were (loosely) targeted at producing HTML 3.2 code. \par Currently the software is targeted at "HTML 4.0 Transitional", which allows CSS, but also permits tags (although these are deprecated). This is a compromise standard that is best placed to be well viewed by V3 and V4 browsers. \par Future versions of the program may attempt to generate stricter HTML 4.0 code, while still offering production of the earlier HTML standards. \par The policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_version_to_be_targeted }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000480054004d004c002000760065007200730069006f006e00200074006f002000620065002000740061007200670065007400650064000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f00760065007200730069006f006e005f0074006f005f00620065005f00740061007200670065007400650064000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML version to be targeted}}} offers some ability to choose the style of HTML generated. \par \par}} {\*\bkmkstart Section_1_2} {\*\bkmkend Section_1_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{1.2 Expected uses of AscToHTM\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Placing text files quickly and easily on the web\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Plain text is still a very popular data format. It is easy to generate, and easy to read. However text files when placed on the web don't look as nice as normal web pages. AscToHTM will allow you to quickly add the HTML markup required to turn a plain text page into a nice looking HTML page. Because it is an automated conversion it will save you time, and ensure you avoid typos in HTML tags that could stop the page displaying wrongly in some web browsers. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Migration of "legacy" text to HTML.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Large amounts of unconverted text exist. As people plan to put this information on the Web, conversion to HTML will become necessary. \par This can be a tedious and time-consuming task. AscToHTM will do much of the work for you. \par AscToHTM is priced to be worth an hour of two of your time. This means that the "pay back" time is negligible (we only mention this in case you have bean-counters to convince :). If you don't think AscToHTM will save you hours, then by all means don't buy it. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Facilitate mastering of HTML pages in ASCII\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ The HTML created by AscToHTM may not be as pretty or as clever as that generated by a full blown HTML editor (read as "bloated"). \par But... \par It'll be easier to write, edit and spell-check, and it may have a hyperlinked contents list generated. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Automated conversions\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM can be used to automatically convert text documents that you receive. For this we usually suggest you run in command line mode. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Conversion of reports to HTML\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Many people have legacy systems that generate printed reports that may be saved to file. AscToHTM can help extend the lifetime of such systems by turning their output to HTML. It may be you'll need some help in getting the best results from the program in such cases, since many reports consist of complex tables. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Conversion print spool files to HTML\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Printer spool files are not strictly speaking plain text, but often - especially in older software systems - these files are plain text with a few printer controls added. Some users have had great success converting such files using asctohtm, and to support this we have added a limited ability to recognise and strip out Unix control characters, VT escape sequences and PCL printer codes. If you have a requirement in this area, contact the author at {\field{\*\fldinst {\fs20 HYPERLINK mailto:info@jafsoft.com }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001100000069006e0066006f0040006a006100660073006f00660074002e0063006f006d000000e0c9ea79f9bace118c8200aa004ba90b300000006d00610069006c0074006f003a0069006e0066006f0040006a006100660073006f00660074002e0063006f006d000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 info@jafsoft.com}}} to discuss whether the software can be made to meet your needs. \par \par}} {\*\bkmkstart Section_1_3} {\*\bkmkend Section_1_3} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{1.3 Other uses of AscToHTM\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Convert Word documents\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Please note, AscToHTM {\b DOES NOT\b0} convert Word's .doc or .rtf file formats. \par AscToHTM was {\i never\i0} intended to handle Word documents. We fully expect HTML export and import filters to appear (they have in Word '97), and we would advise anyone whose master document is in Word to search out these filters and give them a try. \par That said... a lot of people seem unhappy with what's already available, and AscToHTM does a reasonable job if you save the file as text with line breaks, though obviously tables and figures will get lost (in the case of tables, because Word throws them away). \par The main problem is that Word produces lousy looking text. This is one area where AscToHTM does a little better than "garbage in, garbage out" \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Pre-process text for import to Word.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ (This is a bit cheeky, but does actually work.). \par Use AscToHTM to convert text to HTML, then import this into your word processing package. Since the text analysis engine in AscToHTM out-performs that in Word in many respects (URL, table and heading detection to name but three), you can often get better results than importing from text direct.. \par That's because AscToHTM's analysis engine is {\b smarter\b0}. That's not just our view (see {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/asctohtm/reviews.html }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002d00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0061007300630074006f00680074006d002f0072006500760069006500770073002e00680074006d006c000000e0c9ea79f9bace118c8200aa004ba90b5a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0061007300630074006f00680074006d002f0072006500760069006500770073002e00680074006d006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 http://www.jafsoft.com/asctohtm/reviews.html}}}) \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li1080{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b NOTE\b0}\tab The same text analysis engine is used in the text-to-RTF program [AscToRTF], which is more suited to this purpose.\par} \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Pre-process text for printing\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Use AscToHTM to convert text to HTML, then print the file from within Netscape or whatever. The result is a much nicer looking document with fonts'n'stuff. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Add hyperlinks to fairly ordinary pages.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM has a "link dictionary" feature that can be used to add hyperlinks to any word or phrase (see the [Policy Manual]). \par This can greatly enhance an otherwise dull set of text pages. \par \par}} {\*\bkmkstart Section_2} {\*\bkmkend Section_2} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{2 Installation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The shareware version of AscToHTM is made available over the web from [Download location]. Once you register you can download the full version (no nags, no limits), and will be notified of upgrades. To date all upgrades have been free, but we cannot guarantee that this policy will continue for ever. So far I've {\b never\b0} requested payment for any [updates] in over 4 years of continuous development. You can see this history in the {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_11" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000b000000530065006300740069006f006e005f00310031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Change History}}} \par Installation will vary according to the type of install kit you've downloaded, but in each case you first download the .ZIP file appropriate to your system and unzip. \par \par}} {\*\bkmkstart Section_2_1} {\*\bkmkend Section_2_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{2.1 VMS installation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Unzip the files. \par If you've taken an executable version, that's it. \par If you've taken an object library version, execute the build command file. \par You might want to define a foreign command to get better use out of the program. \par Have a cup of coffee and relax :) \par \par}} {\*\bkmkstart Section_2_2} {\*\bkmkend Section_2_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{2.2 Windows installation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The current version of the software makes updates to your Registry. See the Install notes that come with the software for a description of the registry settings used. \par The Windows version requires certain .DLLs. In earlier versions these were supplied separately, with the result that the download size was doubled. The software is "statically linked", meaning you don't need to worry about having the correct DLLs. The price is a slightly larger .exe file. \par \par}} {\*\bkmkstart Section_2_2_1} {\*\bkmkend Section_2_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{2.2.1 Install/uninstall version\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If you've taken a version with install/uninstall help, unzip the file and then run the setup.exe program. This will move the files to a directory, and create all icons etc. \par Once installed, your computer will offer an uninstall option. You can access this via Control Panel | Add/remove software. \par The install/uninstall version is substantially larger than the manual install versions. This means some people experience problems downloading the file. \par For this reason smaller kits without the install/uninstall help are available (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_2_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0032005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 2.2.2}}}) \par \par}} {\*\bkmkstart Section_2_2_2} {\*\bkmkend Section_2_2_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{2.2.2 Simple .ZIP file version\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This version should be used by anyone who anticipates problems with the install/uninstall version, or who simply wishes to upgrade an existing version. \par It's several times smaller than the install/uninstall version. \par Once you've unzipped the files, move them to your preferred directory. \par There will be no uninstall command in this case (unless you are overlaying an earlier installed version). \par \par}} {\*\bkmkstart Section_2_2_3} {\*\bkmkend Section_2_2_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{2.2.3 Console application\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Originally AscToHTM was only available as a console application. Now it is available as a fully-windowed application. Consequently this version is not so widely available. \par The console version is made available to registered users who wish it, as it is more suited for automated conversions inside batch jobs etc. \par The conversion engine is identical in each case, it's just GUI-less. \par Please note, this is {\b not\b0} the same as the DOS version that we once to produce, and will require a Win32 environment. The DOS version is no longer available. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab In later versions of the program the Windows version of supports both the console and Windowed interfaces in a single program. As a result only the Windows version is shipped by default. A separate console version (A2HCONS) will be supplied free of charge to registered users who have a specific requirement (e.g. they want to run AscToHTM from a command file)\par} \par}} {\*\bkmkstart Section_3} {\*\bkmkend Section_3} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{3 How AscToHTM works\par}} {\*\bkmkstart Section_3_1} {\*\bkmkend Section_3_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{3.1 The big assumption\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM makes one big assumption :- \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\b Each text file has been laid out in a consistent manner by its author in a way that makes it easy for a human reader to understand.\b0} \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Given this, AscToHTM tries to read the text file and mark it up in HTML accordingly. This is achieved by making three passes through the document, an analysis pass (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_3_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0033005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 3.2}}}), a collating pass (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 3.3}}}), and an output pass (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_3_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0033005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 3.4}}}). \par Note: Sadly this assumption is not always true \par \par}} {\*\bkmkstart Section_3_2} {\*\bkmkend Section_3_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{3.2 The analysis pass\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ During the analysis pass AscToHTM gathers together all the statistics that it needs to analyse how the author has laid out the file. \par For example, the distribution of line indentations and line lengths is observed, together with the number and types of bullets, section headings and lots of other stuff. \par Once this has been done, the program uses this data to determine the rules used by the author in structured their document. For example are the section headings underlined, capitalised or numbered? If numbered, what style of numbering is used, and by how many characters is each type of heading indented? \par This information is then used to set the analysis polices (see the [Policy Manual]) which may then be overridden by the user (to correct errors), or by loading a policy file with different values. \par \par}} {\*\bkmkstart Section_3_3} {\*\bkmkend Section_3_3} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{3.3 The collating pass\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Having performed the analysis, the program makes a second "collating" pass. This is effectively a dry run for the output pass. \par During this pass the program determines how the file will be output into one or more output files and where certain key in-line tags occur. \par It also assembles any contents list. \par This information is then used during the output pass to reduce the likelyhood of errors, and to ensure all internal hyperlinks are valid and will point to the correct anchor point in the correct output file. \par \par}} {\*\bkmkstart Section_3_4} {\*\bkmkend Section_3_4} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{3.4 The output pass\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ During the output pass AscToHTM \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}generates the HTML\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ and (optionally) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}creates a suite of inter-linked HTML pages\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}creates a set of FRAMES to place the HTML pages into\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}copies the HTML to the Windows clipboard\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}generates a contents list\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}generates a directory page\par}} {\*\bkmkstart Section_3_4_1} {\*\bkmkend Section_3_4_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{3.4.1 Generating HTML\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The HTML generated depends on \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}the original document, including any preprocessor tags placed in the source document.\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}the calculated document policy, modified by any user policies supplied\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}any [HTML fragments] that are defined\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML markup produced}}} describes the markup produced in more detail. \par \par}} {\*\bkmkstart Section_3_4_2} {\*\bkmkend Section_3_4_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{3.4.2 Generating a contents list\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can detect the presence of a (numbered) contents list in the original document. Alternatively you can choose (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents generation policies}}}) to have AscToHTM to generate a contents list for you, in which case any original list is omitted from the output HTML document. \par Regardless of whether the original or generated contents list is used, AscToHTM will turn the contents list into hyperlinks that will take you to the correct HTML file and location. \par There is a fuller discussion of {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 contents lists}}}. The policies that influence contents list production are listed in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents generation policies}}}, whilst the pre-processor commands are described in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.3}}}. \par \par}} {\*\bkmkstart Section_3_4_3} {\*\bkmkend Section_3_4_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{3.4.3 Splitting the document into many HTML pages\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ By default AscToHTM creates a single .HTML file. However, through file organisation document policies (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_6" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0036000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 File generation policies}}}) it is possible to \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}Split the document into a number of smaller .HTML files (see the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#split_level }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c000000530070006c006900740020004c006500760065006c000000e0c9ea79f9bace118c8200aa004ba90b7a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730070006c00690074005f006c006500760065006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Split Level}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}Insert standard JavaScript into the ... section of each page (see also the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_script_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c0020007300630072006900700074002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f007300630072006900700074005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML script file}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {c)\tab}Add a HTML "header" to the top of each generated file (see also the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_header_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c0020006800650061006400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f006800650061006400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML header file}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {d)\tab}Add a navigation bar at the foot of each page with links to the Next/Previous .HTML page and the contents list (see also the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_navigation_bar }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000041006400640020006e0061007600690067006100740069006f006e0020006200610072000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f006e0061007600690067006100740069006f006e005f006200610072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add navigation bar}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {e)\tab}Add a HTML "footer" to the end of each generated page (see also the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_header_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c0020006800650061006400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f006800650061006400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML header file}}})\par}} \par {\*\bkmkstart Section_3_4_4} {\*\bkmkend Section_3_4_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{3.4.4 Generating a set of FRAMES\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par AscToHTM can place the HTML into a set of FRAMES. This is described fully in the chapter on {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_8" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0038000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Frames}}} \par \par}} {\*\bkmkstart Section_3_4_5} {\*\bkmkend Section_3_4_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{3.4.5 Generating HTML for the Windows clipboard\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par The Windows version of the software can place the HTML generated into the clipboard, rather than outputting it into a file. This makes it easier to paste the HTML into another application (such as a HTML editor). When this code of conversion is selected, the and tags are omitted from the output. \par The use of the clipboard is made even more powerful if a clipboard extender such as ClipMate is used. See {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/clipmate.html }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002500000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0063006c00690070006d006100740065002e00680074006d006c000000e0c9ea79f9bace118c8200aa004ba90b4a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0063006c00690070006d006100740065002e00680074006d006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 http://www.jafsoft.com/clipmate.html}}} \par \par}} {\*\bkmkstart Section_4} {\*\bkmkend Section_4} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{4 Running AscToHTM\par}} {\*\bkmkstart Section_4_1} {\*\bkmkend Section_4_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{4.1 Windows version\par}} {\*\bkmkstart Section_4_1_1} {\*\bkmkend Section_4_1_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.1.1 Launching the program\par}} {\*\bkmkstart Section_4_1_1_1} {\*\bkmkend Section_4_1_1_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.1.1 Normal activation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ 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. \par \par}} {\*\bkmkstart Section_4_1_1_2} {\*\bkmkend Section_4_1_1_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.1.2 Execution from a command line\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ From a Windows console command prompt you can type \par \b0 \i }} {\pard\plain \s13 \f113\fs20\b0\i\i\li720{ C:> AscToHTM\par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ or \par \b0 \i }} {\pard\plain \s13 \f113\fs20\b0\i\i\li720{ C:> AscToHTM...\par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In the first case, AscToHTM is launched as normal. \par In the second case AscToHTM will convert the specified files, briefly displaying a status window, and then exiting. In this case, one of the named files can be a .pol policy file. \par 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 large conversions, or conversions from within a batch file are advised to use the console version. Currently the console version is only being made available to registered users. \par \par}} {\*\bkmkstart Section_4_1_1_3} {\*\bkmkend Section_4_1_1_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.1.3 Drag'n'Drop execution\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Create an Icon for AscToHTM, and simply drag'n'drop files onto it. The results are identical to those obtained by typing in the filenames as described in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_1_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0031005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.1.2}}}. \par Alternatively, run the program as normal and then drag files onto the running program. You can configure the program's behaviour in drag'n'drop operation by using the Settings | Drag'n'Drop menu. \par One useful suggestion is to add AscToHTM to your "SendTo" menu (shown when you right-click on a file). See the Windows help file for more details. \par See {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_4_6" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0034005f0036000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.4.6}}} for more suggestions on using desktop icons. \par \par}} {\*\bkmkstart Section_4_1_1_4} {\*\bkmkend Section_4_1_1_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.1.4 Output to the Windows clipboard\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par You can use the program to convert the file to HTML, and to copy the HTML into the Windows clipboard, ready for pasting into other applications (such as a HTML editor). \par To do this, launch the Windows program as normal, and set the Conversion Type on the main screen to "Output HTML to clipboard". \par The HTML copied to the clipboard will be without the and tags to make the HTML more suited to pasting into an existing HTML page. \par \par}} {\*\bkmkstart Section_4_1_2} {\*\bkmkend Section_4_1_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.1.2 Using the Windows Interface\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The Windows interface was re-vamped in version 3.0 and further enhanced in version 3.2. The main changes are \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Introduction of a Windows Menu to replace the old button bar\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}More options on this menu to make locating the correct features more accessible.\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}The policy property sheets no longer have to be closed when doing a conversion.\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Use of DDE to view results in browsers already running.\par}} {\*\bkmkstart Section_4_1_2_1} {\*\bkmkend Section_4_1_2_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.1 Doing a straightforward conversion\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ To do a simple conversion, simply enter the name of the file to be converted or use the "Browse" button to locate the file to be converted. \par Then press the "Convert file(s)" button. \par A status screen is displayed whilst the conversion is in progress. For small files this may flash up so fast you can't actually read it. (If you want to see what it said go to the View...Messages menu option) \par To view the HTML, press the "View results" button. This should launch your preferred HTML viewer to display the newly created HTML page. If you want to automate that process, edit the program's viewer settings (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_2_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0032005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.2.4}}}). \par \par}} {\*\bkmkstart Section_4_1_2_2} {\*\bkmkend Section_4_1_2_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.2 The File menu\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The File menu has the following options: \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Convert\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Initiates the conversion. If you already have a file selected, this file is converted. If you don't, then a browse window will open allowing you to choose a file to convert. \par This option is identical to pressing the "Convert files" button. \par \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Load policies from file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option allows you to load a set of policies previously saved to a policy file. This allows a conversion to be repeatedly done the same way, or a set of conversions to be done the same way (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0036005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.5}}}) \par Note, you can set a policy file to be used by default see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0031005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3}}}. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Save policies to file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option allows you to save your current set of policies to a policy file for later re-use. It is recommended that only a partial set of policies (i.e. any loaded policies and manually set policies) be saved to allow the program maximum flexibility when converting future files. \par See section {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0036005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.5}}} and the discussion in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_5_2_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0036005f0035005f0032005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.5.2.1}}} \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Exit\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Exits the program \par \par}} {\*\bkmkstart Section_4_1_2_3} {\*\bkmkend Section_4_1_2_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.3 The Conversion options menu\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM offers the advanced user a large number of program options. These are called policies, and may be saved in policy files for later re-use. Policy files are described in detail in Chapter 6 of this document. \par Policies broadly come in two sorts. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Analysis policies\b0} represent a description of what the source file does and does not contain. These policies are usually set to default values and/or calculated by analysing the source document. They should only ever need to be manually adjusted if you wish to correct the analysis, or override the detection of certain typographical features. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Output policies\b0} represent styling and other options that cannot be inferred from the source document. These include styling and markup options, and allow the user to "add value" to the HTML generated.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The Conversion Options menu has options to allow you to view and change many of the program's policies (but not all, see the [Policy Manual] for details). \par The menu also has options to \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Load, or change, the policy file used\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ These options allow you to browse for and open the policy file that you want to use. Essentially they are identical to the load option on the File menu (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.2.2}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Reload policies from file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This allows you to reload the policy file (e.g. because you've just edited it by hand) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Save policies to file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This allows you to save the current policies to file for later reuse. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Re-analyze the file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option forces AscToHTM to re-analyse the current source file to (re-)calculate the analysis policies. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Reset to defaults\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option forces all policies back to their AscToHTM defaults. This will negate the effect of any manually set policies, or policies loaded from a policy file. \par \par}} {\*\bkmkstart Section_4_1_2_4} {\*\bkmkend Section_4_1_2_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.4 The Settings menu\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The Settings menu allows you to tailor the way in which the program executes. These settings will usually be saved in your Registry so that they are remembered for next time. \par The Settings menu includes options for \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Documentation\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Specifies the location of the program's documentation on your hard disk (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0033005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3.1}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Diagnostics\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Specifies the level and type of error reporting wanted during the conversion (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0033005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3.2}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Drag and drop execution\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Specifies the program's behaviour when invoked by dragging files onto the program's icon (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3.3}}}.). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Viewers for results files\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Specifies the browser to be used to view results files, and how it should be invoked (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0033005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3.4}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Use of policy files\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Specifies any default policy file to be used (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0031005f0033005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3.5}}}). \par \par}} {\*\bkmkstart Section_4_1_2_5} {\*\bkmkend Section_4_1_2_5} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.5 The Language menu\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The language menu allows you to change the language used in the user interface. These translations are provides by a group of volunteers. Currently translations exist for :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}English\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}German\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b New in Version 4\b0} Italian\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Spanish\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Portuguese\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The software supports the concept of language "skins" which allow the user interface to be exported to an external file which may be edited and then re-loaded. This allows users to offer their own translations, or to correct errors in the existing translations. \par You can read more in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Language support}}} \par \par}} {\*\bkmkstart Section_4_1_2_6} {\*\bkmkend Section_4_1_2_6} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.6 The View menu\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Messages from last conversion\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option allows you to re-view the Messages window displayed during file conversion. On small files this window can sometime be shown too briefly to view the messages. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Results of last conversion\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option will launch the preferred browser for the last file converted. If a wildcard conversion was done, the last file in the group is shown. This option has the same effect as the "View results" button. \par \par}} {\*\bkmkstart Section_4_1_2_7} {\*\bkmkend Section_4_1_2_7} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.2.7 The Help menu\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Contents\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option brings up the Windows help file. This offers a lot of context-sensitive help which can usually be accessed by pressing F1 or "Help" anywhere in the program. \par Over time the Windows Help file has adopted a secondary role compared to the HTML documentation. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Register/check updates\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option takes you to the web page offering registration details or (if you've already registered) listing recent updates. \par Currently the registration page is {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/asctohtm/register_online.html?from=doco }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000003f00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0061007300630074006f00680074006d002f00720065006700690073007400650072005f006f006e006c0069006e0065002e00680074006d006c003f00660072006f006d003d0064006f0063006f000000e0c9ea79f9bace118c8200aa004ba90b7e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0061007300630074006f00680074006d002f00720065006700690073007400650072005f006f006e006c0069006e0065002e00680074006d006c003f00660072006f006d003d0064006f0063006f000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 http://www.jafsoft.com/asctohtm/register_online.html?from=doco}}} \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b HTML documentation\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option allows you to view the HTML documentation for the software. You can either view your local copy from your hard disk, or read the version on the web site (you'll need to connect to the Internet in that case). \par Each installation of AscToHTM comes complete with HTML documentation. Should you decide to move your copy of the documentation, you'll need to alter the settings (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0031005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1.3}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b Other products\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ A list of web pages describing other JafSoft Limited products that may be of interest to you. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b About\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This option launches the About screen. This gives program version information, shows your registration status, and provides a couple of buttons to access the home page and other pages on the Web. \par \par}} {\*\bkmkstart Section_4_1_3} {\*\bkmkend Section_4_1_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.1.3 Program settings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These settings allow you to customize the program's behaviour to a limited extend. \par \par}} {\*\bkmkstart Section_4_1_3_1} {\*\bkmkend Section_4_1_3_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.3.1 Documentation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Allows you to specify the location of the HTML documentation for the program on your machine. By default this is the same as the program directory, and you should only need to change this if you move it. \par \par}} {\*\bkmkstart Section_4_1_3_2} {\*\bkmkend Section_4_1_3_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.3.2 Diagnostics\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Allows you to select the level of detail you want in the messages displayed during conversion. You can also elect to suppress messages by type. \par \par}} {\*\bkmkstart Section_4_1_3_3} {\*\bkmkend Section_4_1_3_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.3.3 Drag and drop execution\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Allows you to specify how you want the program to behave when it is launched by dropping files into the program, or its icon on the desktop. \par \par}} {\*\bkmkstart Section_4_1_3_4} {\*\bkmkend Section_4_1_3_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.3.4 Results viewers\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Allows you to specify the HTML browser to be used to view the created HTML. You can elect to always invoke a results viewer after conversion, and to use DDE to achieve this. \par DDE allows the program to tell an existing browser to display the results. Without DDE a new instance of the browser is launched each time. The behaviour of the browser when sent the results file varies from browser to browser. \par If the DDE call fails for any reason, a new instance of the default browser is launched, so you should ensure this is the same browser as that identified for DDE. \par This dialog also allows an RTF viewer to be selected. This may be used for viewing RTF files, although it's possible that at present your version of the program doesn't require this yet. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b NOTE\b0}\tab On some systems DDE doesn't always work properly. This would cause the program to hang when it attempted to display results. In such cases you would need to stop the program from the task manager. The program will now detect when this has happened and disable use of DDE next time it runs. You can re-enable it using the {\i Settings | Viewers\i0} menu option\par} {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b NOTE\b0}\tab Whereas DDE works fine with Netscape versions up to and including 4.7, it doesn't work with Netscape 6.0 since initial versions of that browser don't support DDE under Windows\par} \par}} {\*\bkmkstart Section_4_1_3_5} {\*\bkmkend Section_4_1_3_5} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.3.5 Use of policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Allows a default policy file to be specified. This is not normally desirable, but if you always use the same policy file, this will save you having to load it each time you run the program. \par You can also elect to always reload the policy file during conversion. This should only be necessary if you're repeatedly changing the policy file in a text editor between conversions while the program is running. \par Note, an alternative to using a default policy file is to define a desktop icon with the policy file specified on the command line (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_4_6" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0034005f0036000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.4.6}}}) \par \par}} {\*\bkmkstart Section_4_1_4} {\*\bkmkend Section_4_1_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.1.4 Language support\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ There is an ongoing effort to make AscToHTM available in more languages. This effort is being undertaken by a number of volunteers. It's unlikely that full translations of User Interface, error messages, help files and documentation will be available in all languages, but the hope is to make the program a little easier for those whose first language is not English. \par Please note that the author only speaks English, and thus can only offer support in English. \par Elements that may be converted include :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Menu Text\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Window Text\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}ToolTips\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Less likely to be translated are :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Messages\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Windows help file\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}HTML documentation\par}} {\*\bkmkstart Section_4_1_4_1} {\*\bkmkend Section_4_1_4_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.4.1 Existing translations\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Depending on how far the process has gone (and how many changes have been made recently) not all text may be in your selected language. \par Currently translations exist for :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}English (British)\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}German\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Portuguese\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Spanish\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b New in version 4\b0} Italian\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ My thanks to all those involved. If you'd like to get involved in this effort, visit \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/products/translations.html }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000003200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f00700072006f00640075006300740073002f007400720061006e0073006c006100740069006f006e0073002e00680074006d006c000000e0c9ea79f9bace118c8200aa004ba90b6400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f00700072006f00640075006300740073002f007400720061006e0073006c006100740069006f006e0073002e00680074006d006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 http://www.jafsoft.com/products/translations.html}}} \par \par}} {\*\bkmkstart Section_4_1_4_2} {\*\bkmkend Section_4_1_4_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.1.4.2 Adding translations using "Language skins"\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The program now supports the concept of language "skins". This allows the existing translation to be exported to a text file called a "language skin". This file consists of one line per translation per line, with a unique number at the start of the line identifying the text, and then the text itself. \par You can edit this file - conventionally with a .lng extension - to contain your own versions of the strings, and then reload this back into the program via the Language menu. The changes will take immediate effect, and are remembered next time you run the program. \par Using this technique we can now offer via and American spellchecker and the translation services of {\field{\*\fldinst {\fs20 HYPERLINK http://babelfish.altavista.com/ }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002000000068007400740070003a002f002f0062006100620065006c0066006900730068002e0061006c0074006100760069007300740061002e0063006f006d002f000000e0c9ea79f9bace118c8200aa004ba90b4000000068007400740070003a002f002f0062006100620065006c0066006900730068002e0061006c0074006100760069007300740061002e0063006f006d002f000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 http://babelfish.altavista.com/}}} three new languages :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}American English\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}"Babelfish" French\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These translations are not expected to be ideal, but they offer a starting point. If anyone cares to mail me corrected version I'll happily make these available... with full credit to the translator. \par Mail updates to {\field{\*\fldinst {\fs20 HYPERLINK mailto:translations@jafsoft.com }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000190000007400720061006e0073006c006100740069006f006e00730040006a006100660073006f00660074002e0063006f006d000000e0c9ea79f9bace118c8200aa004ba90b400000006d00610069006c0074006f003a007400720061006e0073006c006100740069006f006e00730040006a006100660073006f00660074002e0063006f006d000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 translations@jafsoft.com}}} \par \par}} {\*\bkmkstart Section_4_2} {\*\bkmkend Section_4_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{4.2 VMS and console application versions\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The VMS version and windows console version behave identically in terms of their use of command arguments. \par A Linux version has also been beta tested. \par The Windows console version performs identically to the Windows version (which supports the command line operation), but is more suited to use inside batch operations. For example the Windows version is likely to gain focus when it executes, which can be distracting. \par The Windows console version is called A2HCONS (to distinguish it from the fully windowed version AscToHTM), but is only available to registered users of the software. \par \par}} {\*\bkmkstart Section_4_2_1} {\*\bkmkend Section_4_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.2.1 Command line arguments\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The command line should be of the form \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM [ ] [] \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Where \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li1080{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b Filespec\b0}\tab Any valid file specification for the system you're using. This can include wildcards.\par} }} { \trowd \trgaph108\trleft-108 \cellx522 \cellx846 \cellx1170 \cellx5284 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl \cell \cell \cell In the Windows version, this can also be space\cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft-108 \cellx522 \cellx846 \cellx1170 \cellx5284 \widctlpar\intbl\adjustright { \intbl \cell \cell \cell separated lists of files\cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li1080{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b Policy_file\b0}\tab The name of any policy file (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0036000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Using Document Policy files}}}) you want to use for the conversion. Policy files are recognised by having a .pol file extension. For this reason you cannot convert .pol files to HTML.\par} {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b Qualifiers\b0}\tab Extra commands that may be passed in via the command line. In most cases these are equivalent to policies, they're just made available on the command line for your convenience.\par} \par}} {\*\bkmkstart Section_4_2_2} {\*\bkmkend Section_4_2_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.2.2 Command line qualifiers\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Certain aspects of AscToHTM's behaviour can be changed by adding qualifiers to the command line. Qualifiers must begin with the slash (/) character but may be of mixed case and may be shortened provided they remain unique. So /H will get you help, whereas you can't use /S since that could be /SILENT or /SIMPLE \par \par}} {\*\bkmkstart Section_4_2_2_1} {\*\bkmkend Section_4_2_2_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.1 The /COMMA qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par Specifies that the source file is a comma-delimited table. In this case each line will become a row in a table, and each value separated by a comma will become a cell in the table. \par \par}} {\*\bkmkstart Section_4_2_2_2} {\*\bkmkend Section_4_2_2_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.2 The /CONSOLE qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Specifies that the HTML generated should be directed to the output stream, rather than to an output file. This is a step towards making the program more suited for use inside a web server, e.g. to dynamically convert text to HTML on demand, although it is expected this process has some distance to go yet. \par \par}} {\*\bkmkstart Section_4_2_2_3} {\*\bkmkend Section_4_2_2_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.3 The /CONTENTS qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This has exactly the same effect as the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000610064006400200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 add contents list}}} policy line. \par \par}} {\*\bkmkstart Section_4_2_2_4} {\*\bkmkend Section_4_2_2_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.4 The /DEBUG and /LIST qualifiers\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These qualifiers cause AscToHTM to generate some diagnostic files, which have extensions \par }} { \trowd \trgaph108\trleft612 \cellx1568 \cellx4386 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl .LIS1\cell an analysis before policy is set\cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx1568 \cellx4386 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl .LIS\par \cell an analysis after policy is set\par \cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx1568 \cellx4386 \widctlpar\intbl\adjustright { \intbl .STATS\cell a statistics file\cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The list files can assist in understanding how AscToHTM has interpreted your file. The .stats file is neither pretty, nor easy to read, but can in extreme cases assist in diagnosing faults should you wish to report them. \par If the /LIST qualifier is used, only the list files are created. If the /DEBUG qualifier is used the .stats file is also created. \par \par}} {\*\bkmkstart Section_4_2_2_5} {\*\bkmkend Section_4_2_2_5} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.5 The /DOS qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This has exactly the same effect as the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_dos_filenames }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000550073006500200044004f0053002000660069006c0065006e0061006d00650073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f0064006f0073005f00660069006c0065006e0061006d00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use DOS filenames}}} policy line \par \par}} {\*\bkmkstart Section_4_2_2_6} {\*\bkmkend Section_4_2_2_6} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.6 The /INDEX qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This has exactly the same effect as the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#make_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f0000004d0061006b00650020004400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0061006b0065005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Make Directory}}} policy line \par \par}} {\*\bkmkstart Section_4_2_2_7} {\*\bkmkend Section_4_2_2_7} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.7 The /LOG[=filespec] qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This specifies that a .log file should be created. This will contain a copy of all messages generated during the conversion, together with some that may have been suppressed. \par You can specify the log filespec. This can include wildcards, with the input file being used to replace any parts of the filename not specified. \par If omitted, the default log file name is AscToHTM.log \par \par}} {\*\bkmkstart Section_4_2_2_8} {\*\bkmkend Section_4_2_2_8} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.8 The /OUT=filespec qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This specifies where the output file(s) should be placed. It can include wildcards, with the input file being used to replace any parts of the filename not specified. \par Thus "/OUT=*.shtml" will result in a file with the same name, but a .shtml extension. In VMS "/OUT=[.sub]" will place the output in a sub-directory called "sub". \par If omitted, the output file is given the same name as the input file but with a .html extension. That behaviour may change dependant on the values of a number of other policies. \par \par}} {\*\bkmkstart Section_4_2_2_9} {\*\bkmkend Section_4_2_2_9} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.9 The /POLICY qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This has exactly the same effect as the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_policy_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004f0075007400700075007400200050006f006c006900630079002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f0070006f006c006900630079005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output Policy file}}} policy line. \par \par}} {\*\bkmkstart Section_4_2_2_10} {\*\bkmkend Section_4_2_2_10} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.10 The /SILENT qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This specifies that no messages should be displayed on the console. When used with the /CONSOLE qualifier (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_2_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0032005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.2.2.2}}}) this makes the program suitable for use in a web server, although you may need to use redirection under Windows. \par \par}} {\*\bkmkstart Section_4_2_2_11} {\*\bkmkend Section_4_2_2_11} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.11 The /SIMPLE qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This has exactly the same effect as the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#keep_it_simple }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f0000004b006500650070002000690074002000730069006d0070006c0065000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006b006500650070005f00690074005f00730069006d0070006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Keep it simple}}} policy line. \par \par}} {\*\bkmkstart Section_4_2_2_12} {\*\bkmkend Section_4_2_2_12} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.12 The /TABBED qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par Specifies that the source file is a tab-delimited table. In this case each line will become a row in a table, and each value separated by a tab will become a cell in the table. \par \par}} {\*\bkmkstart Section_4_2_2_13} {\*\bkmkend Section_4_2_2_13} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.2.2.13 The /TABLE qualifier\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par Specifies that the source file is a plain text table. In this the program will do its best to analyse the table structure, and reproduce it. \par \par}} {\*\bkmkstart Section_4_3} {\*\bkmkend Section_4_3} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{4.3 Getting the most from AscToHTM\par}} {\*\bkmkstart Section_4_3_1} {\*\bkmkend Section_4_3_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.3.1 Making your first attempt\par}} {\*\bkmkstart Section_4_3_1_1} {\*\bkmkend Section_4_3_1_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.1.1 From the command line\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ To run AscToHTM simply type \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM Input_file.name \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ at the command line. \par This will create a file :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}input_file.html\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ An output file which will have the same file name with a .html extension \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The program may display a number of status messages indicating source lines that it rejects because they "fail policy". Source lines that fail policy are usually simply copied to the output file with no markup applied. These messages are largely informational, and can be ignored if the conversion worked okay. If it didn't, these messages may give a clue as to where the analysis went wrong. \par \par}} {\*\bkmkstart Section_4_3_1_2} {\*\bkmkend Section_4_3_1_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.1.2 From Windows\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Enter the name of the file to be converted in the text field. If you wish, use the browse button to search for the file to be converted. \par Once you've chosen the file, the output filename and input and output directories are inferred from the filename. If you wish, you may edit the output filename and directory. \par Press the {\b Convert file(s)\b0} button. The Messages window will briefly display. If you wish to view these messages later, select the {\b View | Show Messages from last conversion\b0} menu option. \par To view the last file converted, select the {\b View | Results of last conversion\b0} menu option. This should launch your default browser for the file types (.htm or .html) just created. If you get the message "cannot detect default browser", use the {\b Settings\b0} menu to set up the path to the browser you wish to use and try again. \par \par}} {\*\bkmkstart Section_4_3_2} {\*\bkmkend Section_4_3_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.3.2 Refining your results\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If all goes well the resultant HTML will be satisfactory and all in one file. You can further refine the conversion by creating your own document policy. \par In the Windows version, this is done by editing policies via the {\b Conversion Options\b0} menu, which is fully described in the context-sensitive Windows Help file (press F1 at any point). \par However, in all versions the policies can be saved to a text policy file and it is the format of that file that is shown and discussed in this document. \par \par}} {\*\bkmkstart Section_4_3_2_1} {\*\bkmkend Section_4_3_2_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.2.1 Using a policy file\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If your initial results are a little strange, then review the policies calculated by the program, and create a "policy file" to tell the program how to do the conversion differently. \par You can do this as follows :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}{\i By creating a "sample" policy file\i0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ You can create a sample .pol policy file that documents the policies used. Do this either by using the command line \par AscToHTM Input_file.name /policy \par or by ticking \par "Generate a sample policy file" \par on the Conversion Options->File Generation tabbed dialogue \par When this is done then the next time you convert the file, in addition to the .html file generated, you will now have an output policy file "input_file.POL" which describes the document policy file calculated by AscToHTM (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_3_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0033005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 3.2}}}) and used by it during the conversion. \par This file will contain one line each for all the program policies, {\b most of which should be correct\b0}. \par Review the contents of this file, deleting all lines that look correct, and editing all lines that appear to be wrong. \par Save the modified .POL file which should only contain lines for those policies you think are wrong or want to override. \par You'll may need to review the [Policy Manual] in order to understand the policies to do this fully. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}{\i By re-analysing the file\i0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Under Windows a slightly easier option is to select Conversion Options -> Re-analyse the file. This will analyse the file and change all the policy values currently on display to be the values calculated by the program. You can then review and change these values using the tabbed dialogues. \par Once you're happy with your changes, select "Save policies to file" from the menu, saving only the changed policies. You can review this file in a normal text editor. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Once you've produced your new input policy file, re-run the conversion using the new policy file. The program will now override aspects of the calculated document policy with the input policy you've supplied. \par Each document policy file consists of a number of lines of data. Each line has the form \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Keywords : Data value(s) \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ For clarity a number of section headers are added like this : \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ [Analysis] \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Such headings are ignored, as are any lines whose keywords are not recognised or not yet supported. \par The order of policies within the file is usually unimportant, and the placement relative to the "headings" is ignored. The Headings are simply there to make the file easier to read in a text editor. \par A sample fragment from a calculate policy file looks like this \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 [Hyperlinks]\par ------------\par Create hyperlinks : Yes\par Create mailto links : Yes\par Create NEWS links : Yes\par \par \par [Added HTML]\par ------------\par Document Title : (none)\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These are all default values used by AscToHTM. If, for example you want to add a title to your page and prevent email addresses being turned into hyperlinks, simply create a policy file containing the lines \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 [Hyperlinks]\par ------------\par Create mailto links : No\par \par \par [Added HTML]\par ------------\par Document Title : Title text for the HTML page\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ (Remember the insertion of section headings is optional, as is the ordering of policies within the file). \par By refining the input policy file, you can greatly influence the output that AscToHTM generates \par \par}} {\*\bkmkstart Section_4_3_2_2} {\*\bkmkend Section_4_3_2_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.2.2 Using a link dictionary\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In addition to adding hyperlinks for all URLs, email addresses, section references and contents list entries, AscToHTM allows users to specify key phrases that should be turned into hyperlinks. \par This is achieved by adding lines to the input policy of the form \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 [Link Dictionary]\par -----------------\par Link definition : "[AV]" = "AltaVista" + "Using_AltaVista.html"\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The syntax used here is \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 Link definition : "match phrase" = "replacement phrase" + "link"\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In this case the string "[AV]" is replaced by a link to a web page "Using_AltaVista.html" with the text "AltaVista" being highlighted. \par The link dictionary used for this documentation can be seen in the file A2HLINKS.DAT. \par \par}} {\*\bkmkstart Section_4_3_2_3} {\*\bkmkend Section_4_3_2_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.2.3 Using multiple policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If you wish to use AscToHTM to support several text files e.g. for a set of Intranet documentation, it may be useful to share some common document policies, e.g. colour, headers and footers and particularly the link dictionary. \par To support this AscToHTM allows two special types of line in the policy file. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}Include files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ include file : Link_Dictionary.dat\par \par If a line of this type is encountered, the contents of the file Link_dictionary.dat are included in the current policy file. This is the best way of sharing data across many converted files. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}"daisy-chain" files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ switch to file : Other_policy_file.dat \par If a line of this type is encountered, the processing of the current file terminates, and continues in the named file. \par This is a way of "daisy-chaining" policy files together which may be useful if you wish to group files together at different levels. \par \par}} {\*\bkmkstart Section_4_3_2_4} {\*\bkmkend Section_4_3_2_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.2.4 Creating DOS-compatible files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Occasionally it may be necessary to create files consistent with the DOS nnnnnnnn.nnn naming convention. This can happen when working on a DOS or windows 3.n machine, or via a network that has this limitation e.g. Pathworks. \par AscToHTM supports this. There are two ways to achieve this. Either use the command \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM input_file.name /DOS \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Alternatively, simply add the lines \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 [File generation]\par -----------------\par Use DOS filenames : Yes\par DOS filename root : A2H\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ to your policy file. AscToHTM will then create a base file called (in this case) A2H.HTM. \par If you're splitting a large document into many files, subsequent files have the form \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ _ .HTM \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ When this name becomes two long, AscToHTM will create a name of the form \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AAANNNNN.HTM \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Where AAA comes from the file root, and NNNNN is a 5-digit code derived from the rest of the file name. \par \par}} {\*\bkmkstart Section_4_3_2_5} {\*\bkmkend Section_4_3_2_5} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.2.5 Use the pre-processor and in-line tags\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has a built-in pre-processor. This allows you to add special codes to your source file that tell the program what you'd like it to do. \par Examples include delimiting tables, embedding raw HTML or adding a timestamp to the file being converted. \par See {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Using the preprocessor}}} and {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0037005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 In-line tags}}} for more details. \par \par}} {\*\bkmkstart Section_4_3_3} {\*\bkmkend Section_4_3_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.3.3 Processing several files at once\par}} {\*\bkmkstart Section_4_3_3_1} {\*\bkmkend Section_4_3_3_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.3.1 Using wildcards\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ You can convert multiple files at one time by specifying a wildcard describing the files to be converted. The wildcard has to be meaningful to the operating system you are using, and is expanded in alphabetical order. Under Windows this ordering may be case-sensitive. \par At present we recommend that wildcards are only used on the contents of a single directory. Indeed wildcards spanning directories are probably not supported (let's just say it's untested :-) \par Note, the same policies will apply to all files being converted. If you wish different policies to apply, use a steering command file (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_3_3_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0033005f0033005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.3.3.2}}}) \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab In the shareware version, wildcard conversions are limited to only 10 files\par} \par}} {\*\bkmkstart Section_4_3_3_2} {\*\bkmkend Section_4_3_3_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{4.3.3.2 Using a steering command file\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In the console version you can convert several files at the same time in the order and manner of your choosing. To do this use the command \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ AscToHTM @List.file [rest of command line] \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Where the file "list.file" is a steering file which contains a list of AscToHTM command, and the "@" in front indicates it is a list file, rather than a file to be converted. \par An example list file might look like \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 ! this is the main document\par DOCO.TXT IN_DOCO.POL /DOS\par #\par # These are the other chapters\par CHAPTER2.TXT\par CHAPTER3.TXT /SIMPLE\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Note the use of "!" or "#" at the start of a line signifies it's a comment line to be ignored. \par Any qualifiers used on the original AscToHTM line are used as defaults for each conversion, but are overridden by any listed in the list file. In this way it would be possible to specify a default policy file for a bunch of similar conversions. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab In the shareware version, batch conversions are limited to only 10 files\par} \par}} {\*\bkmkstart Section_4_3_4} {\*\bkmkend Section_4_3_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.3.4 Generating log files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ 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 :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b From the command line\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ On the command line you can use to launch the program, add the the /LOG= qualifier (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_2_2_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0032005f0032005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.2.2.7}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b From the policy file\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Use the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_a_log_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004300720065006100740065002000610020006c006f0067002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f0061005f006c006f0067005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create a log file}}} policy. You will need to manually edit this into your .pol file, as it can't be set via the user interface. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b From the Status Dialog\b0}\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ In the Windows version, the Status Dialog now contains a "Save to file" option to save the displayed messages. This dialog is currently limited to 32,676 characters. \par \par}} {\*\bkmkstart Section_4_4} {\*\bkmkend Section_4_4} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{4.4 Other tips and tricks\par}} {\*\bkmkstart Section_4_4_1} {\*\bkmkend Section_4_4_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.1 General\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Read the [FAQ] \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Browse the [Policy Manual] to gain a feel for what options the program support. Similarly the [Tag Manual] \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If you can, try to use as much white space as possible, e.g. before paragraphs and new sections and at the end of the document.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This makes it easier for AscToHTM to place things in context, reduces ambiguity and increases the chances of correct HTML being generated. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Ensure you have consistency in your use of indentation, bullets etc.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ On the output pass AscToHTM rejects lines that "fail policy", so any inconsistencies are liable to lead to errors in the HTML. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Try to avoid lines that may confuse AscToHTM. For example numbers at the start of a line of text may be interpreted as a section heading. If the number is out of sequence, or at an incorrect indentation this will "fail policy". However, it may cause confusion and is best avoided wherever possible.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Where a number has to be at the start of a line, try using an indentation level that doesn't match that used by your headings. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Review the messages displayed during conversion. Often these will highlight problems perceived by the software.\par}} \par {\*\bkmkstart Section_4_4_2} {\*\bkmkend Section_4_4_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.2 Link dictionary\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Try to avoid using match words that are substrings of other match words.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ If you can't avoid this, then list the longer entries first \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Try to ensure you match words will only match the places you want them to match.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This means avoiding overly short match words. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If you can bracket your match words or phrases [like this]. This makes for less mistakes, and makes it clearer in the original that you expect a link adding at that point.\par}} \par {\*\bkmkstart Section_4_4_3} {\*\bkmkend Section_4_4_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.3 Contents List detection\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Contents list detection is tricky at the best of times. It becomes even trickier if \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}There isn't one :-) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}The list only contains chapters and no sub-sections\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If the program wrongly determines that there is/isn't a contents list, use the following policy line \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Expect Contents List : No \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ to tell AscToHTM how it has gone wrong. The usual error is to decide there is a contents list where none exists. \par \par}} {\*\bkmkstart Section_4_4_4} {\*\bkmkend Section_4_4_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.4 Using "Send to" in Windows 95/NT\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can be invoked (without policy file) from windows in a number of additional ways as follows \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Drag and drop your text file onto the AscToHTM icon.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ If you want a policy file, drag that at the same time \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Create a shortcut in your "SendTo" folder in Windows. This is under C:/WINDOWS or C:/WINNT/PROFILES/ depending which system you're using. Once this has been done, right-clicking on a file in explorer brings up the "Send to" menu, and you can now "send" your text file to AscToHTM directly.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ If you want a policy file, add it as an argument to the shortcut's command line. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Better still, create a .BAT file to invoke AscToHTM with a default policy file - e.g. with your favourite colour scheme, and some standard link definitions (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_10" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000f000000530065006300740069006f006e005f0036005f0033005f00310030000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Link dictionary policies}}}) - and add this the "SendTo" folder. \par In this way you can easily convert text files in any number of pre-defined manners. \par \par}} {\*\bkmkstart Section_4_4_5} {\*\bkmkend Section_4_4_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.5 Tables\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM does a reasonable job of detecting and analysing Tables, but the following tips can be useful. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If the extent of the table is wrongly calculated, mark it up using TABLE pre-processor commands described in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.4}}}, or insert an extra blank line before and/or after the table. Tables will rarely bridge a two-line gap.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ If the table extent is wrong, try adjusting the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#table_extending_factor }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000170000005400610062006c006500200065007800740065006e00640069006e006700200066006100630074006f0072000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007400610062006c0065005f0065007800740065006e00640069006e0067005f0066006100630074006f0072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Table extending factor}}} (shown as "Extend preformatted regions" on the Conversion Options -> Analysis policies -> Tables menu option. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If AscToHTM places a code fragment or diagram in TABLE markup, mark the source using BEGIN/END_CODE or BEGIN/END_DIAGRAM pre-processor commands \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Avoid mixing tabs and spaces. This makes spotting column alignments positions more difficult. If you do mix them, check that the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#tab_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000090000005400410042002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b7400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007400610062005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 TAB size}}} policy has a suitable value. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If you want the heading in bold, try drawing a line all the way across, separating header from data \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If too many columns are created, adjust the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimum_table_column_separation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000004d0069006e0069006d0075006d0020005400410042004c004500200063006f006c0075006d006e002000730065007000610072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d0075006d005f007400610062006c0065005f0063006f006c0075006d006e005f00730065007000610072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimum TABLE column separation}}} to be greater than 1, and ensure there are at least two spaces between columns (see also {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.4}}}). Alternatively "break formation" by inserting a space at the start of every second or third line. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If too few columns are created try adjusting the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#column_merging_factor }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001600000043006f006c0075006d006e0020006d0065007200670069006e006700200066006100630074006f0072000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c0075006d006e005f006d0065007200670069006e0067005f0066006100630074006f0072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Column merging factor}}} policy. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If AscToHTM puts lines in tables when they shouldn't be, increase the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimum_automatic__pre__size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d0000004d0069006e0069006d0075006d0020006100750074006f006d00610074006900630020003c005000520045003e002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d0075006d005f006100750074006f006d0061007400690063005f005f007000720065005f005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimum automatic size}}} value. This is a common problem in email digests with people's .sigs in them. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If you wish to fine-tune a particular table, use the pre-processor commands described in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.4}}}. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}If the table layout is approximately correct, switch off the table border (set the value to 0). Often this will look acceptable, even though the analysis has gone wrong.\par}} \par {\*\bkmkstart Section_4_4_6} {\*\bkmkend Section_4_4_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{4.4.6 Using desktop icons and policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par AscToHTM can support arguments being passed on the command line. One 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. \par If you use policy files, edit the icon properties so that the command line reads something like \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ "c:\\program files\\jafsoft\\asctohtm.exe" "c:\\mydir\\mypolicy.pol" \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This will ensure the policy file mypolicy.pol is used in the conversion. You may also need to set the working directory to something suitable. \par If you have multiple policy files (e.g. different colour schemes), simply create additional icons with different policy files. \par \par}} {\*\bkmkstart Section_5} {\*\bkmkend Section_5} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{5 HTML markup produced\par}} {\*\bkmkstart Section_5_1} {\*\bkmkend Section_5_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.1 Text layout\par}} {\*\bkmkstart Section_5_1_1} {\*\bkmkend Section_5_1_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.1.1 Indentation\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM performs statistical analysis on the document to determine at what character positions indentations occur. This information is used on the output pass to determine the indentation level for each source line. \par AscToHTM attempts to indent the HTML code to match the output indentation level, to make it easier to read. \par The indentations themselves are marked up using...tags. \par Future versions of AscToHTM may offer you the option of usingtags. \par \par}} {\*\bkmkstart Section_5_1_2} {\*\bkmkend Section_5_1_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.1.2 Hanging paragraph indents\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Some documents, especially ones dumped from Word, have hanging paragraph indents. That is, each paragraph starts at an offset to the rest of the paragraph. \par AscToHTM struggles heroically with this, and tries not to treat this as text at two indent levels, but it does occasionally get confused. \par If writing a text file from scratch with AscToHTM in mind, then it is best to avoid this practice. \par \par}} {\*\bkmkstart Section_5_1_3} {\*\bkmkend Section_5_1_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.1.3 Bullets\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM detects and supports several types of bullets. \par \par}} {\*\bkmkstart Section_5_1_3_1} {\*\bkmkend Section_5_1_3_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.3.1 Bullet chars\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Bullet chars are lines of the type \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 - this is a bullet line\par \par - this is a bullet paragraph\par because it carries over onto\par more lines\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ That is, a single character followed by the bullet line. AscToHTM can determine via statistical analysis which character, if any, is being used in this way. Special attention is paid to the '-' and 'o' characters. \par Bullets of this type are given a...
markup. \par \par}} {\*\bkmkstart Section_5_1_3_2} {\*\bkmkend Section_5_1_3_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.3.2 Numbered bullets\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can spot numbered bullets. These can sometimes be confused with section headings in some documents. This is one area where the use of a document policy really pays dividends in sorting the sheep from the goats. \par Numbered bullets are given a- ...
...
markup. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab Not all browsers support this type of markup. In such cases, it's possible that the numbering of bullets will get reset to 1 every so often. However, this isn't a problem with either Netscape or Internet Explorer.\par} \par}} {\*\bkmkstart Section_5_1_3_3} {\*\bkmkend Section_5_1_3_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.3.3 Alphabetic bullets\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM detects upper and lower case alphabetic bullets. These are marked up like numbered bullets, with TYPE=a. \par \par}} {\*\bkmkstart Section_5_1_3_4} {\*\bkmkend Section_5_1_3_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.3.4 Roman Numeral bullets\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM detects upper and lower case roman numeral bullets. These are marked up like numbered bullets, with TYPE=i. \par \par}} {\*\bkmkstart Section_5_1_4} {\*\bkmkend Section_5_1_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.1.4 Centred text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can attempt to spot sections of centred text. However, because this can easily go wrong this option is normally switched off. \par Centering is only switched on for single isolated lines, or any group of at least two lines.- ...
... markup is used. \par See the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#allow_automatic_centring }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041006c006c006f00770020006100750074006f006d0061007400690063002000630065006e007400720069006e0067000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061006c006c006f0077005f006100750074006f006d0061007400690063005f00630065006e007400720069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Allow automatic centring}}} \par \par {\*\bkmkstart definitions} \par}} {\*\bkmkstart Section_5_1_5} {\*\bkmkend Section_5_1_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.1.5 Definitions\par}} {\*\bkmkstart Section_5_1_5_1} {\*\bkmkend Section_5_1_5_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.5.1 Definition lines\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ A definition line is a single line that appears to be defining something. Usually this is a line with either a colon (:) or an equals sign (=) in it. For example \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 IMHO = In my humble opinion\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ or \par}} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 Address : Somewhere over the rainbow.\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM attempts to determine what definition characters are used and whether they are strong (only ever used in a definition) or weak (only sometimes used in a definition). \par AscToHTM marks up definition lines by placing a
on the end of the line to preserve the original line structure. Where this decision is made incorrectly unexpected breaks can appear in text. \par AscToHTM offers the option of marking up the definition term in bold. This is not the default behaviour however. \par \par}} {\*\bkmkstart Section_5_1_5_2} {\*\bkmkend Section_5_1_5_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.1.5.2 Definition paragraphs\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM also recognises the use of definition paragraphs such as :- \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 Note: This is a "definition" paragraph, i.e. the whole\par paragraph defines the term shown on the first line.\par Unfortunately AscToHTM currently only copes with single\par paragraphs (i.e. not with continuation paragraphs), and\par only with single word definitions.\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This gets marked up in asequence \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab This is a "definition" paragraph, i.e. the whole paragraph defines the term shown on the first line. Unfortunately AscToHTM currently only copes with single paragraphs (i.e. not with continuation paragraphs), and only with single word definitions.\par} \par}} {\*\bkmkstart Section_5_2} {\*\bkmkend Section_5_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.2 Text formatting\par}} {\*\bkmkstart Section_5_2_1} {\*\bkmkend Section_5_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.2.1 Quoted lines\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM recognises that, especially in Internet files, it is increasingly common to quote from other text sources such as e-mail. The convention used in such cases is to insert a quote character such as > at the start of each line. \par Consequently, AscToHTM adds a
- ...
- ...
tag at the end of such lines to preserve the line structure of the original, and marks it up in .. tags to differentiate the quoted text \par \par}} {\*\bkmkstart Section_5_2_2} {\*\bkmkend Section_5_2_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.2.2 Emphasis\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can look for text emphasised by placing asterisks (*) either side of it, or underscores (_). AscToHTM will convert the enclosed text to {\b bold\b0} and {\i italic\i0} respectively using and tags respectively. \par AscToHTM will also look for combinations of asterisks and underscores which is placed in {\b\i bold italic\b0\i0}. The asterisks and underscores should be properly nested. \par The emphasised word or phrase should span no more than a few lines, and in particular should {\b not\b0} span a blank line. If the phrase is longer, or if AsctoHTM fails to match opening and closing emphasis marks, the characters are left unconverted. \par To a limited extent the software can detect and handle nested emphasis of different types. For example {\i a phrase that is mostly in italics may contain {\b a few bold words\b0} within it\i0}. Nested emphasis of the same type is not supported. \par Tests are made to \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}ignore double asterisks and underscores\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}ignore phrases with underscores in the middle (these may become underlined)\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}{\b (new in version 4)\b0} to allow hyphenated words to be {\b part\b0}-emphasised.\par}} {\*\bkmkstart Section_5_2_3} {\*\bkmkend Section_5_2_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.2.3 Fonts\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The program allows you to select the default font for your files. Fonts are implemented Cascading Style Sheets (CSS) by default, although this can be change to the tag should you wish. \par The tag is allowed in "HTML 3.2", but is "deprecated" in favour of CSS in "HTML 4.0 Transitional". It is completely disallowed under "HTML 4.0 Strict". \par Some older features of the software still use tags. These will be changed to also use CSS in later releases as support for "HTML 4.0 Strict" is added. \par See {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Font Policies}}} for more details. \par \par}} {\*\bkmkstart Section_5_2_4} {\*\bkmkend Section_5_2_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.2.4 Special characters\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The program will detect special characters and symbols such as á and © and will replace these by the correct HTML entity codes á and ©. By using the correct HTML codes, the HTML produced is guaranteed to display correctly on all computers. \par Some symbols use different character codes on different machines (e.g. Mac and PC). \par \par}} {\*\bkmkstart Section_5_3} {\*\bkmkend Section_5_3} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.3 Added hyperlinks\par}} {\*\bkmkstart Section_5_3_1} {\*\bkmkend Section_5_3_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.1 Contents List lines\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Contents list lines are marked up in bold, and turned into a hyperlink pointing at the section referenced. The text is sized according to heading type in the range +/- 1 font size from normal (3). \par \par}} {\*\bkmkstart Section_5_3_2} {\*\bkmkend Section_5_3_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.2 Cross-references\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can convert cross-references to other sections into hyperlinks to those sections. Unfortunately this is currently only possible for second, third, fourth... level numeric headings (n.n, n.n.n, n.n.n.n etc) \par This is because the error rate becomes too high on single numbers/letters or roman numerals. This {\i may\i0} be refined in future releases, although it's hard to see how that would work. \par \par}} {\*\bkmkstart Section_5_3_3} {\*\bkmkend Section_5_3_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.3 URLs\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can convert any URLs in the document to hyperlinks. This includes http and ftp URLs and any web addresses beginning with www. \par The domain name part of the URL will be checked against the known domain name structures and country codes to check it falls within an allowed group. So www.somewhere.thing won't be allowed as ".thing" isn't a proper top level domain. \par URLs that use IP addresses or some more obscure methods of specifying domain names will also be recognised, but the link will be changed wherever to either a domain name or an IP address. This will de-obfuscate any obscure references so beloved by spammers. \par \par}} {\*\bkmkstart Section_5_3_4} {\*\bkmkend Section_5_3_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.4 Usenet Newsgroups\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can convert any newsgroup names it spots into hyperlinks to those newsgroups. Because this is prone to error, AscToHTM currently only converts newsgroups in known USENET hierarchies such as {\field{\*\fldinst {\fs20 HYPERLINK news:rec.gardens }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c0000007200650063002e00670061007200640065006e0073000000e0c9ea79f9bace118c8200aa004ba90b220000006e006500770073003a007200650063002e00670061007200640065006e0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 rec.gardens}}} by default. \par This can be overcome either by \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {a)\tab}placing "news:" in front of the newsgroup name (e.g. {\field{\*\fldinst {\fs20 HYPERLINK news:this.is.a.newsgroup.honest }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000006e006500770073003a0074006800690073002e00690073002e0061002e006e00650077007300670072006f00750070002e0068006f006e006500730074000000e0c9ea79f9bace118c8200aa004ba90b400000006e006500770073003a0074006800690073002e00690073002e0061002e006e00650077007300670072006f00750070002e0068006f006e006500730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 news:this.is.a.newsgroup.honest}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {b)\tab}relaxing this condition via a document policy (see the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#only_use_known_groups }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004f006e006c007900200075007300650020006b006e006f0077006e002000670072006f007500700073000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f006e006c0079005f007500730065005f006b006e006f0077006e005f00670072006f007500700073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Only use known groups}}}) \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {c)\tab}specifying the newsgroup hierarchy as recognised via a policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#recognised_usenet_groups }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000190000005200650063006f0067006e00690073006500640020005500530045004e00450054002000670072006f007500700073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007200650063006f0067006e0069007300650064005f007500730065006e00650074005f00670072006f007500700073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Recognised USENET groups}}}.\par}} \par {\*\bkmkstart Section_5_3_5} {\*\bkmkend Section_5_3_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.5 E-mail addresses\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can convert any email addresses into hypertext mailto: links. As with URLs (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.3.3}}}), the domain name is checked to see it falls into a recognised group. \par \par}} {\*\bkmkstart Section_5_3_6} {\*\bkmkend Section_5_3_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.6 User-specified keywords\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can convert use-specified keywords into hyperlinks. The words or phrase to be converted must lie on a single line in the source document. Care should be taken to ensure keywords are unambiguous. Normally I mark my keywords in [] brackets if authoring for conversion by AscToHTM \par See the discussions on "link dictionaries" in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_3_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0033005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.3.2.2}}} and {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_4_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0034005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.4.2}}}. \par \par}} {\*\bkmkstart Section_5_3_7} {\*\bkmkend Section_5_3_7} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.3.7 Other sections and URLs\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM offers a number of pre-processor commands and in-line tags that allow you to add hyperlinks commands to your source text. \par For example the GOTO tag allows hyperlinks to be created to named sections in the same document. So that \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ [[GOTO Other sections and URLs]] \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ becomes \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_3_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0033005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Other sections and URLs}}} \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In the same way the HYPERLINK tag allows hyperlinks to be inserted \par \par}} {\*\bkmkstart Section_5_4} {\*\bkmkend Section_5_4} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.4 Section headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM recognises various types of headings. Where headings are found, and deemed to be consistent with the prevailing document policy (correct indentation, right type, in numerical sequence etc), AscToHTM will use the standard... markup. \par In addition to this, AscToHTM will insert a named Anchor tag ( ... ) to allow hyperlink jumps to this point. These anchors are used for example in the contents list and cross-reference hyperlinks that AscToHTM generates. \par \par}} {\*\bkmkstart Section_5_4_1} {\*\bkmkend Section_5_4_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.1 Numbered headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This is the preferred heading type and the type that AscToHTM has most success with. Sections of type N.N.N can be checked for consistency, and references to them can be spotted and converted into hyperlinks. \par At present more exotic numbering schemes using roman numerals and letters of the alphabet are not fully supported. This is planned to be implemented soon, possibly via user policy files. \par \par}} {\*\bkmkstart Section_5_4_2} {\*\bkmkend Section_5_4_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.2 Capitalised headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can treat wholly capitalised lines as headings. It also allows for such headings to be spread over more than one line. \par \par}} {\*\bkmkstart Section_5_4_3} {\*\bkmkend Section_5_4_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.3 Underlined headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can recognise underlined text, and optionally promote the preceding line to be a section header. The "underlining" line should have no gaps in it. \par \par}} {\*\bkmkstart Section_5_4_4} {\*\bkmkend Section_5_4_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.4 Embedded headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par The program can look for headings "embedded" in the first paragraph. Such headings are expected to be a complete sentence or phrase in UPPER CASE at the start of a paragraph. Where detected the heading will be marked up in bold, rather thanmarkup, although it will still be added to, and accessible from any hyperlinked contents list you generate for the document. \par At present such headings are not auto-detected... you need to switch on the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_embedded_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000019000000450078007000650063007400200065006d006200650064006400650064002000680065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0065006d006200650064006400650064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect embedded headings}}} policy. \par \par}} {\*\bkmkstart Section_5_4_5} {\*\bkmkend Section_5_4_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.5 Key phrase headings\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par The program can now look for lines that start with particular words or phrases (such as "Chapter", "Part", Title") of your choice and treat these lines as headings. Previously this only worked in a limited way if the heading line was also {\b numbered\b0} ("Chapter 1") etc. \par To use this feature, set the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#heading_key_phrases }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000480065006100640069006e00670020006b0065007900200070006800720061007300650073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680065006100640069006e0067005f006b00650079005f0070006800720061007300650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Heading key phrases}}} \par \par}} {\*\bkmkstart Section_5_4_6} {\*\bkmkend Section_5_4_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.6 Numbered paragraphs\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Some types of documents use what look like section numbers to number paragraphs (e.g. legal documents, or sets of rules). \par AscToHTM can recognise this, and mark up such lines by placing the number in bold, and not using ... markup on the whole line. \par \par}} {\*\bkmkstart Section_5_4_7} {\*\bkmkend Section_5_4_7} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.4.7 Mail and USENET headers\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Some documents, especially those that were originally email or USENET posts, come with header lines, usually in the form of a number of lines with a keyword followed by a colon and then some value. \par AscToHTM can recognise these (to a limited extent). Where these are detected the program will parse the header lines to extract the Subject, Author and Date of the article concerned. A 2-line heading containing this information will then be generated to replace all the unsightly header lines. \par \par}} {\*\bkmkstart Section_5_5} {\*\bkmkend Section_5_5} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.5 Pre-formatted text\par}} {\*\bkmkstart Section_5_5_1} {\*\bkmkend Section_5_5_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.5.1 Lines and form feeds\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Lines are interpreted in context. If they appear to be underlining text, or part of some pre-formatted structure such as a table, then they are treated as such. Otherwise they become horizontal rules (
). \par An attempt is made to interpret half-lines etc as such, although the effect is only approximate. \par Form feeds or page breaks also become
markups. \par {\b New in version 4\b0}\par You can use the [HTML fragment] HORIZONTAL_RULE to customize how lines are displayed, e.g. you can substitute your own image file. \par \par}} {\*\bkmkstart Section_5_5_2} {\*\bkmkend Section_5_5_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.5.2 User defined pre-formatted text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM normally ignores any HTML markup in the original text. The sole exceptions are any preprocessor tags which a user may insert into their text document (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Using the preprocessor}}}). \par For example :- \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 The use of BEGIN_PRE and END_PRE preprocessor\par commands (see 7.1) in\par the text documents\par tells AscToHTM that\par this portion of the\par document\par has been formatted\par by the user and\par should be left unchanged.\par } {\*\bkmkstart Section_5_5_3} {\*\bkmkend Section_5_5_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.5.3 Automatically detected pre-formatted text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM attempts to spot sections of preformatted text. This can vary from a single line (e.g. a line with a page number on the right-hand margin) to a complete table of data. \par Where such text is detected AscToHTM analyses the section to determine what type of pre-formatted text it is. Options include \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Tables\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Code samples\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Ascii Art and diagrams\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}some other formatted text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ A number of policies allow you to control \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}whether or not the program looks for such text\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}how sensitivity it is to "pre-formatted" text\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}how inclined the program is to "extend" the region to adjacent lines\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}whether or not table generation should be attempted\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}various aspects of any table analysis that is carried out.\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ See {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_2_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0032005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Pre-formatted text policies}}} for full details. \par \par}} {\*\bkmkstart Section_5_5_3_1} {\*\bkmkend Section_5_5_3_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.5.3.1 Tables\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Tables are marked out by their use of white space, and a regular pattern of gaps or vertical bars being spotted on each lines. AscToHTM will attempt to spot the table, its columns, its headings, its cell alignment and entries that span multiple columns or rows. \par Should AscToHTM wrongly detect the extent of a table, you can mark up a section of text by using the BEGIN/END_TABLE pre-processor commands. Alternatively you can try adding blank lines before and after, as the analysis uses white space to delimit tables. \par You can alter the characteristics of all tables via the table policies (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_13" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000f000000530065006300740069006f006e005f0036005f0033005f00310033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Table generation policies}}}). \par You can alter the characteristics of all or individual tables via the table pre-processor commands (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.4}}}). \par Or you can suppress the whole thing altogether via the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#attempt_table_generation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041007400740065006d007000740020005400410042004c0045002000670065006e00650072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061007400740065006d00700074005f007400610062006c0065005f00670065006e00650072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Attempt TABLE generation}}} policy \par \par}} {\*\bkmkstart Section_5_5_3_2} {\*\bkmkend Section_5_5_3_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.5.3.2 Code samples\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM attempts to recognise code fragments in technical documents. The code is assumed to be "C++" or "Java"-like, and key indicators are, for example, the presence of ";" characters on the end of lines. \par Should AscToHTM wrongly detect the extent of a code fragment, you can mark up a section of text by using the BEGIN/END_CODE pre-processor commands. \par You can choose what type of markup is used for the code fragment (see the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use__code_.._/code__markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000055007300650020003c0043004f00440045003e002e002e003c002f0043004f00440045003e0020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f005f0063006f00640065005f002e002e005f002f0063006f00640065005f005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use..
markup}}}). \par Of you can suppress the whole thing altogether via the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_code_samples }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000450078007000650063007400200063006f00640065002000730061006d0070006c00650073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0063006f00640065005f00730061006d0070006c00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect code samples}}}. \par \par}} {\*\bkmkstart Section_5_5_3_3} {\*\bkmkend Section_5_5_3_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.5.3.3 Ascii art and diagrams\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM attempts to recognise Ascii art and diagrams in documents. Key indicators include large numbers of non-alphanumeric characters and the use of white space. \par However, some diagrams use the same mix of line and alphabetic characters as tables, so the two sometimes get confused. \par Should AscToHTM wrongly detect the extent or type of a diagram, you can mark up a section of text by using the BEGIN/END_DIAGRAM pre-processor commands. \par \par}} {\*\bkmkstart Section_5_5_3_4} {\*\bkmkend Section_5_5_3_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.5.3.4 Text blocks\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par If AscToHTM detects a block of text at a large indent, it will now place that text in a table in such a way as to preserve as faithfully as possible the original indent. \par Of course, sometimes this text is, in fact, centred on the page. In that case you could consider switching on the policy {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#allow_automatic_centring }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041006c006c006f00770020006100750074006f006d0061007400690063002000630065006e007400720069006e0067000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061006c006c006f0077005f006100750074006f006d0061007400690063005f00630065006e007400720069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Allow automatic centring}}} See {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.1.4}}} \par \par}} {\*\bkmkstart Section_5_5_3_5} {\*\bkmkend Section_5_5_3_5} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.5.3.5 Other formatted text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ If AscToHTM detects formatted text, but decides that is is neither table, code or art (and it knows what it likes), then the text may be put out "as normal", but with
added to each line. In such regions other markup (such as bullets) may not be processed such as it would be elsewhere. \par \par \par}} {\*\bkmkstart Section_5_6} {\*\bkmkend Section_5_6} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{5.6 Added value markup\par}} {\*\bkmkstart Section_5_6_1} {\*\bkmkend Section_5_6_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.6.1 Document Title\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can calculate - or be told - the title of a document. This is placed in... markup in the section of each HTML page produced. \par The Title is calculated as in the order shown below. If the first algorithm returns a value, the subsequent ones are ignored. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {1)\tab}If a $_$_TITLE pre-processor command (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.2}}}) is placed in the source text, that value is used \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {2)\tab}If the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_first_header_as_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000550073006500200066006900720073007400200068006500610064006500720020006100730020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f00660069007200730074005f006800650061006400650072005f00610073005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use first header as title}}} policy is set then the first heading (if any) encountered is used as the title.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li1080{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b Note\b0}\tab Depending on your document structure, this is prone to give bland tiles like "Introduction" , "Overview" and "Summary"\par} \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {3)\tab}If the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_first_line_as_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001800000055007300650020006600690072007300740020006c0069006e00650020006100730020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f00660069007200730074005f006c0069006e0065005f00610073005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use first line as title}}} policy is set then the first line in the file is used as the title. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {4)\tab}If the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f00000044006f00630075006d0065006e00740020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document title}}} policy is set then this value is used.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li1080{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li1080 {\b Note\b0}\tab If this is the value you want, ensure the other policies outlined above are disabled.\par} \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {5)\tab}Finally, if none of the above result in a title the text "Converted from" is used.\par}} \par \par {\*\bkmkstart Section_5_6_2} {\*\bkmkend Section_5_6_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.6.2 Contents lists\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can detect the presence of a contents list in the original document, or it can generate a contents list for you from the headings that it observes. There are a number of policies that give you control over how and where a contents list is generated (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents generation policies}}}). \par There are four different situations in which contents lists may, or may not be generated. These are :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Default conversions (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.1}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Conversion to a single file, using policies (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.2}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Conversion to a multiple files, using policies (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.3}}}). \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}Conversion to a set of frames (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.4}}})\par}} {\*\bkmkstart Section_5_6_2_1} {\*\bkmkend Section_5_6_2_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.6.2.1 Contents lists in default conversions\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ By default AscToHTM will not generate a contents list for a file unless it already has one. \par If it should detect a contents list in the document, then that list is changed into hyperlinks to the named sections. This only works currently for files with numbered headings. \par Where an existing list is detected, headings shown in the contents list are converted into links, and the link text is that in the original contents list, and not the text in the actual heading (often they are different). \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab AsctoHTM currently only detected numbered contents lists, and is occasionally prone to error when they are present. If you experience problems, either delete the contents list and get AscToHTM to generate one for you, or mark up the existing list using the contents pre-processor commands (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.1}}})\par} \par}} {\*\bkmkstart Section_5_6_2_2} {\*\bkmkend Section_5_6_2_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.6.2.2 Contents lists in conversions to a single HTML file\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ As described in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.1}}}, AscToHTM will not generate a contents list by default unless it already has one. \par {\b Requesting a contents list\b0} \par You can request that a contents list is always generated, by using the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000410064006400200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add contents list}}} policy. In this case a contents list is either \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}made from the existing contents list, or \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}generated from the observed headings. in this case the contents list will only be as good as the detection of headings in the rest of the document permits.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b Forcing a generated contents list\b0} \par You can force a generated list to be used by disabling the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_any_existing_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f000000550073006500200061006e00790020006500780069007300740069006e006700200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f0061006e0079005f006500780069007300740069006e0067005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use any existing contents list}}} policy. \par If an existing contents list is present, it is deleted from the output. Normally it's best to either use the existing contents list, or to delete it from the source text and request a generated list. \par {\b Contents lists placement\b0} \par By default the contents list is placed at the top of the output file. In earlier versions of AscToHTM the contents list was always placed in a separate file. \par You can cause contents lists to be placed wherever you want by using the CONTENTS_LIST preprocessor command. If you do this, then contents lists is placed {\b only\b0} where you place CONTENTS_LIST markers. \par {\b Generating a contents list in a separate file\b0} \par If you select the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#generate_external_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000020000000470065006e00650072006100740065002000650078007400650072006e0061006c00200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300670065006e00650072006100740065005f00650078007400650072006e0061006c005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Generate external contents list}}} policy the contents list is placed in a separate file, and a hyperlink to that file called "Contents List" is placed at the top of the HTML page generated from the document. \par You can choose the name of the external file using the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#external_contents_list_filename }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000020000000450078007400650072006e0061006c00200063006f006e00740065006e007400730020006c006900730074002000660069006c0065006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300650078007400650072006e0061006c005f0063006f006e00740065006e00740073005f006c006900730074005f00660069006c0065006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 External contents list filename}}} policy. If omitted, the file is called "Contents_ ", where is the name of the document being converted. \par \par}} {\*\bkmkstart Section_5_6_2_3} {\*\bkmkend Section_5_6_2_3} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.6.2.3 Contents lists in conversions to multiple HTML files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can be made to split the output into many files. At present this is only possible at detected section headings. Each generated page usually has a navigation bar, which includes a hyperlink back to the following section in any contents list. \par The behaviour is identical to that in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0035005f0036005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2.2}}} expect that \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}the output is now split into several files. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}the options to generate an external contents list in a separate file are no longer available. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {c)\tab}if the contents list is being generated, it is now placed at the foot of the first document, rather than at the top (unless the CONTENTS_LIST preprocessor command is used)\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This is usually {\b before\b0} the first heading (which now starts the second document), and {\b after\b0} any document preamble. \par {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab Where the original contents list is used when splitting files it is possible that not every file is directly accessible from the contents list, and that the back links to the contents list may not function as expected. In such cases you can go from the contents list to a major section, and then use the navigation bars to page through to the minor section.\par} \par}} {\*\bkmkstart Section_5_6_2_4} {\*\bkmkend Section_5_6_2_4} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{5.6.2.4 Contents lists in conversions to frames\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par Contents list generation for the main document will proceed as described in the previous sections. \par When making a set of frames, you can elect to have a contents frame generated (the default behaviour), and this will have a generated list placed in a frame on the left. This can mean you have a contents list in the contents frame on the left, and also at the top of the first page in the main document. For this reason the main frame often starts by displaying the second page. \par The number of levels shown in the contents frame list can be controlled by policy. Alternatively you can replace the whole contents of the contents frame by defining a CONTENTS_FRAME [HTML fragment]. \par \par}} {\*\bkmkstart Section_5_6_3} {\*\bkmkend Section_5_6_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.6.3 Directory page\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ When converting several files at once, AscToHTM can be made to generate a "Directory Page". This is an HTML index of all the files converted and their contents. \par The policies available for controlling generation of a directory page are explained in "{\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory Page policies}}}". \par The directory page will consist of an entry for each file converted, in the order that files are converted (usually alphabetic). Each entry will (optionally) contain :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}A link to the file being converted. The link will either be the converted file's HTML title, or failing that, the filename itself. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}Links to each of the sections of the converted file as detected by AscToHTM.\par}} \par {\*\bkmkstart Section_5_6_4} {\*\bkmkend Section_5_6_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.6.4 Headers, footers and JavaScript\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM can be made to add standard header, footers and JavaScript to each page generated. It does this by allowing you to specify include files to be copied into the generated HTML. These include files can contain any valid HTML commands. \par The program supports three types of such files :- \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {i)\tab}Header files. These contain any HTML you want placing immediately after the output's tag.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ A good example might be a standard header, with a logo and links back to the home page. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {ii)\tab}Footer files. These contain any HTML you want placing immediately before the closing tag. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {iii)\tab}Script files, These contain any HTML you want placing inside the ... portion of the generated file. Such tags are not usually visible.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ You should place in here any JavaScript you want, although it is difficult to make this apply to the converted text. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ You can specify include files for the converted files, as well as for any directory page (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.3}}}) that you create. If you don't specify values for the directory page, then it will use the same files as the generated files. \par HTML headers and footers can also be defined as [HTML fragments] (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_5" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0035000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.5}}}). \par \par}} {\*\bkmkstart Section_5_6_5} {\*\bkmkend Section_5_6_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{5.6.5 HTML fragments\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par The "HTML fragments" feature allows you to define a block of HTML that you can elect to have used in place of the default HTML that the program would generate. \par Some reserved names are recognised by the software and used to override the default HTML that is generated. For example the fragment HORIZONTAL_RULE can be used to define a tag that displays an image and which will be used in a number of situations where a simple
tag would have been used otherwise. \par They are described fully in the Tag Manual (see [HTML fragments]). \par \par \par}} {\*\bkmkstart Section_6} {\*\bkmkend Section_6} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{6 Using Document Policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b This chapter has been largely superceded by the [Policy Manual]\b0} \par Document policy files are ordinary text files that list the "policies" that AscToHTM should implement when converting your document. The file can have added comment lines (starting with a "!" or "#" character) and headings for clarity. \par A summary of the recognised policy lines is given in the [Policy manual]. \par In most cases recognised policy lines are identical to those listed in the generated policy file (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000c000000530065006300740069006f006e005f0034005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.1}}}). This is usually a good place to start when making your own policy. \par Only those lines that are recognised policies are acted upon. \par To use a policy file, simply list it on the command line after the name of the file being converted (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_2_2_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0032005f0032005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.2.2.3}}}). \par Document policies have two main uses : \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {a)\tab}To correct any failure of analysis that AscToHTM makes. Hopefully this won't be needed too much as the core analysis engine improves.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Examples include page width, whether or not underlined section headings are expected etc. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {b)\tab}To tell the program how to produce better HTML end product in ways that couldn't possibly be inferred from the original text.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ Examples include adding colour and titles to the page, as well as requesting a large document is split into several pages, and a contents list created. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The document sections in this chapter that described the policies in detail have been moved to a standalone document called the "[Policy Manual]". That document describes the scope, effect, location and default values for all policies recognised by the program. \par \par}} {\*\bkmkstart Section_6_1} {\*\bkmkend Section_6_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{6.1 An example conversion\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This documentation has itself been converted using AscToHTM. The files used were \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}a2hdoco.txt. This is the text version of the documentation. The text version is kept as the master copy and updated as required. It's then converted to HTML. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}ia2hdoco.pol. This is the policy file used to create the HTML version of this document. Only those policies that differ from the defaults have been added.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ This policy file "includes" the link dictionary A2HLINKS.DAT. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}a2hlinks.dat. This is the link dictionary used for this document and is used to add hyperlinks to the main text file. \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {\f1\'b7\tab}html_fragments.inc. This file contains the definitions of the [HTML fragments] used in this conversion.\par}} \par {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These files are included in the distribution kit as an example set of documentation. \par You can, of course, use AscToHTM to convert this doco into whatever format, colour etc that you wish. \par \par}} {\*\bkmkstart Section_6_2} {\*\bkmkend Section_6_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{6.2 Analysis policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These policies are used to control and correct the analysis of files during conversion. Full descriptions of these policies can be found in the [Policy Manual]. \par}} {\*\bkmkstart Section_6_2_1} {\*\bkmkend Section_6_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.1 Overview ("look for") policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The following analysis policies help give you an overview of what the program is looking for, and to enable/disable what is being looked for. \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_indentation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004c006f006f006b00200066006f007200200069006e00640065006e0074006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f0069006e00640065006e0074006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for indentation}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_hanging_paragraphs }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c0000004c006f006f006b00200066006f0072002000680061006e00670069006e006700200070006100720061006700720061007000680073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00680061006e00670069006e0067005f0070006100720061006700720061007000680073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for hanging paragraphs}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_white_space }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004c006f006f006b00200066006f0072002000770068006900740065002000730070006100630065000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00770068006900740065005f00730070006100630065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for white space}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_short_lines }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004c006f006f006b00200066006f0072002000730068006f007200740020006c0069006e00650073000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00730068006f00720074005f006c0069006e00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for short lines}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_horizontal_rulers }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b0000004c006f006f006b00200066006f007200200068006f00720069007a006f006e00740061006c002000720075006c006500720073000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f0068006f00720069007a006f006e00740061006c005f00720075006c006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for horizontal rulers}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimum_ruler_length }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004d0069006e0069006d0075006d002000720075006c006500720020006c0065006e006700740068000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d0075006d005f00720075006c00650072005f006c0065006e006700740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimum ruler length}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_bullets }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000004c006f006f006b00200066006f0072002000620075006c006c006500740073000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00620075006c006c006500740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for bullets}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#search_for_definitions }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000017000000530065006100720063006800200066006f007200200064006500660069006e006900740069006f006e0073000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007300650061007200630068005f0066006f0072005f0064006500660069006e006900740069006f006e0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Search for definitions}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_quoted_text }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004c006f006f006b00200066006f0072002000710075006f00740065006400200074006500780074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00710075006f007400650064005f0074006500780074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for quoted text}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_mail_and_usenet_headers }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000210000004c006f006f006b00200066006f00720020004d00410049004c00200061006e00640020005500530045004e0045005400200068006500610064006500720073000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f006d00610069006c005f0061006e0064005f007500730065006e00650074005f0068006500610064006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for MAIL and USENET headers}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_preformatted_text }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b0000004c006f006f006b00200066006f007200200070007200650066006f0072006d0061007400740065006400200074006500780074000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f0070007200650066006f0072006d00610074007400650064005f0074006500780074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for preformatted text}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#attempt_table_generation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041007400740065006d007000740020005400410042004c0045002000670065006e00650072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061007400740065006d00700074005f007400610062006c0065005f00670065006e00650072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Attempt TABLE generation}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_diagrams }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004c006f006f006b00200066006f00720020006400690061006700720061006d0073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f006400690061006700720061006d0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for diagrams}}} \par \par \par}} {\*\bkmkstart Section_6_2_2} {\*\bkmkend Section_6_2_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.2 General Layout policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The following analysis policies help control general layout parameters:- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#page_width }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000b00000050006100670065002000770069006400740068000000e0c9ea79f9bace118c8200aa004ba90b7800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230070006100670065005f00770069006400740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Page width}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#tab_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000090000005400410042002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b7400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007400610062005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 TAB size}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#short_line_length }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000530068006f007200740020006c0069006e00650020006c0065006e006700740068000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730068006f00720074005f006c0069006e0065005f006c0065006e006700740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Short line length}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#min_chapter_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000004d0069006e00200063006800610070007400650072002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e005f0063006800610070007400650072005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Min chapter size}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_blank_lines_between_paras }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000021000000450078007000650063007400200062006c0061006e006b0020006c0069006e006500730020006200650074007700650065006e002000700061007200610073000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0062006c0061006e006b005f006c0069006e00650073005f006200650074007700650065006e005f00700061007200610073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect blank lines between paras}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#hanging_paragraph_position(s) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e000000480061006e00670069006e0067002000700061007200610067007200610070006800200070006f0073006900740069006f006e002800730029000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680061006e00670069006e0067005f007000610072006100670072006100700068005f0070006f0073006900740069006f006e002800730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Hanging paragraph position(s)}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#search_for_definitions }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000017000000530065006100720063006800200066006f007200200044006500660069006e006900740069006f006e0073000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007300650061007200630068005f0066006f0072005f0064006500660069006e006900740069006f006e0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Search for Definitions}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#new_paragraph_offset }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000150000004e0065007700200050006100720061006700720061007000680020004f00660066007300650074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e00650077005f007000610072006100670072006100700068005f006f00660066007300650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 New Paragraph Offset}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#definition_char }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001000000044006500660069006e006900740069006f006e00200043006800610072000000e0c9ea79f9bace118c8200aa004ba90b8200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006500660069006e006900740069006f006e005f0063006800610072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Definition Char}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#indent_position(s) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000049006e00640065006e007400200070006f0073006900740069006f006e002800730029000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e00640065006e0074005f0070006f0073006900740069006f006e002800730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Indent position(s)}}} \par \par \par}} {\*\bkmkstart Section_6_2_3} {\*\bkmkend Section_6_2_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.3 Bullet policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following bullet point policies that will normally be correctly calculated on the analysis pass :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#look_for_bullets }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000004c006f006f006b00200066006f0072002000620075006c006c006500740073000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006f006f006b005f0066006f0072005f00620075006c006c006500740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Look for bullets}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_alphabetic_bullets }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000450078007000650063007400200061006c00700068006100620065007400690063002000620075006c006c006500740073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0061006c00700068006100620065007400690063005f00620075006c006c006500740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect alphabetic bullets}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_numbered_bullets }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001800000045007800700065006300740020006e0075006d00620065007200650064002000620075006c006c006500740073000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f006e0075006d00620065007200650064005f00620075006c006c006500740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect numbered bullets}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_roman_numeral_bullets }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d000000450078007000650063007400200072006f006d0061006e0020006e0075006d006500720061006c002000620075006c006c006500740073000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0072006f006d0061006e005f006e0075006d006500720061006c005f00620075006c006c006500740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect roman numeral bullets}}} \par \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#recognise__-__as_a_bullet }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a0000005200650063006f0067006e00690073006500200027002d002700200061007300200061002000620075006c006c00650074000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007200650063006f0067006e006900730065005f005f002d005f005f00610073005f0061005f00620075006c006c00650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Recognise '-' as a bullet}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#recognise__o__as_a_bullet }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a0000005200650063006f0067006e00690073006500200027006f002700200061007300200061002000620075006c006c00650074000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007200650063006f0067006e006900730065005f005f006f005f005f00610073005f0061005f00620075006c006c00650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Recognise 'o' as a bullet}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#bullet_char }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c000000420075006c006c0065007400200063006800610072000000e0c9ea79f9bace118c8200aa004ba90b7a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300620075006c006c00650074005f0063006800610072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Bullet char}}}\par \par AscToHTM tries hard not to get confused by the "1", "a" and "I" that happen to end up at the start of lines by random. These could get mistaken for bullet points. \par \par}} {\*\bkmkstart Section_6_2_4} {\*\bkmkend Section_6_2_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.4 Contents analysis policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ There is only one analysis contents policy:- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000450078007000650063007400200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect contents list}}} \par This is described together with all the output contents list policies in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0036005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents generation policies}}} \par For more information on content list generation see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2}}}. \par \par}} {\*\bkmkstart Section_6_2_5} {\*\bkmkend Section_6_2_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.5 File Structure policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following file structure policies that will normally be need to be set manually :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#keep_it_simple }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f0000004b006500650070002000690074002000730069006d0070006c0065000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006b006500650070005f00690074005f00730069006d0070006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Keep it simple}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_code_samples }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000450078007000650063007400200063006f00640065002000730061006d0070006c00650073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0063006f00640065005f00730061006d0070006c00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect code samples}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_contains_dos_characters }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002300000049006e007000750074002000660069006c006500200063006f006e007400610069006e007300200044004f005300200063006800610072006100630074006500720073000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f0063006f006e007400610069006e0073005f0064006f0073005f0063006800610072006100630074006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file contains DOS characters}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_contains_mime_encoding }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002200000049006e007000750074002000660069006c006500200063006f006e007400610069006e00730020004d0049004d004500200065006e0063006f00640069006e0067000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f0063006f006e007400610069006e0073005f006d0069006d0065005f0065006e0063006f00640069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file contains MIME encoding}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_contains_pcl_codes }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e00000049006e007000750074002000660069006c006500200063006f006e007400610069006e0073002000500043004c00200063006f006400650073000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f0063006f006e007400610069006e0073005f00700063006c005f0063006f006400650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file contains PCL codes}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_contains_japanese_characters }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002800000049006e007000750074002000660069006c006500200063006f006e007400610069006e00730020004a006100700061006e00650073006500200063006800610072006100630074006500720073000000e0c9ea79f9bace118c8200aa004ba90bb200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f0063006f006e007400610069006e0073005f006a006100700061006e006500730065005f0063006800610072006100630074006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file contains Japanese characters}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_has_change_bars }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000049006e007000750074002000660069006c006500200068006100730020006300680061006e0067006500200062006100720073000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f006800610073005f006300680061006e00670065005f0062006100720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file has change bars}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_has_page_markers }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000049006e007000750074002000660069006c00650020006800610073002000700061006700650020006d00610072006b006500720073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f006800610073005f0070006100670065005f006d00610072006b006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file has page markers}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#page_marker_size_(in_lines) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000500061006700650020006d00610072006b00650072002000730069007a0065002000280069006e0020006c0069006e006500730029000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230070006100670065005f006d00610072006b00650072005f00730069007a0065005f00280069006e005f006c0069006e006500730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Page marker size (in lines)}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#text_justification }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000013000000540065007800740020004a0075007300740069006600690063006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230074006500780074005f006a0075007300740069006600690063006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Text Justification}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_file_is_double_spaced }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000049006e007000750074002000660069006c006500200069007300200064006f00750062006c00650020007300700061006300650064000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f00660069006c0065005f00690073005f0064006f00750062006c0065005f007300700061006300650064000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input file is double spaced}}} \par \par \par}} {\*\bkmkstart Section_6_2_6} {\*\bkmkend Section_6_2_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.6 Heading policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following section heading policies that will normally be correctly calculated on the analysis pass :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_numbered_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000045007800700065006300740020004e0075006d00620065007200650064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f006e0075006d00620065007200650064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Numbered Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_underlined_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b000000450078007000650063007400200055006e006400650072006c0069006e00650064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0075006e006400650072006c0069006e00650064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Underlined Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_capitalised_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000045007800700065006300740020004300610070006900740061006c0069007300650064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f006300610070006900740061006c0069007300650064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Capitalised Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_embedded_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000019000000450078007000650063007400200045006d006200650064006400650064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0065006d006200650064006400650064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Embedded Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#heading_key_phrases }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000480065006100640069006e00670020006b0065007900200070006800720061007300650073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680065006100640069006e0067005f006b00650079005f0070006800720061007300650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Heading key phrases}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#check_indentation_for_consistency }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002200000043006800650063006b00200069006e00640065006e0074006100740069006f006e00200066006f007200200063006f006e00730069007300740065006e00630079000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006800650063006b005f0069006e00640065006e0074006100740069006f006e005f0066006f0072005f0063006f006e00730069007300740065006e00630079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Check indentation for consistency}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_second_word_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000045007800700065006300740020005300650063006f006e006400200057006f00720064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f007300650063006f006e0064005f0077006f00720064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Second Word Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#first_section_number }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000460069007200730074002000530065006300740069006f006e0020004e0075006d006200650072000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300660069007200730074005f00730065006300740069006f006e005f006e0075006d006200650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 First Section Number}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#smallest_possible_section_number }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002100000053006d0061006c006c00650073007400200070006f0073007300690062006c0065002000730065006300740069006f006e0020006e0075006d006200650072000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230073006d0061006c006c006500730074005f0070006f0073007300690062006c0065005f00730065006300740069006f006e005f006e0075006d006200650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Smallest possible section number}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#largest_possible_section_number }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000004c00610072006700650073007400200070006f0073007300690062006c0065002000730065006300740069006f006e0020006e0075006d006200650072000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006100720067006500730074005f0070006f0073007300690062006c0065005f00730065006300740069006f006e005f006e0075006d006200650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Largest possible section number}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#preserve_underlining_of_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002100000050007200650073006500720076006500200075006e006400650072006c0069006e0069006e00670020006f0066002000680065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300700072006500730065007200760065005f0075006e006400650072006c0069006e0069006e0067005f006f0066005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Preserve underlining of headings}}} \par Section headers are far and away the most complex things the analysis pass has to detect, and the most likely area for errors to occur. \par AscToHTM will also document to a policy file the headings it finds. This is still to be finalised, but currently has the format \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 We have 4 recognised headings\par Heading level 0 = "" N at indent 0\par Heading level 1 = "" N.N at indent 0\par Contents level 0 = "" N at indent 0\par Contents level 1 = "" N.N at indent 2\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM will read in such lines from a policy text file, but does not yet fully supported editing these via the Windows interface. \par The syntax is explained below, but this will probably change in future releases. You can edit these lines in your policy file, and through the policy options in Windows. \par The lines are currently structured as follows \par }} { \trowd \trgaph108\trleft612 \clbrdrb\brdrs\cellx2267 \clbrdrb\brdrs\cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { {\b \keepn\intbl Line component\b0 \cell} {\b Value\b0 \cell} }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx2267 \cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl xxxx\par \cell Either "Heading" or "Contents" according\par to the part of the policy being described\par \cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx2267 \cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl Level n\par \cell Level number, starting at 0 for chapters\par 1 for level 1 headings etc.\par \cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx2267 \cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl "Some_word"\par \cell Any text that may be expected to occur before\par the heading number. E.g. "Chapter" or "Section"\par or "[". The case is unimportant.\par \cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx2267 \cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl N.Nx\par \par \cell The style of the heading number. This will\par ultimately (in later versions) be read\par as a series of number/separator pairs.\par \par The proposed format is\par "N" = number\par "i" / "I" = lower/upper case roman numeral\par with an 'x' at the end signalling that trailing\par letters may be expected (e.g. 5.6a, 5.6b)\par \cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } \trowd \trgaph108\trleft612 \cellx2267 \cellx6595 \keepn\widctlpar\intbl\adjustright \pard\intbl \s2\keepn\widctlpar \f102\fs20\b0\i0 { \keepn\intbl at indent n\cell The indentation that this heading is expected\par at. This is important in helping to eliminate\par false candidates.\cell }\nowidctlpar\widctlpar\intbl\adjustright {\row } } {\*\bkmkstart Section_6_2_7} {\*\bkmkend Section_6_2_7} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.7 Pre-formatted text policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following section heading policies that will normally be correctly calculated on the analysis pass :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimum_automatic__pre__size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d0000004d0069006e0069006d0075006d0020006100750074006f006d00610074006900630020003c005000520045003e002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d0075006d005f006100750074006f006d0061007400690063005f005f007000720065005f005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimum automaticsize}}} \par \par}} {\*\bkmkstart Section_6_2_8} {\*\bkmkend Section_6_2_8} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.2.8 Table analysis policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par AscToHTM uses the following policies to control the detection and analysis of tables :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#attempt_table_generation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041007400740065006d007000740020005400410042004c0045002000670065006e00650072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061007400740065006d00700074005f007400610062006c0065005f00670065006e00650072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Attempt TABLE generation}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#table_extending_factor }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000170000005400610062006c006500200065007800740065006e00640069006e006700200066006100630074006f0072000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007400610062006c0065005f0065007800740065006e00640069006e0067005f0066006100630074006f0072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Table extending factor}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_sparse_tables }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000450078007000650063007400200073007000610072007300650020007400610062006c00650073000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f007300700061007200730065005f007400610062006c00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect sparse tables}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#ignore_table_header_during_analysis }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000024000000490067006e006f007200650020007400610062006c0065002000680065006100640065007200200064007500720069006e006700200061006e0061006c0079007300690073000000e0c9ea79f9bace118c8200aa004ba90baa00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300690067006e006f00720065005f007400610062006c0065005f006800650061006400650072005f0064007500720069006e0067005f0061006e0061006c0079007300690073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Ignore table header during analysis}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#column_merging_factor }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001600000043006f006c0075006d006e0020006d0065007200670069006e006700200066006100630074006f0072000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c0075006d006e005f006d0065007200670069006e0067005f0066006100630074006f0072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Column merging factor}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimum_table_column_separation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000004d0069006e0069006d0075006d0020005400410042004c004500200063006f006c0075006d006e002000730065007000610072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d0075006d005f007400610062006c0065005f0063006f006c0075006d006e005f00730065007000610072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimum TABLE column separation}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_layout }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000440065006600610075006c00740020005400410042004c00450020006c00610079006f00750074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006c00610079006f00750074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE layout}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#tables_could_be_blank_line_separated }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000250000005400610062006c0065007300200063006f0075006c006400200062006500200062006c0061006e006b0020006c0069006e00650020007300650070006100720061007400650064000000e0c9ea79f9bace118c8200aa004ba90bac00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007400610062006c00650073005f0063006f0075006c0064005f00620065005f0062006c0061006e006b005f006c0069006e0065005f007300650070006100720061007400650064000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Tables could be blank line separated}}} \par \par}} {\*\bkmkstart Section_6_3} {\*\bkmkend Section_6_3} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{6.3 Output policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These policies are used to output and generation of files during conversion. Full descriptions of these policies can be found in the [Policy Manual]. \par}} {\*\bkmkstart Section_6_3_1} {\*\bkmkend Section_6_3_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.1 Added HTML policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following HTML policies that will only ever take effect if supplied in a user policy file :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_first_heading_as_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b0000005500730065002000660069007200730074002000680065006100640069006e00670020006100730020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f00660069007200730074005f00680065006100640069006e0067005f00610073005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use first heading as title}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_first_line_as_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001800000055007300650020006600690072007300740020006c0069006e00650020006100730020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f00660069007200730074005f006c0069006e0065005f00610073005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use first line as title}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f00000044006f00630075006d0065006e00740020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document title}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_description }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001500000044006f00630075006d0065006e00740020006400650073006300720069007000740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f006400650073006300720069007000740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document description}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_keywords }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001200000044006f00630075006d0065006e00740020006b006500790077006f007200640073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f006b006500790077006f007200640073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document keywords}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#background_image }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000004200610063006b00670072006f0075006e006400200049006d006100670065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006200610063006b00670072006f0075006e0064005f0069006d006100670065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Background Image}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_header_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c0020006800650061006400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f006800650061006400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML header file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_footer_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c00200066006f006f007400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f0066006f006f007400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML footer file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_script_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000480054004d004c0020005300630072006900700074002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f007300630072006900700074005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML Script file}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#omit__head__and__body__from_output }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000230000004f006d006900740020003c0048004500410044003e00200061006e00640020003c0042004f00440059003e002000660072006f006d0020006f00750074007000750074000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f006d00690074005f005f0068006500610064005f005f0061006e0064005f005f0062006f00640079005f005f00660072006f006d005f006f00750074007000750074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Omit and from output}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_base_url }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001200000044006f00630075006d0065006e007400200042006100730065002000550052004c000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f0062006100730065005f00750072006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document Base URL}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#comment_generation_code }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001800000043006f006d006d0065006e0074002000670065006e00650072006100740069006f006e00200063006f00640065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006d006d0065006e0074005f00670065006e00650072006100740069006f006e005f0063006f00640065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Comment generation code}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_fragments_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000480054004d004c00200066007200610067006d0065006e00740073002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f0066007200610067006d0065006e00740073005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML fragments file}}} \par \par These "polices" allow you to start "adding value" to the HTML generated. That is, they allow to specify things that cannot be inferred from the original text. \par You can also add HTML to your files by using the HTML preprocessor command (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.1}}}) \par \par}} {\*\bkmkstart Section_6_3_2} {\*\bkmkend Section_6_3_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.2 Cascading Style sheet policies (CSS)\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par AscToHTM has the following HTML policies that influence the use of CSS in the HTML generated :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#document_style_sheet }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001500000044006f00630075006d0065006e00740020005300740079006c0065002000530068006500650074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f00630075006d0065006e0074005f007300740079006c0065005f00730068006500650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Document Style Sheet}}} \par Not visible in the user interface is :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_embedded_style_sheet }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000430072006500610074006500200065006d0062006500640064006500640020007300740079006c0065002000730068006500650074000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f0065006d006200650064006400650064005f007300740079006c0065005f00730068006500650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create embedded style sheet}}} \par \par \par}} {\*\bkmkstart Section_6_3_3} {\*\bkmkend Section_6_3_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.3 Contents generation policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following HTML policies that influence the detection and generation of contents lists :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000450078007000650063007400200043006f006e00740065006e007400730020004c006900730074000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Contents List}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000410064006400200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add contents list}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#maximum_level_to_show_in_contents }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000220000004d006100780069006d0075006d0020006c006500760065006c00200074006f002000730068006f007700200069006e00200063006f006e00740065006e00740073000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d006100780069006d0075006d005f006c006500760065006c005f0074006f005f00730068006f0077005f0069006e005f0063006f006e00740065006e00740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Maximum level to show in contents}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_any_existing_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f000000550073006500200061006e00790020006500780069007300740069006e006700200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f0061006e0079005f006500780069007300740069006e0067005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use any existing contents list}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#generate_external_contents_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000020000000470065006e00650072006100740065002000650078007400650072006e0061006c00200063006f006e00740065006e00740073002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300670065006e00650072006100740065005f00650078007400650072006e0061006c005f0063006f006e00740065006e00740073005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Generate external contents file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#external_contents_list_filename }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000020000000450078007400650072006e0061006c00200063006f006e00740065006e007400730020006c006900730074002000660069006c0065006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300650078007400650072006e0061006c005f0063006f006e00740065006e00740073005f006c006900730074005f00660069006c0065006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 External contents list filename}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#hyperlinks_on_numbers }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000016000000480079007000650072006c0069006e006b00730020006f006e0020006e0075006d0062006500720073000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680079007000650072006c0069006e006b0073005f006f006e005f006e0075006d0062006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Hyperlinks on numbers}}} \par \par See also the discussion in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.2}}} \par \par}} {\*\bkmkstart Section_6_3_4} {\*\bkmkend Section_6_3_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.4 Document Colour policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par AscToHTM has a large number of HTML policies that can control the colouring of the files. These policies are spread across a number of areas of functionality. \par {\i General\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_all_colour_markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000053007500700070007200650073007300200061006c006c00200063006f006c006f007500720020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f0061006c006c005f0063006f006c006f00750072005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress all colour markup}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#active_link_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000041006300740069007600650020004c0069006e006b00200043006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100630074006900760065005f006c0069006e006b005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Active Link Colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004200610063006b00670072006f0075006e006400200043006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Background Colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c0000005400650078007400200043006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b7a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Text Colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#unvisited_link_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001600000055006e00760069007300690074006500640020004c0069006e006b00200043006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230075006e0076006900730069007400650064005f006c0069006e006b005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Unvisited Link Colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#visited_link_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000560069007300690074006500640020004c0069006e006b00200043006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230076006900730069007400650064005f006c0069006e006b005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Visited Link Colour}}} \par \par {\i Frames\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#header_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f00000048006500610064006500720020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006800650061006400650072005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Header frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#header_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000048006500610064006500720020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006800650061006400650072005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Header frame text colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#contents_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002100000043006f006e00740065006e007400730020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e00740065006e00740073005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#contents_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000043006f006e00740065006e007400730020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e00740065006e00740073005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents frame text colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#footer_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f00000046006f006f0074006500720020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230066006f006f007400650072005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Footer frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#footer_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000046006f006f0074006500720020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230066006f006f007400650072005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Footer frame text colour}}} \par \par {\i Tables\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#colour_data_rows }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001100000043006f006c006f007500720020006400610074006100200072006f00770073000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c006f00750072005f0064006100740061005f0072006f00770073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Colour data rows}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_border_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000440065006600610075006c00740020005400410042004c004500200062006f007200640065007200200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0062006f0072006400650072005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE border colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000440065006600610075006c00740020005400410042004c004500200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_even_row_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e000000440065006600610075006c00740020005400410042004c00450020006500760065006e00200072006f007700200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006500760065006e005f0072006f0077005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE even row colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_odd_row_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d000000440065006600610075006c00740020005400410042004c00450020006f0064006400200072006f007700200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006f00640064005f0072006f0077005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE odd row colour}}} \par \par \par}} {\*\bkmkstart Section_6_3_5} {\*\bkmkend Section_6_3_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.5 Directory Page policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following policies that can be used to influence whether or not AscToHTM will attempt to generate a Directory page for the files being converted. This is really only appropriate when converting more that one file at once (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_3_3" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0033005f0033000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.3.3}}}) \par The Directory Page will consist of entries for each file being converted (in order of conversion), and can have hyperlinks to the files, and to recognised headings in the files. This makes it suitable for use as a master index to a set of files converted in a single directory. \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#make_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000f0000004d0061006b00650020004400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b8000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0061006b0065005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Make Directory}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#indent_headings_in_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d00000049006e00640065006e0074002000680065006100640069006e0067007300200069006e0020004400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e00640065006e0074005f00680065006100640069006e00670073005f0069006e005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Indent headings in Directory}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#show_file_titles_in_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e000000530068006f0077002000660069006c00650020007400690074006c0065007300200069006e0020004400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730068006f0077005f00660069006c0065005f007400690074006c00650073005f0069006e005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Show file titles in Directory}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_filename }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004400690072006500630074006f00720079002000660069006c0065006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f00660069006c0065006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory filename}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_title }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000100000004400690072006500630074006f007200790020007400690074006c0065000000e0c9ea79f9bace118c8200aa004ba90b8200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f007400690074006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory title}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_description }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004400690072006500630074006f007200790020006400650073006300720069007000740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f006400650073006300720069007000740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory description}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_keywords }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004400690072006500630074006f007200790020006b006500790077006f007200640073000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f006b006500790077006f007200640073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory keywords}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_return_hyperlink_text }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000004400690072006500630074006f00720079002000720065007400750072006e002000680079007000650072006c0069006e006b00200074006500780074000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f00720065007400750072006e005f00680079007000650072006c0069006e006b005f0074006500780074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory return hyperlink text}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_header_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004400690072006500630074006f007200790020006800650061006400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f006800650061006400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory header file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_footer_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004400690072006500630074006f0072007900200066006f006f007400650072002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f0066006f006f007400650072005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory footer file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#directory_script_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004400690072006500630074006f007200790020007300630072006900700074002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006400690072006500630074006f00720079005f007300630072006900700074005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Directory script file}}} \par \par \par}} {\*\bkmkstart Section_6_3_6} {\*\bkmkend Section_6_3_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.6 File generation policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following HTML policies that affect the file generation process :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#input_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001000000049006e0070007500740020006400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b8200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e007000750074005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Input directory}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_directory }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000004f007500740070007500740020006400690072006500630074006f00720079000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f006400690072006500630074006f00720079000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output directory}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_.htm_extension }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000055007300650020002e00480054004d00200065007800740065006e00730069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f002e00680074006d005f0065007800740065006e00730069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use .HTM extension}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_file_extension }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004f00750074007000750074002000660069006c006500200065007800740065006e00730069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f00660069006c0065005f0065007800740065006e00730069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output file extension}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#preserve_file_structure_using__pre_ }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000024000000500072006500730065007200760065002000660069006c006500200073007400720075006300740075007200650020007500730069006e00670020003c005000520045003e000000e0c9ea79f9bace118c8200aa004ba90baa00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300700072006500730065007200760065005f00660069006c0065005f007300740072007500630074007500720065005f007500730069006e0067005f005f007000720065005f000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Preserve file structure using}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#preserve_line_structure }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000180000005000720065007300650072007600650020006c0069006e00650020007300740072007500630074007500720065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300700072006500730065007200760065005f006c0069006e0065005f007300740072007500630074007500720065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Preserve line structure}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#treat_each_line_as_a_paragraph }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f000000540072006500610074002000650061006300680020006c0069006e0065002000610073002000610020007000610072006100670072006100700068000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300740072006500610074005f0065006100630068005f006c0069006e0065005f00610073005f0061005f007000610072006100670072006100700068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Treat each line as a paragraph}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#generate_diagnostics_files }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b000000470065006e0065007200610074006500200064006900610067006e006f00730074006900630073002000660069006c00650073000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300670065006e00650072006100740065005f0064006900610067006e006f00730074006900630073005f00660069006c00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Generate diagnostics files}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_policy_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004f0075007400700075007400200070006f006c006900630079002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f0070006f006c006900630079005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output policy file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_policy_filename }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000170000004f0075007400700075007400200070006f006c006900630079002000660069006c0065006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f0070006f006c006900630079005f00660069006c0065006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output policy filename}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#dos_filename_root }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001200000044004f0053002000660069006c0065006e0061006d006500200072006f006f0074000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230064006f0073005f00660069006c0065006e0061006d0065005f0072006f006f0074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 DOS filename root}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_dos_filenames }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000012000000550073006500200044004f0053002000660069006c0065006e0061006d00650073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f0064006f0073005f00660069006c0065006e0061006d00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use DOS filenames}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#split_level }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c000000530070006c006900740020006c006500760065006c000000e0c9ea79f9bace118c8200aa004ba90b7a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730070006c00690074005f006c006500760065006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Split level}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#min_html_file_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004d0069006e002000480054004d004c002000460069006c0065002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e005f00680074006d006c005f00660069006c0065005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Min HTML File size}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_navigation_bar }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000041006400640020006e0061007600690067006100740069006f006e0020006200610072000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f006e0061007600690067006100740069006f006e005f006200610072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add navigation bar}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#minimise_html_file_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000180000004d0069006e0069006d006900730065002000480054004d004c002000660069006c0065002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e0069006d006900730065005f00680074006d006c005f00660069006c0065005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Minimise HTML file size}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#break_up_long_html_lines }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000042007200650061006b0020007500700020006c006f006e0067002000480054004d004c0020006c0069006e00650073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230062007200650061006b005f00750070005f006c006f006e0067005f00680074006d006c005f006c0069006e00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Break up long HTML lines}}} \par \par These policies specify how your document is divided into one or more HTML files, and how those files are to be named and linked together with hyperlinks. \par \par}} {\*\bkmkstart Section_6_3_7} {\*\bkmkend Section_6_3_7} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.7 Font policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM supports the implementation of fonts via either Cascading style sheets (CSS) or via the tag. \par Related policies are :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_css_to_implement_fonts }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b0000005500730065002000430053005300200074006f00200069006d0070006c0065006d0065006e007400200066006f006e00740073000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f006300730073005f0074006f005f0069006d0070006c0065006d0065006e0074005f0066006f006e00740073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use CSS to implement fonts}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_font }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000d000000440065006600610075006c007400200066006f006e0074000000e0c9ea79f9bace118c8200aa004ba90b7c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f0066006f006e0074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default font}}} \par \par \par}} {\*\bkmkstart Section_6_3_8} {\*\bkmkend Section_6_3_8} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.8 Frames policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par From version 4 onwards AscToHTM will support the output of HTML as a set of HTML FRAMES. A large number of policies support this process. \par {\i General\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#place_document_in_frames }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000050006c00610063006500200064006f00630075006d0065006e007400200069006e0020006600720061006d00650073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230070006c006100630065005f0064006f00630075006d0065006e0074005f0069006e005f006600720061006d00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Place document in frames}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_frame_name }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004f007500740070007500740020006600720061006d00650020006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f006600720061006d0065005f006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output frame name}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_frame_border }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001100000041006400640020004600720061006d006500200062006f0072006400650072000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f006600720061006d0065005f0062006f0072006400650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add Frame border}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#open_frame_links_in_new_window }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f0000004f00700065006e0020006600720061006d00650020006c0069006e006b007300200069006e0020006e00650077002000770069006e0064006f0077000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00700065006e005f006600720061006d0065005f006c0069006e006b0073005f0069006e005f006e00650077005f00770069006e0064006f0077000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Open frame links in new window}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#new_frame_link_window_name }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b0000004e006500770020006600720061006d00650020006c0069006e006b002000770069006e0064006f00770020006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e00650077005f006600720061006d0065005f006c0069006e006b005f00770069006e0064006f0077005f006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 New frame link window name}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_noframes_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000041006400640020004e004f004600520041004d004500530020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f006e006f006600720061006d00650073005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add NOFRAMES links}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#noframes_link_url }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004e004f004600520041004d004500530020006c0069006e006b002000550052004c000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e006f006600720061006d00650073005f006c0069006e006b005f00750072006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 NOFRAMES link URL}}} \par \par {\i Header and Footer frame policies\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_main_header_in_header_frame }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002000000055007300650020006d00610069006e002000680065006100640065007200200069006e00200068006500610064006500720020006600720061006d0065000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f006d00610069006e005f006800650061006400650072005f0069006e005f006800650061006400650072005f006600720061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use main header in header frame}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#header_frame_depth }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000048006500610064006500720020004600720061006d0065002000640065007000740068000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006800650061006400650072005f006600720061006d0065005f00640065007000740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Header Frame depth}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_main_footer_in_footer_frame }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002000000055007300650020006d00610069006e00200066006f006f00740065007200200069006e00200066006f006f0074006500720020006600720061006d0065000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f006d00610069006e005f0066006f006f007400650072005f0069006e005f0066006f006f007400650072005f006600720061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use main footer in footer frame}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#footer_frame_depth }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001300000046006f006f0074006500720020004600720061006d0065002000640065007000740068000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230066006f006f007400650072005f006600720061006d0065005f00640065007000740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Footer Frame depth}}} \par \par {\i Contents frame\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_contents_frame_if_possible }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f000000410064006400200063006f006e00740065006e007400730020006600720061006d006500200069006600200070006f0073007300690062006c0065000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f0063006f006e00740065006e00740073005f006600720061006d0065005f00690066005f0070006f0073007300690062006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add contents frame if possible}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#contents_frame_width }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001500000043006f006e00740065006e007400730020004600720061006d0065002000770069006400740068000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e00740065006e00740073005f006600720061006d0065005f00770069006400740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents Frame width}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#number_of_levels_in_contents_frame }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000230000004e0075006d0062006500720020006f00660020006c006500760065006c007300200069006e00200063006f006e00740065006e007400730020006600720061006d0065000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e0075006d006200650072005f006f0066005f006c006500760065006c0073005f0069006e005f0063006f006e00740065006e00740073005f006600720061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Number of levels in contents frame}}} \par {\i Main Frame\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#split_level }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000000c000000530070006c006900740020006c006500760065006c000000e0c9ea79f9bace118c8200aa004ba90b7a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730070006c00690074005f006c006500760065006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Split level}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#min_html_file_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004d0069006e002000480054004d004c002000460069006c0065002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006d0069006e005f00680074006d006c005f00660069006c0065005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Min HTML File size}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#first_frame_page_number }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000180000004600690072007300740020006600720061006d0065002000700061006700650020006e0075006d006200650072000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300660069007200730074005f006600720061006d0065005f0070006100670065005f006e0075006d006200650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 First frame page number}}} \par \par {\i Frame colours\i0} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#header_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f00000048006500610064006500720020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006800650061006400650072005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Header frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#header_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000048006500610064006500720020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006800650061006400650072005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Header frame text colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#contents_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002100000043006f006e00740065006e007400730020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e00740065006e00740073005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#contents_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000043006f006e00740065006e007400730020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e00740065006e00740073005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Contents frame text colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#footer_frame_background_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f00000046006f006f0074006500720020006600720061006d00650020006200610063006b00670072006f0075006e006400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230066006f006f007400650072005f006600720061006d0065005f006200610063006b00670072006f0075006e0064005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Footer frame background colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#footer_frame_text_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000046006f006f0074006500720020006600720061006d00650020007400650078007400200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230066006f006f007400650072005f006600720061006d0065005f0074006500780074005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Footer frame text colour}}} \par \par \par}} {\*\bkmkstart Section_6_3_9} {\*\bkmkend Section_6_3_9} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.9 Hyperlink policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following hyperlink policies set as defaults :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_hyperlinks }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000120000004300720065006100740065002000680079007000650072006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f00680079007000650072006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create hyperlinks}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_mailto_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001400000043007200650061007400650020006d00610069006c0074006f0020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f006d00610069006c0074006f005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create mailto links}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#allow_email_beginning_with_numbers }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002300000041006c006c006f007700200065006d00610069006c00200062006500670069006e006e0069006e0067002000770069007400680020006e0075006d0062006500720073000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061006c006c006f0077005f0065006d00610069006c005f0062006500670069006e006e0069006e0067005f0077006900740068005f006e0075006d0062006500720073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Allow email beginning with numbers}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#check_domain_name_syntax }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000043006800650063006b00200064006f006d00610069006e0020006e0061006d0065002000730079006e007400610078000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006800650063006b005f0064006f006d00610069006e005f006e0061006d0065005f00730079006e007400610078000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Check domain name syntax}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_gopher_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000430072006500610074006500200067006f00700068006500720020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f0067006f0070006800650072005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create gopher links}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_ftp_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000011000000430072006500610074006500200046005400500020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f006600740070005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create FTP links}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#only_allow_explicit_ftp_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e0000004f006e006c007900200061006c006c006f00770020006500780070006c006900630069007400200046005400500020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f006e006c0079005f0061006c006c006f0077005f006500780070006c0069006300690074005f006600740070005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Only allow explicit FTP links}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_news_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001200000043007200650061007400650020004e0045005700530020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b8600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f006e006500770073005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create NEWS links}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#only_use_known_groups }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004f006e006c007900200075007300650020006b006e006f0077006e002000670072006f007500700073000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f006e006c0079005f007500730065005f006b006e006f0077006e005f00670072006f007500700073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Only use known groups}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#recognised_usenet_groups }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000190000005200650063006f0067006e00690073006500640020005500530045004e00450054002000670072006f007500700073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007200650063006f0067006e0069007300650064005f007500730065006e00650074005f00670072006f007500700073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Recognised USENET groups}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add__br__to_lines_with_urls }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000041006400640020003c00420052003e00200074006f0020006c0069006e0065007300200077006900740068002000550052004c0073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f005f00620072005f005f0074006f005f006c0069006e00650073005f0077006900740068005f00750072006c0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add
to lines with URLs}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#cross-refs_at_level }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000430072006f00730073002d00720065006600730020006100740020006c006500760065006c000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300630072006f00730073002d0072006500660073005f00610074005f006c006500760065006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Cross-refs at level}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#open_link_in_new_browser_window }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000200000004f00700065006e0020006c0069006e006b00200069006e0020006e00650077002000620072006f0077007300650072002000770069006e0064006f0077000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00700065006e005f006c0069006e006b005f0069006e005f006e00650077005f00620072006f0077007300650072005f00770069006e0064006f0077000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Open link in new browser window}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#new_browser_window_name }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000180000006e00650077002000620072006f0077007300650072002000770069006e0064006f00770020006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e00650077005f00620072006f0077007300650072005f00770069006e0064006f0077005f006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 new browser window name}}} \par \par Hyperlinks can also be added by using a link dictionary (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_3_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0033005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.3.2.2}}} and {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_4_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0034005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.4.2}}}). \par \par}} {\*\bkmkstart Section_6_3_10} {\*\bkmkend Section_6_3_10} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.10 Link Dictionary policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Link definitions appear in a policy file as follows :- \par }} {\pard\plain \s3\keepn\widctlpar \f103\fs16\b0\i0 [Link Dictionary]\par -----------------\par Link definition : "a2hdoco.txt" = "Source text" + "/~jaf/A2HDOCO\par } {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ That is, the text to be matched, the text to be used in its placed as the highlighted text, and the URL this link is to point to (in this case a relative URL). \par See the discussions in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_3_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0034005f0033005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.3.2.2}}} and {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_4_4_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0034005f0034005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 4.4.2}}}. \par \par}} {\*\bkmkstart Section_6_3_11} {\*\bkmkend Section_6_3_11} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.11 Preprocessor policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following policies that can be used to influence the preprocessor (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000a000000530065006300740069006f006e005f0037000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Using the preprocessor}}}), and hence the HTML output :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use_preprocessor }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000110000005500730065002000500072006500700072006f0063006500730073006f0072000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f00700072006500700072006f0063006500730073006f0072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use Preprocessor}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#include_document_section(s) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000049006e0063006c00750064006500200064006f00630075006d0065006e0074002000730065006300740069006f006e002800730029000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230069006e0063006c007500640065005f0064006f00630075006d0065006e0074005f00730065006300740069006f006e002800730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Include document section(s)}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#allow_definitions_inside_pre }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d00000041006c006c006f007700200064006500660069006e006900740069006f006e007300200069006e00730069006400650020005000520045000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061006c006c006f0077005f0064006500660069006e006900740069006f006e0073005f0069006e0073006900640065005f007000720065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Allow definitions inside PRE}}} \par \par}} {\*\bkmkstart Section_6_3_12} {\*\bkmkend Section_6_3_12} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.12 HTML styling policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following "styling" that can be used to influence the HTML output :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#allow_automatic_centring }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041006c006c006f00770020006100750074006f006d0061007400690063002000630065006e007400720069006e0067000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061006c006c006f0077005f006100750074006f006d0061007400690063005f00630065006e007400720069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Allow automatic centring}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#automatic_centring_tolerance }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d0000004100750074006f006d0061007400690063002000630065006e007400720069006e006700200074006f006c006500720061006e00630065000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100750074006f006d0061007400690063005f00630065006e007400720069006e0067005f0074006f006c006500720061006e00630065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Automatic centring tolerance}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#ignore_multiple_blank_lines }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000490067006e006f007200650020006d0075006c007400690070006c006500200062006c0061006e006b0020006c0069006e00650073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300690067006e006f00720065005f006d0075006c007400690070006c0065005f0062006c0061006e006b005f006c0069006e00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Ignore multiple blank lines}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#highlight_definition_text }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a00000048006900670068006c006900670068007400200064006500660069006e006900740069006f006e00200074006500780074000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230068006900670068006c0069006700680074005f0064006500660069006e006900740069006f006e005f0074006500780074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Highlight definition text}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use__dl__markup_for_defn._paras }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002000000055007300650020003c0044004c003e0020006d00610072006b0075007000200066006f00720020006400650066006e002e002000700061007200610073000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f005f0064006c005f005f006d00610072006b00750070005f0066006f0072005f006400650066006e002e005f00700061007200610073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Usemarkup for defn. paras}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#largest_allowed__hn__tag }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000190000004c00610072006700650073007400200061006c006c006f0077006500640020003c0048006e003e0020007400610067000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c006100720067006500730074005f0061006c006c006f007700650064005f005f0068006e005f005f007400610067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Largest allowed
tag}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#smallest_allowed__hn__tag }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a00000053006d0061006c006c00650073007400200061006c006c006f0077006500640020003c0048006e003e0020007400610067000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230073006d0061006c006c006500730074005f0061006c006c006f007700650064005f005f0068006e005f005f007400610067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Smallest allowed tag}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#headings_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000010000000480065006100640069006e0067007300200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680065006100640069006e00670073005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Headings colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#preserve_underlining_of_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002100000050007200650073006500720076006500200075006e006400650072006c0069006e0069006e00670020006f0066002000680065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300700072006500730065007200760065005f0075006e006400650072006c0069006e0069006e0067005f006f0066005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Preserve underlining of headings}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#search_for_emphasis }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000530065006100720063006800200066006f007200200065006d007000680061007300690073000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007300650061007200630068005f0066006f0072005f0065006d007000680061007300690073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Search for emphasis}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use__em__and__strong__markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d00000055007300650020003c0045004d003e00200061006e00640020003c005300540052004f004e0047003e0020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f005f0065006d005f005f0061006e0064005f005f007300740072006f006e0067005f005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use and markup}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#preserve_new_paragraph_offset }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e0000005000720065007300650072007600650020004e0065007700200050006100720061006700720061007000680020004f00660066007300650074000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300700072006500730065007200760065005f006e00650077005f007000610072006100670072006100700068005f006f00660066007300650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Preserve New Paragraph Offset}}} \par Also, not available in the user interface is :- \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#first_line_indentation_(in_blocks) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000230000004600690072007300740020006c0069006e006500200069006e00640065006e0074006100740069006f006e002000280069006e00200062006c006f0063006b00730029000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300660069007200730074005f006c0069006e0065005f0069006e00640065006e0074006100740069006f006e005f00280069006e005f0062006c006f0063006b00730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 First line indentation (in blocks)}}} \par}} {\*\bkmkstart Section_6_3_13} {\*\bkmkend Section_6_3_13} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.13 Table Generation policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM has the following policies that can be used to influence whether or not AscToHTM will attempt to detect and generate HTML tables, and the attributes of any tables generated. \par Tables may be tailored individually by adding pre-processor commands to your source text (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_1_4" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0031005f0034000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.1.4}}}) \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#attempt_table_generation }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000041007400740065006d007000740020005400410042004c0045002000670065006e00650072006100740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230061007400740065006d00700074005f007400610062006c0065005f00670065006e00650072006100740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Attempt TABLE generation}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_cell_spacing }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b000000440065006600610075006c00740020005400410042004c0045002000630065006c006c002000730070006100630069006e0067000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00630065006c006c005f00730070006100630069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE cell spacing}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_cell_padding }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b000000440065006600610075006c00740020005400410042004c0045002000630065006c006c002000700061006400640069006e0067000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00630065006c006c005f00700061006400640069006e0067000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE cell padding}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_border_size }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000440065006600610075006c00740020005400410042004c004500200062006f0072006400650072002000730069007a0065000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0062006f0072006400650072005f00730069007a0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE border size}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_width }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000014000000440065006600610075006c00740020005400410042004c0045002000770069006400740068000000e0c9ea79f9bace118c8200aa004ba90b8a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00770069006400740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE width}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000440065006600610075006c00740020005400410042004c004500200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_border_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000440065006600610075006c00740020005400410042004c004500200062006f007200640065007200200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0062006f0072006400650072005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE border colour}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#colour_data_rows }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001100000043006f006c006f007500720020006400610074006100200072006f00770073000000e0c9ea79f9bace118c8200aa004ba90b8400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c006f00750072005f0064006100740061005f0072006f00770073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Colour data rows}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_even_row_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e000000440065006600610075006c00740020005400410042004c00450020006500760065006e00200072006f007700200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006500760065006e005f0072006f0077005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE even row colour}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_odd_row_colour }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d000000440065006600610075006c00740020005400410042004c00450020006f0064006400200072006f007700200063006f006c006f00750072000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006f00640064005f0072006f0077005f0063006f006c006f00750072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE odd row colour}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_alignment }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000018000000440065006600610075006c00740020005400410042004c004500200061006c00690067006e006d0065006e0074000000e0c9ea79f9bace118c8200aa004ba90b9200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f0061006c00690067006e006d0065006e0074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE alignment}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_cell_alignment }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001d000000440065006600610075006c00740020005400410042004c0045002000630065006c006c00200061006c00690067006e006d0065006e0074000000e0c9ea79f9bace118c8200aa004ba90b9c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00630065006c006c005f0061006c00690067006e006d0065006e0074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE cell alignment}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#convert_table_x-refs_to_links }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001e00000043006f006e00760065007200740020005400410042004c004500200058002d007200650066007300200074006f0020006c0069006e006b0073000000e0c9ea79f9bace118c8200aa004ba90b9e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006e0076006500720074005f007400610062006c0065005f0078002d0072006500660073005f0074006f005f006c0069006e006b0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Convert TABLE X-refs to links}}} \par The following policies can only be changed through policy file, but are probably best not used in favour of the their equivalent preprocessor tags. \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_caption }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000016000000440065006600610075006c00740020005400410042004c0045002000630061007000740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00630061007000740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE caption}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_header_rows }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000440065006600610075006c00740020005400410042004c0045002000680065006100640065007200200072006f00770073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006800650061006400650072005f0072006f00770073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE header rows}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_header_cols }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000440065006600610075006c00740020005400410042004c0045002000680065006100640065007200200063006f006c0073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006800650061006400650072005f0063006f006c0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE header cols}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#column_boundaries_have_zero_width }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002200000043006f006c0075006d006e00200062006f0075006e006400610072006900650073002000680061007600650020007a00650072006f002000770069006400740068000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c0075006d006e005f0062006f0075006e006400610072006900650073005f0068006100760065005f007a00650072006f005f00770069006400740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Column boundaries have zero width}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use__code_.._/code__markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000055007300650020003c0043004f00440045003e002e002e003c002f0043004f00440045003e0020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f005f0063006f00640065005f002e002e005f002f0063006f00640065005f005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use ..
markup}}} \par \par}} {\*\bkmkstart Section_6_3_14} {\*\bkmkend Section_6_3_14} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.3.14 Miscellaneous policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM supports the following policies which currently can only be added by editing the .policy file \par {\i Contents List\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#add_mail_headers_to_contents_list }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002200000041006400640020006d00610069006c0020006800650061006400650072007300200074006f00200063006f006e00740065006e007400730020006c006900730074000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006100640064005f006d00610069006c005f0068006500610064006500720073005f0074006f005f0063006f006e00740065006e00740073005f006c006900730074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Add mail headers to contents list}}} \par {\i CSS\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#create_embedded_style_sheet }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000430072006500610074006500200065006d0062006500640064006500640020007300740079006c0065002000730068006500650074000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006300720065006100740065005f0065006d006200650064006400650064005f007300740079006c0065005f00730068006500650074000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Create embedded style sheet}}} \par \par {\i File generation\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#break_up_long_html_lines }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000042007200650061006b0020007500700020006c006f006e0067002000480054004d004c0020006c0069006e00650073000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230062007200650061006b005f00750070005f006c006f006e0067005f00680074006d006c005f006c0069006e00650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Break up long HTML lines}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_version_to_be_targeted }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000480054004d004c002000760065007200730069006f006e00200074006f002000620065002000740061007200670065007400650064000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f00760065007200730069006f006e005f0074006f005f00620065005f00740061007200670065007400650064000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML version to be targeted}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#lines_to_ignore_at_end_of_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001f0000004c0069006e0065007300200074006f002000690067006e006f0072006500200061007400200065006e00640020006f0066002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90ba000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c0069006e00650073005f0074006f005f00690067006e006f00720065005f00610074005f0065006e0064005f006f0066005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Lines to ignore at end of file}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#lines_to_ignore_at_start_of_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000210000004c0069006e0065007300200074006f002000690067006e006f007200650020006100740020007300740061007200740020006f0066002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90ba400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006c0069006e00650073005f0074006f005f00690067006e006f00720065005f00610074005f00730074006100720074005f006f0066005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Lines to ignore at start of file}}} \par \par {\i Fonts\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_all_font_markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001900000053007500700070007200650073007300200061006c006c00200066006f006e00740020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9400000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f0061006c006c005f0066006f006e0074005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress all font markup}}} \par \par {\i Headings\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#expect_second_word_headings }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000045007800700065006300740020005300650063006f006e006400200057006f00720064002000480065006100640069006e00670073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500780070006500630074005f007300650063006f006e0064005f0077006f00720064005f00680065006100640069006e00670073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Expect Second Word Headings}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#first_section_number }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000015000000460069007200730074002000530065006300740069006f006e0020004e0075006d006200650072000000e0c9ea79f9bace118c8200aa004ba90b8c00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300660069007200730074005f00730065006300740069006f006e005f006e0075006d006200650072000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 First Section Number}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#number_of_words_to_include_in_filename }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000270000004e0075006d0062006500720020006f006600200077006f00720064007300200074006f00200069006e0063006c00750064006500200069006e002000660069006c0065006e0061006d0065000000e0c9ea79f9bace118c8200aa004ba90bb000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006e0075006d006200650072005f006f0066005f0077006f007200640073005f0074006f005f0069006e0063006c007500640065005f0069006e005f00660069006c0065006e0061006d0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Number of words to include in filename}}} \par {\i HTML Generation\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#html_version_to_be_targeted }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c000000480054004d004c002000760065007200730069006f006e00200074006f002000620065002000740061007200670065007400650064000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300680074006d006c005f00760065007200730069006f006e005f0074006f005f00620065005f00740061007200670065007400650064000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 HTML version to be targeted}}} \par \par {\i Style\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#first_line_indentation_(in_blocks) }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000230000004600690072007300740020006c0069006e006500200069006e00640065006e0074006100740069006f006e002000280069006e00200062006c006f0063006b00730029000000e0c9ea79f9bace118c8200aa004ba90ba800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300660069007200730074005f006c0069006e0065005f0069006e00640065006e0074006100740069006f006e005f00280069006e005f0062006c006f0063006b00730029000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 First line indentation (in blocks)}}} \par {\i Tables\i0}\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_caption }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000016000000440065006600610075006c00740020005400410042004c0045002000630061007000740069006f006e000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f00630061007000740069006f006e000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE caption}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_header_rows }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000440065006600610075006c00740020005400410042004c0045002000680065006100640065007200200072006f00770073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006800650061006400650072005f0072006f00770073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE header rows}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#default_table_header_cols }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a000000440065006600610075006c00740020005400410042004c0045002000680065006100640065007200200063006f006c0073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300640065006600610075006c0074005f007400610062006c0065005f006800650061006400650072005f0063006f006c0073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Default TABLE header cols}}} \par \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#column_boundaries_have_zero_width }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000002200000043006f006c0075006d006e00200062006f0075006e006400610072006900650073002000680061007600650020007a00650072006f002000770069006400740068000000e0c9ea79f9bace118c8200aa004ba90ba600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c00230063006f006c0075006d006e005f0062006f0075006e006400610072006900650073005f0068006100760065005f007a00650072006f005f00770069006400740068000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Column boundaries have zero width}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#use__code_.._/code__markup }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001b00000055007300650020003c0043004f00440045003e002e002e003c002f0043004f00440045003e0020006d00610072006b00750070000000e0c9ea79f9bace118c8200aa004ba90b9800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023007500730065005f005f0063006f00640065005f002e002e005f002f0063006f00640065005f005f006d00610072006b00750070000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Use..
markup}}} \par \par}} {\*\bkmkstart Section_6_4} {\*\bkmkend Section_6_4} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{6.4 Settings policies\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par These policies are used to control the behaviour of the program during the conversion process. Most program setting are not available as policies, but those that are are listed here. Full descriptions of these policies can be found in the [Policy Manual]. \par \par}} {\*\bkmkstart Section_6_4_1} {\*\bkmkend Section_6_4_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.4.1 Error reporting\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The following policies can be used to tailor the number and type of messages displayed during conversion. \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#error_reporting_level }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000160000004500720072006f00720020007200650070006f007200740069006e00670020006c006500760065006c000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006500720072006f0072005f007200650070006f007200740069006e0067005f006c006500760065006c000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Error reporting level}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_info_messages }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001700000053007500700070007200650073007300200049004e0046004f0020006d0065007300730061006700650073000000e0c9ea79f9bace118c8200aa004ba90b9000000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f0069006e0066006f005f006d0065007300730061006700650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress INFO messages}}},\par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_tag_error_messages }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001c00000053007500700070007200650073007300200054004100470020004500520052004f00520020006d0065007300730061006700650073000000e0c9ea79f9bace118c8200aa004ba90b9a00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f007400610067005f006500720072006f0072005f006d0065007300730061006700650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress TAG ERROR messages}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_url_messages }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000016000000530075007000700072006500730073002000550052004c0020006d0065007300730061006700650073000000e0c9ea79f9bace118c8200aa004ba90b8e00000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f00750072006c005f006d0065007300730061006700650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress URL messages}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_warning_messages }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b02000000170000001a0000005300750070007000720065007300730020005700410052004e0049004e00470020006d0065007300730061006700650073000000e0c9ea79f9bace118c8200aa004ba90b9600000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f007700610072006e0069006e0067005f006d0065007300730061006700650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress WARNING messages}}} \par {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#suppress_program_error_messages }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b020000001700000020000000530075007000700072006500730073002000700072006f006700720061006d0020004500520052004f00520020006d0065007300730061006700650073000000e0c9ea79f9bace118c8200aa004ba90ba200000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c002300730075007000700072006500730073005f00700072006f006700720061006d005f006500720072006f0072005f006d0065007300730061006700650073000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Suppress program ERROR messages}}} \par \par \par}} {\*\bkmkstart Section_6_5} {\*\bkmkend Section_6_5} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{6.5 Saving and loading policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This section has been copied into the Policy manual section on placing policies in a file \par}} {\*\bkmkstart Section_6_5_1} {\*\bkmkend Section_6_5_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.5.1 Overview\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ AscToHTM allows you to save policies to file so that you can later reload them. This allows you to easily define different ways of doing conversions, either for different types of files, or to produce different types of output. \par The policy files have a .pol extension by default, and are simple text files, with one policy on each line. You can, if you wish, edit these policies in a text editor... this is sometimes easier that using all the dialogs in the Windows version. \par When editing policies, it is important not to change the key phrase (the bit before the ":" character), as this needs to be matched exactly by AscToHTM. \par For best results, it is advisable to put in your policy file only those policies you want to fix. This leaves AscToHTM to calculate document-by-document policies that suit the files being converted. \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ {\pard\plain \s14\sb60\sa60 \f114\fs20\b0\i0\qj\fi-360\li720 {\b Note\b0}\tab Avoid using "full" policy file for your conversions. Such files prevent the program from adjusting to each source file, often leading to unwanted results.\par} \par}} {\*\bkmkstart Section_6_5_2} {\*\bkmkend Section_6_5_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.5.2 Generating policy files for your document\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The normal way to create a policy file is by setting options and them saving them using the "save policy file" dialog. This will offer you the choice of creating a partial policy file or a full policy file (see {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_5_2_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0036005f0035005f0032005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.5.2.1}}} and {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_6_5_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b020000000800000010000000530065006300740069006f006e005f0036005f0035005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 6.5.2.2}}}). \par Alternatively, you can set the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_policy_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004f0075007400700075007400200070006f006c006900630079002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f0070006f006c006900630079005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output policy file}}} policy which will generate a full policy file resulting from the analysis of the converted document. \par Once a file is generated you can either edit them in a text editor - deleting policies that are of little interest to you, and editing those that are - or reload them into the program, change them and save them again. \par \par}} {\*\bkmkstart Section_6_5_2_1} {\*\bkmkend Section_6_5_2_1} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{6.5.2.1 Partial policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Partial policy files are files which have values for some, not all, policies. \par These are recommended, because the it leaves AscToHTM free to adjust all the other policies not set in the file, allowing it to adapt to the details of the document being concerned. \par For example, you should only set the indentation policy if you {\b know\b0} what indents you are using, or if you want to override those calculated by AscToHTM. Normally it is best to omit this policy, and allow AscToHTM to work it out itself. \par When you save a policy file from inside AscToHTM, a partial policy file will contain \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}all policies loaded from the current policy file (if any)\par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li1080\fi-360\widctlpar\jclisttab\tx1080{ {\f1\'b7\tab}all policies changed in AscToHTM during the current session (if any)\par}} {\*\bkmkstart Section_6_5_2_2} {\*\bkmkend Section_6_5_2_2} {\pard\plain \s64\sb180\sa60\keepn\widctlpar \f164\fs20\b\i{6.5.2.2 Full policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ A "full" policy file contains a value for almost every possible policy. Such files are usually only useful for documentation and analysis reasons, and should almost never be expected to be reloaded as input into a conversion, as this would totally fix the conversion details. \par \par}} {\*\bkmkstart Section_6_5_3} {\*\bkmkend Section_6_5_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{6.5.3 Naming policy files\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Whenever the {\field{\*\fldinst {\fs20 HYPERLINK http://www.jafsoft.com/doco/policy_manual_5.html#output_policy_file }{\kerning0 {\*\datafield 00d0c9ea79f9bace118c8200aa004ba90b0200000017000000130000004f0075007400700075007400200070006f006c006900630079002000660069006c0065000000e0c9ea79f9bace118c8200aa004ba90b8800000068007400740070003a002f002f007700770077002e006a006100660073006f00660074002e0063006f006d002f0064006f0063006f002f0070006f006c006900630079005f006d0061006e00750061006c005f0035002e00680074006d006c0023006f00750074007000750074005f0070006f006c006900630079005f00660069006c0065000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 Output policy file}}} policy is set the generated "full" policy file is usually called \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{.pol \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ where is the name of the file being created. When this happens any existing file of that name will be overwritten. \par For this reason we {\b strongly\b0} advise you adopt a naming convention of the form \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ in_ .pol or i .pol \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ or place your input policies in a different directory and ensure they are backed up. \par \par \par}} {\*\bkmkstart Section_7} {\*\bkmkend Section_7} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{7 Using the preprocessor\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The preprocessor was introduced to allow users more flexibility in the HTML they generate. As such it allows AscToHTM to be used as a HTML authoring tool, as opposed to a simple text conversion or migration tool. \par The preprocessor looks for \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {i)\tab}"Directives". These are lines that begin with a special character sequence. Presently this is "$_$_". \par}} {\pard\plain \s12\sb30 \f112\fs20\b0\i0\qj\li720\fi-360\widctlpar\jclisttab\tx720{ {ii)\tab}"Tags" that are enclosed in "[[" and "]]".\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ A separate document - the [Tag Manual] - has been produced to describe the pre-processor commands in detail. That document replaces much of the contents that were originally in this section and the next. \par Some commands may be either tags or directives, this is explained more in the tag manual. \par}} {\*\bkmkstart Section_7_1} {\*\bkmkend Section_7_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{7.1 Directives\par}} {\*\bkmkstart Section_7_1_1} {\*\bkmkend Section_7_1_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.1 Marking up sections of text\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The pre-processor can be used to mark sections in your document so that AscToHTM will process them as you wish. \par These include :- \par BEGIN/END_CODE \par BEGIN/END_CONTENTS \par BEGIN/END_DIAGRAM \par BEGIN/END_HTML \par BEGIN/END_IGNORE \par BEGIN/END_PRE \par BEGIN/END_TABLE \par SECTION \par \par BEGIN/END_COMMA_DELIMITED_TABLE \par BEGIN/END_DELIMITED_TABLE \par \par \par}} {\*\bkmkstart Section_7_1_2} {\*\bkmkend Section_7_1_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.2 Commands that influence the .. of a file\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ Some commands can be used to control the contents of the HTML section. These attributes are largely non-visual, but may influence how the document is indexed (e.g. by search engines). \par Commands include :- \par TITLE \par DESCRIPTION \par KEYWORDS \par STYLE_SHEET \par BASEHREF\par \par To fully understand how titles are calculated, see the discussion in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_5_6_1" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0035005f0036005f0031000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 5.6.1}}} \par \par}} {\*\bkmkstart Section_7_1_3} {\*\bkmkend Section_7_1_3} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.3 One line pre-processor commands\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ These commands exist on a line by themselves. They either cause something to be executed at the point they occur, or are used to mark that location in the file in some way. \par The commands include :- \par CONTENTS_LIST \par HTML_LINE \par INCLUDE \par LINERULE \par NAVIGATION_BAR \par TOC \par \par \par}} {\*\bkmkstart Section_7_1_4} {\*\bkmkend Section_7_1_4} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.4 The TABLE commands\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ A large number of delimiters influence the detection, analysis and generation of tables. These are discussed in the [Tag manual] in the The TABLE commands section. \par The table commands include :- \par BEGIN/END_TABLE \par \par TABLE_BGCOLOR \par TABLE_BORDER \par TABLE_BORDERCOLOR \par TABLE_CAPTION \par TABLE_CELLPADDING \par TABLE_CELLSPACING \par TABLE_CELL_ALIGN \par TABLE_COLO(U)R_ROWS \par TABLE_CONVERT_XREFS \par TABLE_EVEN_ROW_COLO(U)R \par TABLE_HEADER_COLS \par TABLE_HEADER_ROWS \par TABLE_MAY_BE_SPARSE \par TABLE_MIN_COLUMN_SEPARATION \par TABLE_ODD_ROW_COLO(U)R \par \par BEGIN/END_COMMA_DELIMITED_TABLE \par BEGIN/END_DELIMITED_TABLE \par TABLE_ALIGN \par TABLE_IGNORE_HEADER \par TABLE_LAYOUT \par \par \par}} {\*\bkmkstart Section_7_1_5} {\*\bkmkend Section_7_1_5} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.5 The CHANGE_POLICY command\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The CHANGE_POLICY command allows policies as described in the [Policy Manual]. You can read more about this in the Tag Manual under The CHANGE_POLICY command \par \par}} {\*\bkmkstart Section_7_1_6} {\*\bkmkend Section_7_1_6} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.6 Block definition\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The programs allows you to define "blocks" of text that can later be inserted or embedded wherever you want in the text. For more details read the Tag Manual section Definition blocks and variables \par Commands include :- \par DEFINE/END_BLOCK and RESET_BLOCK \par DEFINE_VARIABLE \par EMBED_BLOCK \par INSERT_BLOCK \par \par SAVE_CONTEXT...RESTORE_CONTEXT \par \par \par}} {\*\bkmkstart Section_7_1_7} {\*\bkmkend Section_7_1_7} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.1.7 HTML Fragments\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par It is possible to define blocks of HTML that the program will use instead of the HTML it normally produces in certain circumstances. \par These blocks of HTML can themselves contain special HTML fragment tags to allow the HTML to be customized. For example the block HORIZONTAL_RULE can be used to replace the
tag produced wherever lines are detected by a .gif of your choice. If you want this .gif to adopt suitable length and alignment (to match those in the original text) you can use the HTML fragment tags RULEWIDTH and RULEALIGN. \par A full description of [HTML fragments] can be found in the [Tag Manual]. \par \par}} {\*\bkmkstart Section_7_2} {\*\bkmkend Section_7_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{7.2 In-line tags\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In-line tags are introduced in version 3.2. They allow you to place special codes in your source text to achieve effects that couldn't be done by converting plain text alone. As such they greatly enhance AscToHTM's ability to be used as a web authoring tool. \par \par}} {\*\bkmkstart Section_7_2_1} {\*\bkmkend Section_7_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.2.1 Format of in-line tags\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ In-line tags are an extension of the preprocessor tags introduced in earlier versions. As the name implies, in-line tags may be placed "in line" with the source tag, giving greater flexibility for their use. \par In-line tags are signified by the start and end delimiters "[[" and "]]", for example :- \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li720{ [[HTML_COMMENT this will become an HTML comment]] \par }} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ The whole tag must be contained within a single line of the source file, that is there cannot be any newline characters in the middle of a tag. You can have as many tags as you like on any given line, but they may not be nested. \par In-line tags are fully documented in the [Tag Manual]. A summary of some of the in-line tags available is given in {\field{\*\fldinst {\fs20 HYPERLINK \\l "Section_7_2_2" }{\kerning0 {\*\datafield 08d0c9ea79f9bace118c8200aa004ba90b02000000080000000e000000530065006300740069006f006e005f0037005f0032005f0032000000000000}}}{\fldrslt {\cs32\ul\cf2\fs20 7.2.2}}}. \par \par}} {\*\bkmkstart Section_7_2_2} {\*\bkmkend Section_7_2_2} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{7.2.2 Summary of in-line tags\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ This is a brief list of the available in-line tags. A fuller description of using in-line tags is available in the [tag manual] \par Tags include :- \par BR (line break) \par COLO(U)R \par CONTENTS_LIST \par ENTITY \par FONT \par GOTO \par HTML \par HTML_COMMENT \par HYPERLINK \par LINKPOINT \par SPACES \par NB "non-breaking spaces \par SUPER and SUB \par TEXT \par TIMESTAMP \par \par TABLE_LAYOUT \par FILENAME \par FRACTION \par IGNORE_THIS \par VARIABLE \par VERSION \par \par \par}} {\*\bkmkstart Section_8} {\*\bkmkend Section_8} {\pard\plain \s61\sb240\sa120\keepn\widctlpar \f161\fs28\b\i0{8 Frames\par}} {\*\bkmkstart Section_8_1} {\*\bkmkend Section_8_1} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{8.1 Overview\par}} {\pard\plain \s1\sb60\sa60 \f101\fs20\b0\i0\qj\li360{ {\b New in version 4\b0} \par New in version 4 is the ability to have the program generate a set of frames from your source file. The program works to a model set of frames as shown below, but you have a great degree of control over how the frames are laid out, and what their contents are. \par }} {\pard\plain \s4\keepn\widctlpar \f104\fs16\b0\i0 +------------------------------------------------------------+\par | Header frame |\par | (optional) |\par +-------------+----------------------------------------------+\par | NOFRAMES | |\par | link | |\par | | |\par | | |\par | | |\par | Contents | Main |\par | Frame | Frame |\par | (optional) | |\par | | |\par | | |\par | | |\par | | |\par | | |\par +-------------+----------------------------------------------+\par | Footer frame |\par | (optional) |\par +------------------------------------------------------------+\par } {\*\bkmkstart Section_8_2} {\*\bkmkend Section_8_2} {\pard\plain \s62\sb180\sa120\keepn\widctlpar \f162\fs24\b\i{8.2 The frames generated\par}} {\*\bkmkstart Section_8_2_1} {\*\bkmkend Section_8_2_1} {\pard\plain \s63\sb180\sa120\keepn\widctlpar \f163\fs24\b\i0{8.2.1 The master