
********************************************************************************
*
*   \         (c) Thomas Antoni, 27.1.2005 - 13.10.2009
*    \ /\           Mailto:thomas@antonis.de
*    ( )            Downloaded from www.antonis.de --- www.qbasic.de   
*  .( o ).
*                        ----==== Hottest QBasic Stuff on Earth !!! ====----
*
********************************************************************************

********************************************************************************
*
* .----------------.
* | ENGLISH  INFO  |  (Deutsche Info: Siehe unten)
* '----------------'
*
* Download File   : TXT2HTML V1.0 - Converts ANSI Textfiles to HTML
*                   ===================================================
* Prog. Language  : QBasic, QuickBasic
* Test Environment: DOS 6.22, Windos 3.1, Windows 95, NT4 and XP
* Author          : Thomas Antoni
*   - E-Mail      : thomas@antonis.de
*   - Website     : www.qbasic.de
*
********************************************************************************

*** Short Description
This program converts all textfiles in the directory C:\TMP\*.TXT into the 
equivalent HTML files. The converted files are provided in the subdirectory 
C:\TMP\*.HTML and can be viewed with any web browser.

The text files must have "TXT" extensions and can be provided in one of
the following text formats:
- ANSI Code      - Codepage ISO 8859-1 ("Latin 1/Western")
- ASCII Code     - MS-DOS-Codepage 437 ("English")
- Unicode UTF-16 - only the Low Bytes (=ISO 8859-1) are processed

As an option, all internet links and mail addresses are converted to clickable
web links. Another Option suports converting the first line of the TXT file
into an HTML headline.

*** Rating
+++    (in a range of + to +++)


********************************************************************************
*
* .---------------.
* | DEUTSCHE INFO |
* '---------------'
*
* Download-Datei: TXT2HTML V1.0 - Konvertiert ANSI Textdateien in HTML-Dateien
*                 ============================================================
* Progr.sprache : QBasic, QuickBasic
* Getestet unter: DOS 6.22, Windos 3.1, Windows 95, NT4 und XP
* Autor         : Thomas Antoni
*   - E-Mail    : thomas@antonis.de
*   - Webseite  : www.qbasic.de
*
********************************************************************************

*** Kurzbeschreibung
Dieses Q(uick)Basic-Programm wandelt alle im Verzeichnis C:\TMP\ vorgefundenen 
Textdateien in HTML-Dateien um, die in jedem Browser betrachtet werden knnen. 
Die resultierenden HTML-Dateien werden im Unterverzeichnis C:\TMP\HTML\ 
hinterlegt.

Die umzuwandelnden Text-Dateien muessen die Dateierweiterung ".TXT" besitzen. 
Die HTML-Ergebnisdateien erhalten dieselben Namen wie die jeweiligen Text-
Dateien, jedoch mit der Namenserweiterung ",HTM". Die Ausgangs-Text-Dateien 
bleiben unveraendert.

Im Startbildschirm des Programms werden die folgenden 4 Einstellmglichkeiten
angeboten:

1 Die Textdateien knnen in einem der folgenden Textformate kodiert sein:
    - ANSI Code      - Codeseite ISO 8859-1 ("Latin 1/Western")
    - ASCII Code     - MS-DOS-Codeseite 437 ("English")
    - Unicode UTF-16 - Es werden nur die niederwertigen Bytes aller Zeichencodes 
                       ausgewertet (=ISO 8859-1)

2 Optionell kann das Programm alle Web- und Mailadressen automatisch in 
  anklickbare Internet-Links umwandeln. Die Umwandlung in Web-Links erfolgt 
  dergestalt, dass die angeklickte Webseite grundsaetzlich immer in einem neuen 
  Browserfenster erscheint.

3 Die erste Zeile kann wahlweise als Ueberschrift formatiert werden
  mit <h1> und in der Schriftart "Arial Narrow" (Default: keine
  Ueberschrifts-Formatierung)

4 Bei Bedarf wird am Ende des HTML-Dokuments eine Fusszeile mit
  Copyright-Vermerk "(c) Thomas Antoni" und Datum/Uhrzeit eingefuegt
  (Default)

Diese Einstellungen werden beim Beenden das Programms in der Datei
C:\TXT2HTML.INI abgespeichert.

Die TXT-Dateien muessen folgende Voraussetzungen erfuellen:
- Der Text wird in der vorhandenen Formatierung mit allen Zeilenumbruechen
  in die HTML-Datei uebernommen. TXT2HTML fuegt keinerlei Zeilenumbrueche
  und Leerzeilen hinzu. Sinnvoll ist es z.B., die TXT-Datei mit 80 Zeichen
  je Zeile und mit Leerzeilen zwischen den Absaetzen vorzuformatieren.
- Internetadressen muessen mit "www.", "http://" oder "https://" beginnen.
  Direkt nach einer Internetadresse darf nur dann ein Punkt stehen, wenn
  auf diesen ein Leerzeichen folgt.
- Internet- und E-Mail-Adressen durfen nicht durch einen Zeilenumbruch
  unterbrochen werden, sondern muessen jeweils komplett in einer Zeile
  stehen.


*** Inhalt
- TXT2HTML.BAS            = Quellspracheprogramm
- TXT2HTML.EXE            = kompiliertes EXE-Programm

- Test\                   = Einige geteste TXT-Dateien mit den
                            resultierenden HTML-Dateien
- Test\ANSI\*.txt         = einige Testdateien im ANSI-Format
- Test\ANCII\*.txt        = einige Testdateien im ASCII-Format
- Test\UNICODE\*.txt      = einige Testdateien im Unicode-Format (UTF-16)
               Test5.txt  = ohne BOM-Markierung
               Test6.txt  = mit  BOM-Barkierung FFFE_hex
               Test7.txt  = mit  BOM-Barkierung FEFF_hex
- Test\URLtest\           = Test-Text im ANSI-Format mit diversen, teils
                            "exotischen" Webadressen (URLs) und E-Mail-
                            Adressen, die von TXT2HTML.bas in HTML-Links
                            umgewandelt werden.

- IndexGen\               = Ntzliches Zusatz-Tool. Erzeugt eine HTML-Indexdatei
                           (Inhaltsverzeichnis) INDEX.HTM fr eine Gruppe von
                           HML-Dateien. Damit kann man bequem eine bersicht
                           der konvertierten HTML-Dateien anlegen. Die HTML-
                           Dateien erscheinen dort als anklickbare Links.


*** Bewertung
+++   (in einer Skala von + bis +++)


                       ---=== Ende von _Antoni.txt ===---






