asciidoctor 2.0.10 → 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/CHANGELOG.adoc +294 -30
- data/LICENSE +1 -1
- data/README-de.adoc +16 -20
- data/README-fr.adoc +15 -22
- data/README-jp.adoc +15 -26
- data/README-zh_CN.adoc +21 -25
- data/README.adoc +161 -138
- data/asciidoctor.gemspec +6 -13
- 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 +4 -4
- 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 +14 -7
- data/data/stylesheets/asciidoctor-default.css +76 -76
- data/data/stylesheets/coderay-asciidoctor.css +9 -9
- data/lib/asciidoctor/abstract_block.rb +20 -13
- data/lib/asciidoctor/abstract_node.rb +23 -12
- data/lib/asciidoctor/attribute_list.rb +64 -72
- data/lib/asciidoctor/block.rb +6 -6
- data/lib/asciidoctor/cli/invoker.rb +3 -2
- data/lib/asciidoctor/cli/options.rb +32 -31
- data/lib/asciidoctor/convert.rb +168 -162
- data/lib/asciidoctor/converter/docbook5.rb +49 -34
- data/lib/asciidoctor/converter/html5.rb +180 -139
- data/lib/asciidoctor/converter/manpage.rb +118 -90
- data/lib/asciidoctor/converter/template.rb +15 -13
- data/lib/asciidoctor/converter.rb +19 -16
- data/lib/asciidoctor/core_ext/hash/merge.rb +1 -1
- data/lib/asciidoctor/document.rb +77 -86
- data/lib/asciidoctor/extensions.rb +22 -16
- data/lib/asciidoctor/helpers.rb +20 -15
- data/lib/asciidoctor/list.rb +2 -6
- data/lib/asciidoctor/load.rb +103 -101
- data/lib/asciidoctor/logging.rb +10 -8
- data/lib/asciidoctor/parser.rb +211 -220
- data/lib/asciidoctor/path_resolver.rb +17 -15
- data/lib/asciidoctor/reader.rb +87 -79
- data/lib/asciidoctor/rx.rb +9 -7
- data/lib/asciidoctor/section.rb +7 -0
- data/lib/asciidoctor/substitutors.rb +167 -148
- data/lib/asciidoctor/syntax_highlighter/coderay.rb +3 -2
- data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +13 -5
- data/lib/asciidoctor/syntax_highlighter/prettify.rb +7 -4
- data/lib/asciidoctor/syntax_highlighter/pygments.rb +19 -11
- data/lib/asciidoctor/syntax_highlighter/rouge.rb +35 -20
- data/lib/asciidoctor/syntax_highlighter.rb +16 -16
- data/lib/asciidoctor/table.rb +70 -43
- data/lib/asciidoctor/timings.rb +3 -3
- data/lib/asciidoctor/version.rb +1 -1
- data/lib/asciidoctor.rb +45 -19
- data/man/asciidoctor.1 +29 -31
- data/man/asciidoctor.adoc +35 -29
- metadata +17 -70
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
|
-
v2.0.
|
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 @@ v2.0.10, 2019-05-31
|
|
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,7 +16,7 @@ ifdef::env-github[]
|
|
17
16
|
:warning-caption: :warning:
|
18
17
|
endif::[]
|
19
18
|
// Variables:
|
20
|
-
:release-version: 2.0.
|
19
|
+
:release-version: 2.0.17
|
21
20
|
// URIs:
|
22
21
|
:uri-org: https://github.com/asciidoctor
|
23
22
|
:uri-repo: {uri-org}/asciidoctor
|
@@ -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,13 +50,12 @@ 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-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
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.
|
@@ -82,12 +80,10 @@ 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
|
@@ -401,12 +397,9 @@ Asciidoctor est développé dans le but de vous aider à écrire et publier du c
|
|
401
397
|
Mais nous ne pouvons pas le faire sans vos avis !
|
402
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.
|
403
399
|
|
404
|
-
Chat (
|
400
|
+
Chat (Zulip):: {uri-chat}
|
405
401
|
Forum (Nabble):: {uri-discuss}
|
406
402
|
Twitter:: hashtag https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] ou la mention https://twitter.com/asciidoctor[@asciidoctor]
|
407
|
-
////
|
408
|
-
IRC (Chat):: {uri-irc}[#asciidoctor] sur FreeNode IRC
|
409
|
-
////
|
410
403
|
|
411
404
|
ifdef::env-github[]
|
412
405
|
De plus amples informations et documentations sur Asciidoctor peuvent être trouvées sur le site web du projet.
|
@@ -422,7 +415,7 @@ L'organisation Asciidoctor sur GitHub:: {uri-org}
|
|
422
415
|
|
423
416
|
== Licence
|
424
417
|
|
425
|
-
Copyright (C) 2012-
|
418
|
+
Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
|
426
419
|
Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
|
427
420
|
|
428
421
|
Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
|
@@ -430,7 +423,7 @@ Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
|
|
430
423
|
== Auteurs
|
431
424
|
|
432
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.
|
433
|
-
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].
|
434
427
|
|
435
428
|
*AsciiDoc* a été démarré par Stuart Rackham et a reçu de nombreuses contributions de la part de la communauté AsciiDoc.
|
436
429
|
|
data/README-jp.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
|
-
v2.0.
|
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 @@ v2.0.10, 2019-05-31
|
|
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,7 +16,7 @@ ifdef::env-github[]
|
|
17
16
|
:warning-caption: :warning:
|
18
17
|
endif::[]
|
19
18
|
// Variables:
|
20
|
-
:release-version: 2.0.
|
19
|
+
:release-version: 2.0.17
|
21
20
|
// URIs:
|
22
21
|
:uri-org: https://github.com/asciidoctor
|
23
22
|
:uri-repo: {uri-org}/asciidoctor
|
@@ -37,15 +36,15 @@ ifdef::env-site[:uri-project: link:]
|
|
37
36
|
:uri-rel-file-base: link:
|
38
37
|
:uri-rel-tree-base: link:
|
39
38
|
ifdef::env-site,env-yard[]
|
40
|
-
:uri-rel-file-base: {uri-repo}/blob/
|
41
|
-
:uri-rel-tree-base: {uri-repo}/tree/
|
39
|
+
:uri-rel-file-base: {uri-repo}/blob/HEAD/
|
40
|
+
:uri-rel-tree-base: {uri-repo}/tree/HEAD/
|
42
41
|
endif::[]
|
43
42
|
:uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
|
44
43
|
:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
|
45
44
|
:uri-license: {uri-rel-file-base}LICENSE
|
46
45
|
:uri-tests: {uri-rel-tree-base}test
|
47
|
-
:uri-discuss:
|
48
|
-
:uri-
|
46
|
+
:uri-discuss: https://discuss.asciidoctor.org
|
47
|
+
:uri-chat: https://asciidoctor.zulipchat.com
|
49
48
|
:uri-rubygem: https://rubygems.org/gems/asciidoctor
|
50
49
|
:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
|
51
50
|
:uri-user-manual: {uri-docs}/user-manual
|
@@ -55,14 +54,13 @@ endif::[]
|
|
55
54
|
:uri-convert-doc: {uri-docs}/convert-documents
|
56
55
|
:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
|
57
56
|
:uri-gitscm-repo: https://github.com/git/git-scm.com
|
58
|
-
:uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
|
59
57
|
:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
|
60
58
|
:uri-foundation: https://foundation.zurb.com
|
61
59
|
:uri-opal: https://opalrb.com
|
62
60
|
:uri-tilt: https://github.com/rtomayko/tilt
|
63
61
|
:uri-ruby: https://www.ruby-lang.org
|
64
62
|
// images:
|
65
|
-
:image-uri-screenshot: https://
|
63
|
+
:image-uri-screenshot: https://cdn.jsdelivr.net/gh/asciidoctor/asciidoctor/screenshot.png
|
66
64
|
|
67
65
|
{uri-project}[Asciidoctor]は, {uri-what-is-asciidoc}[AsciiDoc] で書かれたコンテンツをHTML5, DocBook, PDFなどのフォーマットに変換する, _高速で_ {uri-license}[オープンソース] のテキストプロセッサおよびパブリッシングツールチェインです.
|
68
66
|
AsciidoctorはRubyで書かれており, すべての主要オペレーティングシステムで動作します.
|
@@ -70,7 +68,7 @@ Asciidoctorプロジェクトは {uri-repo}[GitHubにホスティング] され
|
|
70
68
|
|
71
69
|
インストールをシンプルにするため, AsciidoctorはRubyGem(gem)パッケージとして, {uri-rubygem}[RubyGems.org] で配布されています.
|
72
70
|
さらに, Asciidoctorは主要なLinuxディストリビューション用およびmacOS用パッケージとしても配布されています.
|
73
|
-
|
71
|
+
AsciidoctorはRubyで動作するだけでなく, {uri-asciidoctorj}[AsciidoctorJ]としてJVM上でも動作します. また, {uri-asciidoctorjs}[Asciidoctor.js]としてどのようなJavaScript環境(ブラウザを含む)でも実行できます.
|
74
72
|
|
75
73
|
ifndef::env-site,env-yard[]
|
76
74
|
このドキュメントには以下の言語版が存在します: +
|
@@ -91,14 +89,10 @@ endif::[]
|
|
91
89
|
* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
|
92
90
|
|
93
91
|
ifdef::status[]
|
94
|
-
//.*Project health*
|
95
92
|
image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
|
96
93
|
image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
|
97
|
-
image:https://
|
98
|
-
image:https://
|
99
|
-
//image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status,link=https://coveralls.io/r/asciidoctor/asciidoctor]
|
100
|
-
//image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate,link=https://codeclimate.com/github/asciidoctor/asciidoctor]
|
101
|
-
image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs,link=https://inch-ci.org/github/asciidoctor/asciidoctor]
|
94
|
+
image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
|
95
|
+
image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[Project Chat,link={uri-chat}]
|
102
96
|
endif::[]
|
103
97
|
|
104
98
|
== スポンサー
|
@@ -107,11 +101,6 @@ endif::[]
|
|
107
101
|
スポンサーのみなさま, ありがとうございます!
|
108
102
|
みなさまの多くのサポートなくしてAsciidoctorは実現不可能です.
|
109
103
|
|
110
|
-
ifndef::env-site,env-yard[]
|
111
|
-
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 によって提供されています.
|
112
|
-
さらに, {uri-project}/supporters[Community Backers] のページに掲載されているサポーターによって追加的な資金が提供されています.
|
113
|
-
endif::[]
|
114
|
-
|
115
104
|
https://opencollective.com/asciidoctor[OpenCollective] を通じてスポンサーになることにより, このプロジェクトを支援することができます.
|
116
105
|
|
117
106
|
== 全体像
|
@@ -278,7 +267,7 @@ gem 'asciidoctor'
|
|
278
267
|
$ bundle
|
279
268
|
|
280
269
|
gemをアップグレードするには, Gemfileで新バージョンを指定し, `bundle` を再び実行してください.
|
281
|
-
`bundle update` を(gemを指定せずに)行うことは推奨 *されません* . 他のgemもアップデートされて思わぬ結果になるかもしれないためです.
|
270
|
+
`bundle update` を(gemを指定せずに)行うことは推奨 *されません* . 他のgemもアップデートされて思わぬ結果になるかもしれないためです.
|
282
271
|
|
283
272
|
== アップグレード
|
284
273
|
|
@@ -442,7 +431,7 @@ Asciidoctorは, コンテンツの執筆と公開を簡単にするために開
|
|
442
431
|
しかしあなたからのフィードバックがなくてはAsciidoctorの開発は進みません!
|
443
432
|
ディスカッションリスト, Twitter, チャットルームを使って, 質問をしたりプロジェクトのさまざまな側面について話し合ったりすることをお勧めします.
|
444
433
|
|
445
|
-
チャット(
|
434
|
+
チャット(Zulip):: {uri-chat}
|
446
435
|
ディスカッションリスト(Nabble):: {uri-discuss}
|
447
436
|
Twitter:: ハッシュタグ https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] またはメンション https://twitter.com/asciidoctor[@asciidoctor]
|
448
437
|
|
@@ -460,7 +449,7 @@ GitHub上のAsciidoctorのorganization:: {uri-org}
|
|
460
449
|
|
461
450
|
== ライセンス
|
462
451
|
|
463
|
-
Copyright (C) 2012-
|
452
|
+
Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
|
464
453
|
本ソフトウェアはMITライセンスのもとで使用できます.
|
465
454
|
|
466
455
|
ライセンスの詳細については {uri-license}[LICENSE] ファイルを参照してください.
|
@@ -468,7 +457,7 @@ Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, and the individual
|
|
468
457
|
== 作者
|
469
458
|
|
470
459
|
*Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] がリードし, Asciidoctorの素晴らしきコミュニティの {uri-contributors}[数多くのメンバ] からコントリビューションを受けてきました.
|
471
|
-
このプロジェクトは https://github.com/nickh[Nick Hengeveld]
|
460
|
+
このプロジェクトは https://github.com/nickh[Nick Hengeveld] のプロトタイプをベースに https://github.com/erebor[Ryan Waldron] により2012年から創始されました.
|
472
461
|
|
473
462
|
*AsciiDoc* は Stuart Rackham により創始され, AsciiDocコミュニティの数多くのメンバからコントリビューションを受けてきました.
|
474
463
|
|
data/README-zh_CN.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
|
-
v2.0.
|
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
|
:page-layout: base
|
6
6
|
:idprefix:
|
@@ -10,7 +10,6 @@ v2.0.10, 2019-05-31
|
|
10
10
|
ifndef::env-github[:icons: font]
|
11
11
|
ifdef::env-github[]
|
12
12
|
:status:
|
13
|
-
:outfilesuffix: .adoc
|
14
13
|
:caution-caption: :fire:
|
15
14
|
:important-caption: :exclamation:
|
16
15
|
:note-caption: :paperclip:
|
@@ -18,7 +17,7 @@ ifdef::env-github[]
|
|
18
17
|
:warning-caption: :warning:
|
19
18
|
endif::[]
|
20
19
|
// Variables:
|
21
|
-
:release-version: 2.0.
|
20
|
+
:release-version: 2.0.17
|
22
21
|
// URIs:
|
23
22
|
:uri-org: https://github.com/asciidoctor
|
24
23
|
:uri-repo: {uri-org}/asciidoctor
|
@@ -34,15 +33,15 @@ ifdef::env-site[:uri-project: link:]
|
|
34
33
|
:uri-rel-file-base: link:
|
35
34
|
:uri-rel-tree-base: link:
|
36
35
|
ifdef::env-site[]
|
37
|
-
:uri-rel-file-base: {uri-repo}/blob/
|
38
|
-
:uri-rel-tree-base: {uri-repo}/tree/
|
36
|
+
:uri-rel-file-base: {uri-repo}/blob/HEAD/
|
37
|
+
:uri-rel-tree-base: {uri-repo}/tree/HEAD/
|
39
38
|
endif::[]
|
40
39
|
:uri-changelog: {uri-rel-file-base}CHANGELOG.adoc
|
41
40
|
:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
|
42
41
|
:uri-license: {uri-rel-file-base}LICENSE
|
43
42
|
:uri-tests: {uri-rel-tree-base}test
|
44
|
-
:uri-discuss:
|
45
|
-
:uri-
|
43
|
+
:uri-discuss: https://discuss.asciidoctor.org
|
44
|
+
:uri-chat: https://asciidoctor.zulipchat.com
|
46
45
|
:uri-rubygem: https://rubygems.org/gems/asciidoctor
|
47
46
|
:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
|
48
47
|
:uri-user-manual: {uri-docs}/user-manual
|
@@ -52,18 +51,17 @@ endif::[]
|
|
52
51
|
:uri-render-doc: {uri-docs}/render-documents
|
53
52
|
:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
|
54
53
|
:uri-gitscm-repo: https://github.com/git/git-scm.com
|
55
|
-
:uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
|
56
54
|
:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
|
57
55
|
:uri-foundation: https://foundation.zurb.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
61
|
{uri-project}/[Asciidoctor] 是一个 _快速_ 文本处理器和发布工具链,它可以将 {uri-what-is-asciidoc}[AsciiDoc] 文档转化成 HTML 5、 DocBook 5 以及其他格式。
|
64
62
|
Asciidoctor 由 Ruby 编写,打包成 RubyGem,然后发布到 {uri-rubygem}[RubyGems.org] 上。
|
65
|
-
这个 gem
|
66
|
-
Asciidoctor 是开源的,{uri-repo}[
|
63
|
+
这个 gem 还被包含到几个 Linux 发行版中,其中包括 Fedora、Debian 和 Ubuntu。
|
64
|
+
Asciidoctor 是开源的,link:{uri-repo}[代码托管在 GitHub],遵从 {uri-license}[MIT] 协议。
|
67
65
|
|
68
66
|
该文档有如下语言的翻译版:
|
69
67
|
|
@@ -78,6 +76,13 @@ Asciidoctor 是开源的,{uri-repo}[代码]托管在 GitHub,遵从 {uri-lice
|
|
78
76
|
* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc 语法快速参考]
|
79
77
|
* {uri-docs}/user-manual[Asciidoctor 用户手册]
|
80
78
|
|
79
|
+
ifdef::status[]
|
80
|
+
image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
|
81
|
+
image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
|
82
|
+
image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
|
83
|
+
image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[Project Chat,link={uri-chat}]
|
84
|
+
endif::[]
|
85
|
+
|
81
86
|
.Ruby 所至, Asciidoctor 相随
|
82
87
|
****
|
83
88
|
使用 JRuby 让 Asciidoctor 运行在 Java 虚拟机上。
|
@@ -89,15 +94,6 @@ Asciidoctor 也可以运行在 JavaScript 上。
|
|
89
94
|
Asciidoctor.js 被用于预览 AsciiDoc,支持 Chrome 扩展,Atom,Brackets 或其他基于 Web 的工具。
|
90
95
|
****
|
91
96
|
|
92
|
-
ifdef::status[]
|
93
|
-
.*Project health*
|
94
|
-
image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
|
95
|
-
image:https://ci.appveyor.com/api/projects/status/ifplu67oxvgn6ceq/branch/master?svg=true&passingText=green%20bar&failingText=%23fail&pendingText=building%2E%2E%2E[Build Status (AppVeyor), link=https://ci.appveyor.com/project/asciidoctor/asciidoctor]
|
96
|
-
//image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
|
97
|
-
//image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
|
98
|
-
image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
|
99
|
-
endif::[]
|
100
|
-
|
101
97
|
[#the-big-picture]
|
102
98
|
== 整体概况
|
103
99
|
|
@@ -326,7 +322,7 @@ WARNING: 当你通过 API 使用 Asciidoctor 时,默认的安全模式是 `:se
|
|
326
322
|
在 secure 模式下,很多核心特性将不可用,包括 `include` 特性。
|
327
323
|
如果你想启用这些特性,你需要明确设置安全模式为 `:server` (推荐)或 `:safe`。
|
328
324
|
|
329
|
-
你也可以将 AsciiDoc
|
325
|
+
你也可以将 AsciiDoc 字符串转化为可内嵌的 HTML (为了插入到一个 HTML 页面),用法如下:
|
330
326
|
|
331
327
|
[source]
|
332
328
|
----
|
@@ -393,9 +389,9 @@ Asciidoctor 支持自定义转化器,它可以操作从待处理文件到生
|
|
393
389
|
但是,如果没有反馈,我们将寸步难行。
|
394
390
|
我们鼓励你在讨论组、Twitter或聊天室里,提问为题,讨论项目的方方面面,
|
395
391
|
|
392
|
+
聊天 (Zulip):: {uri-chat}
|
396
393
|
讨论组 (Nabble):: {uri-discuss}
|
397
394
|
Twitter:: https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] 来加入话题 或 https://twitter.com/asciidoctor[@asciidoctor] at并提醒我们
|
398
|
-
聊天 (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
|
399
395
|
|
400
396
|
ifdef::env-github[]
|
401
397
|
Further information and documentation about Asciidoctor can be found on the project's website.
|
@@ -412,7 +408,7 @@ Asciidoctor 组织在 GitHub 托管代码、议案跟踪和相关子项目。
|
|
412
408
|
[#copyright-and-licensing]
|
413
409
|
== 版权和协议
|
414
410
|
|
415
|
-
Copyright (C) 2012-
|
411
|
+
Copyright (C) 2012-present Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
|
416
412
|
这个软件的免费使用是在MIT许可条款授予的。
|
417
413
|
|
418
414
|
请看 {uri-license}[版权声明] 文件来获取更多详细信息。
|
@@ -421,7 +417,7 @@ Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, and the individual
|
|
421
417
|
== 作者
|
422
418
|
|
423
419
|
*Asciidoctor* 由 https://github.com/mojavelinux[Dan Allen] 和 https://github.com/graphitefriction[Sarah White] 领导,并从 Asciidoctor 社区的 {uri-contributors}[很多其他独立开发者] 上收到了很多贡献。
|
424
|
-
项目最初由 https://github.com/erebor[Ryan Waldron] 于 2012年基于 https://github.com/nickh[Nick Hengeveld]
|
420
|
+
项目最初由 https://github.com/erebor[Ryan Waldron] 于 2012年基于 https://github.com/nickh[Nick Hengeveld] 的原型创建。
|
425
421
|
|
426
422
|
*AsciiDoc* 由 Stuart Rackham 启动,并从 AsciiDoc 社区的其他独立开发者上收到很多贡献。
|
427
423
|
|