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....
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.
-Thom
Re: WIP: FujiNet Benutzerhandbuch
Verfasst: 31.12.2024 19:18
von DjayBee
Thom hat gerade eine erweiterte Version des Handbuchs veröffentlicht.
Das PDF befindet sich hier:
https://github.com/FujiNetWIFI/fujinet- ... uide-0.0.2
und hier:
Re: WIP: FujiNet Benutzerhandbuch
Verfasst: 12.06.2026 21:56
von DjayBee
Thom lässt gerade Anleitungen komplett durch die Claude KI erstellen.
Als Basis dient der Quellcode(!), aus dem die KI sich die zu beschreibenden Punkte und weitere Informationen holt.
Das Layout und die Fonts zieht die KI aus bestehender Doku für das jewilige System.
Kleine Sneak-Previews:
- AtariSeite.png (63 KiB) 63 mal betrachtet
- AppleSeite.png (74.38 KiB) 63 mal betrachtet
Ein paar Zitate von ihm zu den Fähigkeiten der KI - schnell mittels DeepL übersetzt:
Die Dokumentation wird DIREKT AUS DEM QUELLCODE IM REPO erstellt.
Ich war fest darauf eingestellt, ihm einen Stapel Screenshots zu füttern, aber es war so: „Nee, da werden illustrierte Figuren verwendet, also mache ich sie selbst.“
Es hat alle Illustrationen erfasst, die schriftgesetzt waren, hat im Quellcode nachgeschaut und die Bildschirme von Hand rekonstruiert.
Das Bild vom Fujinet wurde aus unseren STL-Dateien erstellt.
Das System hat Bluetooth-Code für SIO2BT erkannt, obwohl wir es deaktiviert hatten. Dies wurde auf der Seite "UND ES GIBT NOCH MEHR" vermerkt.
Es hat ganz von selbst erkannt, dass man eine CAS-Datei in Slot 8 einlegen muss.
Meine Güte, sogar die Seite „Was tun, wenn es nicht funktioniert?“ ist richtig.
„DER COMPUTER STARTET EIN ALTES PROGRAMM ANSTELLE VON CONFIG“
Das ist ein Feature...
MEIN ECHTES LAUFWERK UND FUJINET STREITEN SICH UM LAUFWERK 1...
WO IST MEIN AUSDRUCK HINGEKOMMEN?
ICH HABE EIN SPIEL GESTARTET UND ERHALTE EINEN BLAUEN BILDSCHIRM, MÜLL ODER BASIC.
Halte die OPTION-Taste gedrückt.
Im Moment läuft es wie geschmiert mit dem Apple II, wobei das Apple //c-Benutzerhandbuch als Grundlage dient.
Ich habe dem Apple2-Stream einen Stapel Schriftarten übergeben, mit der ausdrücklichen Anweisung, die Schriftarten so genau wie möglich abzugleichen.
Es hat Apple Garamond, Century Std. korrekt erkannt...
Alle CONFIG-Bildschirme sind direkt in der Apple-II-ROM-Schriftart gesetzt –
für dieses Handbuch sind keine Screenshots erforderlich.