asciidoctor 2.0.7 → 2.0.12

data/README-zh_CN.adoc

@@ -1,6 +1,6 @@
 = Asciidoctor
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
-v2.0.7, 2019-04-13
+v2.0.12, 2020-11-10
 // settings:
 :page-layout: base
 :idprefix:
@@ -9,7 +9,6 @@ v2.0.7, 2019-04-13
 :language: {source-language}
 ifndef::env-github[:icons: font]
 ifdef::env-github[]
-:status:
 :outfilesuffix: .adoc
 :caution-caption: :fire:
 :important-caption: :exclamation:
@@ -18,7 +17,7 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // Variables:
-:release-version: 2.0.7
+:release-version: 2.0.12
 // URIs:
 :uri-org: https://github.com/asciidoctor
 :uri-repo: {uri-org}/asciidoctor
@@ -41,7 +40,7 @@ endif::[]
 :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-discuss: https://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
@@ -62,8 +61,8 @@ endif::[]
 
 {uri-project}/[Asciidoctor] 是一个 _快速_ 文本处理器和发布工具链，它可以将 {uri-what-is-asciidoc}[AsciiDoc] 文档转化成 HTML 5、 DocBook 5 以及其他格式。
 Asciidoctor 由 Ruby 编写，打包成 RubyGem，然后发布到 {uri-rubygem}[RubyGems.org] 上。
-这个 gem 还被包含道几个 Linux 发行版中，其中包括 Fedora、Debian 和 Ubuntu。
-Asciidoctor 是开源的，{uri-repo}[代码]托管在 GitHub，遵从 {uri-license}[MIT] 协议。
+这个 gem 还被包含到几个 Linux 发行版中，其中包括 Fedora、Debian 和 Ubuntu。
+Asciidoctor 是开源的，link:{uri-repo}[代码托管在 GitHub]，遵从 {uri-license}[MIT] 协议。
 
 该文档有如下语言的翻译版：
 
@@ -89,15 +88,6 @@ Asciidoctor 也可以运行在 JavaScript 上。
 Asciidoctor.js 被用于预览 AsciiDoc，支持 Chrome 扩展，Atom，Brackets 或其他基于 Web 的工具。
 ****
 
-ifdef::status[]
-.*Project health*
-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::[]
-
 [#the-big-picture]
 == 整体概况
 
@@ -326,7 +316,7 @@ WARNING: 当你通过 API 使用 Asciidoctor 时，默认的安全模式是 `:se
 在 secure 模式下，很多核心特性将不可用，包括 `include` 特性。
 如果你想启用这些特性，你需要明确设置安全模式为 `:server` （推荐）或 `:safe`。
 
-你也可以将 AsciiDoc 字符串转化我内嵌的 HTML （为了插入到一个 HTML 页面），用法如下：
+你也可以将 AsciiDoc 字符串转化为可内嵌的 HTML （为了插入到一个 HTML 页面），用法如下：
 
 [source]
 ----
@@ -412,7 +402,7 @@ Asciidoctor 组织在 GitHub 托管代码、议案跟踪和相关子项目。
 [#copyright-and-licensing]
 == 版权和协议
 
-Copyright (C) 2012-2019 Dan Allen, Ryan Waldron and the Asciidoctor Project.
+Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
 这个软件的免费使用是在MIT许可条款授予的。
 
 请看 {uri-license}[版权声明] 文件来获取更多详细信息。

data/README.adoc

@@ -1,6 +1,6 @@
 = Asciidoctor
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
-v2.0.7, 2019-04-13
+v2.0.12, 2020-11-10
 // settings:
 :idprefix:
 :idseparator: -
@@ -17,7 +17,7 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // Variables:
-:release-version: 2.0.7
+:release-version: 2.0.12
 // URIs:
 :uri-org: https://github.com/asciidoctor
 :uri-repo: {uri-org}/asciidoctor
@@ -27,6 +27,7 @@ endif::[]
 :uri-maven-plugin: {uri-org}/asciidoctor-maven-plugin
 :uri-asciidoclet: {uri-org}/asciidoclet
 :uri-project: https://asciidoctor.org
+:uri-gem: https://rubygems.org/gems/asciidoctor
 ifdef::env-site[:uri-project: link:]
 :uri-docs: {uri-project}/docs
 :uri-news: {uri-project}/news
@@ -43,7 +44,7 @@ endif::[]
 :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-discuss: https://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
@@ -91,12 +92,12 @@ endif::[]
 
 ifdef::status[]
 //.*Project health*
-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/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
+image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
+image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
 //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]
-image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
 endif::[]
 
 == Sponsors
@@ -105,11 +106,6 @@ We want to recognize our {uri-project}/supporters[sponsors] for their commitment
 Thank you sponsors!
 Without your generous support, Asciidoctor would not be possible.
 
-ifndef::env-site,env-yard[]
-Major funding for Asciidoctor is provided by our *Change Maker*, https://opendevise.com[OpenDevise], our *Strategy Sponsors*, https://www.khronos.org/[Khronos Group] and Linda Roberts, and our *Pull Request Backers*, Brian Dominick, Guillaume Grossetie, and Abel Salgado Romero.
-Additional funding is provided by the supporters listed on our {uri-project}/supporters[Community Backers] page.
-endif::[]
-
 You can support this project by becoming a sponsor through https://opencollective.com/asciidoctor[OpenCollective].
 
 == The Big Picture
@@ -164,7 +160,7 @@ Asciidoctor works best when you use UTF-8 everywhere.
 
 == Installation
 
-Asciidoctor can be installed using (a) package managers for popular Linux distributions, (b) Homebrew for macOS, (c) the `gem install` command (recommended for Windows users), (d) the Asciidoctor Docker image, or (e) Bundler.
+Asciidoctor can be installed using (a) package managers for popular Linux distributions, (b) Homebrew for macOS, (c) the `gem install` command (recommended for Windows users or if you'll be installing additional gems), (d) the Asciidoctor Docker image, or (e) Bundler.
 
 The benefit of using your operating system's package manager to install the gem is that it handles installing Ruby and the RubyGems library if those packages are not already installed on your machine.
 
@@ -241,11 +237,11 @@ Or you use the https://rubyinstaller.org/downloads/[Rubyinstaller], download the
 [#gem-install]
 === (d) gem install
 
-Before installing Asciidoctor using `gem install`, you should use https://rvm.io[RVM] to install Ruby in your home directory (i.e., user space).
-Then, you can safely use the `gem` command to install or update the Asciidoctor gem.
+Before installing Asciidoctor using `gem install`, you should set up https://rvm.io[RVM] to install Ruby in your home directory (i.e., user space).
+Then, you can safely use the `gem` command to install or update the Asciidoctor gem, or any other gem for that matter.
 When using RVM, gems are installed in a location isolated from the system.
 
-Open a terminal and type:
+Once you've installed Ruby using RVM, and you have activated it using `rvm use 2.6`, open a terminal and type:
 
  $ gem install asciidoctor
 
@@ -456,9 +452,9 @@ Source repository (git):: {uri-repo}
 Issue tracker:: {uri-issues}
 Asciidoctor organization on GitHub:: {uri-org}
 
-== License
+== Copyright and License
 
-Copyright (C) 2012-2019 Dan Allen, Sarah White and the individual contributors to Asciidoctor.
+Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
 Use of this software is granted under the terms of the MIT License.
 
 See the {uri-license}[LICENSE] for the full license text.
@@ -468,7 +464,11 @@ See the {uri-license}[LICENSE] for the full license text.
 *Asciidoctor* is led by https://github.com/mojavelinux[Dan Allen] and https://github.com/graphitefriction[Sarah White] and has received contributions from {uri-contributors}[many individuals] in Asciidoctor's awesome community.
 The project was initiated in 2012 by https://github.com/erebor[Ryan Waldron] and based on {uri-prototype}[a prototype] written by https://github.com/nickh[Nick Hengeveld].
 
-*AsciiDoc* was started by Stuart Rackham and has received contributions from many individuals in the AsciiDoc community.
+*AsciiDoc* was started and maintained by Stuart Rackham from https://github.com/asciidoc/asciidoc/blob/master/CHANGELOG.txt[2002 to 2013] and has received contributions from many individuals in the https://github.com/asciidoc/asciidoc/graphs/contributors[AsciiDoc community].
+
+== Trademarks
+
+AsciiDoc is a Trademark of the Eclipse Foundation, Inc.
 
 ifndef::env-site[]
 == Changelog

data/asciidoctor.gemspec

@@ -40,14 +40,14 @@ Gem::Specification.new do |s|
   # concurrent-ruby, haml, slim, and tilt are needed for testing custom templates
   s.add_development_dependency 'concurrent-ruby', '~> 1.1.0'
   s.add_development_dependency 'cucumber', '~> 3.1.0'
-  # erubis is needed for testing alternate eRuby impls
-  s.add_development_dependency 'erubis', '~> 2.7.0'
+  # erubi is needed for testing alternate eRuby impls
+  s.add_development_dependency 'erubi', '~> 1.9.0'
   s.add_development_dependency 'haml', '~> 5.0.0'
   s.add_development_dependency 'minitest', '~> 5.11.0'
   s.add_development_dependency 'nokogiri', '~> 1.10.0'
   s.add_development_dependency 'rake', '~> 12.3.0'
-  # Asciidoctor supports Rouge >= 3
-  s.add_development_dependency 'rouge', '~> 3.3.0'
+  # Asciidoctor supports Rouge >= 2
+  s.add_development_dependency 'rouge', '~> 3.15.0'
   s.add_development_dependency 'rspec-expectations', '~> 3.8.0'
   s.add_development_dependency 'slim', '~> 4.0.0'
   s.add_development_dependency 'tilt', '~> 2.0.0'

data/data/locale/attributes-ar.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: ملحق
 :appendix-refsig: {appendix-caption}
 :caution-caption: تنبيه
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+//:chapter-signifier: ???
+//:chapter-refsig: {chapter-signifier}
 :example-caption: مثال
 :figure-caption: الشكل
 :important-caption: مهم
@@ -11,7 +11,8 @@
 ifdef::listing-caption[:listing-caption: قائمة]
 ifdef::manname-title[:manname-title: اسم]
 :note-caption: ملاحظة
-//:part-refsig: ???
+//:part-signifier: ???
+//:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: تمهيد]
 //:section-refsig: ???
 :table-caption: جدول

data/data/locale/attributes-bg.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: Приложение
 :appendix-refsig: {appendix-caption}
 :caution-caption: Внимание
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+//:chapter-signifier: ???
+//:chapter-refsig: {chapter-signifier}
 :example-caption: Пример
 :figure-caption: Фигура
 :important-caption: Важно
@@ -11,7 +11,8 @@
 ifdef::listing-caption[:listing-caption: Листинг]
 ifdef::manname-title[:manname-title: Име]
 :note-caption: Забележка
-//:part-refsig: ???
+//:part-signifier: ???
+//:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Предговор]
 //:section-refsig: ???
 :table-caption: Таблица

data/data/locale/attributes-ca.adoc

@@ -1,9 +1,9 @@
 // Catalan translation, courtesy of Abel Salgado Romero <abelromero@gmail.com> and Alex Soto
-:appendix-caption: Apendix
+:appendix-caption: Apèndix
 :appendix-refsig: {appendix-caption}
 :caution-caption: Atenció
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+:chapter-signifier: Capítol
+:chapter-refsig: {chapter-signifier}
 :example-caption: Exemple
 :figure-caption: Figura
 :important-caption: Important
@@ -11,9 +11,10 @@
 ifdef::listing-caption[:listing-caption: Llista]
 ifdef::manname-title[:manname-title: Nom]
 :note-caption: Nota
-//:part-refsig: ???
+:part-signifier: Part
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Prefaci]
-//:section-refsig: ???
+:section-refsig: Secció
 :table-caption: Taula
 :tip-caption: Suggeriment
 :toc-title: Índex

data/data/locale/attributes-cs.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: Příloha
 :appendix-refsig: {appendix-caption}
 :caution-caption: Upozornění
-:chapter-label: Kapitola
-:chapter-refsig: {chapter-label}
+:chapter-signifier: Kapitola
+:chapter-refsig: {chapter-signifier}
 :example-caption: Příklad
 :figure-caption: Obrázek
 :important-caption: Důležité
@@ -11,7 +11,8 @@
 ifdef::listing-caption[:listing-caption: Seznam]
 ifdef::manname-title[:manname-title: Název]
 :note-caption: Poznámka
-:part-refsig: Část
+:part-signifier: Část
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Úvod]
 :section-refsig: Oddíl
 :table-caption: Tabulka

data/data/locale/attributes-da.adoc

@@ -1,9 +1,9 @@
-// Danish translation, courtesy of Max Rydahl Andersen <manderse@redhat.com>
+// Danish translation, courtesy of Max Rydahl Andersen <manderse@redhat.com>, with updates from Morten Høfft <mhoefft@gbif.org>
 :appendix-caption: Appendix
 :appendix-refsig: {appendix-caption}
 :caution-caption: Forsigtig
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+:chapter-signifier: Kapitel
+:chapter-refsig: {chapter-signifier}
 :example-caption: Eksempel
 :figure-caption: Figur
 :important-caption: Vigtig
@@ -11,9 +11,10 @@
 ifdef::listing-caption[:listing-caption: List]
 ifdef::manname-title[:manname-title: Navn]
 :note-caption: Notat
-//:part-refsig: ???
+:part-signifier: Del
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Forord]
-//:section-refsig: ???
+:section-refsig: Sektion
 :table-caption: Tabel
 :tip-caption: Tips
 :toc-title: Indholdsfortegnelse

data/data/locale/attributes-de.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: Anhang
 :appendix-refsig: {appendix-caption}
 :caution-caption: Achtung
-:chapter-label: Kapitel
-:chapter-refsig: {chapter-label}
+:chapter-signifier: Kapitel
+:chapter-refsig: {chapter-signifier}
 :example-caption: Beispiel
 :figure-caption: Abbildung
 :important-caption: Wichtig
@@ -11,8 +11,8 @@
 ifdef::listing-caption[:listing-caption: Listing]
 ifdef::manname-title[:manname-title: Bezeichnung]
 :note-caption: Anmerkung
-:part-label: Teil
-:part-refsig: {part-label}
+:part-signifier: Teil
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Vorwort]
 :section-refsig: Abschnitt
 :table-caption: Tabelle

data/data/locale/attributes-en.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: Appendix
 :appendix-refsig: {appendix-caption}
 :caution-caption: Caution
-:chapter-label: Chapter
-:chapter-refsig: {chapter-label}
+:chapter-signifier: Chapter
+:chapter-refsig: {chapter-signifier}
 :example-caption: Example
 :figure-caption: Figure
 :important-caption: Important
@@ -11,8 +11,8 @@
 ifdef::listing-caption[:listing-caption: Listing]
 ifdef::manname-title[:manname-title: Name]
 :note-caption: Note
-:part-label: Part
-:part-refsig: {part-label}
+:part-signifier: Part
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Preface]
 :section-refsig: Section
 :table-caption: Table

data/data/locale/attributes-es.adoc

@@ -1,9 +1,9 @@
-// Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com>
+// Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com> with updates from Fede Mendez <federicomh@gmail.com>
 :appendix-caption: Apéndice
 :appendix-refsig: {appendix-caption}
 :caution-caption: Precaución
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+:chapter-signifier: Capítulo
+:chapter-refsig: {chapter-signifier}
 :example-caption: Ejemplo
 :figure-caption: Figura
 :important-caption: Importante
@@ -11,9 +11,10 @@
 ifdef::listing-caption[:listing-caption: Lista]
 ifdef::manname-title[:manname-title: Nombre]
 :note-caption: Nota
-//:part-refsig: ???
+:part-signifier: Parte
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Prefacio]
-//:section-refsig: ???
+:section-refsig: Sección
 :table-caption: Tabla
 :tip-caption: Sugerencia
 :toc-title: Tabla de Contenido

data/data/locale/attributes-fa.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: پیوست
 :appendix-refsig: {appendix-caption}
 :caution-caption: گوشزد
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+//:chapter-signifier: ???
+//:chapter-refsig: {chapter-signifier}
 :example-caption: نمونه
 :figure-caption: نمودار
 :important-caption: مهم
@@ -11,7 +11,8 @@
 ifdef::listing-caption[:listing-caption: فهرست]
 ifdef::manname-title[:manname-title: نام]
 :note-caption: یادداشت
-//:part-refsig: ???
+//:part-signifier: ???
+//:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: پیشگفتار]
 //:section-refsig: ???
 :table-caption: جدول

data/data/locale/attributes-fi.adoc

@@ -2,8 +2,8 @@
 :appendix-caption: Liitteet
 :appendix-refsig: {appendix-caption}
 :caution-caption: Huom
-//:chapter-label: ???
-//:chapter-refsig: {chapter-label}
+//:chapter-signifier: ???
+//:chapter-refsig: {chapter-signifier}
 :example-caption: Esimerkki
 :figure-caption: Kuvio
 :important-caption: Tärkeää
@@ -11,7 +11,8 @@
 ifdef::listing-caption[:listing-caption: Listaus]
 ifdef::manname-title[:manname-title: Nimi]
 :note-caption: Huomio
-//:part-refsig: ???
+//:part-signifier: ???
+//:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Esipuhe]
 //:section-refsig: ???
 :table-caption: Taulukko

data/data/locale/attributes-fr.adoc

@@ -1,9 +1,9 @@
-// French translation, courtesy of Nicolas Comet <nicolas.comet@gmail.com>
+// French translation, courtesy of Nicolas Comet <nicolas.comet@gmail.com> with updates from Maheva Bagard Laursen <mblaursen@gbif.org>
 :appendix-caption: Annexe
 :appendix-refsig: {appendix-caption}
 :caution-caption: Avertissement
-//:chapter-label: Chapitre
-//:chapter-refsig: {chapter-label}
+:chapter-signifier: Chapitre
+:chapter-refsig: {chapter-signifier}
 :example-caption: Exemple
 :figure-caption: Figure
 :important-caption: Important
@@ -11,9 +11,10 @@
 ifdef::listing-caption[:listing-caption: Liste]
 ifdef::manname-title[:manname-title: Nom]
 :note-caption: Note
-//:part-refsig: ???
+:part-signifier: Partie
+:part-refsig: {part-signifier}
 ifdef::preface-title[:preface-title: Préface]
-//:section-refsig: ???
+:section-refsig: Section
 :table-caption: Tableau
 :tip-caption: Astuce
 :toc-title: Table des matières