Online-Manual erstellen aber womit

[DieDolly]

Direkt erwähnt, ich rede über solch ein Manual: https://docs.krita.org/en/index.html

Dieses wurde mit Sphinx erstellt.Keine Ahnung was man mit diesem Python-Zeug anfangen soll.
Aber gibt es keine einfache Möglichkeit, irgendein normales Windows-Programm was man kaufen und runterladen kann, um solche Manuals zu erstellen?

[mmw]

hallo,

vieleicht hilft dies

https://alternativeto.net/

gruß

[himitsu]

HTML/CSS kann man auch mit der Delphi-IDE erstellen/bearbeiten.
Da ist sogar ein kleiner WYSIWYG-Editor drin.
Also wirklich HTML-Dateien, die man via FTP hochladen kann ... Webserver, die auf HTTP eine generierte Webseite rausgeben, da gibt es auch einige Möglichkeiten.

Es gibt massenhaft CMS-Systeme, um Webseiten auch online, ohne Extraprogramm zu erstellen.
(gut, wenn man reines HTML/CSS/JS hat, wo Serverzeitig nicht arbeitet, da ist das dann gegen Hacking am Besten geschützt)

HTML-Editoren gibt es aber auch immernoch in Massen.
-> erstes Ergebins in Google: https://www.drweb.de/html-editoren/

HTML5, jQuery und Dergleichen bieten auch viele der Editoren an.

[Uwe Raabe]

Ich kenne jetzt zwar deine genauen Kriterien nicht, aber ich verwende seit langem Help+Manual. Wie das als Online-Hilfe aussehen kann, zeigt z.B. die hauseigene H+M Online-Hilfe: https://www.helpandmanual.com/help/index.html

[exon]

https://www.helpndoc.com/de/

[himitsu]

OK, Help&Manual nutzen wir auch ... mit eigenen Designs scheint es nicht ganz sooooo einfach zu sein.
Wikipedia und auch Embarcadero nutzt für seine Hilfe MediaWiki und es gibt noch weiter Wiki-Systeme.

Auch für Delphi gibt es Dinge, welche die XmlDoc aus den Delphi-Quellcodes ausliest und daraus eine Hilfe baut. (Emba macht auch sowas, mit den Typeinfos, um für alle Funktionen/Klassen/Konstanten/... eine Hilfeseite zu generieren, auch wenn die dann oft erstmal leer ist)

[DieDolly]

Zitat:

Auch für Delphi gibt es Dinge, welche die XmlDoc aus den Delphi-Quellcodes ausliest und daraus eine Hilfe baut

Hätte erwähnen sollen, dass der Code nicht wichtig ist. Es geht um Hilfen für Endbenutzer.

[himitsu]

Joar, klang auch eher, als wenn es mehr um sowas Tutorials geht, drum hatte ich die "Hilfe"-Generatoren auch erst weggelassen. :angle2:

[TigerLilly]

www.Doc-O-Matic.com hat eine Authoring Teil + kann aus einer Quelle PDF, CHM, HTML etc erzeugen.

[generic]

Ich bin ein großer Fan von Textformaten geworden.

Diese lassen sich auch prima mit einer Quelltext-Verwaltung verwalten und im Team bearbeiten.
Stände zu Versionsnummern funktionieren so prima.

AsciiDoc (https://asciidoc.org/).
MarkDown
oder ähnliches

Abhängig von den Templates lassen sich alle möglichen Formate erzeugen, also HTML oder PDF.

[DieDolly]

Zitat:

The current version of AsciiDoc requires Python 3.5 or later to run.

Damit fällt das leider für mich wieder weg.

[himitsu]

Es wurde mal für Python erfunden und es nutzt(e) Python, um seine eigene Dokumentatiopn zu generieren. (keine EXE, sondern Python-Stripte)

Wenn es kein "installiertes" Python braucht, dann kann man auch die Embeddable-Version des Python verwenden, wenn man nichts installieren will.

[generic]

AsciiDoc ist ein freies Format und es gibt viele Renderer dafür:

Java? Ruby?
https://docs.asciidoctor.org/asciido...atest/install/

[DieDolly]

Die Dokumentation soll im Internet verfügbar sein. HTML, CSS, PHP, JS.

[himitsu]

Ja, diese Tools erstellen dir HTML-Dateien (mit bissl CSS und JavaScript), welche du dann hochladen kannst.
Das Python und sowas muß dort garnicht vorhanden sein.

[hanvas]

Zitat:

Zitat von DieDolly (Beitrag 1484596)

Aber gibt es keine einfache Möglichkeit, irgendein normales Windows-Programm was man kaufen und runterladen kann, um solche Manuals zu erstellen?

Ein WYSIWYG-Editor, mit Export als HTML/PDF/EPUB ist AscidocFX. Die Software ist in Java geschrieben, läuft auch auf Windows und braucht Python nicht.

hth

Ha-Jo

https://asciidocfx.com/

[Rolf Frei]

Ich nutze auch Help&Manual und das hat auch eine HTML (Webhelp) Exportfuntion. Ich kann dir das eigentlich nur empfehlen. Das Design kannst du auch recht gut an deien Bedürfnisse anpassen. Vorallem hast du so die Möglichkeit auch viele anderer Hilfeformate aus eine Quelle zu erstellen: PDF, Windows HTML Help (CHM), Webhelp, Word, Winhelp, EBook.

[dummzeuch]

Nur um auch was in die Diskussion werfen zu können: Wäre ein Wiki vielleicht eine Möglichkeit? Es muss ja nicht für alle editierbar sein.