Doc WAPT

Teilen Sie hier Ihre Erfahrungen und Gedanken zu WAPT / Kommen Sie hierher und berichten Sie über Ihre Erfahrungen mit Wapt, Ihre Meinung und Ihre Wünsche
Forumregeln
Community-Forumregeln
* Englischer Support auf www.reddit.com/r/wapt
* Französischer Community-Support wird in diesem Forum angeboten.
* Bitte kennzeichnen Sie gelöste Themen mit [GELÖST].
* Bitte bearbeiten Sie keine Themen, die mit [GELÖST] markiert sind. Erstellen Sie stattdessen ein neues Thema und verweisen Sie auf das alte.
* Geben Sie die installierte WAPT-Version (1.8.2 / 2.0 / 2.1 / 2.2 / etc.) sowie die Enterprise-/Discovery-Edition an.
* Geben Sie das Server-Betriebssystem (Linux / Windows) und die Version (Debian Stretch/Buster - CentOS 7 - Windows Server 2012/2016/2019) an.
* Geben Sie das Betriebssystem des Administrations-/Paketerstellungsrechners an (Windows 7 / 10)
. * Wie in jedem Community-Forum erfolgt der Support freiwillig durch die Mitglieder. Für Vertriebsunterstützung kontaktieren Sie bitte den Vertrieb von Tranquil IT unter +33 2 40 97 57 55.
Gesperrt
Benutzeravatar
OtOMatick
Nachrichten: 2
Anmeldung: 21. April 2017 - 10:36 Uhr

21. April 2017 - 10:39 Uhr

Hallo,
Ihre Dokumentation ist hervorragend! https://www.wapt.fr/fr/doc/
Könnten Sie mir bitte mitteilen, was ich benötige, um ein ähnliches Tool beim Kunden zu implementieren?
Ich nutze einen CentOS 7-Server und möchte meinem Kunden diese Art von Dokumentation zur Verfügung stellen.
Sie ist übersichtlich, einfach und sehr gut gemacht!

Vielen Dank für Ihr Feedback.
Benutzeravatar
agauvrit
WAPT-Experte
Nachrichten: 238
Anmeldung: 17. November 2016 - 10:25 Uhr
Ort: Nantes
Kontakt:

21. April 2017 - 10:54 Uhr

Hallo,

zunächst einmal vielen Dank im Namen von Tranquil IT Systems. Es freut uns immer sehr über Lob; unser gesamtes Team ist bestrebt, eine möglichst umfassende Dokumentation bereitzustellen.

Die Dokumentation selbst erstellen wir mit reStructuredText, Docutils und Sphinx.

Wenn Sie schon einmal Markdown oder ein Wiki bearbeitet haben, ist die Gliederung der Überschriften recht ähnlich. Der Hauptunterschied liegt im Kompilierungsprozess der Dokumentation, der es uns ermöglicht, Dokumentationen in verschiedenen Sprachen und Formaten (HTML, PDF, ePub und LaTeX) zu generieren.

Wenn Sie mehr über RST, Sphinx und Docutils erfahren möchten: https://www.jujens.eu/posts/2014/Aug/13 ... st-sphinx/

Die offizielle Dokumentation finden Sie hier: http://docutils.sourceforge.net/sandbox ... rt-fr.html

Alexandre
Benutzeravatar
OtOMatick
Nachrichten: 2
Anmeldung: 21. April 2017 - 10:36 Uhr

21. April 2017 – 14:52 Uhr

Danke, ich habe das gewünschte Ergebnis erzielt. ;)
Jetzt werde ich mich damit beschäftigen, wie man das Gleiche manuell macht, da ` yum install` und `pip install` meinen Anforderungen nicht genügen.

Ich möchte die Kontrolle darüber behalten, was ich installiere, damit ich das installieren kann, was ich will, wo ich will (also ausgehend von den tar.gz-Dateien).

(Gibt es zufällig eine Dokumentation zur Installation des gesamten Quellcodes unter CentOS?)
((Noch besser! Ein fertiges, konfigurierbares Paket, das alles Notwendige ohne Abhängigkeiten enthält.))
(((Hey, bieten Sie so etwas nicht auch Ihren Kunden an? Verteilen Sie diese Art von Wiki über Wapt an die Rechner Ihrer Kunden für deren interne Informationen? Einige von ihnen haben wahrscheinlich Intranets oder Wikis.)))
Benutzeravatar
agauvrit
WAPT-Experte
Nachrichten: 238
Anmeldung: 17. November 2016 - 10:25 Uhr
Ort: Nantes
Kontakt:

21. April 2017 – 17:15 Uhr

Für eine Neuinstallation gibt es ehrlich gesagt nicht viel Dokumentation, abgesehen von der setup.py-Datei des Sphinx-Projekts: https://github.com/sphinx-doc/sphinx/bl ... r/setup.py.

Wir verwenden sie nicht unter Windows; der Dokumentations-Kompilierungs-Bot aus dem Git-Repository (Jenkins) verwendet pip-Befehle zur Installation der Abhängigkeiten.

Viel Erfolg trotzdem mit RST. ;)
Gesperrt