{"id":13448389,"url":"https://github.com/asciidoctor/asciidoctor","last_synced_at":"2025-09-09T20:49:44.859Z","repository":{"id":3468631,"uuid":"4523235","full_name":"asciidoctor/asciidoctor","owner":"asciidoctor","description":":gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.","archived":false,"fork":false,"pushed_at":"2025-05-09T16:50:04.000Z","size":18845,"stargazers_count":4980,"open_issues_count":746,"forks_count":811,"subscribers_count":118,"default_branch":"main","last_synced_at":"2025-05-13T00:24:05.672Z","etag":null,"topics":["asciidoc","asciidoctor","converter","docbook","html","manpage","ruby","rubygem"],"latest_commit_sha":null,"homepage":"https://asciidoctor.org","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asciidoctor.png","metadata":{"files":{"readme":"README-de.adoc","changelog":"CHANGELOG.adoc","contributing":"CONTRIBUTING.adoc","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.adoc","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"open_collective":"asciidoctor"}},"created_at":"2012-06-01T19:09:20.000Z","updated_at":"2025-05-12T08:23:46.000Z","dependencies_parsed_at":"2023-01-13T12:32:07.066Z","dependency_job_id":"72049f03-3ad8-4150-8be6-f4d57b168d75","html_url":"https://github.com/asciidoctor/asciidoctor","commit_stats":{"total_commits":5030,"total_committers":207,"mean_commits":24.29951690821256,"dds":0.168389662027833,"last_synced_commit":"e5442fc2848680eada862841b0e92dc9265e1a29"},"previous_names":[],"tags_count":73,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fasciidoctor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asciidoctor","download_url":"https://codeload.github.com/asciidoctor/asciidoctor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253900592,"owners_count":21981273,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asciidoc","asciidoctor","converter","docbook","html","manpage","ruby","rubygem"],"created_at":"2024-07-31T05:01:44.117Z","updated_at":"2025-05-13T10:54:53.516Z","avatar_url":"https://github.com/asciidoctor.png","language":"Ruby","funding_links":["https://opencollective.com/asciidoctor"],"categories":["Ruby","Misc","docs","Happy Exploring 🤘","More Topics","Awesome Ruby CLIs"],"sub_categories":["Formats","Converting"],"readme":"= Asciidoctor\nDan Allen \u003chttps://github.com/mojavelinux[@mojavelinux]\u003e; Sarah White \u003chttps://github.com/graphitefriction[@graphitefriction]\u003e\n// settings:\n:idprefix:\n:idseparator: -\n:source-language: ruby\nifndef::env-github[:icons: font]\nifdef::env-github[]\n:status:\n:caution-caption: :fire:\n:important-caption: :exclamation:\n:note-caption: :paperclip:\n:tip-caption: :bulb:\n:warning-caption: :warning:\nendif::[]\n// Variables:\n:release-version: 2.0.22\n// URIs:\n:uri-org: https://github.com/asciidoctor\n:uri-repo: {uri-org}/asciidoctor\n:uri-asciidoctorj: {uri-org}/asciidoctorj\n:uri-asciidoctorjs: {uri-org}/asciidoctor.js\n:uri-project: https://asciidoctor.org\nifdef::env-site[:uri-project: link:]\n:uri-docs: {uri-project}/docs\n:uri-news: {uri-project}/news\n:uri-manpage: {uri-project}/man/asciidoctor\n:uri-issues: {uri-repo}/issues\n:uri-contributors: {uri-repo}/graphs/contributors\n:uri-rel-file-base: link:\n:uri-rel-tree-base: link:\nifdef::env-site[]\n:uri-rel-file-base: {uri-repo}/blob/HEAD/\n:uri-rel-tree-base: {uri-repo}/tree/HEAD/\nendif::[]\n:uri-changelog: {uri-rel-file-base}CHANGELOG.adoc\n:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc\n:uri-license: {uri-rel-file-base}LICENSE\n:uri-tests: {uri-rel-tree-base}test\n:uri-discuss: https://discuss.asciidoctor.org\n:uri-chat: https://chat.asciidoctor.org\n:uri-rubygem: https://rubygems.org/gems/asciidoctor\n:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc\n:uri-user-manual: {uri-docs}/user-manual\n:uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor\n//:uri-install-doc: {uri-docs}/install-toolchain\n:uri-install-macos-doc: {uri-docs}/install-asciidoctor-macos\n:uri-render-doc: {uri-docs}/render-documents\n:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory\n:uri-gitscm-repo: https://github.com/git/git-scm.com\n:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html\n:uri-foundation: https://foundation.zurb.com\n:uri-opal: https://opalrb.com\n:uri-tilt: https://github.com/rtomayko/tilt\n:uri-ruby: https://ruby-lang.org\n// images:\n:image-uri-screenshot: https://cdn.jsdelivr.net/gh/asciidoctor/asciidoctor/screenshot.png\n\n{uri-project}[Asciidoctor] ist ein _schneller_, {uri-license}[Open Source] Textverarbeitungs- und Publishing-Toolchain für die Konvertierung von {uri-what-is-asciidoc}[AsciiDoc]-Inhalten in HTML 5, DocBook 5, PDF und andere Formate.\nAsciidoctor ist in Ruby geschrieben und läuft auf allen gängigen Betriebsystemen.\nUm die Installation zu vereinfachen wird Asciidoctor als Gem auf {uri-rubygem}[RubyGems.org] verpackt und ist als Paket für gängige Linux-Distributionen und MacOS erhältlich.\nAsciidoctor kann auch in einer JVM mit {uri-asciidoctorj}[AsciidoctorJ] oder einer beliebigen Javascript-Umgebung mit {uri-asciidoctorjs}[Asciidoctor.js] ausgeführt werden.\nDas Asciidoctor-Projekt wird {uri-repo}[auf GitHub] gehostet.\n\nifndef::env-site[]\nDieses Dokument ist auch in folgenden Sprachen erhältlich: +\n{uri-rel-file-base}README-zh_CN.adoc[简体中文]\n|\n{uri-rel-file-base}README.adoc[English]\n|\n{uri-rel-file-base}README-fr.adoc[Français]\n|\n{uri-rel-file-base}README-jp.adoc[日本語]\nendif::[]\n\n.Wichtige Dokumentation\n[.compact]\n* {uri-docs}/what-is-asciidoc[Was ist AsciiDoc?]\n* {uri-docs}/asciidoc-writers-guide[Asciidoctor Benutzerhandbuch]\n* {uri-docs}/user-manual[Asciidoctor Gebrauchshandbuch]\n* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax-Referenz]\n\nifdef::status[]\nimage:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]\nimage:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]\nimage:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]\nimage:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[Project Chat (Zulip),link={uri-chat}]\nendif::[]\n\n== Sponsoren\n\nWir möchten unseren großzügigen Sponsoren danken, ohne deren Unterstützung Asciidoctor nicht möglich wäre.\nVielen Dank an die Sponsoren für ihr Engagement zur Verbesserung der technischen Dokumentation!\nZusätzliche Mittel werden von unseren https://asciidoctor.org/supporters[Community Backers] zur Verfügung gestellt.\n\nSie können dieses Projekt unterstützen, indem Sie Sponsor bei https://opencollective.com/asciidoctor[OpenCollective] werden.\n\n== Das große Ganze\n\nAsciidoctor liest Inhalte, die im Klartext geschrieben wurden, wie im Feld links im Bild unten gezeigt, und wandelt Sie in HTML 5 um, wie im rechten Feld dargestellt.\nAsciidoctor wendet ein Standard-Stylesheet auf das HTML 5-Dokument an, um ein angenehmes Out-of-the-Box-Erlebnis zu bieten.\n\nimage::{image-uri-screenshot}[Preview of AsciiDoc source and corresponding rendered HTML]\n\n== AsciiDoc Verarbeitung\n\nAsciidoctor liest und analysiert Text, der in der AsciiDoc-Syntax geschrieben wurde, und leitet dann den Parse-Tree durch eine Reihe von eingebauten Konvertern, um HTML 5, DocBook 5 und man-pages zu erzeugen.\nSie haben die Möglichkeit, eigene Konverter zu verwenden oder {uri-tilt}[Tilt]-gestützte Vorlagen zu laden, um die generierte Ausgabe anzupassen oder zusätzliche Formate zu erzeugen.\n\nAsciidoctor ist ein Ersatz für den Original AsciiDoc Python Prozessor (`asciidoc.py`).\nDie Asciidoctor-Testsuite verfügt über {uri-tests}[mehr als 2,000 Tests], um die Kompatibilität mit der AsciiDoc-Syntax sicherzustellen.\n\nNeben der klassischen AsciiDoc-Syntax erkennt Asciidoctor zusätzliche Markup- und Formatierungsoptionen, wie z.B. fontbasierte Icons (z.B. `+icon:fire[]+`) und UI-Elemente (z.B. `+button:[Save]+`).\nAsciidoctor bietet auch ein modernes, __responsive Theme__, das auf {uri-foundation}[Foundation] basiert, um die HTML 5-Ausgabe zu gestalten.\n\n== Wo Ruby hingeht, folgt Asciidoctor\n\nSie können Asciidoctor in einer JVM mit JRuby ausführen.\nUm die Asciidoctor API direkt aus Java und anderen JVM-Sprachen aufzurufen, verwenden Sie {uri-asciidoctorj}[AsciidoctorJ].\nEs stehen Ihnen auf {uri-asciidoctorj}[AsciidoctorJ] basierende Plugins zur Verfügung, die den Asciidoctor Prozessor in Apache Maven, Gradle oder Javadoc Builds integrieren.\n\nAsciidoctor läuft auch in JavaScript.\n{uri-opal}[Opal] wird verwendet, um den Ruby-Source in JavaScript umzukompilieren, um {uri-asciidoctorjs}[Asciidoctor.js] zu erzeugen.\nAsciidoctor.js ist eine voll funktionsfähige Version von Asciidoctor, die in jeder JavaScript-Umgebung wie z.B. einem Webbrowser oder Node.js funktioniert.\nEs wird für die AsciiDoc Vorschau-Erweiterungen für Chrome, Atom, Brackets und andere webbasierte Werkzeuge verwendet.\n\n== Anforderungen\n\nAsciidoctor arbeitet unter Linux, MacOS und Windows und benötigt eine der folgenden Implementierungen von {uri-ruby}[Ruby]:\n\n* CRuby (aka MRI) 2.5 - 3.1\n* JRuby 9.1 - 9.3\n* TruffleRuby (GraalVM)\n* Opal (JavaScript)\n\n[CAUTION]\n====\nWenn Sie eine nicht-englische Windows-Umgebung verwenden, können Sie auf einen `Encoding::UndefinedConversionError` stoßen, wenn Sie Asciidoctor aufrufen.\nUm dieses Problem zu beheben, empfehlen wir, die aktive Codepage in Ihrer Konsole auf UTF-8 umzustellen:\n\n  chcp 65001\n\nSobald Sie diese Änderung vorgenommen haben, haben Sie alle Ihre Unicode-Kopfschmerzen hinter sich.\nWenn Sie eine IDE wie Eclipse verwenden, stellen Sie sicher, dass Sie dort auch die Kodierung auf UTF-8 setzen.\nAsciidoctor funktioniert am besten, wenn Sie UTF-8 überall verwenden.\n====\n\n== Installation\n\nAsciidoctor kann mit (a) Paketmanagern für gängige Linux-Distributionen, (b) Homebrew für MacOS, (c) dem Befehl `gem install` (empfohlen für Windows-Benutzer), (d) dem Asciidoctor Docker-Image oder (e) Bundler installiert werden.\n\nDer Vorteil der Verwendung des Paketmanagers Ihres Betriebssystems zur Installation des Gem ist, dass er die Installation von Ruby und der RubyGems-Bibliothek übernimmt, wenn diese Pakete nicht bereits auf Ihrem Rechner installiert sind.\n\n=== (a) Linux Paketmanager\n\nDie vom Paketmanager installierte Version von Asciidoctor entspricht möglicherweise nicht der neuesten Version von Asciidoctor.\nKonsultieren Sie das Paket-Repository für Ihre Distribution, um herauszufinden, welche Version in der Distribution gepackt ist.\n\n* https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]\n* https://www.archlinux.org/packages/?name=asciidoctor[Arch Linux (asciidoctor)]\n* https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]\n* https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (asciidoctor)]\n* https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]\n* https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]\n\nWenn Sie eine Version von Asciidoctor verwenden möchten, die neuer ist als die, die vom Paketmanager installiert wurde, lesen Sie bitte die \u003c\u003cgem-install, Installationsanweisungen\u003e\u003e.\n\n==== apk (Alpine Linux)\n\nUm ein Gem auf Alpine Linux zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ sudo apk add asciidoctor\n\n==== pacman (Arch Linux)\n\nUm ein Gem auf Arch-basierten Distributionen zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ sudo pacman -S asciidoctor\n\n==== APT\n\nAuf Debian und Debian-basierten Distributionen wie Ubuntu nutzen Sie APT um Asciidoctor zu installieren.\nUm das Paket zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ sudo apt-get install -y asciidoctor\n\n==== DNF\n\nAuf RPM-basierten Linux-Distributionen, wie Fedora, CentOS und RHEL, nutzen Sie den DNF Paketmanager um Asciidoctor zu installieren.\nUm das Paket zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ sudo dnf install -y asciidoctor\n\n=== (b) Homebrew (macOS)\n\nSie können Homebrew, den macOS-Paketmanager, verwenden, um Asciidoctor zu installieren.\nWenn Sie Homebrew nicht auf Ihrem Computer haben, führen Sie zuerst die Installationsanweisungen unter https://brew.sh/[brew.sh] aus.\nSobald Homebrew installiert ist, können Sie das Asciidoctor gem installieren.\nÖffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ brew install asciidoctor\n\nHomebrew installiert das `asciidoctor` Gem in ein exklusives Präfix, das unabhängig von den System-Gems ist.\n\n=== (c) Windows\n\nUm Asciidoctor unter Windows zu installieren, gibt es zwei einfache Möglichkeiten.\n\n==== Chocolatey\n\nWenn Sie bereits https://chocolatey.org[chocolatey] verwenden, können Sie folgenden Befehl verwenden:\n\n choco install ruby\n\nDanach folgen Sie der \u003c\u003cgem-install,Gem Installation\u003e\u003e.\n\n==== Rubyinstaller\n\nOder Sie benutzen den https://rubyinstaller.org/downloads/[Rubyinstaller], laden Sie das für Ihre Windows Version passende Paket herunter und nach der Installation folgen Sie ebenfalls der \u003c\u003cgem-install, Gem Installation\u003e\u003e.\n\n[#gem-install]\n=== (d) gem install\n\nBevor Sie Asciidoctor mit `gem install` installieren, sollten Sie https://rvm.io[RVM] verwenden, um Ruby in Ihrem Home-Verzeichnis zu installieren (z.B. Userspace).\nDann können Sie den Befehl `gem` sicher verwenden, um den Asciidoctor Gem zu installieren oder zu aktualisieren.\nBei der Verwendung von RVM werden Gems an einem vom System isolierten Ort installiert.\n\nÖffnen Sie ein Terminal und geben Sie folgendes ein:\n\n $ gem install asciidoctor\n\nWenn Sie eine Vorabversion (z.B. einen Release-Kandidaten) installieren möchten, verwenden Sie:\n\n $ gem install asciidoctor --pre\n\n=== (e) Docker\n\nSiehe {uri-install-docker}[Installing Asciidoctor using Docker].\n\n=== (f) Bundler\n\n. Erstellen Sie ein Gemfile im Stammordner Ihres Projekts (oder im aktuellen Verzeichnis).\n. Fügen Sie den `asciidoctor` Gem wie folgt zu Ihrem Gemfile hinzu:\n+\n[subs=attributes+]\n----\nsource 'https://rubygems.org'\ngem 'asciidoctor'\n# oder spezifizieren Sie die Version explizit\n# gem 'asciidoctor', '{release-version}'\n----\n\n. Speichern Sie das Gemfile\n. Öffnen Sie ein Terminal und installieren Sie das Gem mit:\n\n $ bundle\n\nUm das Gem zu aktualisieren, geben Sie die neue Version im Gemfile an und führen Sie `bundle` erneut aus.\nDie Verwendung von `bundle update` (ohne Angabe eines Gem) wird *nicht* empfohlen, da es auch andere Gems aktualisiert, was möglicherweise nicht das gewünschte Ergebnis ist.\n\n== Upgrade\n\nWenn Sie Asciidoctor mit einem Paketmanager installiert haben, ist ihr Betriebssystem wahrscheinlich so konfiguriert, dass es Pakete automatisch aktualisiert.\nIn diesem Fall müssen Sie das Gem nicht manuell aktualisieren.\n\n=== apk (Alpine Linux)\n\nUm das Gem zu aktualisieren, nutzen Sie:\n\n $ sudo apk add -u asciidoctor\n\n=== APT\n\nUm das Gem zu aktualisieren, nutzen Sie:\n\n $ sudo apt-get upgrade -y asciidoctor\n\n=== DNF\n\nUm das Gem zu aktualisieren, nutzen Sie:\n\n $ sudo dnf update -y asciidoctor\n\n=== Homebrew (macOS)\n\nUm das Gem zu aktualisieren, nutzen Sie:\n\n $ brew update\n $ brew upgrade asciidoctor\n\n=== gem install\n\nWenn Sie Asciidoctor zuvor mit dem Befehl `gem` installiert haben, müssen Sie Asciidoctor manuell aktualisieren, wenn eine neue Version veröffentlicht wird.\nSie können mit folgendem Befehl aktualisieren:\n\n $ gem install asciidoctor\n\nWenn Sie eine neue Version des Edelsteins mit `gem install` installieren, werden mehrere Versionen installiert.\nVerwenden Sie den folgenden Befehl, um die alten Versionen zu entfernen:\n\n $ gem cleanup asciidoctor\n\n== Verwendung\n\nWenn der Asciidoctor Gem erfolgreich installiert wurde, ist das `asciidoctor` Kommandozeilen-Interface (CLI) in Ihrem PATH verfügbar.\nUm die Verfügbarkeit zu überprüfen, führen Sie den folgenden Befehl in Ihrem Terminal aus:\n\n $ asciidoctor --version\n\nSie sollten Informationen über die Asciidoctor-Version und Ihre Ruby-Umgebung im Terminal sehen.\n\n[.output,subs=attributes+]\n....\nAsciidoctor {release-version} [https://asciidoctor.org]\nLaufzeitumgebung (ruby 3.0.1p4 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)\n....\n\nAsciidoctor bietet auch eine API.\nDie API ist für die Integration mit anderer Ruby-Software wie Rails, Sinatra und GitHub und anderen Sprachen wie Java (über {uri-asciidoctorj}[AsciidoctorJ]) und JavaScript (über {uri-asciidoctorjs}[Asciidoctor.js]) vorgesehen.\n\n=== Kommandozeile\n\nMit dem Befehl `asciidoctor` können Sie Asciidoctor von der Kommandozeile (z.B. einem Terminal) aus aufrufen.\n\nDer folgende Befehl konvertiert die Datei README.adoc nach HTML und speichert das Ergebnis in der Datei README.html im gleichen Verzeichnis.\nDer Name der erzeugten HTML-Datei wird aus der Quelldatei abgeleitet, indem die Dateierweiterung auf `.html` geändert wird.\n\n $ asciidoctor README.adoc\n\nSie können den Asciidoctor-Prozessor steuern, indem Sie verschiedene Flags und Schalter hinzufügen, über die Sie sich mittels folgendem Befehl informieren können:\n\n $ asciidoctor --help\n\nZum Beispiel, um die Datei in ein anderes Verzeichnis zu schreiben, verwenden Sie:\n\n $ asciidoctor -D output README.adoc\n\nDie `asciidoctor` {uri-manpage}[man page] bietet eine vollständige Referenz der Kommandozeile.\n\nLesen Sie die folgenden Ressourcen, um mehr über die Verwendung des `asciidoctor`-Befehls zu erfahren.\n\n* {uri-render-doc}[How do I convert a document?]\n* {uri-themes-doc}[How do I use the Asciidoctor stylesheet factory to produce custom themes?]\n\n=== Ruby API\n\nUm Asciidoctor in Ihrer Anwendung verwenden zu können, benötigen Sie zunächst das Gem:\n\n----\nrequire 'asciidoctor'\n----\n\nSie können dann eine AsciiDoc-Quelldatei in eine HTML-Datei konvertieren:\n\n----\nAsciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe\n----\n\nWARNING: Bei Verwendung von Asciidoctor über die API ist der Standard-Sicherheitsmodus `:secure`.\nIm sicheren Modus sind mehrere Kernfunktionen deaktiviert, darunter die `include`-Direktive.\nWenn Sie diese Funktionen aktivieren möchten, müssen Sie den Sicherheitsmodus explizit auf `:server` (empfohlen) oder `:safe` setzen.\n\nSie können einen AsciiDoc-String auch in ein integrierbares HTML (zum Einfügen in eine HTML-Seite) konvertieren, mit:\n\n----\ncontent = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'\nAsciidoctor.convert content, safe: :safe\n----\n\nWenn Sie das komplette HTML-Dokument wünschen, aktivieren Sie die Option `head_footer` wie folgt:\n\n----\ncontent = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'\nhtml = Asciidoctor.convert content, header_footer: true, safe: :safe\n----\n\nWenn Sie Zugriff auf das analysierte Dokument benötigen, können Sie die Konvertierung in einzelne Schritte aufteilen:\n\n----\ncontent = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'\ndocument = Asciidoctor.load content, header_footer: true, safe: :safe\nputs document.doctitle\nhtml = document.convert\n----\n\nDenken Sie daran, dass __Sie die Ausgabe__ von Asciidoctor __ändern können__, wenn Sie sie nicht mögen!\nAsciidoctor unterstützt benutzerdefinierte Konverter, die die Konvertierung vom geparsten Dokument in die generierte Ausgabe übernehmen können.\n\nEine einfache Möglichkeit, die Ausgabe stückweise anzupassen, ist die Verwendung des Template-Konverters.\nDer Template-Konverter ermöglicht es Ihnen, eine von {uri-tilt}[Tilt]-gestützte Template-Datei zur Verfügung zu stellen, um die Konvertierung eines beliebigen Knotens im Dokument zu handhaben.\n\nWie auch immer Sie vorgehen, Sie können die Ausgabe zu 100% kontrollieren.\nWeitere Informationen zur Verwendung der API oder zur Anpassung der Ausgabe finden Sie im {uri-user-manual}[Benutzerhandbuch].\n\n== Mitwirken\n\nNeue Mitwirkende sind immer willkommen!\nWenn Sie Fehler oder Auslassungen im Quellcode, in der Dokumentation oder im Inhalt der Website entdecken, zögern Sie bitte nicht, ein Problem zu melden oder eine Pull Request mit einem Fix zu öffnen.\n\nHier sind einige Möglichkeiten, wie *Sie* dazu beitragen können:\n\n* durch Verwendung von Vorabversionen (Alpha-, Beta- oder Preview-Versionen)\n* durch das Melden von Fehlern\n* durch Vorschläge für neue Funktionen\n* durch das Verfassen oder Bearbeiten von Dokumentationen\n* durch Schreiben von Code mit Tests -- _Kein Patch ist zu klein._\n** Tippfehler beheben\n** Kommentare hinzufügen\n** inkonsistente Leerzeichen bereinigen\n** Tests schreiben!\n* Refactoring von Code\n* durch die Behebung von {uri-issues}[Problemen]\n* durch Überprüfung von Patches\n\nDer {uri-contribute}[Contributing Guide] bietet Informationen darüber, wie man Probleme, Feature Requests, Code und Dokumentation für das Asciidoctor Projekt erstellt, gestaltet und einreicht.\n\n== Hilfe finden\n\nAsciidoctor wurde entwickelt, um Ihnen das Schreiben und Veröffentlichen Ihrer Inhalte zu erleichtern.\nAber wir können es nicht ohne ihr Feedback machen!\nWir ermutigen Sie, Fragen zu stellen und alle Aspekte des Projekts auf der Diskussionsliste, auf Twitter oder im Chatroom zu diskutieren.\n\nChat (Zulip):: {uri-chat}\nDiscussionsliste (Nabble):: {uri-discuss}\nTwitter:: Follow https://twitter.com/asciidoctor[@asciidoctor] or search for the https://twitter.com/search?f=tweets\u0026q=%23asciidoctor[#asciidoctor] hashtag\n\nifdef::env-github[]\nWeitere Informationen und Dokumentation zu Asciidoctor finden Sie auf der Website des Projekts.\n\n{uri-project}[Home] | {uri-news}[News] | {uri-docs}[Docs]\nendif::[]\n\nDie Asciidoctor-Organisation auf GitHub hostet den Quellcode des Projekts, den Issue Tracker und Unterprojekte.\n\nSource repository (git):: {uri-repo}\nIssue tracker:: {uri-issues}\nAsciidoctor Organization auf GitHub:: {uri-org}\n\n== Lizenz\n\nCopyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, und die einzelnen Mitarbeiter von Asciidoctor.\nDie Nutzung dieser Software wird unter den Bedingungen der MIT-Lizenz gewährt.\n\nSiehe die {uri-license}[LIZENZ] für den vollen Lizenztext.\n\n== Authoren\n\n*Asciidoctor* wird von https://github.com/mojavelinux[Dan Allen] und https://github.com/graphitefriction[Sarah White] geleitet und hat Beiträge von {uri-contributors}[vielen Personen] in Asciidoctors großartiger Gemeinschaft erhalten.\nDas Projekt wurde 2012 von https://github.com/erebor[Ryan Waldron] initiiert und basiert auf einem prototyp von https://github.com/nickh[Nick Hengeveld].\n\n*AsciiDoc* wurde von Stuart Rackham gegründet und hat Beiträge von vielen Personen aus der AsciiDoc-Community erhalten.\n\nifndef::env-site[]\n== Changelog\n\nifeval::[{safe-mode-level} \u003c 20]\ninclude::CHANGELOG.adoc[tag=compact,leveloffset=+1]\nendif::[]\n\nEine vollständige Liste der Änderungen in älteren Versionen finden Sie im {uri-changelog}[CHANGELOG].\nendif::[]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fasciidoctor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasciidoctor%2Fasciidoctor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fasciidoctor/lists"}