Hilfe im Programm integrieren?

[NoGAD]

Hallo,

ich habe versucht, eine kleine Hilfe/Kurzanleitung für ein Programm im Programm selbst zu implementieren.

Mir gefällt aber einiges nicht, was ich versucht habe:

1. Richedit: Hier ist die Formatierung sehr umständlich, gerade, wenn es um längere Texte mit verschiedenen Schriftstilen.

2. Webbrowser: Hier sind unter Delphi 10 nur der IE oder Edge verfügbar, beides nutzen nicht alle.

3. Memo: Formatierungen sind hier einfach nicht möglich.


Hat jemand eine Idee, wie man optisch eine solche Aufgabe angeht?

Lieben Gruß Mathias

[DieDolly]

Zitat:

2. Webbrowser: Hier sind unter Delphi 10 nur der IE oder Edge verfügbar, beides nutzen nicht alle.

Eine integrierte Hilfe hat den Vorteil, dass sie offline verfügbar ist. Aber die Pflege ist u.U. umständlich und schön ist sowas auch nicht.

Ich habe meine Hilfe mittlerweile komplett ins WWW verlegt. Wenn man das selber machen möchte, kann man sich mit Bootstrap austoben oder ein Theme kaufen. Oder man nimmt PrettyDocs https://themes.3rdwavemedia.com/demo...ocs/start.html

Vergiss die lokale Offline-Hilfe, vergiss diese Windows-Hilfs-Dateien und vergiss den integrierten Webbrowser.

[himitsu]

Ist egal.

Wir erstellen mit Help&Manual,
die Hilfe kann im Verzeichnis liegen und direkt in einen integrierten Browser oder im StandardBrowser des Windows oder manuell in einer beliebigen Browser.exe geladen werden

sowohl direkt vom Verzeichnis, von einem Share, aus dem Verzeichnis über einen lokalen TIdHttpServer, über einen TIdHttpServer in einem Service irgendwo im Intranet, aus dem Internet (also über jeden anderen WebServer, egal, ob Lokal, im Netz oder im Web)



Und HTML/JS/CSS/Bilder kann man via resrotokoll auch aus den Ressourcen einer EXE/DLL in einen beliebigen Browser laden.

[Uwe Raabe]

Zitat von DieDolly:

Eine integrierte Hilfe hat den Vorteil, dass sie offline verfügbar ist. Aber die Pflege ist u.U. umständlich und schön ist sowas auch nicht.

Umständlich kommt vielleicht auch auf die verwendeten Tools an. Schön ist aber Geschmackssache.

Ich verwende zur Erstellung auch Help & Manual mit Ausgabe je nach Bedarf als CHM für die kontextsensitive Hilfe, PDF für Handbücher und HTML5/WebHelp für Internet & Co. Bislang bin ich damit immer ganz gut gefahren.

[TurboMagic]

Help & Manual kann sicher auch eine CHM Hilfedatei erzeugen.
Da ist dann alles in einer Datei drin und somit auch leichter mal jemand vorab zu
schicken etc. inkl. Index und Suchfunktion.

Die CHM kann man auch leicht an die eigene Anwendung anbinden. Jedes Hilfethema hat dann
eine numerische IDE und die kann man z.B. beim Edit usw. hinterlegen, dann wird bei F1 Drücken
das entsprechende Thema gleich automatisch aufgerufen.

[himitsu]

Und dann brauchst'e noch eine App zum Anzeigen der CHM.
Wie gut/schlecht das funktioniert sieht man am Delphi.

Wir haben uns ins ApplicationEvents.OnHelp gehängt,
da kann dann entweder im HelpContext etwas angegeben werden,
oder in einer Tabelle, welche über's Netz synchronisiert werden kann (da steht dann Form.ClassName, optional noch ein ActiveComponent.Name und dazu dann ein Dateiname sowie auch der Anker oder eine externe URL, z.B. ins Wiki)

Bei F1 word dann für das ActiveComponent, deren Parents (PageControl/Frame) bis zur Form nach oben zu geschaut, ob irgendwo etwas gefunden wird und das Erste dann angezeigt.

[NoGAD]

Ich beanke mich für eure Ideen.

Help & Manual ist mir für mein Hobby leider zu teuer.

Ich habe mich inzwischen doch mit einer Variante über TRichEdit abgefunden, erstelle die formatierte Hilfe in LibreOffice und lade den Code von der RTF-Datei als Stream ins RichEdit. Dann klappt es mit der Formatierung.

Lieben Gruß

[himitsu]

Du kannst HTML-Dateien auch kostenlos mit Delphi erstellen.

[NoGAD]

Zitat von himitsu:

Du kannst HTML-Dateien auch kostenlos mit Delphi erstellen.

Ja, das stimmt, geht auch mit einem Text-Editor. Aber ich möchte keine TWebBrowser-Komponente nutzen, lieber direkt im Programm einbinden.

[exon]

Es gibt auch noch HelpNDoc .

Das wird bei uns von den Kollegen genutzt, ich selbst bekomme davon nur die generierte pas-Datei mit den Hilfe-ID-Konstanten.

Scheint günstiger zu sein als das oben empfohlene. Und es gibt auch eine kostenlose Version für den privaten nichtkommerziellen Gebrauch.

gruß exon