asciidoctor 1.5.7.1 → 1.5.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad8e487a317ee7c1ba5e138157d4515b3af5bdf53ff0dc18afca5eeaa1eb2c63
-  data.tar.gz: a9e4b482528e1f57fbf390ead5e49f17a1ad099f14da9b4cd9755e2ddcb8de20
+  metadata.gz: af6c978f632685e857521e4db2550da18b58a5b2f50b309ca7b4f5768db46d86
+  data.tar.gz: aea7c7d7eff7d6830ff2dda3a945e997e88ce2ba2a1548c4cfc5a315f330026d
 SHA512:
-  metadata.gz: 45c2b7128e586c4533b7c2aee5c9b4f249bc5d2a212b30b89828f3358be983d1d950c1b50ddfa3661587a284c426b89b088c4f58369bf3083f084134679e51c0
-  data.tar.gz: ee0bb8f333c509e165f56eb46f5de656c9930f04235081fcbb072ab36bd40cd0eb664d12d03bb4c6053caaf6d8895dbf674cbe78de30ad9f3f0704aef811d6ed
+  metadata.gz: 2cdb5ae6d6adf2c526ff15c8ad98d1ac4931c872e126112364830968a19bca910168a4d84dad94e7e2af01543ee1c89f373ee7eaa1d9a4010c5968bf8fede1d0
+  data.tar.gz: e644397e6f5f8029d8597b35ba17d950e2eaf39d2ed7078550d250c18630279741bad9d37a98e6b0c034afa3c4bdd7c2ea09c33ee95159230faf1b34d04a8139

data/CHANGELOG.adoc

@@ -13,6 +13,96 @@ endif::[]
 This document provides a high-level view of the changes introduced in Asciidoctor by release.
 For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
 
+== 1.5.8 (2018-10-28) - @mojavelinux
+
+Enhancements::
+
+  * if set, add value of part-signifier and chapter-signifier attributes to part and chapter titles (#2738)
+  * allow position (float) and alignment (align) to be set on video block (#2425)
+  * substitute attribute references in attrlist of include directive (#2761)
+  * add Document#set_header_attribute method for adding method directly to document header during parsing (#2820)
+  * add helper method to extension processor classes to create lists and list items
+  * allow ordered and unordered lists to be nested to an arbitrary / unlimited depth (#2854)
+  * add `prefer` DSL method to extension registry and document processor to flag extension as preferred (#2848)
+  * allow manname and manpurpose to be set using document attributes; don't look for NAME section in this case (#2810)
+  * substitute attribute references in target of custom block macro (honoring attribute-missing setting) (#2839)
+  * interpret `<.>` as an auto-numbered callout in verbatim blocks and callout lists (#2871)
+  * require marker for items in callout list to have circumfix brackets (e.g., `<1>` instead of `1>`) (#2871)
+  * preserve comment guard in front of callout number in verbatim block if icons is not enabled (#1360)
+  * add more conventional styles to quote block when it has the excerpt role (#2092)
+  * colspecs can be separated by semi-colon instead of comma (#2798)
+  * change AbstractBlock#find_by to respond to StopIteration exception; stop traversal after matching ID (#2900)
+  * change AbstractBlock#find_by to honor return values :skip and :skip_children from filter block to skip node and its descendants or just its descendants, respectively (#2067)
+  * add API to retrieve authors as array; use API in converters (#1042) (*@mogztter*)
+  * add support for start attribute on source block to set starting line number when converting to DocBook (#2915)
+  * track imagesdir for image on node and in catalog (#2779)
+  * allow starting line number to be set using start attribute when highighting source block with Pygments or CodeRay (#1742)
+  * upgrade highlight.js to 9.13.1
+
+Fixes::
+
+  * don't hang on description list item that begins with /// (#2888)
+  * don't crash when using AsciiDoc table cell style on column in CSV table (#2817)
+  * show friendly error if CSV data for table contains unclosed quote (#2878) (*@zelivans*)
+  * don't crash when attribute entry continuation is used on last line of file (#2880) (*@zelivans*)
+  * treat empty/missing value of named block attribute followed by other attributes (e.g., caption=,cols=2*) as empty string
+  * AbstractNode#set_option does nothing if option is already set (PR #2778)
+  * allow revnumber to be an attribute reference in revision info line (#2785)
+  * use ::File.open instead of ::IO.binread in Reader for Asciidoctor.js compatibility
+  * add fallback for timezone when setting doctime
+  * preserve UNC path that begins with a double backslash (Windows) (#2869)
+  * fix formatting of quote block (indentation) in manpage output (#2792)
+  * catalog inline anchors in ordered list items (#2812)
+  * detect closing tag on last line with no trailing newline (#2830)
+  * process `!name@` attribute syntax property; follow-up to #642
+  * change document extension processor DSL methods to return registered extension instance instead of array of instances
+  * use fallback value for manname-title to prevent crash in manpage converter
+  * consolidate inner whitespace in prose in manpage output (#2890)
+  * only apply subs to node attribute value if enclosed in single quotes (#2905)
+  * don't hide URI scheme if target of link macro is a bare URI scheme
+  * fix crash when child section of part is out of sequence and section numbering is enabled (#2931)
+  * fix crash when restoring passthroughs if passthrough role is enclosed in single quotes (#2882, #2883)
+  * don't eagerly apply subs to inline attributes in general
+  * make sure encoding of output file is UTF-8
+  * prevent warning about invalid `:asciidoc` option when using custom templates with Slim 4 (#2928)
+  * use Pathname#relative_path_from to compute relative path to file outside of base directory (#2108)
+
+Improvements::
+
+  * change trailing delimiter on part number to colon (:) (#2738)
+  * interpret open line range as infinite (#2914)
+  * rename number property on AbstractBlock to numeral, but keep number as deprecated alias
+  * use CSS class instead of hard-coded inline float style on tables and images (#2753)
+  * use CSS class instead of hard-coded inline text-align style on block images (#2753)
+  * allow hyphen to be used custom block macro name as long as it's not the first character (#2620)
+  * use shorthands %F and %T instead of %Y-%m-%d and %H:%M:%S to format time
+  * read file in binary mode whenever contents are being normalized
+  * use .drop(0) to duplicate arrays (roughly 1.5x as fast as .dup)
+  * only recognize a bullet glyph which is non-repeating as an unordered list marker
+  * rename SyntaxDsl module to SyntaxProcessorDsl (internal)
+  * fail if name given to block macro contains illegal characters
+  * normalize all whitespace in value of manpurpose attribute
+  * make space before callout number after custom line comment character optional
+  * parse attrlist on inline passthrough as a shorthand attribute syntax or literal role (#2910)
+  * add support for range syntax (.. delimiter) to highlight attribute on source block (#2918)
+  * add support for unbounded range to highlight attribute on source block (#2918)
+  * automatically assign title and caption on image block if title is set on custom block source (#2926)
+  * use OS independent timezone (UTC or time offset) in doctime and localtime attributes (#2770)
+  * report correct line number for inline anchor with id already in use (#2769)
+  * generate manpage even if input is non-conforming or malformed (#1639)
+  * allow authorinitials for single author to be overridden (#669)
+
+Documentation::
+
+  * translate README into German (#2829) (*@jwehmschulte*)
+  * sync French translation of README (*@mogztter*)
+  * add Swedish translation of built-in attributes (PR #2930) (*@jonasbjork*)
+
+Build / Infrastructure::
+
+  * replace thread_safe with concurrent-ruby (PR #2822) (*@junaruga*)
+
+// tag::compact[]
 == 1.5.7.1 (2018-05-10) - @mojavelinux
 
 Fixes::
@@ -22,9 +112,9 @@ Fixes::
 
 Build / Infrastructure::
 
-  * drop obsolete logic in rake build
-  * allow lib dir to be overridden for tests using an environment variable (PR #2758)
-  * load asciidoctor/version from LOAD_PATH in gemspec if not found locally (PR #2760)
+  * drop obsolete logic in rake build (*@aerostitch*)
+  * allow lib dir to be overridden for tests using an environment variable (PR #2758) (*@aerostitch*)
+  * load asciidoctor/version from LOAD_PATH in gemspec if not found locally (PR #2760) (*@aerostitch*)
 
 == 1.5.7 (2018-05-02) - @mojavelinux
 
@@ -33,6 +123,7 @@ Enhancements::
   * BREAKING: drop XML tags, character refs, and non-word characters (except hyphen, dot, and space) when auto-generating section IDs (#794)
    ** hyphen, dot, and space are replaced with value of idseparator, if set; otherwise, spaces are dropped
   * allow attribute names to contain any word character defined by Unicode (#2376, PR #2393)
+  * do not recognize attribute entry line if name contains a colon (PR #2377)
   * route all processor messages through a logger instead of using Kernel#warn (#44, PR #2660)
   * add MemoryLogger for capturing messages sent to logger into memory (#44, PR #2660)
   * add NullLogger to prevent messages from being logged (#44, PR #2660)
@@ -202,8 +293,8 @@ Distribution Packages::
   * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
   * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
   * https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
+// end::compact[]
 
-// tag::compact[]
 == 1.5.6.2 (2018-03-20) - @mojavelinux
 
 Bug fixes::
@@ -238,7 +329,6 @@ Distribution Packages::
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.6.2[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.6.2[git tag] |
 https://github.com/asciidoctor/asciidoctor/compare/v1.5.6.1...v1.5.6.2[full diff]
-// end::compact[]
 
 == 1.5.6.1 (2017-07-23) - @mojavelinux
 

data/Gemfile

@@ -4,25 +4,35 @@ source 'https://rubygems.org'
 gemspec
 
 group :development do
-  if (ruby_version = Gem::Version.new RUBY_VERSION) < (Gem::Version.new '2.1.0')
-    if ruby_version < (Gem::Version.new '2.0.0')
-      gem 'haml', '~> 4.0.0'
-      if ruby_version < (Gem::Version.new '1.9.3')
-        gem 'cucumber', '~> 1.3.0'
-        gem 'nokogiri', '~> 1.5.0'
-        gem 'slim', '~> 2.1.0'
-        gem 'tilt', '2.0.7'
+  ruby_version = Gem::Version.new RUBY_VERSION
+  gem 'concurrent-ruby', '~> 1.0.0' unless ruby_version < (Gem::Version.new '1.9.3')
+  if ruby_version < (Gem::Version.new '2.2.0')
+    if ruby_version < (Gem::Version.new '2.1.0')
+      if ruby_version < (Gem::Version.new '2.0.0')
+        gem 'haml', '~> 4.0.0'
+        if ruby_version < (Gem::Version.new '1.9.3')
+          gem 'cucumber', '~> 1.3.0'
+          gem 'nokogiri', '~> 1.5.0'
+          gem 'slim', '~> 2.1.0'
+          gem 'thread_safe', '0.3.6'
+          gem 'tilt', '2.0.7'
+        else
+          gem 'nokogiri', '~> 1.6.0'
+          gem 'slim', '<= 3.0.7'
+        end
       else
         gem 'nokogiri', '~> 1.6.0'
-        gem 'slim', '<= 3.0.7'
       end
     else
-      gem 'nokogiri', '~> 1.6.0'
+      gem 'nokogiri', '~> 1.7.0' if Gem::Platform.local =~ 'x86-mingw32' || Gem::Platform.local =~ 'x64-mingw32'
+      # pin nokogiri because XPath behavior changed on JRuby starting in 1.8.3 (see sparklemotion/nokogiri#1803)
+      gem 'nokogiri', '1.8.2' if RUBY_ENGINE == 'jruby'
+      gem 'racc', '~> 1.4.0' if RUBY_VERSION == '2.1.0' && RUBY_ENGINE == 'rbx'
     end
-  elsif ruby_version < (Gem::Version.new '2.2.0')
-    gem 'nokogiri', '~> 1.7.0' if Gem::Platform.local =~ 'x86-mingw32' || Gem::Platform.local =~ 'x64-mingw32'
+  else
+    # pin nokogiri because XPath behavior changed on JRuby starting in 1.8.3 (see sparklemotion/nokogiri#1803)
+    gem 'nokogiri', '1.8.2' if RUBY_ENGINE == 'jruby'
   end
-  gem 'racc', '~> 1.4.0' if RUBY_VERSION == '2.1.0' && RUBY_ENGINE == 'rbx'
 end
 
 group :doc do

data/README-de.adoc

@@ -0,0 +1,482 @@
+= Asciidoctor
+Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
+v1.5.8, 2018-10-28
+// settings:
+:idprefix:
+:idseparator: -
+:source-language: ruby
+:language: {source-language}
+ifndef::env-github[:icons: font]
+ifdef::env-github[]
+:status:
+:outfilesuffix: .adoc
+:caution-caption: :fire:
+:important-caption: :exclamation:
+:note-caption: :paperclip:
+:tip-caption: :bulb:
+:warning-caption: :warning:
+endif::[]
+// Variables:
+:release-version: 1.5.8
+// URIs:
+:uri-org: https://github.com/asciidoctor
+:uri-repo: {uri-org}/asciidoctor
+:uri-asciidoctorj: {uri-org}/asciidoctorj
+:uri-asciidoctorjs: {uri-org}/asciidoctor.js
+:uri-project: http://asciidoctor.org
+ifdef::env-site[:uri-project: link:]
+:uri-docs: {uri-project}/docs
+:uri-news: {uri-project}/news
+:uri-manpage: {uri-project}/man/asciidoctor
+:uri-issues: {uri-repo}/issues
+:uri-contributors: {uri-repo}/graphs/contributors
+:uri-rel-file-base: link:
+:uri-rel-tree-base: link:
+ifdef::env-site[]
+:uri-rel-file-base: {uri-repo}/blob/master/
+:uri-rel-tree-base: {uri-repo}/tree/master/
+endif::[]
+:uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
+:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
+:uri-license: {uri-rel-file-base}LICENSE
+:uri-tests: {uri-rel-tree-base}test
+:uri-discuss: http://discuss.asciidoctor.org
+:uri-irc: irc://irc.freenode.org/#asciidoctor
+:uri-rubygem: https://rubygems.org/gems/asciidoctor
+:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
+:uri-user-manual: {uri-docs}/user-manual
+:uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor
+//:uri-install-doc: {uri-docs}/install-toolchain
+:uri-install-macos-doc: {uri-docs}/install-asciidoctor-macos
+:uri-render-doc: {uri-docs}/render-documents
+:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
+:uri-gitscm-repo: https://github.com/git/git-scm.com
+:uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
+:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
+:uri-foundation: https://foundation.zurb.com
+:uri-opal: https://opalrb.com
+:uri-tilt: https://github.com/rtomayko/tilt
+:uri-ruby: https://ruby-lang.org
+// images:
+:image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
+
+{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 HTML5, DocBook, PDF und andere Formate.
+Asciidoctor ist in Ruby geschrieben und läuft auf allen gängigen Betriebsystemen.
+Um 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.
+Asciidoctor kann auch in einer JVM mit {uri-asciidoctorj}[AsciidoctorJ] oder einer beliebigen Javascript-Umgebung mit {uri-asciidoctorjs}[Asciidoctor.js] ausgeführt werden.
+Das Asciidoctor-Projekt wird {uri-repo}[auf Github] gehostet.
+
+ifndef::env-site[]
+Dieses Dokument ist auch in folgenden Sprachen erhältlich: +
+{uri-rel-file-base}README-zh_CN.adoc[汉语]
+|
+{uri-rel-file-base}README.adoc[English]
+|
+{uri-rel-file-base}README-fr.adoc[Français]
+|
+{uri-rel-file-base}README-jp.adoc[日本語]
+endif::[]
+
+.Wichtige Dokumentation
+[.compact]
+* {uri-docs}/what-is-asciidoc[Was ist AsciiDoc?]
+* {uri-docs}/asciidoc-writers-guide[Asciidoctor Benutzerhandbuch]
+* {uri-docs}/user-manual[Asciidoctor Gebrauchshandbuch]
+* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax-Referenz]
+
+ifdef::status[]
+.*Projekt Status*
+image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
+image:https://ci.appveyor.com/api/projects/status/ifplu67oxvgn6ceq/branch/master?svg=true&amp;passingText=green%20bar&amp;failingText=%23fail&amp;pendingText=building%2E%2E%2E[Build Status (AppVeyor), link=https://ci.appveyor.com/project/asciidoctor/asciidoctor]
+//image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
+//image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
+image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
+endif::[]
+
+== Sponsoren
+
+Wir möchten unseren großzügigen Sponsoren danken, ohne deren Unterstützung Asciidoctor nicht möglich wäre.
+Vielen Dank an die Sponsoren für ihr Engagement zur Verbesserung der technischen Dokumentation!
+
+image:https://www.okta.com/sites/all/themes/Okta/images/blog/Logos/Okta_Logo_BrightBlue_Medium.png[Okta,280,link=https://developer.okta.com/signup?utm_source=asciidoctor&utm_medium=logo&utm_campaign=sponsor,title="Add User Auth to Your Apps in Minutes with Okta"]
+&nbsp; &nbsp; &nbsp;
+image:https://secure.gravatar.com/avatar/823717a797dbd78ceff7b26aa397f383.png?size=200[OpenDevise,100,link=https://opendevise.com,title="Let the Creators of Asciidoctor and Antora Help You to Accelerate Your Docs"]
+
+Unsere Change Makers, https://developer.okta.com/signup?utm_source=asciidoctor&utm_medium=text-link&utm_campaign=sponsor[Okta] und https://opendevise.com[OpenDevise], sowie unsere Strategiesponsoren https://www.khronos.org/[Khronos Group] und Linda Roberts finanzieren Asciidoctor maßgeblich.
+Zusätzliche Mittel werden von unseren https://asciidoctor.org/supporters[Community Backers] zur Verfügung gestellt.
+
+Sie können dieses Projekt unterstützen, indem Sie Sponsor bei https://opencollective.com/asciidoctor[OpenCollective] werden.
+
+== Das große Ganze
+
+Asciidoctor liest Inhalte, die im Klartext geschrieben wurden, wie im Feld links im Bild unten gezeigt, und wandelt Sie in HTML5 um, wie im rechten Feld dargestellt.
+Asciidoctor wendet ein Standard-Stylesheet auf das HTML5-Dokument an, um ein angenehmes Out-of-the-Box-Erlebnis zu bieten.
+
+image::{image-uri-screenshot}[Preview of AsciiDoc source and corresponding rendered HTML]
+
+== AsciiDoc Verarbeitung
+
+Asciidoctor liest und analysiert Text, der in der AsciiDoc-Syntax geschrieben wurde, und leitet dann den Parse-Tree durch eine Reihe von eingebauten Konvertern, um HTML5, DocBook 5 und man-pages zu erzeugen.
+Sie 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.
+
+Asciidoctor ist ein Ersatz für den Original AsciiDoc Python Prozessor (`asciidoc.py`).
+Die Asciidoctor-Testsuite verfügt über {uri-tests}[mehr als 2,000 Tests], um die Kompatibilität mit der AsciiDoc-Syntax sicherzustellen.
+
+Neben 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]+`).
+Asciidoctor bietet auch ein modernes, __responsive Theme__, das auf {uri-foundation}[Foundation] basiert, um die HTML5-Ausgabe zu gestalten.
+
+== Wo Ruby hingeht, folgt Asciidoctor
+
+Sie können Asciidoctor in einer JVM mit JRuby ausführen.
+Um die Asciidoctor API direkt aus Java und anderen JVM-Sprachen aufzurufen, verwenden Sie {uri-asciidoctorj}[AsciidoctorJ].
+Es stehen Ihnen auf {uri-asciidoctorj}[AsciidoctorJ] basierende Plugins zur Verfügung, die den Asciidoctor Prozessor in Apache Maven, Gradle oder Javadoc Builds integrieren.
+
+Asciidoctor läuft auch in JavaScript.
+{uri-opal}[Opal] wird verwendet, um den Ruby-Source in JavaScript umzukompilieren, um {uri-asciidoctorjs}[Asciidoctor.js] zu erzeugen.
+Asciidoctor.js ist eine voll funktionsfähige Version von Asciidoctor, die in jeder JavaScript-Umgebung wie z.B. einem Webbrowser oder Node.js funktioniert.
+Es wird für die AsciiDoc Vorschau-Erweiterungen für Chrome, Atom, Brackets und andere webbasierte Werkzeuge verwendet.
+
+== Anforderungen
+
+Asciidoctor arbeitet unter Linux, MacOS und Windows und benötigt eine der folgenden Implementierungen von {uri-ruby}[Ruby]:
+
+* Ruby (MRI/CRuby 1.8.7 - 2.5)
+* JRuby (1.7 in Ruby 1.8 und 1.9 modes, 9000)
+* Rubinius 2.2.x
+* Opal (JavaScript)
+
+[CAUTION]
+====
+Wenn Sie eine nicht-englische Windows-Umgebung verwenden, können Sie auf einen `Encoding::UndefinedConversionError` stoßen, wenn Sie Asciidoctor aufrufen.
+Um dieses Problem zu beheben, empfehlen wir, die aktive Codepage in Ihrer Konsole auf UTF-8 umzustellen:
+
+  chcp 65001
+
+Sobald Sie diese Änderung vorgenommen haben, haben Sie alle Ihre Unicode-Kopfschmerzen hinter sich.
+Wenn Sie eine IDE wie Eclipse verwenden, stellen Sie sicher, dass Sie dort auch die Kodierung auf UTF-8 setzen.
+Asciidoctor funktioniert am besten, wenn Sie UTF-8 überall verwenden.
+====
+
+== Installation
+
+Asciidoctor 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.
+
+Der 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.
+
+=== (a) Linux Paketmanager
+
+Die vom Paketmanager installierte Version von Asciidoctor entspricht möglicherweise nicht der neuesten Version von Asciidoctor.
+Konsultieren Sie das Paket-Repository für Ihre Distribution, um herauszufinden, welche Version in der Distribution gepackt ist.
+
+* https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
+* https://www.archlinux.org/packages/?name=asciidoctor[Arch Linux (asciidoctor)]
+* https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+* https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (asciidoctor)]
+* https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
+* https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+
+Wenn Sie eine Version von Asciidoctor verwenden möchten, die neuer ist als die, die vom Paketmanager installiert wurde, lesen Sie bitte die <<gem-install, Installationsanweisungen>>.
+
+==== apk (Alpine Linux)
+
+Um ein Gem auf Alpine Linux zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ sudo apk add asciidoctor
+
+==== pacman (Arch Linux)
+
+Um ein Gem auf Arch-basierten Distributionen zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ sudo pacman -S asciidoctor
+
+==== APT
+
+Auf Debian und Debian-basierten Distributionen wie Ubuntu nutzen Sie APT um Asciidoctor zu installieren.
+Um das Paket zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ sudo apt-get install -y asciidoctor
+
+==== DNF
+
+Auf RPM-basierten Linux-Distributionen, wie Fedora, CentOS und RHEL, nutzen Sie den DNF Paketmanager um Asciidoctor zu installieren.
+Um das Paket zu installieren, öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ sudo dnf install -y asciidoctor
+
+=== (b) Homebrew (macOS)
+
+Sie können Homebrew, den macOS-Paketmanager, verwenden, um Asciidoctor zu installieren.
+Wenn Sie Homebrew nicht auf Ihrem Computer haben, führen Sie zuerst die Installationsanweisungen unter https://brew.sh/[brew.sh] aus.
+Sobald Homebrew installiert ist, können Sie das Asciidoctor gem installieren.
+Öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ brew install asciidoctor
+
+Homebrew installiert das `asciidoctor` Gem in ein exklusives Präfix, das unabhängig von den System-Gems ist.
+
+=== (c) Windows
+
+Um Asciidoctor unter Windows zu installieren, gibt es zwei einfache Möglichkeiten.
+
+==== Chocolatey
+
+Wenn Sie bereits https://chocolatey.org[chocolatey] verwenden, können Sie folgenden Befehl verwenden:
+
+[source]
+----
+choco install ruby
+----
+
+Danach folgen Sie der <<gem-install,Gem Installation>>.
+
+==== Rubyinstaller
+
+Oder 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 <<gem-install, Gem Installation>>.
+
+[#gem-install]
+=== (d) gem install
+
+Bevor Sie Asciidoctor mit `gem install` installieren, sollten Sie https://rvm.io[RVM] verwenden, um Ruby in Ihrem Home-Verzeichnis zu installieren (z.B. Userspace).
+Dann können Sie den Befehl `gem` sicher verwenden, um den Asciidoctor Gem zu installieren oder zu aktualisieren.
+Bei der Verwendung von RVM werden Gems an einem vom System isolierten Ort installiert.
+
+Öffnen Sie ein Terminal und geben Sie folgendes ein:
+
+ $ gem install asciidoctor
+
+Wenn Sie eine Vorabversion (z.B. einen Release-Kandidaten) installieren möchten, verwenden Sie:
+
+ $ gem install asciidoctor --pre
+
+=== (e) Docker
+
+Siehe {uri-install-docker}[Installing Asciidoctor using Docker].
+
+=== (f) Bundler
+
+. Erstellen Sie ein Gemfile im Stammordner Ihres Projekts (oder im aktuellen Verzeichnis).
+. Fügen Sie den `asciidoctor` Gem wie folgt zu Ihrem Gemfile hinzu:
+
++
+[source,subs=attributes+]
+----
+source 'https://rubygems.org'
+gem 'asciidoctor'
+# oder spezifizieren Sie die Version explizit
+# gem 'asciidoctor', '{release-version}'
+----
+
+. Speichern Sie das Gemfile
+. Öffnen Sie ein Terminal und installieren Sie das Gem mit:
+
+ $ bundle
+
+Um das Gem zu aktualisieren, geben Sie die neue Version im Gemfile an und führen Sie `bundle` erneut aus.
+Die 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.
+
+== Upgrade
+
+Wenn Sie Asciidoctor mit einem Paketmanager installiert haben, ist ihr Betriebssystem wahrscheinlich so konfiguriert, dass es Pakete automatisch aktualisiert.
+In diesem Fall müssen Sie das Gem nicht manuell aktualisieren.
+
+=== apk (Alpine Linux)
+
+Um das Gem zu aktualisieren, nutzen Sie:
+
+ $ sudo apk add -u asciidoctor
+
+=== APT
+
+Um das Gem zu aktualisieren, nutzen Sie:
+
+ $ sudo apt-get upgrade -y asciidoctor
+
+=== DNF
+
+Um das Gem zu aktualisieren, nutzen Sie:
+
+ $ sudo dnf update -y asciidoctor
+
+=== Homebrew (macOS)
+
+Um das Gem zu aktualisieren, nutzen Sie:
+
+ $ brew update
+ $ brew upgrade asciidoctor
+
+=== gem install
+
+Wenn Sie Asciidoctor zuvor mit dem Befehl `gem` installiert haben, müssen Sie Asciidoctor manuell aktualisieren, wenn eine neue Version veröffentlicht wird.
+Sie können mit folgendem Befehl aktualisieren:
+
+ $ gem install asciidoctor
+
+Wenn Sie eine neue Version des Edelsteins mit `gem install` installieren, werden mehrere Versionen installiert.
+Verwenden Sie den folgenden Befehl, um die alten Versionen zu entfernen:
+
+ $ gem cleanup asciidoctor
+
+== Verwendung
+
+Wenn der Asciidoctor Gem erfolgreich installiert wurde, ist das `asciidoctor` Kommandozeilen-Interface (CLI) in Ihrem PATH verfügbar.
+Um die Verfügbarkeit zu überprüfen, führen Sie den folgenden Befehl in Ihrem Terminal aus:
+
+ $ asciidoctor --version
+
+Sie sollten Informationen über die Asciidoctor-Version und Ihre Ruby-Umgebung im Terminal sehen.
+
+[.output,subs=attributes+]
+....
+Asciidoctor 1.5.7 [https://asciidoctor.org]
+Laufzeitumgebung (ruby 2.5.1p57 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
+....
+
+Asciidoctor bietet auch eine API.
+Die 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.
+
+=== Kommandozeile
+
+Mit dem Befehl `asciidoctor` können Sie Asciidoctor von der Kommandozeile (z.B. einem Terminal) aus aufrufen.
+
+Der folgende Befehl konvertiert die Datei README.adoc nach HTML und speichert das Ergebnis in der Datei README.html im gleichen Verzeichnis.
+Der Name der erzeugten HTML-Datei wird aus der Quelldatei abgeleitet, indem die Dateierweiterung auf `.html` geändert wird.
+
+ $ asciidoctor README.adoc
+
+Sie können den Asciidoctor-Prozessor steuern, indem Sie verschiedene Flags und Schalter hinzufügen, über die Sie sich mittels folgendem Befehl informieren können:
+
+ $ asciidoctor --help
+
+Zum Beispiel, um die Datei in ein anderes Verzeichnis zu schreiben, verwenden Sie:
+
+ $ asciidoctor -D output README.adoc
+
+Die `asciidoctor` {uri-manpage}[man page] bietet eine vollständige Referenz der Kommandozeile.
+
+Lesen Sie die folgenden Ressourcen, um mehr über die Verwendung des `asciidoctor`-Befehls zu erfahren.
+
+* {uri-render-doc}[How do I convert a document?]
+* {uri-themes-doc}[How do I use the Asciidoctor stylesheet factory to produce custom themes?]
+
+=== Ruby API
+
+Um Asciidoctor in Ihrer Anwendung verwenden zu können, benötigen Sie zunächst das Gem:
+
+[source]
+----
+require 'asciidoctor'
+----
+
+Sie können dann eine AsciiDoc-Quelldatei in eine HTML-Datei konvertieren:
+
+[source]
+----
+Asciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe
+----
+
+WARNING: Bei Verwendung von Asciidoctor über die API ist der Standard-Sicherheitsmodus `:secure`.
+Im sicheren Modus sind mehrere Kernfunktionen deaktiviert, darunter die `include`-Direktive.
+Wenn Sie diese Funktionen aktivieren möchten, müssen Sie den Sicherheitsmodus explizit auf `:server` (empfohlen) oder `:safe` setzen.
+
+Sie können einen AsciiDoc-String auch in ein integrierbares HTML (zum Einfügen in eine HTML-Seite) konvertieren, mit:
+
+[source]
+----
+content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
+Asciidoctor.convert content, safe: :safe
+----
+
+Wenn Sie das komplette HTML-Dokument wünschen, aktivieren Sie die Option `head_footer` wie folgt:
+
+[source]
+----
+content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
+html = Asciidoctor.convert content, header_footer: true, safe: :safe
+----
+
+Wenn Sie Zugriff auf das analysierte Dokument benötigen, können Sie die Konvertierung in einzelne Schritte aufteilen:
+
+[source]
+----
+content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
+document = Asciidoctor.load content, header_footer: true, safe: :safe
+puts document.doctitle
+html = document.convert
+----
+
+Denken Sie daran, dass __Sie die Ausgabe__ von Asciidoctor __ändern können__, wenn Sie sie nicht mögen!
+Asciidoctor unterstützt benutzerdefinierte Konverter, die die Konvertierung vom geparsten Dokument in die generierte Ausgabe übernehmen können.
+
+Eine einfache Möglichkeit, die Ausgabe stückweise anzupassen, ist die Verwendung des Template-Konverters.
+Der 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.
+
+Wie auch immer Sie vorgehen, Sie können die Ausgabe zu 100% kontrollieren.
+Weitere Informationen zur Verwendung der API oder zur Anpassung der Ausgabe finden Sie im {uri-user-manual}[Benutzerhandbuch].
+
+== Mitwirken
+
+Neue Mitwirkende sind immer willkommen!
+Wenn 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.
+
+Hier sind einige Möglichkeiten, wie *Sie* dazu beitragen können:
+
+* durch Verwendung von Vorabversionen (Alpha-, Beta- oder Preview-Versionen)
+* durch das Melden von Fehlern
+* durch Vorschläge für neue Funktionen
+* durch das Verfassen oder Bearbeiten von Dokumentationen
+* durch Schreiben von Code mit Tests -- _Kein Patch ist zu klein._
+** Tippfehler beheben
+** Kommentare hinzufügen
+** inkonsistente Leerzeichen bereinigen
+** Tests schreiben!
+* Refactoring von Code
+* durch die Behebung von {uri-issues}[Problemen]
+* durch Überprüfung von Patches
+
+Der {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.
+
+== Hilfe finden
+
+Asciidoctor wurde entwickelt, um Ihnen das Schreiben und Veröffentlichen Ihrer Inhalte zu erleichtern.
+Aber wir können es nicht ohne ihr Feedback machen!
+Wir ermutigen Sie, Fragen zu stellen und alle Aspekte des Projekts auf der Diskussionsliste, auf Twitter oder im Chatroom zu diskutieren.
+
+Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
+Discussionsliste (Nabble):: {uri-discuss}
+Twitter:: https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] hashtag or https://twitter.com/asciidoctor[@asciidoctor] mention
+
+ifdef::env-github[]
+Weitere Informationen und Dokumentation zu Asciidoctor finden Sie auf der Website des Projekts.
+
+{uri-project}[Home] | {uri-news}[News] | {uri-docs}[Docs]
+endif::[]
+
+Die Asciidoctor-Organisation auf GitHub hostet den Quellcode des Projekts, den Issue Tracker und Unterprojekte.
+
+Source repository (git):: {uri-repo}
+Issue tracker:: {uri-issues}
+Asciidoctor Organization auf GitHub:: {uri-org}
+
+== Lizenz
+
+Copyright (C) 2012-2018 Dan Allen, Sarah White und die einzelnen Mitarbeiter von Asciidoctor.
+Die Nutzung dieser Software wird unter den Bedingungen der MIT-Lizenz gewährt.
+
+Siehe die {uri-license}[LIZENZ] für den vollen Lizenztext.
+
+== Authoren
+
+*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.
+Das Projekt wurde 2012 von https://github.com/erebor[Ryan Waldron] initiiert und basiert auf einem {uri-prototype}[Prototyp] von https://github.com/nickh[Nick Hengeveld].
+
+*AsciiDoc* wurde von Stuart Rackham gegründet und hat Beiträge von vielen Personen aus der AsciiDoc-Community erhalten.
+
+ifndef::env-site[]
+== Changelog
+
+ifeval::[{safe-mode-level} < 20]
+include::CHANGELOG.adoc[tag=compact,leveloffset=+1]
+endif::[]
+
+Eine vollständige Liste der Änderungen in älteren Versionen finden Sie im {uri-changelog}[CHANGELOG].
+endif::[]