imported>SchlurcherBot: Bot: http → https

2026-01-24T08:42:20Z

Bot: http → https

Neue Seite

{{Infobox Dateiformat
| Name = AsciiDoc ([[Auszeichnungssprache#Vereinfachte Auszeichnungssprachen|Auszeichnungssprache]])
| Icon =
| Logo =
| Screenshot =
| Beschreibung = Auszeichnungssprache für Text
| Dateiendung = .adoc, .asciidoc
| MIME = 
| MIME-Anm =
| MagischeZahl =
| MagischeZahlNotation =
| MagischeZahlHex =
| Entwickler = Stuart Rackham
| Veröffentlicht = 2002
| LetzteVersion =
| LetzteVersionDatum =
| Art = [[Auszeichnungssprache#Vereinfachte Auszeichnungssprachen|Vereinfachte Auszeichnungssprache]]
| Container für =
| Enthalten in =
| Erweitert von = [[Textdatei]]
| Erweitert zu = Asciidoctor
| Standard =
| Website =
}}
{{Infobox Software
|Name = asciidoc (Software)
|Logo =
|Screenshot =
|Beschreibung = Implementierung von AsciiDoc, wandelt AsciiDoc in andere Formate
|Maintainer = Stuart Rackham
|Hersteller =
|Erscheinungsjahr = 2002
|AktuelleVersion = 10.0.2
|AktuelleVersionFreigabeDatum = 2021-11-13
|AktuelleVorabVersion =
|AktuelleVorabVersionFreigabeDatum =
|Programmiersprache = [[Python (Programmiersprache)|Python]]
|Betriebssystem = [[Plattformunabhängigkeit|plattformunabhängig]], unterstützt diverse Betriebssysteme
|Kategorie = [[Konvertierung (Informatik)|Dokumentwandler]]
|Lizenz = [[GNU General Public License|GPLv2]] ([[freie Software]])
|Deutsch =
|Website = [https://asciidoc.org/ asciidoc.org]
|Dateien =
}}
{{Infobox Software
|Name = asciidoctor (Software)
|Logo =
|Screenshot =
|Beschreibung = Implementierung von Asciidoctor, wandelt Asciidoctor-Dokumente in andere Formate
|Maintainer = Dan Allan
|Hersteller =
|Erscheinungsjahr = 2013 
|AktuelleVersion = [https://github.com/asciidoctor/asciidoctor/releases v2.0.17]
|AktuelleVersionFreigabeDatum = 2022-01-06
|AktuelleVorabVersion =
|AktuelleVorabVersionFreigabeDatum =
|Programmiersprache = [[Ruby (Programmiersprache)|Ruby]]
|Betriebssystem = [[Plattformunabhängigkeit|plattformunabhängig]], unterstützt diverse Betriebssysteme
|Kategorie = [[Konvertierung (Informatik)|Dokumentwandler]]
|Lizenz = [[MIT License]]
|Deutsch =
|Website = [https://asciidoctor.org/ asciidoctor.org]
|Dateien =
}}

'''AsciiDoc''' ist eine [[vereinfachte Auszeichnungssprache]], die dazu dient, Texte in verschiedenen [[Dokumentenformat]]en zu veröffentlichen. AsciiDoc-Dateien können entweder nach [[Hypertext Markup Language|HTML]] oder ins [[DocBook]]-Format konvertiert werden – und von dort dann ggf. weiter in viele andere Formate, z. B. [[PDF]] oder [[Manpage]].

Im Vergleich zu auf [[SGML]] oder [[XML]] basierenden Dokumentenformaten wie DocBook haben auf [[Plain text]] basierende „leichte“ Auszeichnungssprachen wie AsciiDoc den Vorteil, leicht erlernbar zu sein und auch unverarbeitet (als Quelltext) gut lesbar zu sein. Weitere „leichte“ Auszeichnungssprachen sind z. B. [[Markdown]], [[reStructuredText]], [[Textile]], [[Almost Plain Text]] oder auch [[Wikitext]].

Einer breiten Öffentlichkeit wurde AsciiDoc bekannt durch den Einsatz in [[GitHub]].

== Geschichte und Software ==
Das ursprüngliche Konvertierprogramm, ''asciidoc'', ist in [[Python (Programmiersprache)|Python]] geschrieben und steht unter der freien [[GNU General Public License]] (GPL). Im Juni 2020 wurde eine an aktuelle Python-Versionen angepasste Version veröffentlicht.

Eine Neuimplementierung von AsciiDoc ist ‘Asciidoctor’, Version 0.1 wurde 2013 veröffentlicht. [[GitHub]] verwendet Asciidoctor, um AsciiDoc-Dokumente nach HTML zu wandeln.<ref>[https://asciidoctor.org/news/2013/01/30/asciidoc-returns-to-github/ AsciiDoc, powered by Asciidoctor, returns to GitHub]</ref><ref>Dokumentation der Software-Bibliothek [https://github.com/github/markup#markups markup]. Die Bibliothek entscheidet beim Anzeigen einer auf GitHub liegenden Datei (zum Beispiel README), welche Markup-Bibliothek verwendet wird, um den Inhalt nach HTML zu wandeln.</ref> Neben der Ruby-Variante ist Asciidoctor auch in Varianten für [[Java (Programmiersprache)|Java]] und [[JavaScript]] verfügbar.

== AsciiDoc Working Group ==
Am 6. Februar 2020 gab die [[Eclipse Foundation]] bekannt, dass die ''AsciiDoc Working Group'' gegründet wurde zur Standardisierung von AsciiDoc.<ref name="eclipse-2020-02-06"/> Die Open-Source-Organisation will einen „offenen und neutralen Raum für die Diskussionen und Entwicklungen zur Auszeichnungssprache schaffen, sowohl was die Sprache als auch das Dokumentmodell betrifft.“<ref name="heise-2020-02-14"/>

== Beispiel ==
Das folgende Beispiel zeigt einen in AsciiDoc geschriebenen Quelltext
und eine HTML-Darstellung ähnlich der, wie sie ein AsciiDoc-Prozessor aus dem Quelltext erzeugt.

Die [[Zeichenkodierung|Encoding]]-Angabe in der ersten Zeile ist nur nötig, wenn das Dokument nicht in [[UTF-8]] kodiert ist.

{|
|-
! Eingabe
|-
|
<pre>
:encoding: iso-8859-1

= Meine Überschrift
K. Mustermann

https://wikipedia.org[Wikipedia] ist eine Online-Enzyklopädie,
verfügbar auf Englisch, Deutsch und in *vielen* anderen Sprachen.

== Software

Sie können 'paket' mit dem `make`-Kommando installieren:

make install paket

== Hardware

Häufig genutzte Metalle sind:

* Eisen
* Kupfer
</pre>
|}

{|
|-
! Ergebnis
|-
| style="padding: .5em; border: 1pt solid #BBBBBB;" |
<div style="border-bottom: 1px solid #AAAAAA; font-size: 1.8em; margin-top: 1em; margin-bottom: .25em; overflow: hidden;">Meine Überschrift</div>
'''K. Mustermann'''

<div style="font-family:serif;">
[https://wikipedia.org/ Wikipedia] ist eine
Online-Enzyklopädie, verfügbar auf
Englisch, Deutsch und in '''vielen''' anderen Sprachen.
</div>

<div style="border-bottom: 1px solid #AAAAAA; font-size: 1.5em; margin-top: 1em; margin-bottom: .25em; overflow: hidden;">Software</div>
<span style="font-family:serif;">Sie können ''paket'' mit dem <code style="border:0; background:#FFFFFF;">make</code>-Kommando installieren:</span>

make install paket

<div style="border-bottom: 1px solid #AAAAAA; font-size: 1.5em; margin-top: 1em; margin-bottom: .25em; overflow: hidden;">Hardware</div>
<div style="font-family:serif;">
Häufig genutzte Metalle sind:

* Eisen
* Kupfer
</div>
|}

== Vergleich zu Wikitext ==
AsciiDoc ähnelt in mancher Hinsicht [[Wikitext]], wie viele vereinfachte Auszeichnungssprachen.<ref name="LWML">Die Seite [[:en:Lightweight markup language|Lightweight markup language]] der englischen Wikipedia vergleicht viele Aspekte diverser Auszeichnungssprachen in Tabellenform.</ref> Die Stärken der beiden Sprachen machen sich in den jeweiligen Einsatzgebieten bemerkbar, für die sie entwickelt wurden.

Wikitext wurde für die Darstellung von Webseiten entwickelt, speziell Wiki-Seiten. Beispielsweise macht Wikitext es den Autoren einfach, Verweise auf andere Wiki-Seiten darzustellen. Die Schreibweise für einen Verweis auf die Seite [[Beispiel]] ist zum Beispiel <code><nowiki>[[Beispiel]]</nowiki></code>. Original AsciiDoc besitzt für Verweise auf Wiki-Seiten keine eigene Schreibweise. Verweise müssen die volle [[URL]] angeben, zum Beispiel <code><nowiki>https://de.wikipedia.org/wiki/Beispiel[Beispiel]</nowiki></code>.

AsciiDoc hingegen wurde für technische Dokumentation entwickelt, insbesondere im Bereich der Informatik. Beispielsweise ist es sehr einfach, im Fließtext Dateinamen oder Programmcode auszuzeichnen. Zum Beispiel ergibt <code>`Beispiel`</code> das Ergebnis <code style="border:0; background:#FFFFFF;">Beispiel</code>, während Wikitext für das Ergebnis <code>Beispiel</code> die Schreibweise <code><nowiki><code>Beispiel</code></nowiki></code> erfordert und für das Ergebnis <code style="border:0; background:#FFFFFF;">Beispiel</code> gar die Schreibweise <code><nowiki><code style="border:0; background:#FFFFFF;">Beispiel</code></nowiki></code>.

Ein weiterer Unterschied sind die Ausgabeformate. MediaWiki bietet ohne Weiteres nur Wandlung von Wikitext nach [[HTML]] und beschränkt sich insofern auf die Darstellung von Web-Seiten. Die gängigen AsciiDoc-Implementierungen bieten neben HTML verschiedene weitere Ausgabeformate, neben den schon erwähnten PDF, DocBook und Manpage auch [[EPUB]] und [[LaTeX]].<ref name="LWML" /> Dadurch bietet sich AsciiDoc auch für die Formatierung von Büchern und allgemein Dokumenten an, die auch außerhalb des Webs verbreitet und gelesen werden können sollen.

== Literatur ==
* {{Internetquelle |autor=Alexander Schwartz |url=https://www.heise.de/hintergrund/Documentation-as-Code-mit-Asciidoctor-4642013.html |titel=Documentation as Code mit Asciidoctor |werk=Heise Developer |datum=2020-01-21 |abruf=2020-02-16 |kommentar=Umfang sechs Kapitel}}

== Weblinks ==
* [https://asciidoc.org/ Website des AsciiDoc-Projekts] (englisch)
* [http://powerman.name/doc/asciidoc-compact AsciiDoc Cheatsheet (Kurzzusammenfassung)] (englisch)
* [https://dbcb.github.io/asciidocToGo AsciidocToGo] Portable Version von AsciiDoc für [[Microsoft Windows|MS Windows]] (englisch)

== Einzelnachweise ==
<references>
<ref name="eclipse-2020-02-06">
{{Internetquelle |autor=Dan Allen |url=https://www.eclipse.org/lists/asciidoc-wg/msg00002.html |titel=[asciidoc-wg] More about the AsciiDoc Working Group |werk=eclipse.org |datum=2020-02-06 |abruf=2020-02-16}}
</ref>
<ref name="heise-2020-02-14">
{{Internetquelle |autor=Alexander Neumann |url=https://www.heise.de/developer/meldung/Arbeitsgruppe-zur-Auszeichnungssprache-AsciiDoc-gestartet-4660580.html |titel=Arbeitsgruppe zur Auszeichnungssprache AsciiDoc gestartet |werk=heise online |datum=2020-02-14 |abruf=2020-02-16}}
</ref>
</references>

[[Kategorie:Vereinfachte Auszeichnungssprache]]

AsciiDoc - Versionsgeschichte

imported>SchlurcherBot: Bot: http → https