asciidoctor 1.5.8 → 2.0.17

Sign up to get free protection for your applications and to get access to all the features.
Files changed (197) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +11 -0
  3. data/CHANGELOG.adoc +628 -45
  4. data/LICENSE +2 -1
  5. data/README-de.adoc +28 -38
  6. data/README-fr.adoc +30 -43
  7. data/README-jp.adoc +255 -201
  8. data/README-zh_CN.adoc +40 -44
  9. data/README.adoc +170 -143
  10. data/asciidoctor.gemspec +22 -34
  11. data/bin/asciidoctor +5 -4
  12. data/data/locale/attributes-ar.adoc +4 -3
  13. data/data/locale/attributes-be.adoc +23 -0
  14. data/data/locale/attributes-bg.adoc +4 -3
  15. data/data/locale/attributes-ca.adoc +6 -5
  16. data/data/locale/attributes-cs.adoc +4 -3
  17. data/data/locale/attributes-da.adoc +6 -5
  18. data/data/locale/attributes-de.adoc +6 -5
  19. data/data/locale/attributes-en.adoc +4 -4
  20. data/data/locale/attributes-es.adoc +6 -5
  21. data/data/locale/attributes-fa.adoc +4 -3
  22. data/data/locale/attributes-fi.adoc +4 -3
  23. data/data/locale/attributes-fr.adoc +8 -7
  24. data/data/locale/attributes-hu.adoc +4 -3
  25. data/data/locale/attributes-id.adoc +4 -3
  26. data/data/locale/attributes-it.adoc +6 -5
  27. data/data/locale/attributes-ja.adoc +4 -3
  28. data/data/locale/{attributes-kr.adoc → attributes-ko.adoc} +4 -3
  29. data/data/locale/attributes-nb.adoc +4 -3
  30. data/data/locale/attributes-nl.adoc +6 -5
  31. data/data/locale/attributes-nn.adoc +4 -3
  32. data/data/locale/attributes-pl.adoc +8 -7
  33. data/data/locale/attributes-pt.adoc +6 -5
  34. data/data/locale/attributes-pt_BR.adoc +6 -5
  35. data/data/locale/attributes-ro.adoc +4 -3
  36. data/data/locale/attributes-ru.adoc +6 -5
  37. data/data/locale/attributes-sr.adoc +4 -4
  38. data/data/locale/attributes-sr_Latn.adoc +4 -4
  39. data/data/locale/attributes-sv.adoc +4 -4
  40. data/data/locale/attributes-th.adoc +23 -0
  41. data/data/locale/attributes-tr.adoc +4 -3
  42. data/data/locale/attributes-uk.adoc +6 -5
  43. data/data/locale/attributes-vi.adoc +23 -0
  44. data/data/locale/attributes-zh_CN.adoc +4 -3
  45. data/data/locale/attributes-zh_TW.adoc +4 -3
  46. data/data/reference/syntax.adoc +296 -0
  47. data/data/stylesheets/asciidoctor-default.css +120 -114
  48. data/data/stylesheets/coderay-asciidoctor.css +15 -17
  49. data/lib/asciidoctor/abstract_block.rb +146 -140
  50. data/lib/asciidoctor/abstract_node.rb +152 -170
  51. data/lib/asciidoctor/attribute_list.rb +77 -89
  52. data/lib/asciidoctor/block.rb +29 -28
  53. data/lib/asciidoctor/callouts.rb +4 -2
  54. data/lib/asciidoctor/cli/invoker.rb +20 -24
  55. data/lib/asciidoctor/cli/options.rb +107 -96
  56. data/lib/asciidoctor/cli.rb +3 -2
  57. data/lib/asciidoctor/convert.rb +199 -0
  58. data/lib/asciidoctor/converter/composite.rb +40 -48
  59. data/lib/asciidoctor/converter/docbook5.rb +627 -644
  60. data/lib/asciidoctor/converter/html5.rb +1053 -951
  61. data/lib/asciidoctor/converter/manpage.rb +581 -532
  62. data/lib/asciidoctor/converter/template.rb +232 -271
  63. data/lib/asciidoctor/converter.rb +370 -185
  64. data/lib/asciidoctor/core_ext/float/truncate.rb +20 -0
  65. data/lib/asciidoctor/core_ext/hash/merge.rb +8 -0
  66. data/lib/asciidoctor/core_ext/match_data/names.rb +7 -0
  67. data/lib/asciidoctor/core_ext/nil_or_empty.rb +1 -0
  68. data/lib/asciidoctor/core_ext/regexp/is_match.rb +4 -2
  69. data/lib/asciidoctor/core_ext.rb +8 -17
  70. data/lib/asciidoctor/document.rb +503 -461
  71. data/lib/asciidoctor/extensions.rb +127 -174
  72. data/lib/asciidoctor/helpers.rb +184 -107
  73. data/lib/asciidoctor/inline.rb +9 -12
  74. data/lib/asciidoctor/list.rb +11 -29
  75. data/lib/asciidoctor/load.rb +119 -0
  76. data/lib/asciidoctor/logging.rb +22 -17
  77. data/lib/asciidoctor/parser.rb +673 -719
  78. data/lib/asciidoctor/path_resolver.rb +48 -33
  79. data/lib/asciidoctor/reader.rb +383 -338
  80. data/lib/asciidoctor/rouge_ext.rb +39 -0
  81. data/lib/asciidoctor/rx.rb +723 -0
  82. data/lib/asciidoctor/section.rb +17 -16
  83. data/lib/asciidoctor/stylesheets.rb +19 -37
  84. data/lib/asciidoctor/substitutors.rb +926 -1022
  85. data/lib/asciidoctor/syntax_highlighter/coderay.rb +88 -0
  86. data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +34 -0
  87. data/lib/asciidoctor/syntax_highlighter/html_pipeline.rb +10 -0
  88. data/lib/asciidoctor/syntax_highlighter/prettify.rb +30 -0
  89. data/lib/asciidoctor/syntax_highlighter/pygments.rb +157 -0
  90. data/lib/asciidoctor/syntax_highlighter/rouge.rb +143 -0
  91. data/lib/asciidoctor/syntax_highlighter.rb +253 -0
  92. data/lib/asciidoctor/table.rb +152 -114
  93. data/lib/asciidoctor/timings.rb +7 -5
  94. data/lib/asciidoctor/version.rb +2 -1
  95. data/lib/asciidoctor/writer.rb +30 -0
  96. data/lib/asciidoctor.rb +266 -1340
  97. data/man/asciidoctor.1 +49 -47
  98. data/man/asciidoctor.adoc +54 -45
  99. metadata +50 -245
  100. data/CONTRIBUTING.adoc +0 -185
  101. data/Gemfile +0 -60
  102. data/Rakefile +0 -129
  103. data/bin/asciidoctor-safe +0 -15
  104. data/features/open_block.feature +0 -92
  105. data/features/pass_block.feature +0 -66
  106. data/features/step_definitions.rb +0 -49
  107. data/features/text_formatting.feature +0 -57
  108. data/features/xref.feature +0 -1039
  109. data/lib/asciidoctor/converter/base.rb +0 -59
  110. data/lib/asciidoctor/converter/docbook45.rb +0 -93
  111. data/lib/asciidoctor/converter/factory.rb +0 -226
  112. data/lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb +0 -6
  113. data/lib/asciidoctor/core_ext/1.8.7/concurrent/hash.rb +0 -5
  114. data/lib/asciidoctor/core_ext/1.8.7/hash/key.rb +0 -4
  115. data/lib/asciidoctor/core_ext/1.8.7/io/binread.rb +0 -6
  116. data/lib/asciidoctor/core_ext/1.8.7/io/write.rb +0 -5
  117. data/lib/asciidoctor/core_ext/1.8.7/string/chr.rb +0 -6
  118. data/lib/asciidoctor/core_ext/1.8.7/string/limit_bytesize.rb +0 -29
  119. data/lib/asciidoctor/core_ext/1.8.7/symbol/empty.rb +0 -6
  120. data/lib/asciidoctor/core_ext/1.8.7/symbol/length.rb +0 -6
  121. data/lib/asciidoctor/core_ext/string/limit_bytesize.rb +0 -10
  122. data/test/api_test.rb +0 -1240
  123. data/test/attribute_list_test.rb +0 -242
  124. data/test/attributes_test.rb +0 -1623
  125. data/test/blocks_test.rb +0 -3870
  126. data/test/converter_test.rb +0 -470
  127. data/test/document_test.rb +0 -1853
  128. data/test/extensions_test.rb +0 -1560
  129. data/test/fixtures/asciidoc_index.txt +0 -521
  130. data/test/fixtures/basic-docinfo-footer.html +0 -6
  131. data/test/fixtures/basic-docinfo-footer.xml +0 -8
  132. data/test/fixtures/basic-docinfo.html +0 -1
  133. data/test/fixtures/basic-docinfo.xml +0 -4
  134. data/test/fixtures/basic.asciidoc +0 -5
  135. data/test/fixtures/chapter-a.adoc +0 -3
  136. data/test/fixtures/child-include.adoc +0 -5
  137. data/test/fixtures/circle.svg +0 -9
  138. data/test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb +0 -6
  139. data/test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml +0 -6
  140. data/test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml +0 -3
  141. data/test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml +0 -5
  142. data/test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml +0 -1
  143. data/test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim +0 -6
  144. data/test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim +0 -3
  145. data/test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim +0 -5
  146. data/test/fixtures/custom-docinfodir/basic-docinfo.html +0 -1
  147. data/test/fixtures/custom-docinfodir/docinfo.html +0 -1
  148. data/test/fixtures/docinfo-footer.html +0 -1
  149. data/test/fixtures/docinfo-footer.xml +0 -9
  150. data/test/fixtures/docinfo.html +0 -1
  151. data/test/fixtures/docinfo.xml +0 -3
  152. data/test/fixtures/doctime-localtime.adoc +0 -2
  153. data/test/fixtures/dot.gif +0 -0
  154. data/test/fixtures/encoding.asciidoc +0 -13
  155. data/test/fixtures/file-with-missing-include.adoc +0 -1
  156. data/test/fixtures/grandchild-include.adoc +0 -3
  157. data/test/fixtures/hello-asciidoctor.pdf +0 -69
  158. data/test/fixtures/include-file.asciidoc +0 -24
  159. data/test/fixtures/include-file.jsx +0 -8
  160. data/test/fixtures/include-file.ml +0 -3
  161. data/test/fixtures/include-file.xml +0 -5
  162. data/test/fixtures/lists.adoc +0 -96
  163. data/test/fixtures/master.adoc +0 -5
  164. data/test/fixtures/mismatched-end-tag.adoc +0 -7
  165. data/test/fixtures/other-chapters.adoc +0 -11
  166. data/test/fixtures/outer-include.adoc +0 -5
  167. data/test/fixtures/parent-include-restricted.adoc +0 -5
  168. data/test/fixtures/parent-include.adoc +0 -5
  169. data/test/fixtures/sample.asciidoc +0 -30
  170. data/test/fixtures/section-a.adoc +0 -4
  171. data/test/fixtures/stylesheets/custom.css +0 -3
  172. data/test/fixtures/subdir/index.adoc +0 -3
  173. data/test/fixtures/subdir/inner-include.adoc +0 -3
  174. data/test/fixtures/subdir/middle-include.adoc +0 -5
  175. data/test/fixtures/subs-docinfo.html +0 -2
  176. data/test/fixtures/subs.adoc +0 -6
  177. data/test/fixtures/tagged-class-enclosed.rb +0 -25
  178. data/test/fixtures/tagged-class.rb +0 -23
  179. data/test/fixtures/tip.gif +0 -0
  180. data/test/fixtures/unclosed-tag.adoc +0 -3
  181. data/test/fixtures/unexpected-end-tag.adoc +0 -4
  182. data/test/invoker_test.rb +0 -745
  183. data/test/links_test.rb +0 -855
  184. data/test/lists_test.rb +0 -5151
  185. data/test/logger_test.rb +0 -211
  186. data/test/manpage_test.rb +0 -660
  187. data/test/options_test.rb +0 -262
  188. data/test/paragraphs_test.rb +0 -562
  189. data/test/parser_test.rb +0 -742
  190. data/test/paths_test.rb +0 -395
  191. data/test/preamble_test.rb +0 -173
  192. data/test/reader_test.rb +0 -2161
  193. data/test/sections_test.rb +0 -3575
  194. data/test/substitutions_test.rb +0 -2066
  195. data/test/tables_test.rb +0 -2036
  196. data/test/test_helper.rb +0 -447
  197. data/test/text_test.rb +0 -309
data/LICENSE CHANGED
@@ -1,6 +1,7 @@
1
1
  MIT License
2
2
 
3
- Copyright (C) 2012-2018 Dan Allen, Ryan Waldron and the Asciidoctor Project
3
+ Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, and the
4
+ individual contributors to Asciidoctor.
4
5
 
5
6
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
7
  of this software and associated documentation files (the "Software"), to deal
data/README-de.adoc CHANGED
@@ -1,6 +1,6 @@
1
1
  = Asciidoctor
2
- Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
3
- v1.5.8, 2018-10-28
2
+ Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>
3
+ v2.0.17, 2022-01-05
4
4
  // settings:
5
5
  :idprefix:
6
6
  :idseparator: -
@@ -9,7 +9,6 @@ v1.5.8, 2018-10-28
9
9
  ifndef::env-github[:icons: font]
10
10
  ifdef::env-github[]
11
11
  :status:
12
- :outfilesuffix: .adoc
13
12
  :caution-caption: :fire:
14
13
  :important-caption: :exclamation:
15
14
  :note-caption: :paperclip:
@@ -17,13 +16,13 @@ ifdef::env-github[]
17
16
  :warning-caption: :warning:
18
17
  endif::[]
19
18
  // Variables:
20
- :release-version: 1.5.8
19
+ :release-version: 2.0.17
21
20
  // URIs:
22
21
  :uri-org: https://github.com/asciidoctor
23
22
  :uri-repo: {uri-org}/asciidoctor
24
23
  :uri-asciidoctorj: {uri-org}/asciidoctorj
25
24
  :uri-asciidoctorjs: {uri-org}/asciidoctor.js
26
- :uri-project: http://asciidoctor.org
25
+ :uri-project: https://asciidoctor.org
27
26
  ifdef::env-site[:uri-project: link:]
28
27
  :uri-docs: {uri-project}/docs
29
28
  :uri-news: {uri-project}/news
@@ -33,15 +32,15 @@ ifdef::env-site[:uri-project: link:]
33
32
  :uri-rel-file-base: link:
34
33
  :uri-rel-tree-base: link:
35
34
  ifdef::env-site[]
36
- :uri-rel-file-base: {uri-repo}/blob/master/
37
- :uri-rel-tree-base: {uri-repo}/tree/master/
35
+ :uri-rel-file-base: {uri-repo}/blob/HEAD/
36
+ :uri-rel-tree-base: {uri-repo}/tree/HEAD/
38
37
  endif::[]
39
38
  :uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
40
39
  :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
41
40
  :uri-license: {uri-rel-file-base}LICENSE
42
41
  :uri-tests: {uri-rel-tree-base}test
43
- :uri-discuss: http://discuss.asciidoctor.org
44
- :uri-irc: irc://irc.freenode.org/#asciidoctor
42
+ :uri-discuss: https://discuss.asciidoctor.org
43
+ :uri-chat: https://asciidoctor.zulipchat.com
45
44
  :uri-rubygem: https://rubygems.org/gems/asciidoctor
46
45
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
47
46
  :uri-user-manual: {uri-docs}/user-manual
@@ -51,20 +50,19 @@ endif::[]
51
50
  :uri-render-doc: {uri-docs}/render-documents
52
51
  :uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
53
52
  :uri-gitscm-repo: https://github.com/git/git-scm.com
54
- :uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
55
53
  :uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
56
54
  :uri-foundation: https://foundation.zurb.com
57
55
  :uri-opal: https://opalrb.com
58
56
  :uri-tilt: https://github.com/rtomayko/tilt
59
57
  :uri-ruby: https://ruby-lang.org
60
58
  // images:
61
- :image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
59
+ :image-uri-screenshot: https://cdn.jsdelivr.net/gh/asciidoctor/asciidoctor/screenshot.png
62
60
 
63
- {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.
61
+ {uri-project}[Asciidoctor] ist ein _schneller_, {uri-license}[Open Source] Textverarbeitungs- und Publishing-Toolchain für die Konvertierung von {uri-what-is-asciidoc}[AsciiDoc]-Inhalten in HTML 5, DocBook 5, PDF und andere Formate.
64
62
  Asciidoctor ist in Ruby geschrieben und läuft auf allen gängigen Betriebsystemen.
65
63
  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.
66
64
  Asciidoctor kann auch in einer JVM mit {uri-asciidoctorj}[AsciidoctorJ] oder einer beliebigen Javascript-Umgebung mit {uri-asciidoctorjs}[Asciidoctor.js] ausgeführt werden.
67
- Das Asciidoctor-Projekt wird {uri-repo}[auf Github] gehostet.
65
+ Das Asciidoctor-Projekt wird {uri-repo}[auf GitHub] gehostet.
68
66
 
69
67
  ifndef::env-site[]
70
68
  Dieses Dokument ist auch in folgenden Sprachen erhältlich: +
@@ -85,45 +83,37 @@ endif::[]
85
83
  * {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax-Referenz]
86
84
 
87
85
  ifdef::status[]
88
- .*Projekt Status*
89
- image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
90
- 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]
91
- //image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
92
- //image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
93
- image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
86
+ image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
87
+ image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
88
+ image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
89
+ image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[Project Chat (Zulip),link={uri-chat}]
94
90
  endif::[]
95
91
 
96
92
  == Sponsoren
97
93
 
98
94
  Wir möchten unseren großzügigen Sponsoren danken, ohne deren Unterstützung Asciidoctor nicht möglich wäre.
99
95
  Vielen Dank an die Sponsoren für ihr Engagement zur Verbesserung der technischen Dokumentation!
100
-
101
- 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"]
102
- &nbsp; &nbsp; &nbsp;
103
- 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"]
104
-
105
- 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.
106
96
  Zusätzliche Mittel werden von unseren https://asciidoctor.org/supporters[Community Backers] zur Verfügung gestellt.
107
97
 
108
98
  Sie können dieses Projekt unterstützen, indem Sie Sponsor bei https://opencollective.com/asciidoctor[OpenCollective] werden.
109
99
 
110
100
  == Das große Ganze
111
101
 
112
- 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.
113
- Asciidoctor wendet ein Standard-Stylesheet auf das HTML5-Dokument an, um ein angenehmes Out-of-the-Box-Erlebnis zu bieten.
102
+ Asciidoctor liest Inhalte, die im Klartext geschrieben wurden, wie im Feld links im Bild unten gezeigt, und wandelt Sie in HTML 5 um, wie im rechten Feld dargestellt.
103
+ Asciidoctor wendet ein Standard-Stylesheet auf das HTML 5-Dokument an, um ein angenehmes Out-of-the-Box-Erlebnis zu bieten.
114
104
 
115
105
  image::{image-uri-screenshot}[Preview of AsciiDoc source and corresponding rendered HTML]
116
106
 
117
107
  == AsciiDoc Verarbeitung
118
108
 
119
- 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.
109
+ 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 HTML 5, DocBook 5 und man-pages zu erzeugen.
120
110
  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.
121
111
 
122
112
  Asciidoctor ist ein Ersatz für den Original AsciiDoc Python Prozessor (`asciidoc.py`).
123
113
  Die Asciidoctor-Testsuite verfügt über {uri-tests}[mehr als 2,000 Tests], um die Kompatibilität mit der AsciiDoc-Syntax sicherzustellen.
124
114
 
125
115
  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]+`).
126
- Asciidoctor bietet auch ein modernes, __responsive Theme__, das auf {uri-foundation}[Foundation] basiert, um die HTML5-Ausgabe zu gestalten.
116
+ Asciidoctor bietet auch ein modernes, __responsive Theme__, das auf {uri-foundation}[Foundation] basiert, um die HTML 5-Ausgabe zu gestalten.
127
117
 
128
118
  == Wo Ruby hingeht, folgt Asciidoctor
129
119
 
@@ -140,9 +130,9 @@ Es wird für die AsciiDoc Vorschau-Erweiterungen für Chrome, Atom, Brackets und
140
130
 
141
131
  Asciidoctor arbeitet unter Linux, MacOS und Windows und benötigt eine der folgenden Implementierungen von {uri-ruby}[Ruby]:
142
132
 
143
- * Ruby (MRI/CRuby 1.8.7 - 2.5)
144
- * JRuby (1.7 in Ruby 1.8 und 1.9 modes, 9000)
145
- * Rubinius 2.2.x
133
+ * CRuby (aka MRI) 2.3 - 2.6
134
+ * JRuby 9.1 - 9.2
135
+ * TruffleRuby (GraalVM)
146
136
  * Opal (JavaScript)
147
137
 
148
138
  [CAUTION]
@@ -328,7 +318,7 @@ Sie sollten Informationen über die Asciidoctor-Version und Ihre Ruby-Umgebung i
328
318
  [.output,subs=attributes+]
329
319
  ....
330
320
  Asciidoctor 1.5.7 [https://asciidoctor.org]
331
- Laufzeitumgebung (ruby 2.5.1p57 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
321
+ Laufzeitumgebung (ruby 2.6.0p0 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
332
322
  ....
333
323
 
334
324
  Asciidoctor bietet auch eine API.
@@ -441,9 +431,9 @@ Asciidoctor wurde entwickelt, um Ihnen das Schreiben und Veröffentlichen Ihrer
441
431
  Aber wir können es nicht ohne ihr Feedback machen!
442
432
  Wir ermutigen Sie, Fragen zu stellen und alle Aspekte des Projekts auf der Diskussionsliste, auf Twitter oder im Chatroom zu diskutieren.
443
433
 
444
- Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
434
+ Chat (Zulip):: {uri-chat}
445
435
  Discussionsliste (Nabble):: {uri-discuss}
446
- Twitter:: https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] hashtag or https://twitter.com/asciidoctor[@asciidoctor] mention
436
+ Twitter:: Follow https://twitter.com/asciidoctor[@asciidoctor] or search for the https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] hashtag
447
437
 
448
438
  ifdef::env-github[]
449
439
  Weitere Informationen und Dokumentation zu Asciidoctor finden Sie auf der Website des Projekts.
@@ -459,15 +449,15 @@ Asciidoctor Organization auf GitHub:: {uri-org}
459
449
 
460
450
  == Lizenz
461
451
 
462
- Copyright (C) 2012-2018 Dan Allen, Sarah White und die einzelnen Mitarbeiter von Asciidoctor.
452
+ Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, und die einzelnen Mitarbeiter von Asciidoctor.
463
453
  Die Nutzung dieser Software wird unter den Bedingungen der MIT-Lizenz gewährt.
464
454
 
465
455
  Siehe die {uri-license}[LIZENZ] für den vollen Lizenztext.
466
456
 
467
457
  == Authoren
468
458
 
469
- *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.
470
- 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].
459
+ *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.
460
+ Das Projekt wurde 2012 von https://github.com/erebor[Ryan Waldron] initiiert und basiert auf einem prototyp von https://github.com/nickh[Nick Hengeveld].
471
461
 
472
462
  *AsciiDoc* wurde von Stuart Rackham gegründet und hat Beiträge von vielen Personen aus der AsciiDoc-Community erhalten.
473
463
 
data/README-fr.adoc CHANGED
@@ -1,6 +1,6 @@
1
1
  = Asciidoctor
2
- Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
3
- v1.5.8, 2018-10-28
2
+ Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>
3
+ v2.0.17, 2022-01-05
4
4
  // settings:
5
5
  :idprefix:
6
6
  :idseparator: -
@@ -9,7 +9,6 @@ v1.5.8, 2018-10-28
9
9
  ifndef::env-github[:icons: font]
10
10
  ifdef::env-github[]
11
11
  :status:
12
- :outfilesuffix: .adoc
13
12
  :caution-caption: :fire:
14
13
  :important-caption: :exclamation:
15
14
  :note-caption: :paperclip:
@@ -17,13 +16,13 @@ ifdef::env-github[]
17
16
  :warning-caption: :warning:
18
17
  endif::[]
19
18
  // Variables:
20
- :release-version: 1.5.8
19
+ :release-version: 2.0.17
21
20
  // URIs:
22
21
  :uri-org: https://github.com/asciidoctor
23
22
  :uri-repo: {uri-org}/asciidoctor
24
23
  :uri-asciidoctorj: {uri-org}/asciidoctorj
25
24
  :uri-asciidoctorjs: {uri-org}/asciidoctor.js
26
- :uri-project: http://asciidoctor.org
25
+ :uri-project: https://asciidoctor.org
27
26
  ifdef::env-site[:uri-project: link:]
28
27
  :uri-docs: {uri-project}/docs
29
28
  :uri-news: {uri-project}/news
@@ -33,15 +32,15 @@ ifdef::env-site[:uri-project: link:]
33
32
  :uri-rel-file-base: link:
34
33
  :uri-rel-tree-base: link:
35
34
  ifdef::env-site[]
36
- :uri-rel-file-base: {uri-repo}/blob/master/
37
- :uri-rel-tree-base: {uri-repo}/tree/master/
35
+ :uri-rel-file-base: {uri-repo}/blob/HEAD/
36
+ :uri-rel-tree-base: {uri-repo}/tree/HEAD/
38
37
  endif::[]
39
38
  :uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
40
39
  :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
41
40
  :uri-license: {uri-rel-file-base}LICENSE
42
41
  :uri-tests: {uri-rel-tree-base}test
43
- :uri-discuss: http://discuss.asciidoctor.org
44
- :uri-irc: irc://irc.freenode.org/#asciidoctor
42
+ :uri-discuss: https://discuss.asciidoctor.org
43
+ :uri-chat: https://asciidoctor.zulipchat.com
45
44
  :uri-rubygem: https://rubygems.org/gems/asciidoctor
46
45
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
47
46
  :uri-user-manual: {uri-docs}/user-manual
@@ -51,15 +50,14 @@ endif::[]
51
50
  :uri-render-doc: {uri-docs}/render-documents
52
51
  :uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
53
52
  :uri-gitscm-repo: https://github.com/git/git-scm.com
54
- :uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
55
53
  :uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
56
- :uri-foundation: http://foundation.zurb.com
54
+ :uri-foundation: https://foundation.zurb.com
57
55
  :uri-tilt: https://github.com/rtomayko/tilt
58
56
  :uri-ruby: https://ruby-lang.org
59
57
  // images:
60
- :image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
58
+ :image-uri-screenshot: https://cdn.jsdelivr.net/gh/asciidoctor/asciidoctor/screenshot.png
61
59
 
62
- {uri-project}/[Asciidoctor] est un processeur de texte et une chaîne de publication _rapide_ et {uri-license}[open source] permettant de convertir du contenu {uri-what-is-asciidoc}[AsciiDoc] en HTML5, DocBook, PDF et d'autres formats.
60
+ {uri-project}/[Asciidoctor] est un processeur de texte et une chaîne de publication _rapide_ et {uri-license}[open source] permettant de convertir du contenu {uri-what-is-asciidoc}[AsciiDoc] en HTML 5, DocBook 5, PDF et d'autres formats.
63
61
  Asciidoctor est écrit en Ruby et fonctionne sur les principaux systèmes d'exploitation.
64
62
  Pour simplifier l'installation, Asciidoctor est publié au format gem sur {uri-rubygem}[RubyGems.org], et il est également disponible en tant que paquet système sur les principales distributions Linux ainsi que sur macOS.
65
63
  Asciidoctor fonctionne aussi sur la JVM avec {uri-asciidoctorj}[AsciidoctorJ] et dans n'importe quel environnement JavaScript avec {uri-asciidoctorjs}[Asciidoctor.js].
@@ -82,38 +80,30 @@ endif::[]
82
80
  * {uri-docs}/user-manual[Manuel Utilisateur Asciidoctor]
83
81
 
84
82
  ifdef::status[]
85
- .*Santé du projet*
86
- image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
87
- 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]
88
- //image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
89
- //image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
90
- image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
83
+ image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
84
+ image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
85
+ image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
86
+ image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[Project Chat,link={uri-chat}]
91
87
  endif::[]
92
88
 
93
89
  == Sponsors
94
90
 
95
91
  Nous souhaitons exprimer toute notre reconnaissance à nos généreux sponsors, sans qui Asciidoctor ne pourrait pas exister.
96
92
  Merci à vous pour votre engagement dans l'amélioration de la documentation technique !
97
-
98
- 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"]
99
- &nbsp; &nbsp; &nbsp;
100
- 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"]
101
-
102
- Asciidoctor est financé majoritairement par nos *Change Makers*, https://developer.okta.com/signup?utm_source=asciidoctor&utm_medium=text-link&utm_campaign=sponsor[Okta] et https://opendevise.com[OpenDevise], ainsi que par nos *Strategy Sponsors*, https://www.khronos.org/[Khronos Group] et Linda Roberts.
103
93
  Un apport financier supplémentaire est assuré par https://asciidoctor.org/supporters[la communauté].
104
94
 
105
95
  Vous pouvez aider ce projet en devant un sponsor sur https://opencollective.com/asciidoctor[OpenCollective].
106
96
 
107
97
  == En un mot
108
98
 
109
- Asciidoctor lit du contenu écrit en texte brut, comme présenté dans la partie gauche de l'image ci-dessous, et le convertit en HTML5, comme présenté dans la partie droite.
110
- Asciidoctor applique une feuille de style par défaut au document HTML5 afin de fournir une expérience de lecture agréable, clé en main.
99
+ Asciidoctor lit du contenu écrit en texte brut, comme présenté dans la partie gauche de l'image ci-dessous, et le convertit en HTML 5, comme présenté dans la partie droite.
100
+ Asciidoctor applique une feuille de style par défaut au document HTML 5 afin de fournir une expérience de lecture agréable, clé en main.
111
101
 
112
102
  image::{image-uri-screenshot}[Prévisualisation d'une source AsciiDoc et le rendu HTML correspondant]
113
103
 
114
104
  == Le traitement d'AsciiDoc
115
105
 
116
- Asciidoctor lit et analyse la syntaxe du texte écrit en AsciiDoc afin de créer une représentation, sous forme d'arbre, à partir de laquelle des templates sont appliqués pour produire de l'HTML5, du DocBook 5 et des pages de man(uel).
106
+ Asciidoctor lit et analyse la syntaxe du texte écrit en AsciiDoc afin de créer une représentation, sous forme d'arbre, à partir de laquelle des templates sont appliqués pour produire de l'HTML 5, du DocBook 5 et des pages de man(uel).
117
107
 
118
108
  Vous avez la possibilité d'écrire votre propre convertisseur ou de fournir des templates supportant {uri-tilt}[Tilt] pour personnaliser le résultat généré ou pour produire des formats alternatifs.
119
109
 
@@ -121,7 +111,7 @@ Asciidoctor remplace le processeur AsciiDoc original écrit en Python (`asciidoc
121
111
  La suite de tests Asciidoctor possède {uri-tests}[plus de 2,000 tests] afin de garantir la compatibilité avec la syntaxe AsciiDoc.
122
112
 
123
113
  En plus de la syntaxe AsciiDoc standard, Asciidoctor reconnaît des balises additionnelles ainsi que des options de formatage, comme les polices d'icônes (par exemple `+icon:fire[]+`) et des éléments d'interface (par exemple `+button:[Enregistrer]+`).
124
- Asciidoctor offre aussi un thème moderne et « responsive » basé sur {uri-foundation}[Foundation] pour styliser le document HTML5 généré.
114
+ Asciidoctor offre aussi un thème moderne et « responsive » basé sur {uri-foundation}[Foundation] pour styliser le document HTML 5 généré.
125
115
 
126
116
  == Asciidoctor est disponible partout où Ruby est disponible
127
117
 
@@ -137,9 +127,9 @@ Asciidoctor.js est utilisé pour faire fonctionner les extensions AsciiDoc Previ
137
127
 
138
128
  Asciidoctor fonctionne sur Linux, macOS et Windows et requiert une des implémentations suivantes de {uri-ruby}[Ruby] :
139
129
 
140
- * Ruby (MRI/CRuby 1.8.7 - 2.5)
141
- * JRuby (1.7 en mode Ruby 1.8 et 1.9, 9000)
142
- * Rubinius 2.2.x
130
+ * CRuby (aka MRI) 2.3 - 2.6
131
+ * JRuby 9.1 - 9.2
132
+ * TruffleRuby (GraalVM)
143
133
  * Opal (JavaScript)
144
134
 
145
135
  [CAUTION]
@@ -203,7 +193,7 @@ Ouvrez un terminal et tapez :
203
193
 
204
194
  $ brew install asciidoctor
205
195
 
206
- Homebrew installe la gemme `asciidoctor` dans un répertoire spécifique qui est indépendant des gemmes système.
196
+ Homebrew installe la gemme `asciidoctor` dans un répertoire spécifique qui est indépendant des gemmes système.
207
197
 
208
198
  [#gem-install]
209
199
  === (c) gem install
@@ -297,7 +287,7 @@ Vous devriez voir les informations concernant la version d'Asciidoctor et celle
297
287
 
298
288
  [.output,subs=attributes+]
299
289
  ....
300
- Asciidoctor {release-version} [http://asciidoctor.org]
290
+ Asciidoctor {release-version} [https://asciidoctor.org]
301
291
  Runtime Environment (ruby 2.4.1p111 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
302
292
  ....
303
293
 
@@ -348,7 +338,7 @@ Vous pouvez aussi convertir une chaîne de texte en fragment HTML (pour une inse
348
338
 
349
339
  [source]
350
340
  ----
351
- content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
341
+ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
352
342
  Asciidoctor.convert content, safe: :safe
353
343
  ----
354
344
 
@@ -356,7 +346,7 @@ Si vous voulez le document HTML complet, activez l'option `header_footer` comme
356
346
 
357
347
  [source]
358
348
  ----
359
- content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
349
+ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
360
350
  html = Asciidoctor.convert content, header_footer: true, safe: :safe
361
351
  ----
362
352
 
@@ -364,7 +354,7 @@ Si vous avez besoin d'accéder au document analysé, vous pouvez séparer la con
364
354
 
365
355
  [source]
366
356
  ----
367
- content = '_Zen_ in the art of writing http://asciidoctor.org[AsciiDoc].'
357
+ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
368
358
  document = Asciidoctor.load content, header_footer: true, safe: :safe
369
359
  puts document.doctitle
370
360
  html = document.convert
@@ -407,12 +397,9 @@ Asciidoctor est développé dans le but de vous aider à écrire et publier du c
407
397
  Mais nous ne pouvons pas le faire sans vos avis !
408
398
  Nous vous encourageons à poser vos questions et à discuter de n'importe quels aspects du projet sur la liste de discussion, Twitter ou dans le salon de discussion.
409
399
 
410
- Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
400
+ Chat (Zulip):: {uri-chat}
411
401
  Forum (Nabble):: {uri-discuss}
412
402
  Twitter:: hashtag https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] ou la mention https://twitter.com/asciidoctor[@asciidoctor]
413
- ////
414
- IRC (Chat):: {uri-irc}[#asciidoctor] sur FreeNode IRC
415
- ////
416
403
 
417
404
  ifdef::env-github[]
418
405
  De plus amples informations et documentations sur Asciidoctor peuvent être trouvées sur le site web du projet.
@@ -428,7 +415,7 @@ L'organisation Asciidoctor sur GitHub:: {uri-org}
428
415
 
429
416
  == Licence
430
417
 
431
- Copyright (C) 2012-2018 Dan Allen, Sarah White et les contributeurs individuels d'Asciidoctor.
418
+ Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
432
419
  Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
433
420
 
434
421
  Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
@@ -436,7 +423,7 @@ Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
436
423
  == Auteurs
437
424
 
438
425
  *Asciidoctor* est mené par https://github.com/mojavelinux[Dan Allen] et https://github.com/graphitefriction[Sarah White] et reçoit de nombreuses contributions de la part de la {uri-contributors}[géniale communauté] Asciidoctor.
439
- Le projet a été initié en 2012 par https://github.com/erebor[Ryan Waldron] et est basé sur {uri-prototype}[un prototype] écrit par https://github.com/nickh[Nick Hengeveld].
426
+ Le projet a été initié en 2012 par https://github.com/erebor[Ryan Waldron] et est basé sur un prototype écrit par https://github.com/nickh[Nick Hengeveld].
440
427
 
441
428
  *AsciiDoc* a été démarré par Stuart Rackham et a reçu de nombreuses contributions de la part de la communauté AsciiDoc.
442
429