Sources und Infos zur JavaMagazin-Kolumne von R.D. Müller und G. Starke
Wir stellen Ihnen eine Reihe von Werkzeugen vor, mit denen Sie AsciiDoc schreiben und bearbeiten können. Dazu gehören natürlich die "ganz normalen" Editoren und einige PlugIns für moderne Entwicklungsumgebungen. Andererseits sind AsciiDoc und AsciiDoctor ihrerseits ja auch nur Werkzeuge, die "adoc" Dateien in html oder andere Formate übersetzen - also diskutieren wir kurz, wie Sie AsciiDoc/AsciiDoctor in Ihren Buildprozess oder Ihre CI-Pipeline integrieren können.
Der Zweck DIESER Datei ist diesmal mehr eine Link-Sammlung, und weniger eine Anleitung für eigene docs-as-code Experimente.
-
AsciiDocFX als Standalone-AsciiDoc Editor
-
normale Editoren und/oder Entwicklungsumgebungen mit AsciiDoc
-
VS-Code, (Visual-Studio Code)
-
AsciiDoc Live - ein Online-Editor
-
Build-Werkzeuge
-
Gradle
-
Maven
-
Kommandozeile
-
-
HtmlSanityCheck - rudimentäres Testen von AsciiDoc basierter Dokumentation.
Falls Sie eine Website mit AsciiDoc erstellen und pflegen wollen, bitten wir Sie allerdings noch um etwas Geduld - eine spätere Folge der Kolumne wird dieses (umfangreiche) Thema aufgreifen (dann allerdings ziemlich opinionated)…
-
Eric Pragt pflegt eine Liste von Werkzeugen und Beispielen rund um AsciiDoc.
-
Einige Kommentare nach langer Nutzung von AsciiDocFX
-
Podcast zu Atom mit den ursprünglichen Autor, Details zur Entwicklung und viele Interna - unserer Ansicht nach hörenswert für Entwickler
Visual-Studio Code ist eine quelloffene Entwicklungsumgebung für Web- und Cloudanwendungen, die komplett auf Web-Technologien basiert und jede Menge Programmiersprachen unterstützt. Miterfinder ist übrigens Erich Gamma, der davor schon maßgeblich an Eclipse mitgewirkt hat (und ganz nebenbei noch JUnit mit erfunden hat).
-
Asciidoc-Support für VS-Code, dessen Sourcecode liegt bei Github.
|
Tip
|
Das AsciiDoc Plugin benötigt unbedingt den (Ruby-)AsciiDoctor Prozessor installiert - wir haben das unter MacOS nur mit der Installation via 'gem install asciidoctor' geschafft, die Homebrew-Variante hat zu Fehlern geführt… |
-
Multi-Cursor-Support für VS-Code, ein selten benutztes, aber in diesen seltenen Fällen immens hilfreiches Feature…
-
Zu VS-Code gibt’s sogar einen Youtube-Channel mit Einführungsvideos, beispielsweise zu Debugging, Customization oder Git-Nutzung.
-
Der abenteuerliche Weg zu VS-Code mit AsciiDoc unter Windows
-
Eric Pragt, Autor des IntelliJ-AsciiDoc Plugins, hat eine kurze Einführung zu AsciiDoc mit IntelliJ geschrieben.
-
Matt Neuburg hat ein Bundle für den TextMate Editor entwickelt (und damit einige seiner sehr coolen Bücher über ioS-Entwicklung geschrieben), he eats his own dogfood.
-
Auf der AsciiDoctor Homepage gibt’s eine kurze Einführung in LivePreview für unterschiedliche Browser
-
Die Plugins für Firefox, Chrome und Opera wurden bei Github entwickelt - allerdings nicht mehr aktiv weitergepflegt.
-
Für Firefox gibt’s auf der Add-ons Seite eine unterstützte Version.
-
AsciiDoc war die ursprüngliche Referenzimplementierung (in Python) von Stuart Rackham, die es seit ca. 2002 gibt. Die AsciiDoc Homepage, gleichzeitig Heimat der ursprünglichen Syntaxdefinition.
-
AsciiDoctor ist eine vollständige Neuimplementierung in Ruby, die (im Gegensatz zur früheren Python-Version) signifikant auf Performance, Modularisierung udn Erweiterbarkeit Wert legt. Sie wird maßgeblich von Dan Allen (Twitter: @mojavelinux)] gepflegt. AsciiDoctor Homepage.
-
AsciiDoc.js ist eine JavaScript-Version von AsciiDoctor, die über Opal Source-2-Source Compiler von Ruby in JavaScript übersetzt wird. Grundlage für die in-Browser-live-Preview AddOns.