Seite 1 von 2
Windows Hilfe erstellen (chm) - Erläuterung der PB Verzeichn
Verfasst: 09.11.2007 21:35
von Kurzer
Nabend zusammen,
zwei Sachen, die evtl. miteinander zu tun haben:
1) Ich suche nach einem Tool / tutorial, um eine Windows-Hilfedatei für mein Programm zu erstellen. Die Endung für diese Dateien sind .chm. Kann sein, daß es da bereits neuere Formate gibt, ich meine das Format, welches auch unter Win98 darstellbar ist (die PB-Hilfe z.B.). Womit baut ihr Eure chm's?
2) Ich habe im PB-Verzeichnis Library SDK\DocMaker eine DocMaker.exe gefunden, deren Funktion sich mir nicht ganz erschliesst. Wäre das evtl. schon das Tool, welches ich brauche?
In diesem Zusammenhang ist auch das Interessen an den weiteren PB-Unterverzeichnissen aufgekeimt. Gibt es irgendwo eine Beschreibung für was die zusätzlichen Dateien in diesen Ordnern gut sind. Ich bin tendenziell nicht unbeleckt, was das "hinter die Kullissen gucken" angeht, aber da meine Erfahrunen lediglich von den Kulissen des Amiga herrühren (und auch ca. 15 Jahre alt sind), fehlt mir jetzt doch reichlich Grundlageninfo. Z.B. würde ich auch gern mal die von PB erzeugte Assembler-Datei einsehen wollen, die an den NAsm weitergereicht wird. Einfach nur, um wieder mal Assembler-Luft geschnuppert zu haben (auch wenn's kein 680x0 code ist
).
Verfasst: 09.11.2007 21:45
von X0r
Re: Windows Hilfe erstellen (chm) - Erläuterung der PB Verze
Verfasst: 09.11.2007 22:08
von Kiffi
Kurzer hat geschrieben:Womit baut ihr Eure chm's?
ich persönlich mit UDO (
http://www.udo-open-source.org/).
Allerdings ist hier ein wenig Einarbeitungszeit vonnöten.
Einsteigerfreundlicher sind das Programme wie der HelpMaker (Freeware):
http://www.vizacc.com/gen_download.php
Wenn es um Dokumentationen von PB-Libs oder Includes geht, dann solltest
Du Dir auf jeden Fall auch die Tools von gnozal anschauen:
http://freenet-homepage.de/gnozal/
Grüße ... Kiffi
Verfasst: 09.11.2007 22:16
von Thomas
Hatte damals die gleiche Frage ...
http://www.purebasic.fr/german/viewtopi ... hlight=chm
Jetzt benutze ich HTML Help Workshop:
HTML-Dateien erstellen das zeug dadurchjagen, FERTIG!
Verfasst: 10.11.2007 00:40
von Kurzer
Danke für die links...
HelpMaker schmiert mir unter Win98SE leider ab, gucke mir dann doch das M$ Produkt an (UDO will ich mir (noch) nicht antun
.)
Verfasst: 10.11.2007 13:24
von gnozal
What I did for PureFORM.chm :
- build the HTML files with NVU / KOMPOSER
- compile the HTML to CHM with PureHELP Compiler [or directly with MS Help Compiler]
- open CHM file (with TotalCMD plugin [or 7-ZIP])
- edit the HHC file
- recompile CHM (with TotalCMD plugin [or 7-ZIP])
Now, when I have to modify an HTML page :
- edit HTML file with NVU / KOMPOSER
- add to CHM (with TotalCMD plugin [or 7-ZIP])
I hope it's somehow clear enough ...
Note : I use TotalCMD a lot ; with the CHM plugin it can handle CHM files like a regular ZIP archive !
Verfasst: 10.11.2007 20:31
von Kurzer
Der HTML Help Workshop tut seinen Dienst (aus Zeitgründen leider erst 10 Minuten angesehen), hat aber wohl keinen eigenen WYSIWYG HTML-Editor bei. Macht nix, habe eh einen externen Editor wegen meiner Website. Besten Dank also, Eure Beiträge haben geholfen.
@gnozal: I'm a big TotalCommander fan too.
Could you shortly explain the purpose of the HHC file in a CHM (up to now I had no time to create a helpfile - I took only a quick look on HTML Help Workshop)?
And what is the name of the TC-Plugin you mentioned?
Do I understand correctly? If I have a basic framework in CHM-format, then I simply add modyfied HTML-file(s) into the CHM-file using the TC-Plugin. But if I have to change the structure of the Help (e.g. new links), then I have to use HTML Help Workshop?
Sorry, I have no time this weekend to test this.
Verfasst: 12.11.2007 12:13
von gnozal
Kurzer hat geschrieben:@gnozal: I'm a big TotalCommander fan too.
Could you shortly explain the purpose of the HHC file in a CHM (up to now I had no time to create a helpfile - I took only a quick look on HTML Help Workshop)?
And what is the name of the TC-Plugin you mentioned?
PLUGIN =
http://www.totalcmd.net/plugring/chmdir.html
The HHC file defines the 'summary' treegadget content.
Example (from PureFORM.chm) :
Code: Alles auswählen
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<HTML>
<HEAD>
<meta name="GENERATOR" content="Gnozal HelpMaker Pro">
<!-- Sitemap 1.0 -->
</HEAD><BODY>
<OBJECT type="text/site properties">
<param name="Window Styles" value="0x24">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Introduction">
<param name="Local" value="Introduction.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Gadget manipulation">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Create new gadgets">
<param name="Local" value="CreateGadgets.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Move / resize gadgets">
<param name="Local" value="MoveResizeGadgets.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Gadget placement">
<param name="Local" value="GadgetPlacement.htm">
</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Menus">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The main menu">
<param name="Local" value="MainMenu.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The window menu">
<param name="Local" value="WindowMenu.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The gadget menu">
<param name="Local" value="GadgetMenu.htm">
</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Windows">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The main window">
<param name="Local" value="MainWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The gadget list">
<param name="Local" value="GadgetListWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The window list">
<param name="Local" value="WindowListWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The gadget properties">
<param name="Local" value="GadgetPropertiesWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The window properties">
<param name="Local" value="WindowPropertiesWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The integrator">
<param name="Local" value="IntegratorWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The code view">
<param name="Local" value="CodeViewWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="The gadget bar">
<param name="Local" value="GadgetBarWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Menu builder">
<param name="Local" value="MenuBuilderWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Toolbar builder">
<param name="Local" value="ToolbarBuilderWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Statusbar builder">
<param name="Local" value="StatusBarBuilderWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Tab order">
<param name="Local" value="GadgetOrderWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Gadget groups">
<param name="Local" value="GadgetGroupsWindow.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Code infusion">
<param name="Local" value="CodeInfusionWindow.htm">
</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value=" Miscellaneous">
</OBJECT>
<UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Update source code">
<param name="Local" value="SourceUpdating.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Custom gadgets">
<param name="Local" value="CustomGadgetsWindow.htm">
</OBJECT>
</UL>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Preferences">
<param name="Local" value="Preferences.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="FAQ">
<param name="Local" value="FAQ.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="License">
<param name="Local" value="License.htm">
</OBJECT>
</UL>
</BODY></HTML>
Kurzer hat geschrieben:Do I understand correctly? If I have a basic framework in CHM-format, then I simply add modyfied HTML-file(s) into the CHM-file using the TC-Plugin.
Yes, works for me.
Kurzer hat geschrieben:But if I have to change the structure of the Help (e.g. new links), then I have to use HTML Help Workshop?
Not necessarily. Copy your new HTML files to the CHM and update the HHC file.
Verfasst: 13.11.2007 00:03
von Kurzer
Edit: Too bad, the TC Plugin don't run on Win98Se. But HTML Help Workshop will be adequate.
Verfasst: 29.12.2007 10:09
von gnozal
Kurzer hat geschrieben:
Edit: Too bad, the TC Plugin don't run on Win98Se. But HTML Help Workshop will be adequate.
It runs, be sure to download the latest version [there was a Win98 bug in some versions].