Ein neues Handbuch in AsciiDoc
Teil 5
Mittlerweile ist das neue Jahr schon ein paar Tage alt und auch die letzten Urlauber sind nun auch wieder fleissig am Arbeiten.
Natürlich habe ich auch über die Feiertage einen Gang runter geschaltet und hauptsächlich an administrativen Dingen für das neue Jahr gearbeitet. Ebenso habe ich einiges an der Webseite für die bald erscheinende Merlin Project-Version 8.1 vorbereitet.
Daraus kann der aufmerksame Leser sofort entnehmen, dass ich am neuen Handbuch nicht ganz viel geschrieben habe … eigentlich gar nichts 🤷♂️.
Reaktionen auf vorherige Beiträge
Trotzdem möchte ich auf einige Mails eingehen, die mich nach dem vierten Teil erreicht haben. Viele Leute interessieren sich sehr für die Variablen und Textersetzungen. Daher möchte ich dieses Mal einen wichtigen Tip geben.
Weiterlesen ...Ein neues Handbuch in AsciiDoc
Teil 4
In dieser Woche hat es endlich wieder funktioniert. Mein Plan mit den geblockten Zeitphasen im Kalender ist aufgegangen. Ich konnte am Mittwoch fast durchgehend schreiben.
Dabei sind mir ein paar Kleinigkeiten in AsciiDoc aufgefallen, die ich mit Ihnen teilen möchte.
Weiterlesen ...Ein neues Handbuch in AsciiDoc
Teil 3
Ich hatte es bereits zu Beginn befürchtet; bei aller Motivation das Buch schnell zu schreiben – das Tagesgeschäft steht dem irgendwie immer im Weg.
In der letzten Woche war ich sehr viel unterwegs. Natürlich im Auftrag des Herrn ;-) Und in dieser Woche folgte eine Überraschung der Nächsten.
Das Ergebnis ist unbefriedigend, aber deutlich: Ich habe keine 20 Sätze schreiben können.
Also kann ich mir das aktuelle Kanban-Board hier auch sparen; denn es sieht noch genau so aus.
Weiter geht es nächste Woche… hoffentlich.
Ein neues Handbuch in AsciiDoc
Teil 2
Dieses ist der zweite Teil meines Projektberichts für das neue Merlin Project-Handbuch. Ich werde jeden Freitag versuchen ein mehr oder weniger kurzes Update zum Projekt zu geben.
Das Projekt
Bevor wir uns auf AsciiDoc stürzen, hier ein schneller Blick auf mein Projekt.
- Das Git repository wurde aufgesetzt
- Die Zeilen sind definiert und wurden zum Teil auch hier aufgeführt.
- Die Vorraussetzungen sind soweit bekannt.
- Eine erste Gliederung ist erstellt und wird jetzt peu-à-peu verfeinert.
- Als Bilder werde ich zunächst nur schnelle Bildschirmfotos verwenden, und die dann bei Bedarf neu erstellen.
- Ein Wochentag zum Schreiben ist festgelegt.
Gerade der letzte Punkt war eine echte Herausforderung für mich, denn irgendwie muss ich mir die Zeit zum Schreiben freischaufeln. Wenn ich einfach nur jede verfügbare Minute nehme, werde ich wohl nie fertig. Ich brauche einen festen Zeitblock und genau den habe ich mir geschaffen. Ab sofort ist der Mittwoch mein Handbuch-Schreibtag. Mal schauen, wie lange das funktioniert …
Weiterlesen ...Ein neues Handbuch in AsciiDoc
Teil 1
Wir optimieren Merlin Project permanent für eine einfachere Bedienung. Begonnen haben wir bereits vor einiger Zeit mit dem Startdialog und dem Aufräumen des Inspektors.
Mit der Version 8 hat nun die dynamische Hilfe Einzug gehalten: Einfach nur das ?-Symbol anklicken und schon erhalten Sie zu jedem Objekt, auf das Sie mit der Maus (oder beim iPad mit dem Finger) zeigen, einen erklärenden Hilfetext. Für Ihre eigenen Felder können Sie sogar eigene Hilfetexte anlegen.
Doch leider hängt unser Handbuch etwas hinterher. Aber keine Sorge, es gibt reichhaltige und aktuelle Dokumentation, wie:
- Ein Tutorial,
- umfangreiche Fragen und Antworten,
- viele Support-Artikel in diesem Blog
- und natürlich die eingangs beschriebene, dynamische Hilfe.
Ein vollständiges Handbuch existiert zur Zeit nicht. Und genau das möchte ich jetzt ändern.
Weiterlesen ...