asciidoctor 2.0.6 → 2.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9066105e2eb3a4a1eef1b7e03730a3daa81e6b0abcfebef789e5c02e4a070db8
-  data.tar.gz: 902d0e58872adbafcd81a6faa7373b4e207ad5596ec37f3d1a01a6e83fabfac2
+  metadata.gz: 11a800adcdf4265d33a08cd8a131f72c4d0ae4fbafdca247c857743151f7a62a
+  data.tar.gz: d469b8d294a613e6cf41d8bfb20064adfae9f053bb37b23873a0dc18247d7060
 SHA512:
-  metadata.gz: a77b68c94c63ba1f783cc1e2af7ead46415a8f49f85195f7367f94506b12d1ad19310b142249d534cc61513633ba4ba8e931e744922f4a3bfe92e9b0e9e4d97d
-  data.tar.gz: d0a13bb0dfe883cb0a8e6ae949e3f6178de75f57d6d6a35f90ee5954f8b85faa6c76b0c3244a07aca43478daab789a33b3f780faa1e083b27bba5a1eb9f5cf74
+  metadata.gz: 471623feae9609099d5687e8a0231650990fb4b8fc39f95cfa64a8afcfc6777465354fec84e2d083088fb3706016eb3146cd83305c0c9242de61ded5bb10d046
+  data.tar.gz: 73959dff4b12916de260b924d5496ecef849e1989e9167ad3a74f812d937a7697b97289af0e74c85ed139aad962730b6f516f41e09d870ffbe5839afbba469db

data/CHANGELOG.adoc

@@ -13,6 +13,140 @@ 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.
 
+// tag::compact[]
+== 2.0.11 (2020-11-02) - @mojavelinux
+
+Bug Fixes::
+
+  * Fix infinite loop when callout list with obsolete syntax is found inside list item (#3472)
+  * Fix infinite loop when xreftext contains a circular reference path in HTML and manpage converters (#3543)
+  * Apply text formatting to table cells in implicit header row when column has the "a" or "l" style (#3760)
+  * Fix errant reference warning for valid reference when running in compat mode (#3555)
+  * Initialize backend traits for converter (if not previously initialized) using assigned basebackend; mimics Asciidoctor < 2 behavior (#3341)
+  * Set source_location on preamble block when sourcemap option is enabled (#3799)
+  * Link the notitle and showtitle attributes so they act as opposites for the same toggle (#3804)
+  * Pass options to constructor of Rouge lexer instead of #lex method; restores compatibility with Rouge >= 3.4 (#3336)
+  * Don't clobber cgi-style options on language when enabling start_inline option on the Rouge PHP lexer (#3336)
+  * Fix parsing of wrapped link and xref text, including when an attrlist signature is detected (#3331)
+  * Restore deprecated writable number property on AbstractBlock
+  * Always use title as xreftext if target block has an empty caption, regardless of xrefstyle value (#3745)
+  * Allow a bibliography reference to be used inside a footnote (#3325)
+  * Fix bottom margin collapsing on AsciiDoc table cell (#3370)
+  * Remove excess hard line break in multi-line AsciiMath blocks (#3407)
+  * Only strip trailing spaces from lines of AsciiDoc include file (#3436)
+  * Remove errant optional flag in regexp for menu macro that breaks Asciidoctor.js (#3433)
+  * Preserve repeating backslashes when generating manpage output (#3456)
+  * Honor percentage width specified on macro of inline SVG (#3464)
+  * Removing leading and trailing blank lines in AsciiDoc include file to match assumption of parser (#3470)
+  * Activate extensions when :extensions option is set even if Extensions API is not yet loaded (#3570)
+  * Don't activate global extensions if :extensions option is false (#3570)
+  * Escape ellipsis at start of line in manpage output (#3645) (*@jnavila*)
+  * Don't register footnote with ID if a footnote is already registered with that ID (#3690)
+  * Honor start attribute on ordered list in manpage output (#3714)
+  * Warn instead of crashing if SVG to inline is empty (#3638) (*@mogztter*)
+  * Compute highlight line ranges on source block relative to value of start attribute (#3519) (*@mogztter*)
+  * Prevent collapsible block from incrementing example number by assigning an empty caption (#3639)
+  * Use custom init function for highlight.js to select the correct `code` elements (#3761)
+  * Fix resolved value of :to_dir when both :to_file and :to_dir options are set to absolute paths (#3778)
+  * Fix crash if value of `stylesheets` attribute contains a folder and the destination directory for the stylesheet does not exist (even when the `:mkdirs` option is set) (#3808)
+  * Fix crash if value passed by API for `copycss` attribute is not a string (#3592)
+  * Restore label in front of each bibliography entry in DocBook output that was dropped by fix for #3085 (#3782)
+  * Apply max width to each top-level container instead of body in HTML output (#3513)
+  * Don't apply border-collapse: separate to HTML for table blocks; fixes double border at boundary of colspan/rowspan (#3793) (*@ahus1*)
+  * Don't remove right border on last table cell in row (#2563)
+  * Rework table borders to leverage border collapsing (apply frame border to table, grid border to cells, and selectively override border on cells to accommodate frame) (#3387)
+
+Compliance::
+
+  * Add support for muted option to self-hosted video (#3408)
+  * Move style tag for convert-time syntax highlighters (coderay, rouge, pygments) into head (#3462)
+  * Move style tag for client-side syntax highlighters (highlight.js, prettify) into head (#3503)
+  * Define entry point API methods (load, convert, load_file, convert_file) as class methods instead of module_function to avoid conflict with Kernel.load (#3625)
+  * Retain attribute order on HTML code tag for source block to remain consistent with output from 1.5.x (#3786)
+  * Correct language code for Korean language file from kr to ko (#3807) (*@jnavila*)
+
+Improvements::
+
+  * Apply word wrap (i.e., `word-wrap: anywhere`) to body in default stylesheet (#3544)
+  * Allow `nobreak` and `nowrap` roles to be used on any inline element (#3544)
+  * Add CSS class to support pre-wrap role to preserve leading, trailing, and repeating spaces in phrase (#3815)
+  * Preserve guard around XML-style callout when icons are not enabled (#3319)
+  * Use `.fam C` command to switch font family for verbatim blocks to monospaced text in manpage output (#3561)
+  * Remove redundant test for halign and valign attributes on table cell in DocBook converter
+  * Allow encoding of include file to be specified using encoding attribute (#3248)
+  * Allow template to be used to override outline by only specifying the outline template (#3491)
+  * Upgrade MathJax from 2.7.5 to 2.7.9
+  * Upgrade highlight.js from 9.15.10 to 9.18.3 (note that this increases script size from 48.8 KB to 71.5 KB)
+  * Skip unused default attribute assignments for embedded document
+  * Allow a URL macro to have a preceding single or double quote (#3376)
+  * Add support for erubi template engine; use it in place of erubis in test suite; note the use of erubis is deprecated (#3737)
+  * Download and embed remote custom stylesheet if allow-uri-read is set (#3765)
+  * Remove direction property from default stylesheet (#3753) (*@abdnh*)
+  * remove max width setting on content column for print media in default stylesheet (#3802)
+  * Normalize frame value "topbot" to "ends" in HTML output (consistently use frame-ends class) (#3797)
+  * Add role setter method on AbstractNode (#3614)
+  * Map chapter-signifier and part-signifier attributes in locale attribute files to replace chapter-label and part-label (#3817)
+
+Build / Infrastructure::
+
+  * Run test suite on TruffleRuby nightly (*@mogztter*, *@erebor*)
+  * Upgrade TruffleRuby to 20.0.0 (*@mogztter*)
+  * Trigger upstream builds for AsciidoctorJ on Github Actions (*@robertpanzer*)
+
+// end::compact[]
+== 2.0.10 (2019-05-31) - @mojavelinux
+
+Bug Fixes::
+
+  * fix Asciidoctor.convert_file to honor `header_footer: false` option when writing to file (#3316)
+  * fix placement of title on excerpt block (#3289)
+  * always pass same options to SyntaxHighlighter#docinfo, regardless of value of location argument
+  * fix signature of SyntaxHighlighter#docinfo method (#3300)
+  * when `icons` is set to `image`, enable image icons, but don't use it as the value of the `icontype` attribute (#3308)
+
+== 2.0.9 (2019-04-30) - @mojavelinux
+
+Bug Fixes::
+
+  * process multiple single-item menu macros in same line (#3279)
+  * register images in catalog correctly (#3283)
+  * rename AbstractNode#options method to AbstractNode#enabled_options so it doesn't get shadowed by Document#options (#3282)
+  * don't fail to convert document if alt attribute is not set on block or inline image (typically by an extension)
+  * fix lineno of source location on blocks that follow a detached list continuation (#3281)
+  * assume inline image type is "image" if not set (typically by an extension)
+
+== 2.0.8 (2019-04-22) - @mojavelinux
+
+Bug Fixes::
+
+  * restore background color applied to literal blocks by default stylesheet (#3258)
+  * use portability constants (CC_ALL, CC_ANY) in regular expressions defined in built-in converters (DocBook5 and ManPage)
+  * use portability constant (CC_ANY) in regular expression for custom inline macros
+  * use smarter margin collapsing for AsciiDoc table cell content; prevent passthrough content from being cut off (#3256)
+  * don't limit footnote ref to ASCII charset; allow any word character in Unicode to be used (#3269)
+
+Improvements::
+
+  * register_for methods accept arguments as symbols (#3274)
+  * use Concurrent::Map instead of Concurrent::Hash in template converter
+  * use module_function keyword to define methods in Helpers
+  * move regular expression definitions to separate source file (internal change)
+
+== 2.0.7 (2019-04-13) - @mojavelinux
+
+Bug Fixes::
+
+  * fix crash when resolving ID from text and at least one candidate contains an unresolved xref (#3254)
+  * fix compatibility with Rouge 2.0
+
+Improvements::
+
+  * improve documentation for the `-a` CLI option; explain that `@` modifier can be placed at end of name as alternative to end of value
+  * move source for main API entry points (load, load_file, convert, convert_file) to separate files (internal change)
+  * define main API entry points (load, load_file, convert, convert_file) as module functions
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.6 (2019-04-04) - @mojavelinux
 
 Bug Fixes::
@@ -26,6 +160,8 @@ Improvements::
   * implement Helpers.extname as a more efficient and flexible File.extname method
   * check for AsciiDoc file extension using end_with? instead of resolving the extname and using a lookup
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.5 (2019-04-01) - @mojavelinux
 
 Bug Fixes::
@@ -36,6 +172,8 @@ Bug Fixes::
   * mark encoding of stdio objects used in CLI as UTF-8 (#3225)
   * make Asciidoctor::SyntaxHighlighter::Config.register_for method public as documented
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.4 (2019-03-31) - @mojavelinux
 
 Bug Fixes::
@@ -46,6 +184,8 @@ Bug Fixes::
   * move Asciidoctor::Converter::BackendTraits.derive_backend_traits method to Asciidoctor::Converter
   * mark render and render_file methods as deprecated in API docs
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.3 (2019-03-28) - @mojavelinux
 
 Bug Fixes::
@@ -53,6 +193,8 @@ Bug Fixes::
   * fix crash when attrlist is used on literal monospace phrase (#3216)
   * update use of magic regexp variables to fix compatibility with Opal / Asciidoctor.js (#3214)
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.2 (2019-03-26) - @mojavelinux
 
 Bug Fixes::
@@ -60,6 +202,8 @@ Bug Fixes::
   * apply verbatim substitutions to literal paragraphs attached to list item (#3205)
   * implement #lines and #source methods on Table::Cell based on cell text (#3207)
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.1 (2019-03-25) - @mojavelinux
 
 Bug Fixes::
@@ -75,13 +219,15 @@ Build / Infrastructure::
 
   * bundle .yardopts in RubyGem (#3193)
 
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 2.0.0 (2019-03-22) - @mojavelinux
 
 Enhancements / Compliance::
 
   * drop support for Ruby < 2.3 and JRuby < 9.1 and remove workarounds (#2764)
   * drop support for Slim < 3 (#2998)
-  * drop the converter for the docbook45 backend (#3005)
+  * drop the converter for the docbook45 backend from core; moved to https://github.com/asciidoctor/asciidoctor-docbook45 (#3005)
   * apply substitutions to section and block titles in normal substitution order (#1173)
   * make syntax highlighter pluggable; extract all logic into adapter classes (#2106)
   * add syntax highlighter adapter for Rouge (#1040)
@@ -117,6 +263,7 @@ Enhancements / Compliance::
   * use the third argument of AbstractNode#attr / AbstractNode#attr? to set the name of a fallback attribute to look for on the document (#1934)
   * change default value of third argument to Abstractnode#attr / AbstractNode#attr? to nil so attribute doesn't inherit by default (#3059)
   * look for table-frame, table-grid, and table-stripes attributes on document as fallback for frame, grid, and stripes attributes on table (#3059)
+  * add support for hover mode for table stripes (stripes=hover) (#3110)
   * always assume the target of a shorthand interdocument xref is a reference to an AsciiDoc document (source-to-source) (#3021)
   * if the target of a formal xref macro has a file extension, assume it's a path reference (#3021)
   * never assume target of a formal xref macro is a path reference unless a file extension or fragment is present (#3021)
@@ -169,6 +316,7 @@ Improvements::
   * value comparison in AbstractNode#attr? is only performed if expected value is truthy
   * align default CodeRay style with style for other syntax highlighters (#2106)
   * ensure linenos class is added to linenos column when source highlighter is pygments and pygments-css=style
+  * disable table stripes by default (#3110)
   * rename CSS class of Pygments line numbering table to linenotable (to align with Rouge) (#1040)
   * remove unused Converter#convert_with_options method (#2891)
   * add -e, --embedded CLI flag as alias for -s, --no-header-footer (require long option to specify eRuby impl) (#1444)
@@ -242,7 +390,8 @@ Build / Infrastructure::
   * exclude test suite, build script, and Gemfile from gem (#3044)
   * split build tasks out into individual files
 
-// tag::compact[]
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
 == 1.5.8 (2018-10-28) - @mojavelinux
 
 Enhancements::
@@ -267,6 +416,7 @@ Enhancements::
   * 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)
+  * add intrinsic attribute named `pp` that effectively resolves to `++` (#2807)
   * upgrade highlight.js to 9.13.1
 
 Bug Fixes::
@@ -331,7 +481,6 @@ Documentation::
 Build / Infrastructure::
 
   * replace thread_safe with concurrent-ruby (PR #2822) (*@junaruga*)
-// end::compact[]
 
 == 1.5.7.1 (2018-05-10) - @mojavelinux
 
@@ -352,6 +501,11 @@ 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
+  * BREAKING: disable interdocument xrefs in compat mode (#2740)
+  * BREAKING: automatically parse attributes in link macro if equals is present, ignoring linkattrs (except in compat mode) (#2059)
+  * pass non-AsciiDoc file extensions in target of xref through unprocessed (#2740)
+  * process any known AsciiDoc file extension in target of shorthand interdocument xref if hash is also present (e.g., `<<target.asciidoc#,text>>`) (#2740)
+  * only allow .adoc to be used in target of formal xref macro to create an interdocument xref (with or without a hash) (#2740)
   * 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)
@@ -471,7 +625,6 @@ Improvements / Refactoring::
   * move callouts into document catalog (PR #2394)
   * document ID defined in block attribute line takes precedence over ID defined inside document title line
   * don't look for link and window attributes on document when resolving these attributes for an image
-  * when linkattrs is set, only parse attributes in link macro if equals is present
   * skip line comments in name section of manpage (#2584, PR #2585)
   * always activate extension registry passed to processor (PR #2379)
   * skip extension registry activation if no groups are registered (PR #2373)
@@ -848,7 +1001,7 @@ Enhancements::
   * Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (#1721) (*@JojoBoulix*)
   * Add reversed attribute to ordered list if reversed option is enabled (#1830)
   * Add support for additional docinfo locations (e.g., :header)
-  * Configure default stylesheet to break monospace word if exceeds length of line; add roles to prevent breaks (#1814)
+  * Configure default stylesheet to break monospace word if exceeds length of line using `word-wrap: break-word`; add `nobreak` and `nowrap` roles to prevent breaks (#1814)
   * Introduce translation file for built-in labels (*@ciampix*)
   * Provide translations for built-in labels (*@JmyL* - kr, *@ciampix* - it, *@ivannov* - bg, *@maxandersen* - da, *@radcortez* - pt, *@eddumelendez* - es, *@leathersole* - jp, *@aslakknutsen* - no, *@shahryareiv* - fa, *@AlexanderZobkov* - ru, *@dongwq* - zh, *@rmpestano* - pt_BR, *@ncomet* - fr, *@lgvz* - fi, *@patoi* - hu, *@BojanStipic* - sr, *@fwilhe* - de, *@rahmanusta* - tr, *@abelsromero* - ca, *@aboullaite* - ar, *@roelvs* - nl)
   * Translate README to Chinese (*@diguage*)
@@ -1102,7 +1255,7 @@ Improvements::
   * define JAVASCRIPT_PLATFORM constant to simplify conditional logic in the JavaScript environment (#897)
   * provide access to destination directory, outfile and outdir via Document object (#1203)
   * print encoding information in version report produced by `asciidoctor -v` (#1210)
-  * add intrinsic attribute named `cpp` with value `C++` (#1208)
+  * add intrinsic attribute named `cpp` that effectively resolves to `C++` (#1208)
   * preserve URI targets passed to `stylesheet` and related attributes (#1192)
   * allow numeric characters in block attribute name (#1103)
   * support custom YouTube playlists (#1105)

data/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
-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.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README-de.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.6, 2019-04-04
+v2.0.11, 2020-11-02
 // settings:
 :idprefix:
 :idseparator: -
@@ -17,7 +17,7 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // Variables:
-:release-version: 2.0.6
+:release-version: 2.0.11
 // URIs:
 :uri-org: https://github.com/asciidoctor
 :uri-repo: {uri-org}/asciidoctor
@@ -40,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
@@ -453,14 +453,14 @@ Asciidoctor Organization auf GitHub:: {uri-org}
 
 == Lizenz
 
-Copyright (C) 2012-2019 Dan Allen, Sarah White und die einzelnen Mitarbeiter von Asciidoctor.
+Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, 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.
+*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.

data/README-fr.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.6, 2019-04-04
+v2.0.11, 2020-11-02
 // settings:
 :idprefix:
 :idseparator: -
@@ -17,7 +17,7 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // Variables:
-:release-version: 2.0.6
+:release-version: 2.0.11
 // URIs:
 :uri-org: https://github.com/asciidoctor
 :uri-repo: {uri-org}/asciidoctor
@@ -40,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
@@ -422,7 +422,7 @@ L'organisation Asciidoctor sur GitHub:: {uri-org}
 
 == Licence
 
-Copyright (C) 2012-2019 Dan Allen, Sarah White et les contributeurs individuels d'Asciidoctor.
+Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
 Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
 
 Consultez le fichier {uri-license}[LICENSE] pour plus de détails.

data/README-jp.adoc

@@ -1,8 +1,7 @@
 = Asciidoctor
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
-v2.0.6, 2019-04-04
+v2.0.11, 2020-11-02
 // settings:
-:page-layout: base
 :idprefix:
 :idseparator: -
 :source-language: ruby
@@ -18,13 +17,17 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // Variables:
-:release-version: 2.0.6
+:release-version: 2.0.11
 // URIs:
 :uri-org: https://github.com/asciidoctor
 :uri-repo: {uri-org}/asciidoctor
 :uri-asciidoctorj: {uri-org}/asciidoctorj
 :uri-asciidoctorjs: {uri-org}/asciidoctor.js
+:uri-gradle-plugin: {uri-org}/asciidoctor-gradle-plugin
+: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
@@ -33,7 +36,7 @@ ifdef::env-site[:uri-project: link:]
 :uri-contributors: {uri-repo}/graphs/contributors
 :uri-rel-file-base: link:
 :uri-rel-tree-base: link:
-ifdef::env-site[]
+ifdef::env-site,env-yard[]
 :uri-rel-file-base: {uri-repo}/blob/master/
 :uri-rel-tree-base: {uri-repo}/tree/master/
 endif::[]
@@ -41,85 +44,108 @@ 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
 :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-osx-doc: {uri-docs}/install-asciidoctor-macosx
-:uri-render-doc: {uri-docs}/render-documents
+:uri-install-macos-doc: {uri-docs}/install-asciidoctor-macos
+:uri-convert-doc: {uri-docs}/convert-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
+:uri-ruby: https://www.ruby-lang.org
 // images:
 :image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
 
-{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}[hosted on GitHub] で {uri-license}[the MIT licence]のもとに配布されます.
-
-ifndef::env-site[]
-Translations of this document are available in the following languages:
-
-* {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-project}[Asciidoctor]は, {uri-what-is-asciidoc}[AsciiDoc] で書かれたコンテンツをHTML5, DocBook, PDFなどのフォーマットに変換する, _高速で_ {uri-license}[オープンソース] のテキストプロセッサおよびパブリッシングツールチェインです.
+AsciidoctorはRubyで書かれており, すべての主要オペレーティングシステムで動作します.
+Asciidoctorプロジェクトは {uri-repo}[GitHubにホスティング] されています.
+
+インストールをシンプルにするため, AsciidoctorはRubyGem（gem）パッケージとして, {uri-rubygem}[RubyGems.org] で配布されています.
+さらに, Asciidoctorは主要なLinuxディストリビューション用およびmacOS用パッケージとしても配布されています.
+AsciidctorはRubyで動作するだけでなく, {uri-asciidoctorj}[AsciidoctorJ]としてJVM上でも動作します. また, {uri-asciidoctorjs}[Asciidoctor.js]としてどのようなJavaScript環境（ブラウザを含む）でも実行できます.
+
+ifndef::env-site,env-yard[]
+このドキュメントには以下の言語版が存在します: +
+{uri-rel-file-base}README.adoc[English]
+|
+{uri-rel-file-base}README-zh_CN.adoc[汉语]
+|
+{uri-rel-file-base}README-de.adoc[Deutsch]
+|
+{uri-rel-file-base}README-fr.adoc[Français]
 endif::[]
 
-.Key documentation
+.主なドキュメント
 [.compact]
 * {uri-docs}/what-is-asciidoc[What is AsciiDoc?]
 * {uri-docs}/asciidoc-writers-guide[AsciiDoc Writer's Guide]
-* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
 * {uri-docs}/user-manual[Asciidoctor User Manual]
+* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
 
-.Rubyの行く先, Asciidoctorの追うところ
-****
-AsciidoctorはJRubyを用いてJVM上でも実行できます.
-Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには,  {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
-AsciidoctorJに基づいた, AsciidoctorプロセッサをApache Maven, GradleやJavadocに統合するプラグインがあります.
+ifdef::status[]
+//.*Project health*
+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://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::[]
 
-AsciidoctorはJavaScriptでも実行可能です.
-{uri-asciidoctorjs}[Asciidoctor.js], WebブラウザやNode.jsのようなJavaScript環境で動くAsciidoctorの完全機能版, を生成するために, RubyのソースをJavaScriptにトランスパイルするのに https://opalrb.com[Opal]を使います.
-Asciidoctor.jsはChrome, Atom, Brackets や他のウェブベースのツールの拡張機能としてAsciiDocのプレビューのために使われます.
-****
+== スポンサー
 
-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"]
+{uri-project}/supporters[スポンサー] のみなさまが, このプロジェクトをサポートし, より良いテクニカルドキュメンテーションの実現にコミットメントをしてくださっていることに感謝します.
+スポンサーのみなさま, ありがとうございます！
+みなさまの多くのサポートなくしてAsciidoctorは実現不可能です.
+
+ifndef::env-site,env-yard[]
+Asciidoctorの主な資金的サポートは, *Change Maker* である https://opendevise.com[OpenDevise], *Strategy Sponsors* である https://www.khronos.org/[Khronos Group] とLinda Roberts, そして *Pull Request Backers* である Brian Dominick, Guillaume Grossetie, Abel Salgado Romero によって提供されています.
+さらに, {uri-project}/supporters[Community Backers] のページに掲載されているサポーターによって追加的な資金が提供されています.
 endif::[]
 
-== The Big Picture
+https://opencollective.com/asciidoctor[OpenCollective] を通じてスポンサーになることにより, このプロジェクトを支援することができます.
+
+== 全体像
+
+Asciidoctorは, 下図左側のようなプレーンテキストを読み込んで, 右側のようなHTML5に変換します.
+特別な設定をしなくてもきれいな表示が得られるよう, HTML5の出力にはデフォルトのスタイルシートが適用されます.
+
+image::{image-uri-screenshot}[AsciiDocソースとレンダリングされたHTMLのプレビュー]
+
+== AsciiDocの処理
 
-Asciidoctorは下図の左側のパネルに示されるように, 平文で書かれた内容を読み, 右のパネルに描かれるようにHTML 5に変換します.
-Asciidoctorは枠にとらわれない快適なエクスペリエンスのためにデフォルトスタイルシートをHTML 5ドキュメントに適用します.
+Asciidoctorは, AsciiDoc文法で書かれたテキストを読み込んでパースします. 次に内蔵コンバータにパースツリーを渡します. これによりHTML5, DocBook 5やman(マニュアルmanページ)が出力されます.
+出力をカスタマイズしたりフォーマットを追加したりしたいときは, ユーザ独自のコンバータや {uri-tilt}[Tilt] 対応テンプレートを使用することができます.
 
-image::{image-uri-screenshot}[Preview of AsciiDoc source and corresponding rendered HTML]
+AsciidoctorはオリジナルのAsciiDoc Pythonプロセッサ(`asciidoc.py`)に完全互換です.
+Asciidoctorのテストスイートには, AsciiDoc文法との互換性を保証するために {uri-tests}[2350個を超えるテスト] が入っています.
 
-== AsciiDoc Processing
-AsciidoctorはAsciiDoc文法で書かれたテキストを読み込み解釈し, それからHTML 5, DocBook 5やman(ual)を出力するために内蔵コンバータセットにパースツリーを渡します.
-生成された出力をカスタマイズ, あるいは追加のフォーマットをつくるためにあなた自身のコンバータを使うことや {uri-tilt}[Tilt]-supported テンプレートを読み込むオプションがあります.
+Asciidoctorでは, AsciiDocの従来の文法のほかに, Asciidoctorで追加されたマークアップとフォーマッティングオプションが使用できます. フォントベースのアイコン (例えば, `+icon:fire[]+`) やUIエレメント(`+button:[Save]+`)がそれにあたります.
+またAsciidoctorは, HTML5出力時のスタイルとして {uri-foundation}[Foundation] に基づいたモダンでレスポンシブなテーマも提供します.
 
-NOTE: AsciidoctorはオリジナルのAsciiDoc Pythonプロセッサ(`asciidoc.py`)の完全互換です.
-Asciidoctorテストスイートは {uri-tests}[> 1,600 tests] をAsciiDoc文法との互換性を保証するために有しています.
+== RubyのあるところAsciidoctorも動く
 
-クラシックなAsciiDoc文法に加えて, Asciidoctorは追加のマークアップとフォントベースのicons(例えば, `+icon:fire[]+`)などのフォーマッティングオプションとUIエレメント(`+button:[Save]+`)を  受け付けます.
-AsciidoctorはHTML 5出力をスタイルするため, モダンで,  {uri-foundation}[Foundation] に基づいたレスポンシブテーマをも提供します.
+AsciidoctorはJRubyを用いてJVM上でも実行できます.
+Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには, {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
+AsciidoctorJを使ったAsciiDocの処理をビルドに直接組み込むビルドツール用プラグインとして, {uri-maven-plugin}[Apache Maven用], {uri-gradle-plugin}[Gradle用], および {uri-asciidoclet}[Javadoc用] が存在します.
+
+AsciidoctorはJavaScriptでも実行可能です.
+Rubyで書かれたソースを {uri-opal}[Opal] を使ってJavaScriptにトランスパイルすることで {uri-asciidoctorjs}[Asciidoctor.js] が作成されています.
+Asciidoctor.jsはどんなJavaScript環境（WebブラウザやNode.jsを含む）でも動作する, JavaScript版の完全なAsciidoctorです.
+Chrome, Atom, Bracketsやその他のウェブベースのツールで, AsciiDocをプレビューするための拡張機能にAsciidoctor.jsが使われています.
 
-== Requirements
+== 必要条件
 
-AsciidoctorはLinux, OS X (Mac)とWindowsで動き, 下記の {uri-ruby}[Ruby]実装の一つを必要とします.
+AsciidoctorはLinux, macOS, およびWindowsで動作し, 下記の {uri-ruby}[Ruby]実装の一つを必要とします.
 
 * CRuby (aka MRI) 2.3 - 2.6
 * JRuby 9.1 - 9.2
@@ -128,58 +154,121 @@ AsciidoctorはLinux, OS X (Mac)とWindowsで動き, 下記の {uri-ruby}[Ruby]
 
 [CAUTION]
 ====
-もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError` に遭遇するでしょう.
-これを解決するには使っているコンソールの有効なコードページをUTF-8:
+もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError` に遭遇するかもしれません.
+これを解決するには, 以下のコマンドにより, 使っているコンソールの有効なコードページをUTF-8に変更することを推奨します:
 
  chcp 65001
 
-に変更することを推奨します.
 一度この変更をすると, Unicode関連の頭痛の種は消えるでしょう.
 もしEclipseのようなIDEを使っているなら, 同様にエンコーディングをUTF-8にするのを忘れないでください.
-AsciidoctorはUTF-8が使われているところで最高の働きを見せます.
+AsciidoctorはUTF-8の環境において最も良好に動作します.
 ====
 
-== Installation
+== インストール
 
-Asciidoctorは (a) `gem install` コマンド,  (b) Bundler あるいは (c) 有名Linuxディストリビューションのパッケージマネージャ を用いてインストールされます.
+Asciidoctorは, (a) 主なLinuxディストリビューションのパッケージマネージャ, (b) macOSのHomebrew, (c) `gem install` コマンド（Windowsユーザに推奨）, (d) Asciidoctor Dockerイメージ, あるいは(e) Bundlerを用いてインストールできます.
 
-TIP: Linuxパッケージマネージャを用いてインストールすることの利点は, もしRubyやRubyGemsライブラリがまだインストールされていなかったら, それらを処理してくれることです.
-欠点はgemのリリース直後にはすぐには有効にならないことです.
-もし最新バージョンを使いたければ, 必ず `gem` コマンドを使いましょう.
+Linuxパッケージマネージャを用いてインストールする利点は, もしRubyやRubyGemsライブラリがまだインストールされていなかったら, それらをインストールしてくれることです.
 
-=== (a) gem install
+=== (a) Linuxのパッケージマネージャ
 
-ターミナルを開き, 入力しましょう (先頭の`$`は除く):
+パッケージマネージャによってインストールされるAsciidoctorは最新バージョンではないかもしれません.
+ディストリビューションの各リリースにおいてどのバージョンのAsciidoctorがパッケージされているかを確認するには, パッケージリポジトリを参照してください.
 
- $ gem install asciidoctor
+* 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)]
 
-もし, 先行リリースバージョン(例えばリリース候補版)をインストールしたければ
+パッケージマネージャによってインストールされるバージョンよりも新しいAsciidoctorを使用したい場合は, <<gem-install,gemのインストール方法>> を参照してください.
 
- $ gem install asciidoctor --pre
+==== apk (Alpine Linux)
 
-.アップグレード
-[TIP]
-====
-もしAsciidoctorの以前のバージョンがインストール済みであれば, 以下によってアップデートできます:
+Alpine Linuxにgemをインストールするには, ターミナルを開き, 以下を入力してください:
 
- $ gem update asciidoctor
+ $ sudo apk add asciidoctor
 
-もし gem update の代わりに `gem install` を使ってgemを新バージョンにした場合, 複数バージョンがインストールされるでしょう.
-そのときは, 以下のgemコマンドで古いバージョンを削除しましょう:
+==== pacman (Arch Linux)
 
- $ gem cleanup asciidoctor
-====
+Archベースのディストリビューションにgemをインストールするには, ターミナルを開き, 以下を入力してください:
+
+ $ sudo pacman -S asciidoctor
+
+==== APT
+
+Debian, またはUbuntuなどDebianベースのディストリビューションでは, APTを使ってAsciidoctorをインストールしてください.
+Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
+
+ $ sudo apt-get install -y asciidoctor
+
+==== DNF
+
+Fedora, CentOS, RHELなどRPMベースのLinuxディストリビューションでは, DNFパッケージマネージャを使ってAsciidoctorをインストールしてください.
+Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
+
+ $ sudo dnf install -y asciidoctor
+
+=== (b) Homebrew (macOS)
+
+macOSでは, パッケージマネージャHomebrewを使用してAsciidoctorをインストールすることができます.
+Homebrewをお持ちでない場合は, まず https://brew.sh/[brew.sh] の説明に従ってHomebrewをインストールしてください.
+Homebrewをインストールできたら, `asciidoctor` gemをインストールすることができます.
+ターミナルを開き, 以下を入力してください:
+
+ $ brew install asciidoctor
+
+Homebrewにより, システムレベルのgemとは別の独立したprefixのパスに `asciidoctor` gemがインストールされます.
+
+=== (c) Windows
 
-=== (b) Bundler
+WindowsでAsciidoctorを使う場合は, 簡単な方法が2つあります.
 
-. プロジェクトフォルダーのルート(かカレントディレクトリ)にGemfileを作成
+==== Chocolatey
+
+すでにお使いのマシンで https://chocolatey.org[chocolatey] を使用しているなら, 以下の方法を使用することができます:
+
+[source]
+----
+choco install ruby
+----
+
+そのあとは <<gem-install,gemのインストール方法>> に従ってください.
+
+==== Rubyinstaller
+
+https://rubyinstaller.org/downloads/[Rubyinstaller] を使用したい場合は, お使いのWindowsのバージョンに適したRubyinstallerをダウンロードしてRubyをインストールしたあと, <<gem-install,gemのインストール方法>> に従ってください.
+
+[#gem-install]
+=== (d) gem install
+
+Asciidoctorを `gem install` を使ってインストールするのであれば, その前に https://rvm.io[RVM] を使ってhomeディレクトリ（つまりユーザ領域）にRubyをインストールしておくべきです.
+そうすれば, `gem` コマンドを使用して安全にAsciidoctor gemのインストールやアップデートができます.
+RVMを使用すると, システムから隔離された場所にgemがインストールされます.
+
+ターミナルを開き, 以下のように入力してください:
+
+ $ gem install asciidoctor
+
+もし, 先行リリースバージョン(例えばリリース候補版)をインストールしたければ以下のようにします.
+
+ $ gem install asciidoctor --pre
+
+=== (e) Docker
+
+{uri-install-docker}[Installing Asciidoctor using Docker]を参照してください.
+
+=== (f) Bundler
+
+. プロジェクトのルートフォルダ(またはカレントディレクトリ)にGemfileを作成
 . `asciidoctor` gemをGemfileに以下のように追加:
 +
 [source,subs=attributes+]
 ----
 source 'https://rubygems.org'
 gem 'asciidoctor'
-# or specify the version explicitly
+# または明示的にバージョンを指定
 # gem 'asciidoctor', '{release-version}'
 ----
 
@@ -189,111 +278,89 @@ gem 'asciidoctor'
  $ bundle
 
 gemをアップグレードするには, Gemfileで新バージョンを指定し, `bundle` を再び実行してください.
-`bundle update` は他のgemもアップデートするため推奨されて *いない* ので, 思わぬ結果になるかも知れません.
+`bundle update` を（gemを指定せずに）行うことは推奨 *されません* . 他のgemもアップデートされて思わぬ結果になるかもしれないためです. 
 
-=== (c) Linux package managers
+== アップグレード
 
-==== DNF (Fedora 21 or greater)
+オペレーティングシステムのパッケージマネージャでAsciidoctorをインストールしたのであれば, おそらくパッケージは自動的にアップデートされるように設定されています. その場合は, gemを手動でアップデートする必要はありません.
 
-dnfを使いFedora21かそれ以上にインストールするには, ターミナルを開き, 以下を入力してください:
+=== apk (Alpine Linux)
 
- $ sudo dnf install -y asciidoctor
-
-gemをアップグレードするには:
-
- $ sudo dnf update -y asciidoctor
-
-TIP: お使いのシステムは自動的にrpmパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
+gemをアップグレードするには, 以下を使用してください:
 
-==== apt-get (Debian, Ubuntu, Mint)
-
-Debian, UbuntuまたはMintにインストールするには, ターミナルを開き, 以下を入力してください:
+ $ sudo apk add -u asciidoctor
 
- $ sudo apt-get install -y asciidoctor
+=== APT
 
-gemをアップグレードするには:
+gemをアップグレードするには, 以下を使用してください:
 
  $ sudo apt-get upgrade -y asciidoctor
 
-TIP: お使いのシステムは自動的にdebパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
-
-パッケージマネージャ(apt-get)によってインストールされたバージョンのAsciidoctorは最新リリースのAsciidoctorではないかもしれません.
-ディストリビューションのリリース毎に, どのバージョンがパッケージされているかはパッケージリポジトリを調べてください.
-
-* https://packages.debian.org/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[asciidoctor package by Debian release]
-* https://packages.ubuntu.com/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[asciidoctor package by Ubuntu release]
-* https://community.linuxmint.com/software/view/asciidoctor[asciidoctor package by Mint release]
+=== DNF
 
-[CAUTION]
-====
-パッケージマネージャによって管理されているgemをアップデートするのに `gem udpate` コマンドを使うなといわれるでしょう.
-そのようなことをするのは, パッケージマネージャがファイル(/usr/local下にインストールされた)を追跡できなくなるためにシステムが不安定な状態にするためです.
-単純に, システムgemはパッケージマネージャによってのみ管理されるべきです.
+gemをアップグレードするには, 以下を使用してください:
 
-もし, パッケージマネージャによってインストールされたのより新しいバージョンのAsciidoctorを使いたければ,  https://rvm.io[RVM] や https://github.com/rbenv/rbenv[rbenv]を使ってRubyをホームディレクトリ(すなわち, ユーザースペース)にインストールするべきです.
-それから, 安心して `gem` コマンドをAsciidoctorのアップデート, インストールのために使うことができます.
-RVMやrbenvを使っているなら, gemはシステムからは孤立した場所にインストールされます.
-====
+ $ sudo dnf update -y asciidoctor
 
-==== apk (Alpine Linux)
+=== Homebrew (macOS)
 
-Alpine Linuxにgemをインストールするには, ターミナルを開き, 以下を入力してください:
+gemをアップグレードするには, 以下を使用してください:
 
- $ sudo apk add asciidoctor
+ $ brew update
+ $ brew upgrade asciidoctor
 
-gemをアップグレードするには:
+=== gem install
 
- $ sudo apk add -u asciidoctor
+`gem` コマンドを使ってAsciidoctorをインストールした場合は, 新しいバージョンのAsciidoctorがリリースされたら手動でアップグレードする必要があります.
+以下を入力することでアップグレードできます:
 
-TIP: お使いのシステムは自動的にapkパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
+ $ gem install asciidoctor
 
-=== Other installation options
+`gem install` を使って新しいバージョンのgemをインストールすると, 複数のバージョンがインストールされた状態になります.
+以下のコマンドを使って古いバージョンを削除してください.
 
-* {uri-install-docker}[Installing Asciidoctor using Docker]
-* {uri-install-osx-doc}[Installing Asciidoctor on Mac OS X]
-// at the moment, the following entry is just a reiteration of the information in this README
-//* {uri-install-doc}[Installing the Asciidoctor toolchain]
+ $ gem cleanup asciidoctor
 
-== Usage
+== 使い方
 
-Asciidoctorのインストールに成功すれば,  `asciidoctor` コマンドラインインターフェース(CLI)がPATH中で有効になります.
-確認のために, 以下をターミナルで実行しましょう:
+Asciidoctorのインストールが成功すると, `asciidoctor` コマンドがPATHに存在するようになり, Asciidoctorのコマンドラインインターフェース(CLI)が使用できるようになります.
+確認のために, ターミナルで以下を実行しましょう:
 
  $ asciidoctor --version
 
-AsciidoctorのバージョンとRuby環境についての情報がターミナルに出力されたのを見ることができるはずです.
+AsciidoctorのバージョンとRuby環境についての情報がターミナルに出力されるはずです.
 
 [.output,subs=attributes+]
 ....
 Asciidoctor {release-version} [https://asciidoctor.org]
-Runtime Environment (ruby 2.4.1p111 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
+Runtime Environment (ruby 2.6.0p0 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
 ....
 
-AsciidoctorはAPIを提供します.
-APIは他のRubyソフトウェア, Rails, SinatraとGitHub, そして他の言語, Java (via {uri-asciidoctorj}[AsciidoctorJ] )とJavaScript (via {uri-asciidoctorjs}[Asciidoctor.js])との統合を意図しています.
+AsciidoctorはAPIも提供します.
+APIは他のRubyソフトウェア, たとえばRails, Sinatra, GitHub, そして他の言語, たとえばJava ({uri-asciidoctorj}[AsciidoctorJ] 経由)やJavaScript ({uri-asciidoctorjs}[Asciidoctor.js] 経由)と組み合わせて使用するためのものです.
 
-=== Command line interface (CLI)
+=== コマンドラインインターフェース (CLI)
 
-`asciidoctor` コマンドはAsciidoctorをコマンドライン(つまりターミナル)から起動することを可能にします.
+`asciidoctor` コマンドによりコマンドライン(つまりターミナル)からAsciidoctorを起動することができます.
 
-次のコマンドはファイルREADME.adocをHTMLに変換し, 結果を同じディレクトリのREADME.htmlに保存します.
-生成されたHTMLファイルの名前はソースファイル依存し, その拡張子を `.html` に変えます.
+次のコマンドにより, README.adocというファイルがHTMLに変換され, 結果が同じディレクトリのREADME.htmlとして保存されます.
+生成されるHTMLファイルの名前は, ソースファイルのファイル名の拡張子を `.html` に替えたものとなります.
 
  $ asciidoctor README.adoc
 
-Asciidoctorプロセッサに様々なフラグやスイッチを与えることで制御できます.それは以下を用いて調べることができます:
+さまざまなフラグやスイッチを与えることでAsciidoctorプロセッサをコントロールすることができます. フラグやスイッチの説明は以下のコマンドで表示されます:
 
  $ asciidoctor --help
 
-例えば, ファイルを異なるディレクトリに書き出すには:
+例えば, ファイルを異なるディレクトリに書き出すには以下を使用します:
 
  $ asciidoctor -D output README.adoc
 
-`asciidoctor` {uri-manpage}[man page] はコマンドライン・インタフェースの完全なリファレンスを提供します.
+コマンドラインインタフェースの完全なリファレンスは `asciidoctor` の {uri-manpage}[manページ] にあります.
 
-`asciidoctor` コマンドの使い方についてもっと学ぶには以下を参照してください.
+`asciidoctor` コマンドの使い方の詳細については以下を参照してください.
 
-* {uri-render-doc}[How do I convert a document?]
+* {uri-convert-doc}[How do I convert a document?]
 * {uri-themes-doc}[How do I use the Asciidoctor stylesheet factory to produce custom themes?]
 
 === Ruby API
@@ -303,16 +370,16 @@ Asciidoctorをアプリケーションの中で使うには, まずgemをrequire
 [source]
 require 'asciidoctor'
 
-それから, AsciiDocソースファイルをHTMLファイルに変換できます:
+そうすると, 以下のようにしてAsciiDocソースファイルをHTMLファイルに変換できます:
 
 [source]
 Asciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe
 
-WARNING: AsciidoctorをAPI経由で使っている時, デフォルトのセーフモードは `:secure` です.
-セキュアモードでは,  `include` ディレクティブを含むいくつかのコア機能は無効化されています.
-もしこれらの機能を有効化したい場合, 明示的にセーフモードを `:server` (推奨)か `:safe` にする必要があります.
+WARNING: AsciidoctorをAPI経由で使っているとき, デフォルトのセーフモードは `:secure` （セキュアモード）です.
+セキュアモードでは, `include` ディレクティブを含むいくつかのコア機能が無効化されています.
+これらの機能を有効化したい場合, 明示的にセーフモードを `:server` (推奨)か `:safe` にする必要があります.
 
-AsciiDoc文字列を埋め込みHTML(HTMLページヘの挿入)へ変換することもできます:
+AsciiDoc文字列を, 埋め込み用HTML(HTMLページヘの挿入用)に変換することもできます:
 
 [source]
 ----
@@ -320,7 +387,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
 Asciidoctor.convert content, safe: :safe
 ----
 
-もし完全なHTMLドキュメントを求めるのであれば,  `header_footer` オプションを以下の通り有効にしてください:
+もし完全なHTMLドキュメントが必要であれば, 以下のように `header_footer` オプションを有効にしてください:
 
 [source]
 ----
@@ -328,7 +395,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
 html = Asciidoctor.convert content, header_footer: true, safe: :safe
 ----
 
-パースされたドキュメントにアクセスしたいのなら, 変換を個々のステップに分割することが出来ます:
+パースされたドキュメントにアクセスしたい場合は, 変換を複数のステップに分割します:
 
 [source]
 ----
@@ -338,81 +405,79 @@ puts document.doctitle
 html = document.convert
 ----
 
-Asciidoctorの生成する出力が気に入らないのであれば,  _あなたはそれを変更できる_ ことを忘れないでください!
-Asciidoctorはパースされたドキュメントを生成された出力に変換する処理を扱うカスタムコンバーターをサポートしています.
+Asciidoctorの生成する出力が気に入らない場合は, _あなたはそれを変更できる_ ことを忘れないでください!
+パースされたドキュメントを出力形式に変換するコンバータは, カスタマイズが可能です.
 
-断片的な出力をカスタマイズする簡単な方法の一つはテンプレートコンバーターを使うことです.
-テンプレートコンバーターによって, ドキュメント中のあらゆるノードの変換を扱うために {uri-tilt}[Tilt]-supportedテンプレートファイルを使うことができます.
+出力を部分的にカスタマイズする簡単な方法としてはテンプレートコンバータがあります.
+テンプレートコンバータでは, ドキュメントの各ノードの変換に {uri-tilt}[Tilt]対応テンプレートファイルを使うことができます.
 
-そのようにすれば, 出力を100%制御することが _できます_ .
-APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[user manual] を参照してください.
+さまざまな方法を使って出力は100%制御することが _できます_ .
+APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[ユーザマニュアル] を参照してください.
 
-== Contributing
+== コントリビューション
 
-{uri-freesoftware}[free software] の精神においては,  _everyone_ がこのプロジェクトを改良するのをたすけることが勧められています.
-もしエラーや手抜かりをソースコード, ドキュメント, あるいはウェブサイトに見つけたのなら, 恥じることなく修正と共にpull requestの開設やissueの送信をしてください.
-New contributors are always welcome!
+新しいコントリビューションを常に歓迎します!
+もしソースコード, ドキュメント, あるいはウェブサイトに間違いや不備を見つけたら遠慮なく, イシューを作成するか, 修正をおこなってpull requestを作成してください.
 
-*あなた*  にもできることがあります:
+*あなた* にもできることがあります:
 
-* 先行バージョン(alpha, beta or preview)の使用
+* 先行バージョン(alpha, beta, またはpreview版)の使用
 * バグレポート
 * 新機能提案
-* ドキュメントの執筆
-* 仕様の執筆
-* コーディング -- _パッチでも, 足りなすぎるなんてことはありません_
+* ドキュメントの執筆または編集
+* テストをつけてコードを書くこと -- _どのようなパッチであれ小さすぎるなどということはありません_
 ** typoの修正
 ** コメントの追加
 ** 一貫性のないホワイトスペースの除去
 ** テストの記述!
 * リファクタリング
-*  {uri-issues}[issues] の修正
-* パッチの批評
+* {uri-issues}[イシュー] の解決
+* パッチのレビュー
 
-{uri-contribute}[Contributing] ガイドはどうやってスタイルをつくるか, issueを送るか, 機能リクエスト, コーディング, ドキュメンテーションをAsciidoctor Projectにするかについての情報を提供しています.
+Asciidoctorプロジェクトにイシュー, 機能リクエスト, コード, ドキュメントを送る際の, 作成方法, スタイル, および送り方は, {uri-contribute}[Contributing] ガイドに記載されています.
 
-== Getting Help
+== 助けを得る
 
-Asciidoctorプロジェクトはあなたが簡単に著作を書いて, 配布するのをたすけるため開発されています.
-しかしあなたのフィードバックなしにはできません!
-ディスカッションリストで, Twitterで, チャットルームで, 質問し, プロジェクトのあらゆる側面について話し合うようお勧めします.
+Asciidoctorは, コンテンツの執筆と公開を簡単にするために開発されています.
+しかしあなたからのフィードバックがなくてはAsciidoctorの開発は進みません!
+ディスカッションリスト, Twitter, チャットルームを使って, 質問をしたりプロジェクトのさまざまな側面について話し合ったりすることをお勧めします.
 
-Discussion list (Nabble):: {uri-discuss}
-Twitter:: #asciidoctor hashtag or @asciidoctor mention
-Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
+チャット(Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
+ディスカッションリスト(Nabble):: {uri-discuss}
+Twitter:: ハッシュタグ https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] またはメンション https://twitter.com/asciidoctor[@asciidoctor]
 
 ifdef::env-github[]
-以下のプロジェクトサイトに、Asciidoctorに関するさらに詳しい情報やドキュメントがあります。
+以下のプロジェクトサイトに, Asciidoctorに関するさらに詳しい情報やドキュメントがあります.
 
-{uri-project}/[Home] | {uri-news}[News] | {uri-docs}[Docs]
+{uri-project}[Home] | {uri-news}[News] | {uri-docs}[Docs]
 endif::[]
 
-GitHub上のAsciidoctorはプロジェクトのソースコード, イシュートラッカー, サブプロジェクトを管理しています.
+GitHub上のAsciidoctorのorganizationではプロジェクトのソースコード, イシュートラッカー, サブプロジェクトが管理されています.
 
-Source repository (git):: {uri-repo}
-Issue tracker:: {uri-issues}
-Asciidoctor organization on GitHub:: {uri-org}
+ソースリポジトリ(git):: {uri-repo}
+イシュートラッカー:: {uri-issues}
+GitHub上のAsciidoctorのorganization:: {uri-org}
 
-== Copyright and Licensing
+== ライセンス
 
-Copyright (C) 2012-2019 Dan Allen, Ryan Waldron and the Asciidoctor Project.
-本ソフトウェアはMITライセンスのもとで自由に使用できます.
+Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
+本ソフトウェアはMITライセンスのもとで使用できます.
 
-詳細は {uri-license}[LICENSE] ファイルを参照してください.
+ライセンスの詳細については {uri-license}[LICENSE] ファイルを参照してください.
 
-== Authors
+== 作者
 
-*Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] が先導し, Asciidoctorの素晴らしきコミュニティの数多くのメンバからコントリビューションを受けてきました．
-このプロジェクトは2012年から https://github.com/nickh[Nick Hengeveld] の {uri-prototype}[プロトタイプ] をベースに https://github.com/erebor[Ryan Waldron] により創始されました.
+*Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] がリードし, Asciidoctorの素晴らしきコミュニティの {uri-contributors}[数多くのメンバ] からコントリビューションを受けてきました．
+このプロジェクトは https://github.com/nickh[Nick Hengeveld] の {uri-prototype}[プロトタイプ] をベースに https://github.com/erebor[Ryan Waldron] により2012年から創始されました.
 
 *AsciiDoc* は Stuart Rackham により創始され, AsciiDocコミュニティの数多くのメンバからコントリビューションを受けてきました.
 
 ifndef::env-site[]
-== Changelog
+== 変更履歴
 
 ifeval::[{safe-mode-level} < 20]
 include::CHANGELOG.adoc[tag=compact,leveloffset=+1]
 endif::[]
 
-リリースごとの変更一覧は {uri-changelog}[CHANGELOG] を参照してください.
+過去のリリースの完全な変更点リストについては {uri-changelog}[CHANGELOG] を参照してください.
 endif::[]