Format der Hilfedateien?

[shmia]

Zitat:

Zitat von DelphiMini (Beitrag 1080549)

aber ich schließe mich WM_CLOSE wie Bummi an.
Denn HTML ist, wie von WM_CLOSE beschrieben, gut einsetzbar.

Besser als nichts, aber weit von einer perfekten Lösung entfernt.
Eine Hilfedatei sollte platzsparend (also komprimiert) und alles in einer Datei enthalten.
Beides ist für normales HTML nicht erfüllt.
Wir haben z.B. eine Software, bei der über 250 HTML-Dateien als Hilfe beiliegen (in Deutsch und Englisch).
Installiert man beide Sprachen, dann braucht das auf der Platte über 200 MB :shock:
Microsoft war mit ihrem HTMLHelp (*.chm) im Prinzip schon auf dem richtigen Weg.
Eine CHM-Datei ist ein komprimierter Kontainer für HTML-Dateien.
Nur leider haben sie's verbockt und WinHelp2 erfunden :wall:

[WM_CLOSE]

@shmia: HTML hat aber den Vorteil, dass ich es bei Bedarf schnell in jedes beliebige Format umwandeln kann. (Bei Auslieferung der SW)
Dass chm bei größeren Projekten vielleicht diverse Vorteile bietet streitet ja niemand ab.

ABER: 200MB?? Sind da vielleicht viele große Bilder drin? Oder ist jede einzelne Seite mit einem eigenen Hintergrundbild belegt?
Bei mir hat eine Seite mit 3 Screenshots (800x600) im JPEG Format Max 0,5 MB
Das sind ja fast 1MB für jede seite!

Das mit den vielen Dateien ist aber tatsächlich ein Problem.

[Florian Hämmerle]

Ich gewöhn mir gerade an, meine Dokumentationen (auch wenn sie nicht sehr groß sind) mit Latex zu erstellen. Da kann man in viele Formate exportieren und alle zur Verfügung stellen.

[Namenloser]

LaTeX ist eine nette Sache, nutze ich auch gerne, für Dokumentationen habe ich es aber noch nicht eingesetzt (wobei ich sowieso bisher erst eine einzige geschrieben habe). Die Idee gefällt mir aber gut.

Hat jemand vielleicht ein kleines Beispiel, wie so eine mit LaTeX erstellte und ins chm-Format konvertierte Dokumentation aussieht?

[Florian Hämmerle]

Das kannst du über ein Stylesheet alles schön regeln :)

hab auf die schnelle auch kein Beispiel gefunden

[BUG]

Zitat:

Zitat von BUG (Beitrag 1080559)

Zu dem Thema evtl. interessant: http://www.delphipraxis.net/147569-l...erstellen.html

Obwohl man das wohl noch optimieren kann.

[Namenloser]

Zitat:

Zitat von Florian Hämmerle (Beitrag 1080610)

Das kannst du über ein Stylesheet alles schön regeln :)

Ist das so? Die Formatierungen von ins HTML-Format konvertierten LaTeX-Dokumenten sind nach meiner Erfahrung meist hardcoded. Aber es gibt ja auch verschiedene Converter, vielleicht machen manche es besser...

[Florian Hämmerle]

Ich denke schon, zumindest das von BUG verlinkte Beispiel - Dort werden classes verwendet.

mfg Florian

[smart]

Warum nimmt man zB. nicht eine Datenbank mit kleine Maske als Hilfe Datei?

[WM_CLOSE]

Weil das den eine Eigen-Bastellösung wäre.
In vielen Fällen würde es dem Anwender besser gefallen,
aber bis das dann richtig läuft und schön aussieht,... vergeht teure Zeit.
Man verwendet also das, was schon die Leute vor einem gebastelt haben (also schon fertig ist).