asciidoctor 1.5.8 → 2.0.17
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.yardopts +11 -0
- data/CHANGELOG.adoc +628 -45
- data/LICENSE +2 -1
- data/README-de.adoc +28 -38
- data/README-fr.adoc +30 -43
- data/README-jp.adoc +255 -201
- data/README-zh_CN.adoc +40 -44
- data/README.adoc +170 -143
- data/asciidoctor.gemspec +22 -34
- data/bin/asciidoctor +5 -4
- data/data/locale/attributes-ar.adoc +4 -3
- data/data/locale/attributes-be.adoc +23 -0
- data/data/locale/attributes-bg.adoc +4 -3
- data/data/locale/attributes-ca.adoc +6 -5
- data/data/locale/attributes-cs.adoc +4 -3
- data/data/locale/attributes-da.adoc +6 -5
- data/data/locale/attributes-de.adoc +6 -5
- data/data/locale/attributes-en.adoc +4 -4
- data/data/locale/attributes-es.adoc +6 -5
- data/data/locale/attributes-fa.adoc +4 -3
- data/data/locale/attributes-fi.adoc +4 -3
- data/data/locale/attributes-fr.adoc +8 -7
- data/data/locale/attributes-hu.adoc +4 -3
- data/data/locale/attributes-id.adoc +4 -3
- data/data/locale/attributes-it.adoc +6 -5
- data/data/locale/attributes-ja.adoc +4 -3
- data/data/locale/{attributes-kr.adoc → attributes-ko.adoc} +4 -3
- data/data/locale/attributes-nb.adoc +4 -3
- data/data/locale/attributes-nl.adoc +6 -5
- data/data/locale/attributes-nn.adoc +4 -3
- data/data/locale/attributes-pl.adoc +8 -7
- data/data/locale/attributes-pt.adoc +6 -5
- data/data/locale/attributes-pt_BR.adoc +6 -5
- data/data/locale/attributes-ro.adoc +4 -3
- data/data/locale/attributes-ru.adoc +6 -5
- data/data/locale/attributes-sr.adoc +4 -4
- data/data/locale/attributes-sr_Latn.adoc +4 -4
- data/data/locale/attributes-sv.adoc +4 -4
- data/data/locale/attributes-th.adoc +23 -0
- data/data/locale/attributes-tr.adoc +4 -3
- data/data/locale/attributes-uk.adoc +6 -5
- data/data/locale/attributes-vi.adoc +23 -0
- data/data/locale/attributes-zh_CN.adoc +4 -3
- data/data/locale/attributes-zh_TW.adoc +4 -3
- data/data/reference/syntax.adoc +296 -0
- data/data/stylesheets/asciidoctor-default.css +120 -114
- data/data/stylesheets/coderay-asciidoctor.css +15 -17
- data/lib/asciidoctor/abstract_block.rb +146 -140
- data/lib/asciidoctor/abstract_node.rb +152 -170
- data/lib/asciidoctor/attribute_list.rb +77 -89
- data/lib/asciidoctor/block.rb +29 -28
- data/lib/asciidoctor/callouts.rb +4 -2
- data/lib/asciidoctor/cli/invoker.rb +20 -24
- data/lib/asciidoctor/cli/options.rb +107 -96
- data/lib/asciidoctor/cli.rb +3 -2
- data/lib/asciidoctor/convert.rb +199 -0
- data/lib/asciidoctor/converter/composite.rb +40 -48
- data/lib/asciidoctor/converter/docbook5.rb +627 -644
- data/lib/asciidoctor/converter/html5.rb +1053 -951
- data/lib/asciidoctor/converter/manpage.rb +581 -532
- data/lib/asciidoctor/converter/template.rb +232 -271
- data/lib/asciidoctor/converter.rb +370 -185
- data/lib/asciidoctor/core_ext/float/truncate.rb +20 -0
- data/lib/asciidoctor/core_ext/hash/merge.rb +8 -0
- data/lib/asciidoctor/core_ext/match_data/names.rb +7 -0
- data/lib/asciidoctor/core_ext/nil_or_empty.rb +1 -0
- data/lib/asciidoctor/core_ext/regexp/is_match.rb +4 -2
- data/lib/asciidoctor/core_ext.rb +8 -17
- data/lib/asciidoctor/document.rb +503 -461
- data/lib/asciidoctor/extensions.rb +127 -174
- data/lib/asciidoctor/helpers.rb +184 -107
- data/lib/asciidoctor/inline.rb +9 -12
- data/lib/asciidoctor/list.rb +11 -29
- data/lib/asciidoctor/load.rb +119 -0
- data/lib/asciidoctor/logging.rb +22 -17
- data/lib/asciidoctor/parser.rb +673 -719
- data/lib/asciidoctor/path_resolver.rb +48 -33
- data/lib/asciidoctor/reader.rb +383 -338
- data/lib/asciidoctor/rouge_ext.rb +39 -0
- data/lib/asciidoctor/rx.rb +723 -0
- data/lib/asciidoctor/section.rb +17 -16
- data/lib/asciidoctor/stylesheets.rb +19 -37
- data/lib/asciidoctor/substitutors.rb +926 -1022
- data/lib/asciidoctor/syntax_highlighter/coderay.rb +88 -0
- data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +34 -0
- data/lib/asciidoctor/syntax_highlighter/html_pipeline.rb +10 -0
- data/lib/asciidoctor/syntax_highlighter/prettify.rb +30 -0
- data/lib/asciidoctor/syntax_highlighter/pygments.rb +157 -0
- data/lib/asciidoctor/syntax_highlighter/rouge.rb +143 -0
- data/lib/asciidoctor/syntax_highlighter.rb +253 -0
- data/lib/asciidoctor/table.rb +152 -114
- data/lib/asciidoctor/timings.rb +7 -5
- data/lib/asciidoctor/version.rb +2 -1
- data/lib/asciidoctor/writer.rb +30 -0
- data/lib/asciidoctor.rb +266 -1340
- data/man/asciidoctor.1 +49 -47
- data/man/asciidoctor.adoc +54 -45
- metadata +50 -245
- data/CONTRIBUTING.adoc +0 -185
- data/Gemfile +0 -60
- data/Rakefile +0 -129
- data/bin/asciidoctor-safe +0 -15
- data/features/open_block.feature +0 -92
- data/features/pass_block.feature +0 -66
- data/features/step_definitions.rb +0 -49
- data/features/text_formatting.feature +0 -57
- data/features/xref.feature +0 -1039
- data/lib/asciidoctor/converter/base.rb +0 -59
- data/lib/asciidoctor/converter/docbook45.rb +0 -93
- data/lib/asciidoctor/converter/factory.rb +0 -226
- data/lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb +0 -6
- data/lib/asciidoctor/core_ext/1.8.7/concurrent/hash.rb +0 -5
- data/lib/asciidoctor/core_ext/1.8.7/hash/key.rb +0 -4
- data/lib/asciidoctor/core_ext/1.8.7/io/binread.rb +0 -6
- data/lib/asciidoctor/core_ext/1.8.7/io/write.rb +0 -5
- data/lib/asciidoctor/core_ext/1.8.7/string/chr.rb +0 -6
- data/lib/asciidoctor/core_ext/1.8.7/string/limit_bytesize.rb +0 -29
- data/lib/asciidoctor/core_ext/1.8.7/symbol/empty.rb +0 -6
- data/lib/asciidoctor/core_ext/1.8.7/symbol/length.rb +0 -6
- data/lib/asciidoctor/core_ext/string/limit_bytesize.rb +0 -10
- data/test/api_test.rb +0 -1240
- data/test/attribute_list_test.rb +0 -242
- data/test/attributes_test.rb +0 -1623
- data/test/blocks_test.rb +0 -3870
- data/test/converter_test.rb +0 -470
- data/test/document_test.rb +0 -1853
- data/test/extensions_test.rb +0 -1560
- data/test/fixtures/asciidoc_index.txt +0 -521
- data/test/fixtures/basic-docinfo-footer.html +0 -6
- data/test/fixtures/basic-docinfo-footer.xml +0 -8
- data/test/fixtures/basic-docinfo.html +0 -1
- data/test/fixtures/basic-docinfo.xml +0 -4
- data/test/fixtures/basic.asciidoc +0 -5
- data/test/fixtures/chapter-a.adoc +0 -3
- data/test/fixtures/child-include.adoc +0 -5
- data/test/fixtures/circle.svg +0 -9
- data/test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb +0 -6
- data/test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml +0 -6
- data/test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml +0 -3
- data/test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml +0 -5
- data/test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml +0 -1
- data/test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim +0 -6
- data/test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim +0 -3
- data/test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim +0 -5
- data/test/fixtures/custom-docinfodir/basic-docinfo.html +0 -1
- data/test/fixtures/custom-docinfodir/docinfo.html +0 -1
- data/test/fixtures/docinfo-footer.html +0 -1
- data/test/fixtures/docinfo-footer.xml +0 -9
- data/test/fixtures/docinfo.html +0 -1
- data/test/fixtures/docinfo.xml +0 -3
- data/test/fixtures/doctime-localtime.adoc +0 -2
- data/test/fixtures/dot.gif +0 -0
- data/test/fixtures/encoding.asciidoc +0 -13
- data/test/fixtures/file-with-missing-include.adoc +0 -1
- data/test/fixtures/grandchild-include.adoc +0 -3
- data/test/fixtures/hello-asciidoctor.pdf +0 -69
- data/test/fixtures/include-file.asciidoc +0 -24
- data/test/fixtures/include-file.jsx +0 -8
- data/test/fixtures/include-file.ml +0 -3
- data/test/fixtures/include-file.xml +0 -5
- data/test/fixtures/lists.adoc +0 -96
- data/test/fixtures/master.adoc +0 -5
- data/test/fixtures/mismatched-end-tag.adoc +0 -7
- data/test/fixtures/other-chapters.adoc +0 -11
- data/test/fixtures/outer-include.adoc +0 -5
- data/test/fixtures/parent-include-restricted.adoc +0 -5
- data/test/fixtures/parent-include.adoc +0 -5
- data/test/fixtures/sample.asciidoc +0 -30
- data/test/fixtures/section-a.adoc +0 -4
- data/test/fixtures/stylesheets/custom.css +0 -3
- data/test/fixtures/subdir/index.adoc +0 -3
- data/test/fixtures/subdir/inner-include.adoc +0 -3
- data/test/fixtures/subdir/middle-include.adoc +0 -5
- data/test/fixtures/subs-docinfo.html +0 -2
- data/test/fixtures/subs.adoc +0 -6
- data/test/fixtures/tagged-class-enclosed.rb +0 -25
- data/test/fixtures/tagged-class.rb +0 -23
- data/test/fixtures/tip.gif +0 -0
- data/test/fixtures/unclosed-tag.adoc +0 -3
- data/test/fixtures/unexpected-end-tag.adoc +0 -4
- data/test/invoker_test.rb +0 -745
- data/test/links_test.rb +0 -855
- data/test/lists_test.rb +0 -5151
- data/test/logger_test.rb +0 -211
- data/test/manpage_test.rb +0 -660
- data/test/options_test.rb +0 -262
- data/test/paragraphs_test.rb +0 -562
- data/test/parser_test.rb +0 -742
- data/test/paths_test.rb +0 -395
- data/test/preamble_test.rb +0 -173
- data/test/reader_test.rb +0 -2161
- data/test/sections_test.rb +0 -3575
- data/test/substitutions_test.rb +0 -2066
- data/test/tables_test.rb +0 -2036
- data/test/test_helper.rb +0 -447
- data/test/text_test.rb +0 -309
data/LICENSE
CHANGED
@@ -1,6 +1,7 @@
|
|
1
1
|
MIT License
|
2
2
|
|
3
|
-
Copyright (C) 2012-
|
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]
|
3
|
-
|
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:
|
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:
|
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/
|
37
|
-
:uri-rel-tree-base: {uri-repo}/tree/
|
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:
|
44
|
-
:uri-
|
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://
|
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
|
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
|
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
|
-
|
89
|
-
image:https://img.shields.io/
|
90
|
-
image:https://
|
91
|
-
|
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
|
-
|
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
|
113
|
-
Asciidoctor wendet ein Standard-Stylesheet auf das
|
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
|
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
|
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
|
-
*
|
144
|
-
* JRuby
|
145
|
-
*
|
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.
|
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 (
|
434
|
+
Chat (Zulip):: {uri-chat}
|
445
435
|
Discussionsliste (Nabble):: {uri-discuss}
|
446
|
-
Twitter:: https://twitter.com/
|
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-
|
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
|
470
|
-
Das Projekt wurde 2012 von https://github.com/erebor[Ryan Waldron] initiiert und basiert auf einem
|
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]
|
3
|
-
|
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:
|
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:
|
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/
|
37
|
-
:uri-rel-tree-base: {uri-repo}/tree/
|
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:
|
44
|
-
:uri-
|
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:
|
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://
|
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
|
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
|
-
|
86
|
-
image:https://img.shields.io/
|
87
|
-
image:https://
|
88
|
-
|
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
|
-
|
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
|
110
|
-
Asciidoctor applique une feuille de style par défaut au document
|
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'
|
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
|
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
|
-
*
|
141
|
-
* JRuby
|
142
|
-
*
|
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} [
|
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
|
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
|
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
|
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 (
|
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-
|
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
|
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
|
|