MAKEHTM v1.00 ------------- (c) 1995, Dr A Olowofoyeku (the African Chief) This program is a simple command line program that converts ascii files to HTML format suitable for WWW browsers (such as Mosaic, Netscape, and Cello). The program consists of DOS, Windows, and OS/2 (16-bit) versions. Files: ----- 1. MAKEHTM.EXE (Dos and Windows version - "bound" executable) 2. MAKEOS2.EXE (Dos and OS/2 version - "bound" executable) 3. MAKEHTM.TXT (This file) 4. MAKEHTM.INI (optional INI file containing codes) 5. SAMPLE.SRC (sample source file for MAKEHTM) 6. SAMPLE.HTM (output - HTML file for Chief's Installer Pro) The "bound" executables referred to above each contain 2 program modules - each contains a DOS program, which will execute as a DOS program if it is run from a DOS prompt. But each also contains either a Windows program (MAKEHTM.EXE) or an OS/2 program (MAKEOS2.EXE) which will run as a native Windows or OS/2 program if run from Windows, or from an OS/2 prompt, respectively. SYNTAX ------ Syntax = MAKEHTM [ [/TEMP] [/CODE] [/LIST] ] [>outfile] or MAKEHTM [PARAMETER] /TEMP = show a template HTML source (can be redirected to a file). /CODE = show the applicable codes (can be redirected to a file). /LIST = show the built-in codes (can be redirected to a file) Parameters = [/AUTO] [/AUTOFULL] [/CLEANUP] [/REV] [/BL+] [/LB+] /AUTO = create HTML headers automatically /AUTOFULL = create working HTML file automatically /BL+ = auto-convert blank lines to paragraphs /LB+ = add the line break code after each line of text /REV = convert HTML file back to MAKEHTM source /CLEANUP = remove all embedded formatting codes from file Examples: MAKEHTM /TEMP > tmp.htm MAKEHTM TEST1.TXT TEST1.HTM MAKEHTM TEST1.TXT TEST1.HTM /AUTO MAKEHTM TEST1.TXT TEST1.HTM /AUTO /BL+ MAKEHTM TEST1.TXT TEST1.HTM /AUTOFULL MAKEHTM TEST1.TXT TEST1.HTM /AUTOFULL /LB+ MAKEHTM TEST3.HTM TEST2.SRC /REV MAKEHTM TEST1.HTM TEST1.TXT /CLEANUP OPERATION --------- This program works by taking an ascii file as the input file, and then writing out an HTML file as the output file. The input file will contain embedded codes which represent HTML formatting codes. The embedded codes can either be in normal HTML language (which will be left intact), or in the form of codes supported by MAKEHTM (which will be converted to the specified HTML code). MAKEHTM contains 61 built-in codes, and you can obtain a list of them by typing: MAKEHTM /LIST (this presents a list of the built-in MAKEHTM codes, and what they will be translated to in the HTML output file) In addition to these 61 built-in codes, MAKEHTM also supports up to 20 user-defined codes. These must be put in a file called MAKEHTM.INI in the following format; = e.g., /i+ = /I- = NOTES: ----- 1. IF YOU HAVE A MAKEHTM.INI file, it MUST contain (in addition to any new ones) the first 61 codes. You can do this easily by redirecting the output from MAKEHTM /LIST to a file, and then deleting the first comment line from that file. The current MAKEHTM.INI was obtained by doing just that; i.e., MAKEHTM /LIST > MAKEHTM.INI 2. MAKEHTM.INI can contain only codes. No comments, no other statements. 3. You can change the default built-in codes in your MAKEHTM.INI file. 4. Whenever a MAKEHTM.INI file is found (in the current directory or in the DOS or OS/2 "PATH") its contents are used instead of the built-in codes. Please note this, whenever you are running any of the MAKEHTM programs. Failure to take this into account may lead to the wrong codes being used. 5. You can get a list of the codes that will be applied for any particular run by running: MAKEHTM /CODE Whatever output you see from that command is the codes that will be used if you run the program on your source files. DISCLAIMER ---------- Ok. I wrote these programs for my own use only, and the only guarantee that I care to give is that, running them on my own computer, and in my own house, will not lead to a nuclear holocaust which will destroy planet Earth. So, THE PROGRAMS MAKEHTM AND MAKEOS2 AND EVERY FILE OR PROGRAM IN THIS PACKAGE ARE ALL SUPPLIED "AS IS", WITHOUT ANY WARRANTEE OF ANY KIND WHATSOEVER. YOU USE ANY AND ALL OF THE FILES IN THIS PACKAGE ENTIRELY AT YOUR OWN RISK, AND YOU PUT THEM ON YOUR COMPUTER AT YOUR OWN RISK. YOU SUPPLY THEM TO YOUR FRIENDS, ACQUAINTANCES, SPOUSES, PARTNERS, ENEMIES AND MATES, ALL ENTIRELY AT YOUR OWN RISK. I ACCEPT NO LIABILITY FOR ANY LOSS OR DAMAGE, INCLUDING, BUT IN NO WAY LIMITED TO LOSSES OF A PHYSICAL, MENTAL, MARITAL, SOCIAL, ECONOMIC, FINANCIAL, OR OF ANY OTHER NATURE, WHETHER OR NOT OF THE SAME KIND AS ANY OF THE AFORESAID, IN RESPECT OF THE USE OR THE PURPORTED USE OF ANY OF THE FILES IN THIS PACKAGE, FOR ANY PURPOSE WHATSOEVER. I DO NOT EVEN WARRANTEE THAT THE FILES AND PROGRAMS IN THIS PACKAGE WILL NOT KILL YOU, NOR DO I WARRANTEE THAT THEY WILL NOT CAUSE WORLD WAR III, OR DAMAGE THE OZONE LAYER BEYOND REPAIR. IF YOU ARE NOT HAPPY WITH THESE DISCLAIMERS OR ANY OF THEM, THEN YOU MUST DELETED ALL THE FILES IN THIS PACKAGE FROM YOUR DISKS IMMEDIATELY, AND PERMANENTLY, AND YOU HAVE NO LICENSE OR PERMISSION TO USE OR TEST OR KEEP ANY OF THE FILES IN THIS PACKAGE. LICENSE ------- This package is released as FREEWARE. Use it as you please. If it works well for you, fine. Please drop me an email message about it (but please expect no replies). If it does not work well for you, then delete it - but please don't worry me about it. This program is free, and since you did not pay me for it, please do NOT expect ANY support at all. I will answer NO QUESTIONS about this program. Please note that fact. Above all, please don't give me a hard time about why it is not a GUI program or why I have done anything the way I did. This program was written ENTIRELY FOR MY OWN USE ONLY, and it serves THAT purpose VERY well. I have chosen to make it free to the world, so that those who find it useful may use it. Those who do not find it useful can go and buy a commercial or a shareware package that does the same. You may distribute this program freely - as long as; --------------------------------------------------- 1. ALL the files supplied by me are included 2. You do NOT add any files to the package (except that non-English translations of this file may be added, with no responsibility from me). 3. You do not alter any of the files in the package 4. You do not charge anything for the distribution, except that shareware disk vendors may charge a fee for disk duplication and handling (in any case not exceeding $5 US (or equivalent) Language: --------- MAKEHTM was written in Borland Pascal 7.0, and the OS/2 Module was written in Borland Pascal 7.0 with the BP4OS2 patch. Sorry, I cannot supply the source code. ------------------------------------------- September 1995, Dr A Olowofoyeku (the African Chief) Email: laa12@keele.ac.uk -------------------------------------------