KALHelp Hilfeautoren

Robert W.B. Linn´s Software, Beispielprojekte und Tipps zu TurboDB, TurboDB VCP, TurboDB Studio, Visual Data Publisher

KALHelp Hilfeautoren » KALHelp Hilfeautoren

KALHelp ist eine Datenbank basierte Anwendung für Hilfeautoren mit dem folgende On-Line-Hilfen und Dokumente erstellt werden können:

strukturierte HTML-Seiten

HTML Help Dateien (chm)

Rich Text Format Dateien (rtf)

gedruckte Dokumentationen (in Buch- oder Handout Format)

Schwerpunkt ist die Erstellung von Windows Hilfedateien mit vielfältige Einstellungsmöglichkeiten.

Das Prinzip beruht auf einem Thema mit Kapitel und einem oder mehreren Unterkapiteln, die sogenannte Topics.
Zu jedem Topic lassen sich wiederum Stichworte frei zuordnen. Im Topicinhalt können

Verweise auf Kapitel, Topics, Sub-Topics, Internet- oder eMail-Adressen definiert werden,

Grafiken (Bitmaps) eingebunden werden,

HTML-Tags definiert werden.

Die erstellte Seiten im Format HTML oder HTML Help zeigen

die Kapitel und Topics,

ein Stichwortverzeichnis,

ein Glossar,

alle Kapitel und Topics als Übersicht.

Weiterhin können mehrere Themen zu eine HTML Multi-Thema Anwendung zugeordnet werden.
Somit kann zum Beispiel eine Internet Homepage erstellt werden. Als Beispiel siehe www.rwblinn.de.

Die Anwendungsgebiete sind vielfältig.Beispiele zu nennen sind:

Hilfedateien für Anwenderprogramme (inkl. contextsensitive Hilfe)

Sammlungen von Informationen wie Tips und Tricks, Nachschlagewerke

Programmdokumentation

Benutzerhandouts

KALHelp ist einfach in der Bedienung. Keine komplexen Masken oder Bedienelemente.
Haben Sie Ihre Dokumentation einmal mit KALHelp erstellt, ist die Verwaltung sehr einfach.
Als Autor ist nur ein Quelltext in Form eine Datenbank zu warten.
Bedingt durch die Möglichkeit das Thema in gedruckter Form auszugeben, ist es nicht notwendig
eine gesonderte Dokumentation zu erstellen. Es können beliebig viele Themen verwaltet werden.

KALHelp ist Freeware

Screenshot

Downloads

KALHelp Hilfeautoren: kalhelp.exe (6.631 KB 08.08.2010 18:27)

KALHelp Editor : kalhelpe.zip (1.451 KB 08.08.2010 20:37)
Die Zip-Datei in das KALHelp Unterverzeichnis plugins entpacken.

KALHelp Viewer : kalhelpv.zip (1.011 KB 08.08.2010 19:19)
Die Zip-Datei in das KALHelp Unterverzeichnis plugins entpacken.

Installation

Die Datei kalhelp.exe ausführen und Anweisungen folgen.
KALHelp muß in ein neues Verzeichnis installiert werden.
Daten von eine vorherige Version importieren mittels
1.Dialogfenster Thema auswählen
2.Menü Datei/Import.../Update ... wählen
3.Ordner von vorherige Version eingeben (z.B. kalhlp62)
4.Je nach Anzahl Themen kann der Import einige Minuten dauern.

De-Installation

Windows Programmgruppe KALHelp: KALHelp De-Installation ausführen.

Updates

a. Um Teilupdates installieren zu können, muss KALHelp bereits installiert sein.
b. Teilupdates sind keine komplette Programmversionen aber enthalten Teilbereiche.
b. Teilupdates sind gepackte Dateien im Zip-Format. Im Downloadbereich sind Entpacker zu finden oder hier direkt pkunzip.exe (29 KB 01.02.1993 02:04).
c. Installation Teilupdate:
1. Das komplette KALHelp Programmverzeichnis inklusive Unterverzeichnisse sichern.
2. Das Update im KALHelp Programmverzeichnis entpacken - dabei die Verzeichnisstruktur beibehalten.
d. KALHelp starten. Das Thema-Formular zeigt links unten die aktuelle Version plus Versionsdatum

Hinweise

Ideen oder weitere Entwickelungen auf dieser Basis sind willkommen.

Changelog

(+) = Neu, (*) = Verbessert, (-) = Entfernt, (!) = Hinweis
Siehe auch unter KALHelp Entwicklungsstand nächste Version

[Versionsverwaltung]

(+) = Neu, (*) = Verbessert, (-) = Entfernt, (!) = Hinweis

6.5 (12.08.2010)

ALLGEMEIN
(*) Formulare überarbeitet (Symbole durch Schalter ersetzt)
(*) Info Symbole ersetzt durch Menüpunkt Hilfe/Info...
(+) KALHelp Hilfe von WinHelp auf auf HTML-Help umgestellt.
(-) Der externe Editor kann nicht mehr definiert werden. Standard ist KALHelp Editor im KALHelp Plugins Verzeichnis.
(*) Interne Verbesserungen

WINHELP
(-) WinHelp wird nicht mehr unterstützt

HTML
(+) Thema mit einem Topic, Topic als Indexseite verwenden
(+) Token links, mitte und rechts (wie left, center, right)
(+) Topic Details werden im Adresformat gezeigt
(*) Topic Fußzeile eMail + Autor Informationen ersetzt durch Copyright Information
(*) Fehler mailto Verweis behoben
(*) HTML Prüfungen erweitert (khputil.dll)
(*) HTML META Information Generator setzt Thema Autor
(-) HTML META Information DESC entfernt
(*) Fehler Verweis Darstellungen = (Schalter), * (unterstrichen), % (nicht unterstrichen) behoben

HTML HELP
(+) Route Information Leerzeichen durch >> ersetzt; wenn kein kapitel Routezeichen ausgeblendet
(+) Eine externe Keyworddatei htmlhelp.key kann eingebunden werden um Keywords frei definieren zu können
(+) Alias (hhalias.h) und Map (hhmap.h) Abschnitte werden erstellt und in der Projektdatei .hhp eingebunden. Ermöglicht Kontext-sensitive Hilfe (direkter Aufruf Topics)
(+) Popup Dateien (hhpopup.h und hhpopup.txt) für Popup Topics werden erstellt und in der Projektdatei .hhp eingebunden. Popup-Text ist max. 255 zeichen lang.
(+) Thema ohne Kapitel, nur Topics: Topics werden im Inhaltsverzeichnis aufgelistet, Index zeigt alle Topics und Zusatzdateien
(+) Thema ohne Kapitel, nur Topics: Seite Übersicht > Alle Topics auf eine Seite - Auswahlliste und Topics werden gezeigt
(+) KALHelp Optionen: Auswahl ob KALHelp Hilfeformat winhelp oder html help
(*) Ein Topic-Modus Inhaltsverzeichnis Fehler behoben
(*) Fehler Umwandlung Verweis auf die Erste Seite behoben

THEMA
(+) Thema-Formular: Kapitel und Topic HTML-Datei zeigen
(*) Thema-Formular: Symbole für Thema Neu, Bearbeiten und Löschen führen gleiche Aktionen aus wie die Schalter neu, bearbeiten und löschen
(+) Thema-Formular/Register Thema: Layout überarbeitet - links Thema Angaben, rechts Thema Generierung
(+) Thema-Formular/Register Thema: Thema Generierung erweitert mit Anzeige Buchform, Erstellen Buchform Text Standard
(+) Thema-Formular/Register Thema: Feld Copyright Platzhalter für Titel, Autor, Version, Datum, Zeit
(+) Thema-Formular/Register HTML Einstellungen: Angaben erste Seite können HTML Tags enthalten (z.B. Auswahlliste <BR><HR>)
(+) Thema-Formular/Register HTML Einstellungen: Angaben erste Seite Überschrift + Zeichen durch Kapitel+Topics zeigen ersetzt (Register Allgemeine Einstellungen)
(+) Thema-Formular/Register HTML Help Einstellungen: Kopiere CHM-datei zum Zielverzeichnis
(+) Thema-Formular/Register HTML Help Einstellungen - Feld Stopliste: Symbol zur Bearbeitung Stopliste mit dem ext. Editor
(+) Thema-Formular/Register HTML Help Einstellungen - Feld Stopliste: Zusätzlich Auswahl stoplist.stp als Vorgabe
(+) Thema-Formular: Menu/Extras>Dateimanager
(*) Thema-Formular: Verschiedene kleinere optische Verbesserungen
(+) Thema-Links-Formular/Neues Register Verweise mit den meisten Verweismöglichkeiten als Schalter zur Übernahme Link-Syntax im Text
(+) Token linie1 und linie2, verwenden die Thema HTML Einstellungen für Linien dick und dünn
(+) Token datum und zeit
(*) Berichte Thema in Buchform, Thema in Buchform RTF, HTML und Textausgabe verschiedene Fehler beseitigt

KAPITEL
(*) Kapitelformular: überarbeitet mit den Registern Kapitel, Kapitel-Text und Übersicht
(+) Kapitelformular: Menu > Extras > Kopiere Topic KontextNr
(+) Kapitelformular: Menu > Extras > Kopiere All Topic KontextNr

TOPICS
(*) Topicformular: überarbeitet mit den Registern Topic, Text Editor, Help Optionen und Übersicht
(+) Topicformular: Sicherheitsabfrage beim Speichern Topic in HTML Datei
(+) Topicformular: Schalter um ein Bild in ein Topic einzufügen
(*) Topicformular: Topic-Text Schalter Layout geändert

MULTITHEMA
(+) Multithema-Formular: Schalter für Edit Thema
(+) Multithema-Formular: Menu/Extras>Dateimanager
(*) Multithema-Formular: Layout erste Seite geändert (analog Thema-Formular)
(*) Navigator Layout optimiert
(+) Navigator Sucheintrag mittels kalhelp.ini > kalhelp > HTMLSuche = html ref tag
(+) Navigator Kontakteintrag mittels kalhelp.ini > kalhelp > HTMLKontakt = html ref tag
(+) Umwandlung Zeile aufgebaut aus | Zelle1 | Zelle2 | in eine HTML Tabelle wenn kalhelp.ini > kalhelp > HTMLMakeTable = 1.
(+) Topic-Auswahlliste nach Kapiteltext wenn Anzahl Topics >= Ini-Wert und ungleich 0. Ini-Wert ist kalhelp.ini > kalhelp > MltThemaZeigeSelect = NN. NN = Anzahl Topics.
(*) Interne Verbesserungen

KALHELP Viewer
(+) Topic-Texte in HTML-Format anzeigen
Aufruf: kalhelpv.exe
Ablage: Der KALHelp Viewer befindet sich im KALHelp Unterverzeichnis Plugins.

KALHELP Editor
(*) Umbenannt von KALHelpPad in KALHelp Editor
(*) Alle Tools in eine Anwendung zusammengefasst und überarbeitet
Aufruf: kalhelpe.exe
Ablage: Der KALHelp Editor befindet sich im KALHelp Unterverzeichnis Plugins.

KALHELP TOOLBOX
Eine neue KALHelp Toolbox befindet sich im KALHelp Verzeichnis Plugins.
Die Toolbox kann auch für frühere KALHelp Versionen verwendet werden.
Zu beachten sei bei der Verwendung für ältere KALHelp Versionen neue Verweise, wie datum, zeit, linie1, linie2 etc. nicht umgesetzt.
Aufruf: kalhelpt.exe
Ablage: Der KALHelp Toolbox befindet sich im KALHelp Unterverzeichnis Plugins.