Seite 1 von 1

WIP: FujiNet Benutzerhandbuch

Verfasst: 20.03.2024 15:21
von tschak909
Ich arbeite derzeit an einem Benutzerhandbuch für den ATARI FujiNet.

Es wird mit Docbook geschrieben und auf GitHub gehostet:
https://github.com/FujiNetWIFI/fujinet-manuals

Die Gründe, warum ich es in diesem Format schreibe:
  • DocBook kann mehrere Ausgabeformate wiedergeben. Ich beabsichtige, PDF, EPUB und HTML zu verwenden.
    Der Stil ist von der Struktur getrennt.
    Das Standard-Stylesheet für PDF definiert ein druckbares Formular, das extrem professionell aussieht.
    Die Formatvorlage für HTML wird auf XSLTNG basieren. Dies erzeugt sehr sauberes HTML, sehr sauberes CSS und sieht auch sehr professionell aus.
    Internationalisierung ist möglich, um in andere Sprachen zu übersetzen.
Ich habe genug von einem Stylesheet getan, die ich eine Kopie des Dokuments unten gerendert haben.

Was haltet ihr davon?

-Thom

Re: WIP: FujiNet Benutzerhandbuch

Verfasst: 20.03.2024 20:48
von Olix
Finde ich klasse.
Wenn man bedenkt wie beliebt das FujiNet ist, dann wird das Handbuch sicher gut ankommen.

Re: WIP: FujiNet Benutzerhandbuch

Verfasst: 20.03.2024 22:35
von wosch
Perfekt.
Wenn´s jetzt noch ne Schwarz/Rot/Goldene Flagge zum Sprache umschalten gäbe.... :mrgreen:
Aber das was ich bis jetzt überflogen habe, ist gut zu verstehen.
Ich denke auf das Handbuch hat die Atari-Gemeinde gewartet.
HW-Unterschiede, Firmwareupdate, Links werden vermutlich noch kommen?
Gruß
Wolfgang

Re: WIP: FujiNet Benutzerhandbuch

Verfasst: 21.03.2024 00:51
von tschak909
Ich gehe davon aus, dass dieses Handbuch mindestens ein paar hundert Seiten umfassen wird. Ich habe so viele Inhalte, die ich schreiben muss. Jeder, der helfen kann, bitte tun, das Handbuch ist offen für alle über GitHub zusammenarbeiten.
working-on-docs.png
-Thom