asciidoctor 2.0.7 → 2.0.12
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.adoc +169 -7
- data/LICENSE +2 -1
- data/README-de.adoc +5 -15
- data/README-fr.adoc +4 -14
- data/README-jp.adoc +234 -186
- data/README-zh_CN.adoc +7 -17
- data/README.adoc +18 -18
- data/asciidoctor.gemspec +4 -4
- data/data/locale/attributes-ar.adoc +4 -3
- 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 +6 -5
- data/data/locale/attributes-hu.adoc +4 -3
- data/data/locale/attributes-id.adoc +4 -3
- data/data/locale/attributes-it.adoc +4 -3
- 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 +4 -3
- 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-tr.adoc +4 -3
- data/data/locale/attributes-uk.adoc +6 -5
- data/data/locale/attributes-zh_CN.adoc +4 -3
- data/data/locale/attributes-zh_TW.adoc +4 -3
- data/data/stylesheets/asciidoctor-default.css +33 -30
- data/lib/asciidoctor.rb +89 -791
- data/lib/asciidoctor/abstract_block.rb +19 -11
- data/lib/asciidoctor/abstract_node.rb +21 -15
- data/lib/asciidoctor/attribute_list.rb +59 -67
- data/lib/asciidoctor/cli/invoker.rb +2 -0
- data/lib/asciidoctor/cli/options.rb +3 -3
- data/lib/asciidoctor/convert.rb +167 -162
- data/lib/asciidoctor/converter.rb +14 -13
- data/lib/asciidoctor/converter/docbook5.rb +10 -26
- data/lib/asciidoctor/converter/html5.rb +62 -43
- data/lib/asciidoctor/converter/manpage.rb +13 -12
- data/lib/asciidoctor/converter/template.rb +6 -3
- data/lib/asciidoctor/document.rb +25 -41
- data/lib/asciidoctor/extensions.rb +3 -3
- data/lib/asciidoctor/helpers.rb +38 -39
- data/lib/asciidoctor/inline.rb +1 -1
- data/lib/asciidoctor/load.rb +101 -101
- data/lib/asciidoctor/parser.rb +30 -25
- data/lib/asciidoctor/path_resolver.rb +35 -25
- data/lib/asciidoctor/reader.rb +14 -7
- data/lib/asciidoctor/rx.rb +722 -0
- data/lib/asciidoctor/substitutors.rb +61 -39
- data/lib/asciidoctor/syntax_highlighter.rb +22 -8
- data/lib/asciidoctor/syntax_highlighter/coderay.rb +1 -1
- data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +12 -4
- data/lib/asciidoctor/syntax_highlighter/prettify.rb +7 -4
- data/lib/asciidoctor/syntax_highlighter/pygments.rb +2 -3
- data/lib/asciidoctor/syntax_highlighter/rouge.rb +15 -7
- data/lib/asciidoctor/table.rb +52 -23
- data/lib/asciidoctor/version.rb +1 -1
- data/man/asciidoctor.1 +6 -6
- data/man/asciidoctor.adoc +4 -3
- metadata +10 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 63300fdec712603ef3bcd94f0ffefcf409471851030c9ef4884939da23b60303
|
4
|
+
data.tar.gz: b4fce4c962f9f62dd0ace6665ac53277529f00b17f49a5ec77c0fc1a01c4a6be
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f8864b33f6bd1aa4e0e425050de59ab7e193aab248df31968b61bf014c72d2e64cae8b89c8cda074c5b25f7fe7fe8c0adb7a9c1b237f4ebef8eaca337f4773d5
|
7
|
+
data.tar.gz: ef875df64d41583613ff6d333c1d8decf59ad7870768711e9405b4128505876d9a0a3dad904e559d03752d12cbc0665cd4aed40998ca95303af513bee55aaed5
|
data/CHANGELOG.adoc
CHANGED
@@ -13,6 +13,146 @@ endif::[]
|
|
13
13
|
This document provides a high-level view of the changes introduced in Asciidoctor by release.
|
14
14
|
For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
|
15
15
|
|
16
|
+
== 2.0.12.rc.1 (2020-11-10) - @mojavelinux
|
17
|
+
|
18
|
+
Bug Fixes::
|
19
|
+
|
20
|
+
* Set type and target property on unresolved footnote reference and unset id property (fixes regression) (#3825)
|
21
|
+
* Fix crash when inlining an SVG if the explicit width or height value on the image node is not a string (#3829)
|
22
|
+
* Reset word wrap behavior to normal on tables, then reenable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)
|
23
|
+
|
24
|
+
Improvements::
|
25
|
+
|
26
|
+
* Pass through role to DocBook output for inline image (#3832)
|
27
|
+
|
28
|
+
Compliance::
|
29
|
+
|
30
|
+
* Defer use of Ruby >= 2.3 constructs to restore compatibility with Ruby 2.0 until at least next minor release (#3827)
|
31
|
+
* Don't append the default px unit identifier to the explicit width or height value when inlining an SVG (#3829)
|
32
|
+
|
33
|
+
Build / Infrastructure::
|
34
|
+
|
35
|
+
* Migrate Linux CI jobs to GitHub Actions (#3837)
|
36
|
+
* Migrate Windows CI jobs to GitHub Actions (#3839)
|
37
|
+
* Run CI job on macOS (#3842)
|
38
|
+
|
39
|
+
== 2.0.11 (2020-11-02) - @mojavelinux
|
40
|
+
|
41
|
+
Bug Fixes::
|
42
|
+
|
43
|
+
* Fix infinite loop when callout list with obsolete syntax is found inside list item (#3472)
|
44
|
+
* Fix infinite loop when xreftext contains a circular reference path in HTML and manpage converters (#3543)
|
45
|
+
* Apply text formatting to table cells in implicit header row when column has the "a" or "l" style (#3760)
|
46
|
+
* Fix errant reference warning for valid reference when running in compat mode (#3555)
|
47
|
+
* Initialize backend traits for converter (if not previously initialized) using assigned basebackend; mimics Asciidoctor < 2 behavior (#3341)
|
48
|
+
* Set source_location on preamble block when sourcemap option is enabled (#3799)
|
49
|
+
* Link the notitle and showtitle attributes so they act as opposites for the same toggle (#3804)
|
50
|
+
* Pass options to constructor of Rouge lexer instead of #lex method; restores compatibility with Rouge >= 3.4 (#3336)
|
51
|
+
* Don't clobber cgi-style options on language when enabling start_inline option on the Rouge PHP lexer (#3336)
|
52
|
+
* Fix parsing of wrapped link and xref text, including when an attrlist signature is detected (#3331)
|
53
|
+
* Restore deprecated writable number property on AbstractBlock
|
54
|
+
* Always use title as xreftext if target block has an empty caption, regardless of xrefstyle value (#3745)
|
55
|
+
* Allow a bibliography reference to be used inside a footnote (#3325)
|
56
|
+
* Fix bottom margin collapsing on AsciiDoc table cell (#3370)
|
57
|
+
* Remove excess hard line break in multi-line AsciiMath blocks (#3407)
|
58
|
+
* Only strip trailing spaces from lines of AsciiDoc include file (#3436)
|
59
|
+
* Remove errant optional flag in regexp for menu macro that breaks Asciidoctor.js (#3433)
|
60
|
+
* Preserve repeating backslashes when generating manpage output (#3456)
|
61
|
+
* Honor percentage width specified on macro of inline SVG (#3464)
|
62
|
+
* Removing leading and trailing blank lines in AsciiDoc include file to match assumption of parser (#3470)
|
63
|
+
* Activate extensions when :extensions option is set even if Extensions API is not yet loaded (#3570)
|
64
|
+
* Don't activate global extensions if :extensions option is false (#3570)
|
65
|
+
* Escape ellipsis at start of line in manpage output (#3645) (*@jnavila*)
|
66
|
+
* Don't register footnote with ID if a footnote is already registered with that ID (#3690)
|
67
|
+
* Honor start attribute on ordered list in manpage output (#3714)
|
68
|
+
* Warn instead of crashing if SVG to inline is empty (#3638) (*@mogztter*)
|
69
|
+
* Compute highlight line ranges on source block relative to value of start attribute (#3519) (*@mogztter*)
|
70
|
+
* Prevent collapsible block from incrementing example number by assigning an empty caption (#3639)
|
71
|
+
* Use custom init function for highlight.js to select the correct `code` elements (#3761)
|
72
|
+
* Fix resolved value of :to_dir when both :to_file and :to_dir options are set to absolute paths (#3778)
|
73
|
+
* Fix crash if value of `stylesheets` attribute contains a folder and the destination directory for the stylesheet does not exist (even when the `:mkdirs` option is set) (#3808)
|
74
|
+
* Fix crash if value passed by API for `copycss` attribute is not a string (#3592)
|
75
|
+
* Restore label in front of each bibliography entry in DocBook output that was dropped by fix for #3085 (#3782)
|
76
|
+
* Apply max width to each top-level container instead of body in HTML output (#3513)
|
77
|
+
* Don't apply border-collapse: separate to HTML for table blocks; fixes double border at boundary of colspan/rowspan (#3793) (*@ahus1*)
|
78
|
+
* Don't remove right border on last table cell in row (#2563)
|
79
|
+
* Rework table borders to leverage border collapsing (apply frame border to table, grid border to cells, and selectively override border on cells to accommodate frame) (#3387)
|
80
|
+
|
81
|
+
Compliance::
|
82
|
+
|
83
|
+
* Add support for muted option to self-hosted video (#3408)
|
84
|
+
* Move style tag for convert-time syntax highlighters (coderay, rouge, pygments) into head (#3462)
|
85
|
+
* Move style tag for client-side syntax highlighters (highlight.js, prettify) into head (#3503)
|
86
|
+
* Define entry point API methods (load, convert, load_file, convert_file) as class methods instead of module_function to avoid conflict with Kernel.load (#3625)
|
87
|
+
* Retain attribute order on HTML code tag for source block to remain consistent with output from 1.5.x (#3786)
|
88
|
+
* Correct language code for Korean language file from kr to ko (#3807) (*@jnavila*)
|
89
|
+
|
90
|
+
Improvements::
|
91
|
+
|
92
|
+
* Apply word wrap (i.e., `word-wrap: anywhere`) to body in default stylesheet (#3544)
|
93
|
+
* Allow `nobreak` and `nowrap` roles to be used on any inline element (#3544)
|
94
|
+
* Add CSS class to support pre-wrap role to preserve leading, trailing, and repeating spaces in phrase (#3815)
|
95
|
+
* Preserve guard around XML-style callout when icons are not enabled (#3319)
|
96
|
+
* Use `.fam C` command to switch font family for verbatim blocks to monospaced text in manpage output (#3561)
|
97
|
+
* Remove redundant test for halign and valign attributes on table cell in DocBook converter
|
98
|
+
* Allow encoding of include file to be specified using encoding attribute (#3248)
|
99
|
+
* Allow template to be used to override outline by only specifying the outline template (#3491)
|
100
|
+
* Upgrade MathJax from 2.7.5 to 2.7.9
|
101
|
+
* Upgrade highlight.js from 9.15.10 to 9.18.3 (note that this increases script size from 48.8 KB to 71.5 KB)
|
102
|
+
* Skip unused default attribute assignments for embedded document
|
103
|
+
* Allow a URL macro to have a preceding single or double quote (#3376)
|
104
|
+
* Add support for erubi template engine; use it in place of erubis in test suite; note the use of erubis is deprecated (#3737)
|
105
|
+
* Download and embed remote custom stylesheet if allow-uri-read is set (#3765)
|
106
|
+
* Remove direction property from default stylesheet (#3753) (*@abdnh*)
|
107
|
+
* remove max width setting on content column for print media in default stylesheet (#3802)
|
108
|
+
* Normalize frame value "topbot" to "ends" in HTML output (consistently use frame-ends class) (#3797)
|
109
|
+
* Add role setter method on AbstractNode (#3614)
|
110
|
+
* Map chapter-signifier and part-signifier attributes in locale attribute files to replace chapter-label and part-label (#3817)
|
111
|
+
|
112
|
+
Build / Infrastructure::
|
113
|
+
|
114
|
+
* Run test suite on TruffleRuby nightly (*@mogztter*, *@erebor*)
|
115
|
+
* Upgrade TruffleRuby to 20.0.0 (*@mogztter*)
|
116
|
+
* Trigger upstream builds for AsciidoctorJ on Github Actions (*@robertpanzer*)
|
117
|
+
|
118
|
+
== 2.0.10 (2019-05-31) - @mojavelinux
|
119
|
+
|
120
|
+
Bug Fixes::
|
121
|
+
|
122
|
+
* fix Asciidoctor.convert_file to honor `header_footer: false` option when writing to file (#3316)
|
123
|
+
* fix placement of title on excerpt block (#3289)
|
124
|
+
* always pass same options to SyntaxHighlighter#docinfo, regardless of value of location argument
|
125
|
+
* fix signature of SyntaxHighlighter#docinfo method (#3300)
|
126
|
+
* when `icons` is set to `image`, enable image icons, but don't use it as the value of the `icontype` attribute (#3308)
|
127
|
+
|
128
|
+
== 2.0.9 (2019-04-30) - @mojavelinux
|
129
|
+
|
130
|
+
Bug Fixes::
|
131
|
+
|
132
|
+
* process multiple single-item menu macros in same line (#3279)
|
133
|
+
* register images in catalog correctly (#3283)
|
134
|
+
* rename AbstractNode#options method to AbstractNode#enabled_options so it doesn't get shadowed by Document#options (#3282)
|
135
|
+
* don't fail to convert document if alt attribute is not set on block or inline image (typically by an extension)
|
136
|
+
* fix lineno of source location on blocks that follow a detached list continuation (#3281)
|
137
|
+
* assume inline image type is "image" if not set (typically by an extension)
|
138
|
+
|
139
|
+
== 2.0.8 (2019-04-22) - @mojavelinux
|
140
|
+
|
141
|
+
Bug Fixes::
|
142
|
+
|
143
|
+
* restore background color applied to literal blocks by default stylesheet (#3258)
|
144
|
+
* use portability constants (CC_ALL, CC_ANY) in regular expressions defined in built-in converters (DocBook5 and ManPage)
|
145
|
+
* use portability constant (CC_ANY) in regular expression for custom inline macros
|
146
|
+
* use smarter margin collapsing for AsciiDoc table cell content; prevent passthrough content from being cut off (#3256)
|
147
|
+
* don't limit footnote ref to ASCII charset; allow any word character in Unicode to be used (#3269)
|
148
|
+
|
149
|
+
Improvements::
|
150
|
+
|
151
|
+
* register_for methods accept arguments as symbols (#3274)
|
152
|
+
* use Concurrent::Map instead of Concurrent::Hash in template converter
|
153
|
+
* use module_function keyword to define methods in Helpers
|
154
|
+
* move regular expression definitions to separate source file (internal change)
|
155
|
+
|
16
156
|
== 2.0.7 (2019-04-13) - @mojavelinux
|
17
157
|
|
18
158
|
Bug Fixes::
|
@@ -23,7 +163,10 @@ Bug Fixes::
|
|
23
163
|
Improvements::
|
24
164
|
|
25
165
|
* improve documentation for the `-a` CLI option; explain that `@` modifier can be placed at end of name as alternative to end of value
|
26
|
-
* move source for main API entry points (load, load_file, convert, convert_file) to separate files
|
166
|
+
* move source for main API entry points (load, load_file, convert, convert_file) to separate files (internal change)
|
167
|
+
* define main API entry points (load, load_file, convert, convert_file) as module functions
|
168
|
+
|
169
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
27
170
|
|
28
171
|
== 2.0.6 (2019-04-04) - @mojavelinux
|
29
172
|
|
@@ -38,6 +181,8 @@ Improvements::
|
|
38
181
|
* implement Helpers.extname as a more efficient and flexible File.extname method
|
39
182
|
* check for AsciiDoc file extension using end_with? instead of resolving the extname and using a lookup
|
40
183
|
|
184
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
185
|
+
|
41
186
|
== 2.0.5 (2019-04-01) - @mojavelinux
|
42
187
|
|
43
188
|
Bug Fixes::
|
@@ -48,6 +193,8 @@ Bug Fixes::
|
|
48
193
|
* mark encoding of stdio objects used in CLI as UTF-8 (#3225)
|
49
194
|
* make Asciidoctor::SyntaxHighlighter::Config.register_for method public as documented
|
50
195
|
|
196
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
197
|
+
|
51
198
|
== 2.0.4 (2019-03-31) - @mojavelinux
|
52
199
|
|
53
200
|
Bug Fixes::
|
@@ -58,6 +205,8 @@ Bug Fixes::
|
|
58
205
|
* move Asciidoctor::Converter::BackendTraits.derive_backend_traits method to Asciidoctor::Converter
|
59
206
|
* mark render and render_file methods as deprecated in API docs
|
60
207
|
|
208
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
209
|
+
|
61
210
|
== 2.0.3 (2019-03-28) - @mojavelinux
|
62
211
|
|
63
212
|
Bug Fixes::
|
@@ -65,6 +214,8 @@ Bug Fixes::
|
|
65
214
|
* fix crash when attrlist is used on literal monospace phrase (#3216)
|
66
215
|
* update use of magic regexp variables to fix compatibility with Opal / Asciidoctor.js (#3214)
|
67
216
|
|
217
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
218
|
+
|
68
219
|
== 2.0.2 (2019-03-26) - @mojavelinux
|
69
220
|
|
70
221
|
Bug Fixes::
|
@@ -72,6 +223,8 @@ Bug Fixes::
|
|
72
223
|
* apply verbatim substitutions to literal paragraphs attached to list item (#3205)
|
73
224
|
* implement #lines and #source methods on Table::Cell based on cell text (#3207)
|
74
225
|
|
226
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
227
|
+
|
75
228
|
== 2.0.1 (2019-03-25) - @mojavelinux
|
76
229
|
|
77
230
|
Bug Fixes::
|
@@ -87,13 +240,15 @@ Build / Infrastructure::
|
|
87
240
|
|
88
241
|
* bundle .yardopts in RubyGem (#3193)
|
89
242
|
|
243
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
244
|
+
|
90
245
|
== 2.0.0 (2019-03-22) - @mojavelinux
|
91
246
|
|
92
247
|
Enhancements / Compliance::
|
93
248
|
|
94
249
|
* drop support for Ruby < 2.3 and JRuby < 9.1 and remove workarounds (#2764)
|
95
250
|
* drop support for Slim < 3 (#2998)
|
96
|
-
* drop the converter for the docbook45 backend (#3005)
|
251
|
+
* drop the converter for the docbook45 backend from core; moved to https://github.com/asciidoctor/asciidoctor-docbook45 (#3005)
|
97
252
|
* apply substitutions to section and block titles in normal substitution order (#1173)
|
98
253
|
* make syntax highlighter pluggable; extract all logic into adapter classes (#2106)
|
99
254
|
* add syntax highlighter adapter for Rouge (#1040)
|
@@ -129,6 +284,7 @@ Enhancements / Compliance::
|
|
129
284
|
* use the third argument of AbstractNode#attr / AbstractNode#attr? to set the name of a fallback attribute to look for on the document (#1934)
|
130
285
|
* change default value of third argument to Abstractnode#attr / AbstractNode#attr? to nil so attribute doesn't inherit by default (#3059)
|
131
286
|
* look for table-frame, table-grid, and table-stripes attributes on document as fallback for frame, grid, and stripes attributes on table (#3059)
|
287
|
+
* add support for hover mode for table stripes (stripes=hover) (#3110)
|
132
288
|
* always assume the target of a shorthand interdocument xref is a reference to an AsciiDoc document (source-to-source) (#3021)
|
133
289
|
* if the target of a formal xref macro has a file extension, assume it's a path reference (#3021)
|
134
290
|
* never assume target of a formal xref macro is a path reference unless a file extension or fragment is present (#3021)
|
@@ -181,6 +337,7 @@ Improvements::
|
|
181
337
|
* value comparison in AbstractNode#attr? is only performed if expected value is truthy
|
182
338
|
* align default CodeRay style with style for other syntax highlighters (#2106)
|
183
339
|
* ensure linenos class is added to linenos column when source highlighter is pygments and pygments-css=style
|
340
|
+
* disable table stripes by default (#3110)
|
184
341
|
* rename CSS class of Pygments line numbering table to linenotable (to align with Rouge) (#1040)
|
185
342
|
* remove unused Converter#convert_with_options method (#2891)
|
186
343
|
* add -e, --embedded CLI flag as alias for -s, --no-header-footer (require long option to specify eRuby impl) (#1444)
|
@@ -254,7 +411,8 @@ Build / Infrastructure::
|
|
254
411
|
* exclude test suite, build script, and Gemfile from gem (#3044)
|
255
412
|
* split build tasks out into individual files
|
256
413
|
|
257
|
-
|
414
|
+
Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
|
415
|
+
|
258
416
|
== 1.5.8 (2018-10-28) - @mojavelinux
|
259
417
|
|
260
418
|
Enhancements::
|
@@ -279,6 +437,7 @@ Enhancements::
|
|
279
437
|
* add support for start attribute on source block to set starting line number when converting to DocBook (#2915)
|
280
438
|
* track imagesdir for image on node and in catalog (#2779)
|
281
439
|
* allow starting line number to be set using start attribute when highighting source block with Pygments or CodeRay (#1742)
|
440
|
+
* add intrinsic attribute named `pp` that effectively resolves to `++` (#2807)
|
282
441
|
* upgrade highlight.js to 9.13.1
|
283
442
|
|
284
443
|
Bug Fixes::
|
@@ -343,7 +502,6 @@ Documentation::
|
|
343
502
|
Build / Infrastructure::
|
344
503
|
|
345
504
|
* replace thread_safe with concurrent-ruby (PR #2822) (*@junaruga*)
|
346
|
-
// end::compact[]
|
347
505
|
|
348
506
|
== 1.5.7.1 (2018-05-10) - @mojavelinux
|
349
507
|
|
@@ -364,6 +522,11 @@ Enhancements::
|
|
364
522
|
|
365
523
|
* BREAKING: drop XML tags, character refs, and non-word characters (except hyphen, dot, and space) when auto-generating section IDs (#794)
|
366
524
|
** hyphen, dot, and space are replaced with value of idseparator, if set; otherwise, spaces are dropped
|
525
|
+
* BREAKING: disable interdocument xrefs in compat mode (#2740)
|
526
|
+
* BREAKING: automatically parse attributes in link macro if equals is present, ignoring linkattrs (except in compat mode) (#2059)
|
527
|
+
* pass non-AsciiDoc file extensions in target of xref through unprocessed (#2740)
|
528
|
+
* process any known AsciiDoc file extension in target of shorthand interdocument xref if hash is also present (e.g., `<<target.asciidoc#,text>>`) (#2740)
|
529
|
+
* only allow .adoc to be used in target of formal xref macro to create an interdocument xref (with or without a hash) (#2740)
|
367
530
|
* allow attribute names to contain any word character defined by Unicode (#2376, PR #2393)
|
368
531
|
* do not recognize attribute entry line if name contains a colon (PR #2377)
|
369
532
|
* route all processor messages through a logger instead of using Kernel#warn (#44, PR #2660)
|
@@ -483,7 +646,6 @@ Improvements / Refactoring::
|
|
483
646
|
* move callouts into document catalog (PR #2394)
|
484
647
|
* document ID defined in block attribute line takes precedence over ID defined inside document title line
|
485
648
|
* don't look for link and window attributes on document when resolving these attributes for an image
|
486
|
-
* when linkattrs is set, only parse attributes in link macro if equals is present
|
487
649
|
* skip line comments in name section of manpage (#2584, PR #2585)
|
488
650
|
* always activate extension registry passed to processor (PR #2379)
|
489
651
|
* skip extension registry activation if no groups are registered (PR #2373)
|
@@ -860,7 +1022,7 @@ Enhancements::
|
|
860
1022
|
* Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (#1721) (*@JojoBoulix*)
|
861
1023
|
* Add reversed attribute to ordered list if reversed option is enabled (#1830)
|
862
1024
|
* Add support for additional docinfo locations (e.g., :header)
|
863
|
-
* Configure default stylesheet to break monospace word if exceeds length of line
|
1025
|
+
* Configure default stylesheet to break monospace word if exceeds length of line using `word-wrap: break-word`; add `nobreak` and `nowrap` roles to prevent breaks (#1814)
|
864
1026
|
* Introduce translation file for built-in labels (*@ciampix*)
|
865
1027
|
* Provide translations for built-in labels (*@JmyL* - kr, *@ciampix* - it, *@ivannov* - bg, *@maxandersen* - da, *@radcortez* - pt, *@eddumelendez* - es, *@leathersole* - jp, *@aslakknutsen* - no, *@shahryareiv* - fa, *@AlexanderZobkov* - ru, *@dongwq* - zh, *@rmpestano* - pt_BR, *@ncomet* - fr, *@lgvz* - fi, *@patoi* - hu, *@BojanStipic* - sr, *@fwilhe* - de, *@rahmanusta* - tr, *@abelsromero* - ca, *@aboullaite* - ar, *@roelvs* - nl)
|
866
1028
|
* Translate README to Chinese (*@diguage*)
|
@@ -1114,7 +1276,7 @@ Improvements::
|
|
1114
1276
|
* define JAVASCRIPT_PLATFORM constant to simplify conditional logic in the JavaScript environment (#897)
|
1115
1277
|
* provide access to destination directory, outfile and outdir via Document object (#1203)
|
1116
1278
|
* print encoding information in version report produced by `asciidoctor -v` (#1210)
|
1117
|
-
* add intrinsic attribute named `cpp`
|
1279
|
+
* add intrinsic attribute named `cpp` that effectively resolves to `C++` (#1208)
|
1118
1280
|
* preserve URI targets passed to `stylesheet` and related attributes (#1192)
|
1119
1281
|
* allow numeric characters in block attribute name (#1103)
|
1120
1282
|
* support custom YouTube playlists (#1105)
|
data/LICENSE
CHANGED
@@ -1,6 +1,7 @@
|
|
1
1
|
MIT License
|
2
2
|
|
3
|
-
Copyright (C) 2012-
|
3
|
+
Copyright (C) 2012-2020 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
2
|
Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
|
3
|
-
v2.0.
|
3
|
+
v2.0.12, 2020-11-10
|
4
4
|
// settings:
|
5
5
|
:idprefix:
|
6
6
|
:idseparator: -
|
@@ -8,7 +8,6 @@ v2.0.7, 2019-04-13
|
|
8
8
|
:language: {source-language}
|
9
9
|
ifndef::env-github[:icons: font]
|
10
10
|
ifdef::env-github[]
|
11
|
-
:status:
|
12
11
|
:outfilesuffix: .adoc
|
13
12
|
:caution-caption: :fire:
|
14
13
|
:important-caption: :exclamation:
|
@@ -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.12
|
21
20
|
// URIs:
|
22
21
|
:uri-org: https://github.com/asciidoctor
|
23
22
|
:uri-repo: {uri-org}/asciidoctor
|
@@ -40,7 +39,7 @@ endif::[]
|
|
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:
|
42
|
+
:uri-discuss: https://discuss.asciidoctor.org
|
44
43
|
:uri-irc: irc://irc.freenode.org/#asciidoctor
|
45
44
|
:uri-rubygem: https://rubygems.org/gems/asciidoctor
|
46
45
|
:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
|
@@ -84,15 +83,6 @@ endif::[]
|
|
84
83
|
* {uri-docs}/user-manual[Asciidoctor Gebrauchshandbuch]
|
85
84
|
* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax-Referenz]
|
86
85
|
|
87
|
-
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&passingText=green%20bar&failingText=%23fail&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"]
|
94
|
-
endif::[]
|
95
|
-
|
96
86
|
== Sponsoren
|
97
87
|
|
98
88
|
Wir möchten unseren großzügigen Sponsoren danken, ohne deren Unterstützung Asciidoctor nicht möglich wäre.
|
@@ -453,14 +443,14 @@ Asciidoctor Organization auf GitHub:: {uri-org}
|
|
453
443
|
|
454
444
|
== Lizenz
|
455
445
|
|
456
|
-
Copyright (C) 2012-
|
446
|
+
Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, und die einzelnen Mitarbeiter von Asciidoctor.
|
457
447
|
Die Nutzung dieser Software wird unter den Bedingungen der MIT-Lizenz gewährt.
|
458
448
|
|
459
449
|
Siehe die {uri-license}[LIZENZ] für den vollen Lizenztext.
|
460
450
|
|
461
451
|
== Authoren
|
462
452
|
|
463
|
-
*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
|
453
|
+
*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.
|
464
454
|
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].
|
465
455
|
|
466
456
|
*AsciiDoc* wurde von Stuart Rackham gegründet und hat Beiträge von vielen Personen aus der AsciiDoc-Community erhalten.
|
data/README-fr.adoc
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
= Asciidoctor
|
2
2
|
Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
|
3
|
-
v2.0.
|
3
|
+
v2.0.12, 2020-11-10
|
4
4
|
// settings:
|
5
5
|
:idprefix:
|
6
6
|
:idseparator: -
|
@@ -8,7 +8,6 @@ v2.0.7, 2019-04-13
|
|
8
8
|
:language: {source-language}
|
9
9
|
ifndef::env-github[:icons: font]
|
10
10
|
ifdef::env-github[]
|
11
|
-
:status:
|
12
11
|
:outfilesuffix: .adoc
|
13
12
|
:caution-caption: :fire:
|
14
13
|
:important-caption: :exclamation:
|
@@ -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.12
|
21
20
|
// URIs:
|
22
21
|
:uri-org: https://github.com/asciidoctor
|
23
22
|
:uri-repo: {uri-org}/asciidoctor
|
@@ -40,7 +39,7 @@ endif::[]
|
|
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:
|
42
|
+
:uri-discuss: https://discuss.asciidoctor.org
|
44
43
|
:uri-irc: irc://irc.freenode.org/#asciidoctor
|
45
44
|
:uri-rubygem: https://rubygems.org/gems/asciidoctor
|
46
45
|
:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
|
@@ -81,15 +80,6 @@ endif::[]
|
|
81
80
|
* {uri-docs}/asciidoc-syntax-quick-reference[Syntaxe de Référence AsciiDoc]
|
82
81
|
* {uri-docs}/user-manual[Manuel Utilisateur Asciidoctor]
|
83
82
|
|
84
|
-
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&passingText=green%20bar&failingText=%23fail&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"]
|
91
|
-
endif::[]
|
92
|
-
|
93
83
|
== Sponsors
|
94
84
|
|
95
85
|
Nous souhaitons exprimer toute notre reconnaissance à nos généreux sponsors, sans qui Asciidoctor ne pourrait pas exister.
|
@@ -422,7 +412,7 @@ L'organisation Asciidoctor sur GitHub:: {uri-org}
|
|
422
412
|
|
423
413
|
== Licence
|
424
414
|
|
425
|
-
Copyright (C) 2012-
|
415
|
+
Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
|
426
416
|
Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
|
427
417
|
|
428
418
|
Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
|
data/README-jp.adoc
CHANGED
@@ -1,15 +1,13 @@
|
|
1
1
|
= Asciidoctor
|
2
2
|
Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>; Ryan Waldron <https://github.com/erebor[@erebor]>
|
3
|
-
v2.0.
|
3
|
+
v2.0.12, 2020-11-10
|
4
4
|
// settings:
|
5
|
-
:page-layout: base
|
6
5
|
:idprefix:
|
7
6
|
:idseparator: -
|
8
7
|
:source-language: ruby
|
9
8
|
:language: {source-language}
|
10
9
|
ifndef::env-github[:icons: font]
|
11
10
|
ifdef::env-github[]
|
12
|
-
:status:
|
13
11
|
:outfilesuffix: .adoc
|
14
12
|
:caution-caption: :fire:
|
15
13
|
:important-caption: :exclamation:
|
@@ -18,13 +16,17 @@ ifdef::env-github[]
|
|
18
16
|
:warning-caption: :warning:
|
19
17
|
endif::[]
|
20
18
|
// Variables:
|
21
|
-
:release-version: 2.0.
|
19
|
+
:release-version: 2.0.12
|
22
20
|
// URIs:
|
23
21
|
:uri-org: https://github.com/asciidoctor
|
24
22
|
:uri-repo: {uri-org}/asciidoctor
|
25
23
|
:uri-asciidoctorj: {uri-org}/asciidoctorj
|
26
24
|
:uri-asciidoctorjs: {uri-org}/asciidoctor.js
|
25
|
+
:uri-gradle-plugin: {uri-org}/asciidoctor-gradle-plugin
|
26
|
+
:uri-maven-plugin: {uri-org}/asciidoctor-maven-plugin
|
27
|
+
:uri-asciidoclet: {uri-org}/asciidoclet
|
27
28
|
:uri-project: https://asciidoctor.org
|
29
|
+
:uri-gem: https://rubygems.org/gems/asciidoctor
|
28
30
|
ifdef::env-site[:uri-project: link:]
|
29
31
|
:uri-docs: {uri-project}/docs
|
30
32
|
:uri-news: {uri-project}/news
|
@@ -33,7 +35,7 @@ ifdef::env-site[:uri-project: link:]
|
|
33
35
|
:uri-contributors: {uri-repo}/graphs/contributors
|
34
36
|
:uri-rel-file-base: link:
|
35
37
|
:uri-rel-tree-base: link:
|
36
|
-
ifdef::env-site[]
|
38
|
+
ifdef::env-site,env-yard[]
|
37
39
|
:uri-rel-file-base: {uri-repo}/blob/master/
|
38
40
|
:uri-rel-tree-base: {uri-repo}/tree/master/
|
39
41
|
endif::[]
|
@@ -41,85 +43,92 @@ endif::[]
|
|
41
43
|
:uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
|
42
44
|
:uri-license: {uri-rel-file-base}LICENSE
|
43
45
|
:uri-tests: {uri-rel-tree-base}test
|
44
|
-
:uri-discuss:
|
46
|
+
:uri-discuss: https://discuss.asciidoctor.org
|
45
47
|
:uri-irc: irc://irc.freenode.org/#asciidoctor
|
46
48
|
:uri-rubygem: https://rubygems.org/gems/asciidoctor
|
47
49
|
:uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
|
48
50
|
:uri-user-manual: {uri-docs}/user-manual
|
49
51
|
:uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor
|
50
52
|
//:uri-install-doc: {uri-docs}/install-toolchain
|
51
|
-
:uri-install-
|
52
|
-
:uri-
|
53
|
+
:uri-install-macos-doc: {uri-docs}/install-asciidoctor-macos
|
54
|
+
:uri-convert-doc: {uri-docs}/convert-documents
|
53
55
|
:uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
|
54
56
|
:uri-gitscm-repo: https://github.com/git/git-scm.com
|
55
57
|
:uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
|
56
58
|
:uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
|
57
59
|
:uri-foundation: https://foundation.zurb.com
|
60
|
+
:uri-opal: https://opalrb.com
|
58
61
|
:uri-tilt: https://github.com/rtomayko/tilt
|
59
|
-
:uri-ruby: https://ruby-lang.org
|
62
|
+
:uri-ruby: https://www.ruby-lang.org
|
60
63
|
// images:
|
61
64
|
:image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
|
62
65
|
|
63
|
-
{uri-project}
|
64
|
-
AsciidoctorはRubyで書かれており,
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
66
|
+
{uri-project}[Asciidoctor]は, {uri-what-is-asciidoc}[AsciiDoc] で書かれたコンテンツをHTML5, DocBook, PDFなどのフォーマットに変換する, _高速で_ {uri-license}[オープンソース] のテキストプロセッサおよびパブリッシングツールチェインです.
|
67
|
+
AsciidoctorはRubyで書かれており, すべての主要オペレーティングシステムで動作します.
|
68
|
+
Asciidoctorプロジェクトは {uri-repo}[GitHubにホスティング] されています.
|
69
|
+
|
70
|
+
インストールをシンプルにするため, AsciidoctorはRubyGem(gem)パッケージとして, {uri-rubygem}[RubyGems.org] で配布されています.
|
71
|
+
さらに, Asciidoctorは主要なLinuxディストリビューション用およびmacOS用パッケージとしても配布されています.
|
72
|
+
AsciidctorはRubyで動作するだけでなく, {uri-asciidoctorj}[AsciidoctorJ]としてJVM上でも動作します. また, {uri-asciidoctorjs}[Asciidoctor.js]としてどのようなJavaScript環境(ブラウザを含む)でも実行できます.
|
73
|
+
|
74
|
+
ifndef::env-site,env-yard[]
|
75
|
+
このドキュメントには以下の言語版が存在します: +
|
76
|
+
{uri-rel-file-base}README.adoc[English]
|
77
|
+
|
|
78
|
+
{uri-rel-file-base}README-zh_CN.adoc[汉语]
|
79
|
+
|
|
80
|
+
{uri-rel-file-base}README-de.adoc[Deutsch]
|
81
|
+
|
|
82
|
+
{uri-rel-file-base}README-fr.adoc[Français]
|
74
83
|
endif::[]
|
75
84
|
|
76
|
-
|
85
|
+
.主なドキュメント
|
77
86
|
[.compact]
|
78
87
|
* {uri-docs}/what-is-asciidoc[What is AsciiDoc?]
|
79
88
|
* {uri-docs}/asciidoc-writers-guide[AsciiDoc Writer's Guide]
|
80
|
-
* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
|
81
89
|
* {uri-docs}/user-manual[Asciidoctor User Manual]
|
90
|
+
* {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
|
82
91
|
|
83
|
-
|
84
|
-
****
|
85
|
-
AsciidoctorはJRubyを用いてJVM上でも実行できます.
|
86
|
-
Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには, {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
|
87
|
-
AsciidoctorJに基づいた, AsciidoctorプロセッサをApache Maven, GradleやJavadocに統合するプラグインがあります.
|
92
|
+
== スポンサー
|
88
93
|
|
89
|
-
|
90
|
-
|
91
|
-
Asciidoctor
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
image:https://img.shields.io/travis/asciidoctor/asciidoctor/master.svg[Build Status (Travis CI), link=https://travis-ci.org/asciidoctor/asciidoctor]
|
97
|
-
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]
|
98
|
-
//image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
|
99
|
-
image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
|
100
|
-
image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
|
101
|
-
endif::[]
|
94
|
+
{uri-project}/supporters[スポンサー] のみなさまが, このプロジェクトをサポートし, より良いテクニカルドキュメンテーションの実現にコミットメントをしてくださっていることに感謝します.
|
95
|
+
スポンサーのみなさま, ありがとうございます!
|
96
|
+
みなさまの多くのサポートなくしてAsciidoctorは実現不可能です.
|
97
|
+
|
98
|
+
https://opencollective.com/asciidoctor[OpenCollective] を通じてスポンサーになることにより, このプロジェクトを支援することができます.
|
99
|
+
|
100
|
+
== 全体像
|
102
101
|
|
103
|
-
|
102
|
+
Asciidoctorは, 下図左側のようなプレーンテキストを読み込んで, 右側のようなHTML5に変換します.
|
103
|
+
特別な設定をしなくてもきれいな表示が得られるよう, HTML5の出力にはデフォルトのスタイルシートが適用されます.
|
104
104
|
|
105
|
-
|
106
|
-
Asciidoctorは枠にとらわれない快適なエクスペリエンスのためにデフォルトスタイルシートをHTML 5ドキュメントに適用します.
|
105
|
+
image::{image-uri-screenshot}[AsciiDocソースとレンダリングされたHTMLのプレビュー]
|
107
106
|
|
108
|
-
|
107
|
+
== AsciiDocの処理
|
109
108
|
|
110
|
-
|
111
|
-
|
112
|
-
生成された出力をカスタマイズ, あるいは追加のフォーマットをつくるためにあなた自身のコンバータを使うことや {uri-tilt}[Tilt]-supported テンプレートを読み込むオプションがあります.
|
109
|
+
Asciidoctorは, AsciiDoc文法で書かれたテキストを読み込んでパースします. 次に内蔵コンバータにパースツリーを渡します. これによりHTML5, DocBook 5やman(マニュアルmanページ)が出力されます.
|
110
|
+
出力をカスタマイズしたりフォーマットを追加したりしたいときは, ユーザ独自のコンバータや {uri-tilt}[Tilt] 対応テンプレートを使用することができます.
|
113
111
|
|
114
|
-
|
115
|
-
Asciidoctor
|
112
|
+
AsciidoctorはオリジナルのAsciiDoc Pythonプロセッサ(`asciidoc.py`)に完全互換です.
|
113
|
+
Asciidoctorのテストスイートには, AsciiDoc文法との互換性を保証するために {uri-tests}[2350個を超えるテスト] が入っています.
|
116
114
|
|
117
|
-
|
118
|
-
Asciidoctor
|
115
|
+
Asciidoctorでは, AsciiDocの従来の文法のほかに, Asciidoctorで追加されたマークアップとフォーマッティングオプションが使用できます. フォントベースのアイコン (例えば, `+icon:fire[]+`) やUIエレメント(`+button:[Save]+`)がそれにあたります.
|
116
|
+
またAsciidoctorは, HTML5出力時のスタイルとして {uri-foundation}[Foundation] に基づいたモダンでレスポンシブなテーマも提供します.
|
119
117
|
|
120
|
-
==
|
118
|
+
== RubyのあるところAsciidoctorも動く
|
121
119
|
|
122
|
-
Asciidoctorは
|
120
|
+
AsciidoctorはJRubyを用いてJVM上でも実行できます.
|
121
|
+
Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには, {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
|
122
|
+
AsciidoctorJを使ったAsciiDocの処理をビルドに直接組み込むビルドツール用プラグインとして, {uri-maven-plugin}[Apache Maven用], {uri-gradle-plugin}[Gradle用], および {uri-asciidoclet}[Javadoc用] が存在します.
|
123
|
+
|
124
|
+
AsciidoctorはJavaScriptでも実行可能です.
|
125
|
+
Rubyで書かれたソースを {uri-opal}[Opal] を使ってJavaScriptにトランスパイルすることで {uri-asciidoctorjs}[Asciidoctor.js] が作成されています.
|
126
|
+
Asciidoctor.jsはどんなJavaScript環境(WebブラウザやNode.jsを含む)でも動作する, JavaScript版の完全なAsciidoctorです.
|
127
|
+
Chrome, Atom, Bracketsやその他のウェブベースのツールで, AsciiDocをプレビューするための拡張機能にAsciidoctor.jsが使われています.
|
128
|
+
|
129
|
+
== 必要条件
|
130
|
+
|
131
|
+
AsciidoctorはLinux, macOS, およびWindowsで動作し, 下記の {uri-ruby}[Ruby]実装の一つを必要とします.
|
123
132
|
|
124
133
|
* CRuby (aka MRI) 2.3 - 2.6
|
125
134
|
* JRuby 9.1 - 9.2
|
@@ -128,58 +137,121 @@ AsciidoctorはLinux, OS X (Mac)とWindowsで動き, 下記の {uri-ruby}[Ruby]
|
|
128
137
|
|
129
138
|
[CAUTION]
|
130
139
|
====
|
131
|
-
もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError`
|
132
|
-
|
140
|
+
もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError` に遭遇するかもしれません.
|
141
|
+
これを解決するには, 以下のコマンドにより, 使っているコンソールの有効なコードページをUTF-8に変更することを推奨します:
|
133
142
|
|
134
143
|
chcp 65001
|
135
144
|
|
136
|
-
に変更することを推奨します.
|
137
145
|
一度この変更をすると, Unicode関連の頭痛の種は消えるでしょう.
|
138
146
|
もしEclipseのようなIDEを使っているなら, 同様にエンコーディングをUTF-8にするのを忘れないでください.
|
139
|
-
AsciidoctorはUTF-8
|
147
|
+
AsciidoctorはUTF-8の環境において最も良好に動作します.
|
140
148
|
====
|
141
149
|
|
142
|
-
==
|
150
|
+
== インストール
|
143
151
|
|
144
|
-
Asciidoctor
|
152
|
+
Asciidoctorは, (a) 主なLinuxディストリビューションのパッケージマネージャ, (b) macOSのHomebrew, (c) `gem install` コマンド(Windowsユーザに推奨), (d) Asciidoctor Dockerイメージ, あるいは(e) Bundlerを用いてインストールできます.
|
145
153
|
|
146
|
-
|
147
|
-
欠点はgemのリリース直後にはすぐには有効にならないことです.
|
148
|
-
もし最新バージョンを使いたければ, 必ず `gem` コマンドを使いましょう.
|
154
|
+
Linuxパッケージマネージャを用いてインストールする利点は, もしRubyやRubyGemsライブラリがまだインストールされていなかったら, それらをインストールしてくれることです.
|
149
155
|
|
150
|
-
=== (a)
|
156
|
+
=== (a) Linuxのパッケージマネージャ
|
151
157
|
|
152
|
-
|
158
|
+
パッケージマネージャによってインストールされるAsciidoctorは最新バージョンではないかもしれません.
|
159
|
+
ディストリビューションの各リリースにおいてどのバージョンのAsciidoctorがパッケージされているかを確認するには, パッケージリポジトリを参照してください.
|
153
160
|
|
154
|
-
|
161
|
+
* https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
|
162
|
+
* https://www.archlinux.org/packages/?name=asciidoctor[Arch Linux (asciidoctor)]
|
163
|
+
* https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
|
164
|
+
* https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (asciidoctor)]
|
165
|
+
* https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
|
166
|
+
* https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
|
155
167
|
|
156
|
-
|
168
|
+
パッケージマネージャによってインストールされるバージョンよりも新しいAsciidoctorを使用したい場合は, <<gem-install,gemのインストール方法>> を参照してください.
|
157
169
|
|
158
|
-
|
170
|
+
==== apk (Alpine Linux)
|
159
171
|
|
160
|
-
|
161
|
-
[TIP]
|
162
|
-
====
|
163
|
-
もしAsciidoctorの以前のバージョンがインストール済みであれば, 以下によってアップデートできます:
|
172
|
+
Alpine Linuxにgemをインストールするには, ターミナルを開き, 以下を入力してください:
|
164
173
|
|
165
|
-
$
|
174
|
+
$ sudo apk add asciidoctor
|
166
175
|
|
167
|
-
|
168
|
-
そのときは, 以下のgemコマンドで古いバージョンを削除しましょう:
|
176
|
+
==== pacman (Arch Linux)
|
169
177
|
|
170
|
-
|
171
|
-
|
178
|
+
Archベースのディストリビューションにgemをインストールするには, ターミナルを開き, 以下を入力してください:
|
179
|
+
|
180
|
+
$ sudo pacman -S asciidoctor
|
181
|
+
|
182
|
+
==== APT
|
183
|
+
|
184
|
+
Debian, またはUbuntuなどDebianベースのディストリビューションでは, APTを使ってAsciidoctorをインストールしてください.
|
185
|
+
Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
|
186
|
+
|
187
|
+
$ sudo apt-get install -y asciidoctor
|
188
|
+
|
189
|
+
==== DNF
|
190
|
+
|
191
|
+
Fedora, CentOS, RHELなどRPMベースのLinuxディストリビューションでは, DNFパッケージマネージャを使ってAsciidoctorをインストールしてください.
|
192
|
+
Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
|
193
|
+
|
194
|
+
$ sudo dnf install -y asciidoctor
|
195
|
+
|
196
|
+
=== (b) Homebrew (macOS)
|
197
|
+
|
198
|
+
macOSでは, パッケージマネージャHomebrewを使用してAsciidoctorをインストールすることができます.
|
199
|
+
Homebrewをお持ちでない場合は, まず https://brew.sh/[brew.sh] の説明に従ってHomebrewをインストールしてください.
|
200
|
+
Homebrewをインストールできたら, `asciidoctor` gemをインストールすることができます.
|
201
|
+
ターミナルを開き, 以下を入力してください:
|
202
|
+
|
203
|
+
$ brew install asciidoctor
|
204
|
+
|
205
|
+
Homebrewにより, システムレベルのgemとは別の独立したprefixのパスに `asciidoctor` gemがインストールされます.
|
206
|
+
|
207
|
+
=== (c) Windows
|
208
|
+
|
209
|
+
WindowsでAsciidoctorを使う場合は, 簡単な方法が2つあります.
|
210
|
+
|
211
|
+
==== Chocolatey
|
172
212
|
|
173
|
-
|
213
|
+
すでにお使いのマシンで https://chocolatey.org[chocolatey] を使用しているなら, 以下の方法を使用することができます:
|
174
214
|
|
175
|
-
|
215
|
+
[source]
|
216
|
+
----
|
217
|
+
choco install ruby
|
218
|
+
----
|
219
|
+
|
220
|
+
そのあとは <<gem-install,gemのインストール方法>> に従ってください.
|
221
|
+
|
222
|
+
==== Rubyinstaller
|
223
|
+
|
224
|
+
https://rubyinstaller.org/downloads/[Rubyinstaller] を使用したい場合は, お使いのWindowsのバージョンに適したRubyinstallerをダウンロードしてRubyをインストールしたあと, <<gem-install,gemのインストール方法>> に従ってください.
|
225
|
+
|
226
|
+
[#gem-install]
|
227
|
+
=== (d) gem install
|
228
|
+
|
229
|
+
Asciidoctorを `gem install` を使ってインストールするのであれば, その前に https://rvm.io[RVM] を使ってhomeディレクトリ(つまりユーザ領域)にRubyをインストールしておくべきです.
|
230
|
+
そうすれば, `gem` コマンドを使用して安全にAsciidoctor gemのインストールやアップデートができます.
|
231
|
+
RVMを使用すると, システムから隔離された場所にgemがインストールされます.
|
232
|
+
|
233
|
+
ターミナルを開き, 以下のように入力してください:
|
234
|
+
|
235
|
+
$ gem install asciidoctor
|
236
|
+
|
237
|
+
もし, 先行リリースバージョン(例えばリリース候補版)をインストールしたければ以下のようにします.
|
238
|
+
|
239
|
+
$ gem install asciidoctor --pre
|
240
|
+
|
241
|
+
=== (e) Docker
|
242
|
+
|
243
|
+
{uri-install-docker}[Installing Asciidoctor using Docker]を参照してください.
|
244
|
+
|
245
|
+
=== (f) Bundler
|
246
|
+
|
247
|
+
. プロジェクトのルートフォルダ(またはカレントディレクトリ)にGemfileを作成
|
176
248
|
. `asciidoctor` gemをGemfileに以下のように追加:
|
177
249
|
+
|
178
250
|
[source,subs=attributes+]
|
179
251
|
----
|
180
252
|
source 'https://rubygems.org'
|
181
253
|
gem 'asciidoctor'
|
182
|
-
#
|
254
|
+
# または明示的にバージョンを指定
|
183
255
|
# gem 'asciidoctor', '{release-version}'
|
184
256
|
----
|
185
257
|
|
@@ -189,111 +261,89 @@ gem 'asciidoctor'
|
|
189
261
|
$ bundle
|
190
262
|
|
191
263
|
gemをアップグレードするには, Gemfileで新バージョンを指定し, `bundle` を再び実行してください.
|
192
|
-
`bundle update`
|
193
|
-
|
194
|
-
=== (c) Linux package managers
|
264
|
+
`bundle update` を(gemを指定せずに)行うことは推奨 *されません* . 他のgemもアップデートされて思わぬ結果になるかもしれないためです.
|
195
265
|
|
196
|
-
|
266
|
+
== アップグレード
|
197
267
|
|
198
|
-
|
268
|
+
オペレーティングシステムのパッケージマネージャでAsciidoctorをインストールしたのであれば, おそらくパッケージは自動的にアップデートされるように設定されています. その場合は, gemを手動でアップデートする必要はありません.
|
199
269
|
|
200
|
-
|
201
|
-
|
202
|
-
gemをアップグレードするには:
|
203
|
-
|
204
|
-
$ sudo dnf update -y asciidoctor
|
205
|
-
|
206
|
-
TIP: お使いのシステムは自動的にrpmパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
|
270
|
+
=== apk (Alpine Linux)
|
207
271
|
|
208
|
-
|
272
|
+
gemをアップグレードするには, 以下を使用してください:
|
209
273
|
|
210
|
-
|
274
|
+
$ sudo apk add -u asciidoctor
|
211
275
|
|
212
|
-
|
276
|
+
=== APT
|
213
277
|
|
214
|
-
gem
|
278
|
+
gemをアップグレードするには, 以下を使用してください:
|
215
279
|
|
216
280
|
$ sudo apt-get upgrade -y asciidoctor
|
217
281
|
|
218
|
-
|
219
|
-
|
220
|
-
パッケージマネージャ(apt-get)によってインストールされたバージョンのAsciidoctorは最新リリースのAsciidoctorではないかもしれません.
|
221
|
-
ディストリビューションのリリース毎に, どのバージョンがパッケージされているかはパッケージリポジトリを調べてください.
|
282
|
+
=== DNF
|
222
283
|
|
223
|
-
|
224
|
-
* https://packages.ubuntu.com/search?keywords=asciidoctor&searchon=names&exact=1&suite=all§ion=all[asciidoctor package by Ubuntu release]
|
225
|
-
* https://community.linuxmint.com/software/view/asciidoctor[asciidoctor package by Mint release]
|
284
|
+
gemをアップグレードするには, 以下を使用してください:
|
226
285
|
|
227
|
-
|
228
|
-
====
|
229
|
-
パッケージマネージャによって管理されているgemをアップデートするのに `gem udpate` コマンドを使うなといわれるでしょう.
|
230
|
-
そのようなことをするのは, パッケージマネージャがファイル(/usr/local下にインストールされた)を追跡できなくなるためにシステムが不安定な状態にするためです.
|
231
|
-
単純に, システムgemはパッケージマネージャによってのみ管理されるべきです.
|
286
|
+
$ sudo dnf update -y asciidoctor
|
232
287
|
|
233
|
-
|
234
|
-
それから, 安心して `gem` コマンドをAsciidoctorのアップデート, インストールのために使うことができます.
|
235
|
-
RVMやrbenvを使っているなら, gemはシステムからは孤立した場所にインストールされます.
|
236
|
-
====
|
288
|
+
=== Homebrew (macOS)
|
237
289
|
|
238
|
-
|
290
|
+
gemをアップグレードするには, 以下を使用してください:
|
239
291
|
|
240
|
-
|
292
|
+
$ brew update
|
293
|
+
$ brew upgrade asciidoctor
|
241
294
|
|
242
|
-
|
295
|
+
=== gem install
|
243
296
|
|
244
|
-
gem
|
297
|
+
`gem` コマンドを使ってAsciidoctorをインストールした場合は, 新しいバージョンのAsciidoctorがリリースされたら手動でアップグレードする必要があります.
|
298
|
+
以下を入力することでアップグレードできます:
|
245
299
|
|
246
|
-
$
|
247
|
-
|
248
|
-
TIP: お使いのシステムは自動的にapkパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
|
300
|
+
$ gem install asciidoctor
|
249
301
|
|
250
|
-
|
302
|
+
`gem install` を使って新しいバージョンのgemをインストールすると, 複数のバージョンがインストールされた状態になります.
|
303
|
+
以下のコマンドを使って古いバージョンを削除してください.
|
251
304
|
|
252
|
-
|
253
|
-
* {uri-install-osx-doc}[Installing Asciidoctor on Mac OS X]
|
254
|
-
// at the moment, the following entry is just a reiteration of the information in this README
|
255
|
-
//* {uri-install-doc}[Installing the Asciidoctor toolchain]
|
305
|
+
$ gem cleanup asciidoctor
|
256
306
|
|
257
|
-
==
|
307
|
+
== 使い方
|
258
308
|
|
259
|
-
Asciidoctor
|
260
|
-
確認のために,
|
309
|
+
Asciidoctorのインストールが成功すると, `asciidoctor` コマンドがPATHに存在するようになり, Asciidoctorのコマンドラインインターフェース(CLI)が使用できるようになります.
|
310
|
+
確認のために, ターミナルで以下を実行しましょう:
|
261
311
|
|
262
312
|
$ asciidoctor --version
|
263
313
|
|
264
|
-
AsciidoctorのバージョンとRuby
|
314
|
+
AsciidoctorのバージョンとRuby環境についての情報がターミナルに出力されるはずです.
|
265
315
|
|
266
316
|
[.output,subs=attributes+]
|
267
317
|
....
|
268
318
|
Asciidoctor {release-version} [https://asciidoctor.org]
|
269
|
-
Runtime Environment (ruby 2.
|
319
|
+
Runtime Environment (ruby 2.6.0p0 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
|
270
320
|
....
|
271
321
|
|
272
|
-
AsciidoctorはAPI
|
273
|
-
APIは他のRubyソフトウェア, Rails, Sinatra
|
322
|
+
AsciidoctorはAPIも提供します.
|
323
|
+
APIは他のRubyソフトウェア, たとえばRails, Sinatra, GitHub, そして他の言語, たとえばJava ({uri-asciidoctorj}[AsciidoctorJ] 経由)やJavaScript ({uri-asciidoctorjs}[Asciidoctor.js] 経由)と組み合わせて使用するためのものです.
|
274
324
|
|
275
|
-
===
|
325
|
+
=== コマンドラインインターフェース (CLI)
|
276
326
|
|
277
|
-
`asciidoctor`
|
327
|
+
`asciidoctor` コマンドによりコマンドライン(つまりターミナル)からAsciidoctorを起動することができます.
|
278
328
|
|
279
|
-
|
280
|
-
|
329
|
+
次のコマンドにより, README.adocというファイルがHTMLに変換され, 結果が同じディレクトリのREADME.htmlとして保存されます.
|
330
|
+
生成されるHTMLファイルの名前は, ソースファイルのファイル名の拡張子を `.html` に替えたものとなります.
|
281
331
|
|
282
332
|
$ asciidoctor README.adoc
|
283
333
|
|
284
|
-
Asciidoctor
|
334
|
+
さまざまなフラグやスイッチを与えることでAsciidoctorプロセッサをコントロールすることができます. フラグやスイッチの説明は以下のコマンドで表示されます:
|
285
335
|
|
286
336
|
$ asciidoctor --help
|
287
337
|
|
288
|
-
例えば,
|
338
|
+
例えば, ファイルを異なるディレクトリに書き出すには以下を使用します:
|
289
339
|
|
290
340
|
$ asciidoctor -D output README.adoc
|
291
341
|
|
292
|
-
`asciidoctor` {uri-manpage}[man
|
342
|
+
コマンドラインインタフェースの完全なリファレンスは `asciidoctor` の {uri-manpage}[manページ] にあります.
|
293
343
|
|
294
|
-
`asciidoctor`
|
344
|
+
`asciidoctor` コマンドの使い方の詳細については以下を参照してください.
|
295
345
|
|
296
|
-
* {uri-
|
346
|
+
* {uri-convert-doc}[How do I convert a document?]
|
297
347
|
* {uri-themes-doc}[How do I use the Asciidoctor stylesheet factory to produce custom themes?]
|
298
348
|
|
299
349
|
=== Ruby API
|
@@ -303,16 +353,16 @@ Asciidoctorをアプリケーションの中で使うには, まずgemをrequire
|
|
303
353
|
[source]
|
304
354
|
require 'asciidoctor'
|
305
355
|
|
306
|
-
|
356
|
+
そうすると, 以下のようにしてAsciiDocソースファイルをHTMLファイルに変換できます:
|
307
357
|
|
308
358
|
[source]
|
309
359
|
Asciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe
|
310
360
|
|
311
|
-
WARNING: AsciidoctorをAPI
|
312
|
-
セキュアモードでは,
|
313
|
-
|
361
|
+
WARNING: AsciidoctorをAPI経由で使っているとき, デフォルトのセーフモードは `:secure` (セキュアモード)です.
|
362
|
+
セキュアモードでは, `include` ディレクティブを含むいくつかのコア機能が無効化されています.
|
363
|
+
これらの機能を有効化したい場合, 明示的にセーフモードを `:server` (推奨)か `:safe` にする必要があります.
|
314
364
|
|
315
|
-
AsciiDoc
|
365
|
+
AsciiDoc文字列を, 埋め込み用HTML(HTMLページヘの挿入用)に変換することもできます:
|
316
366
|
|
317
367
|
[source]
|
318
368
|
----
|
@@ -320,7 +370,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
|
|
320
370
|
Asciidoctor.convert content, safe: :safe
|
321
371
|
----
|
322
372
|
|
323
|
-
もし完全なHTML
|
373
|
+
もし完全なHTMLドキュメントが必要であれば, 以下のように `header_footer` オプションを有効にしてください:
|
324
374
|
|
325
375
|
[source]
|
326
376
|
----
|
@@ -328,7 +378,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
|
|
328
378
|
html = Asciidoctor.convert content, header_footer: true, safe: :safe
|
329
379
|
----
|
330
380
|
|
331
|
-
|
381
|
+
パースされたドキュメントにアクセスしたい場合は, 変換を複数のステップに分割します:
|
332
382
|
|
333
383
|
[source]
|
334
384
|
----
|
@@ -338,81 +388,79 @@ puts document.doctitle
|
|
338
388
|
html = document.convert
|
339
389
|
----
|
340
390
|
|
341
|
-
Asciidoctor
|
342
|
-
|
391
|
+
Asciidoctorの生成する出力が気に入らない場合は, _あなたはそれを変更できる_ ことを忘れないでください!
|
392
|
+
パースされたドキュメントを出力形式に変換するコンバータは, カスタマイズが可能です.
|
343
393
|
|
344
|
-
|
345
|
-
|
394
|
+
出力を部分的にカスタマイズする簡単な方法としてはテンプレートコンバータがあります.
|
395
|
+
テンプレートコンバータでは, ドキュメントの各ノードの変換に {uri-tilt}[Tilt]対応テンプレートファイルを使うことができます.
|
346
396
|
|
347
|
-
|
348
|
-
APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[
|
397
|
+
さまざまな方法を使って出力は100%制御することが _できます_ .
|
398
|
+
APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[ユーザマニュアル] を参照してください.
|
349
399
|
|
350
|
-
==
|
400
|
+
== コントリビューション
|
351
401
|
|
352
|
-
|
353
|
-
|
354
|
-
New contributors are always welcome!
|
402
|
+
新しいコントリビューションを常に歓迎します!
|
403
|
+
もしソースコード, ドキュメント, あるいはウェブサイトに間違いや不備を見つけたら遠慮なく, イシューを作成するか, 修正をおこなってpull requestを作成してください.
|
355
404
|
|
356
|
-
*あなた*
|
405
|
+
*あなた* にもできることがあります:
|
357
406
|
|
358
|
-
* 先行バージョン(alpha, beta
|
407
|
+
* 先行バージョン(alpha, beta, またはpreview版)の使用
|
359
408
|
* バグレポート
|
360
409
|
* 新機能提案
|
361
|
-
*
|
362
|
-
*
|
363
|
-
* コーディング -- _パッチでも, 足りなすぎるなんてことはありません_
|
410
|
+
* ドキュメントの執筆または編集
|
411
|
+
* テストをつけてコードを書くこと -- _どのようなパッチであれ小さすぎるなどということはありません_
|
364
412
|
** typoの修正
|
365
413
|
** コメントの追加
|
366
414
|
** 一貫性のないホワイトスペースの除去
|
367
415
|
** テストの記述!
|
368
416
|
* リファクタリング
|
369
|
-
*
|
370
|
-
*
|
417
|
+
* {uri-issues}[イシュー] の解決
|
418
|
+
* パッチのレビュー
|
371
419
|
|
372
|
-
{uri-contribute}[Contributing]
|
420
|
+
Asciidoctorプロジェクトにイシュー, 機能リクエスト, コード, ドキュメントを送る際の, 作成方法, スタイル, および送り方は, {uri-contribute}[Contributing] ガイドに記載されています.
|
373
421
|
|
374
|
-
==
|
422
|
+
== 助けを得る
|
375
423
|
|
376
|
-
Asciidoctor
|
377
|
-
|
378
|
-
|
424
|
+
Asciidoctorは, コンテンツの執筆と公開を簡単にするために開発されています.
|
425
|
+
しかしあなたからのフィードバックがなくてはAsciidoctorの開発は進みません!
|
426
|
+
ディスカッションリスト, Twitter, チャットルームを使って, 質問をしたりプロジェクトのさまざまな側面について話し合ったりすることをお勧めします.
|
379
427
|
|
380
|
-
|
381
|
-
|
382
|
-
|
428
|
+
チャット(Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
|
429
|
+
ディスカッションリスト(Nabble):: {uri-discuss}
|
430
|
+
Twitter:: ハッシュタグ https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] またはメンション https://twitter.com/asciidoctor[@asciidoctor]
|
383
431
|
|
384
432
|
ifdef::env-github[]
|
385
|
-
|
433
|
+
以下のプロジェクトサイトに, Asciidoctorに関するさらに詳しい情報やドキュメントがあります.
|
386
434
|
|
387
|
-
{uri-project}
|
435
|
+
{uri-project}[Home] | {uri-news}[News] | {uri-docs}[Docs]
|
388
436
|
endif::[]
|
389
437
|
|
390
|
-
GitHub上のAsciidoctor
|
438
|
+
GitHub上のAsciidoctorのorganizationではプロジェクトのソースコード, イシュートラッカー, サブプロジェクトが管理されています.
|
391
439
|
|
392
|
-
|
393
|
-
|
394
|
-
Asciidoctor
|
440
|
+
ソースリポジトリ(git):: {uri-repo}
|
441
|
+
イシュートラッカー:: {uri-issues}
|
442
|
+
GitHub上のAsciidoctorのorganization:: {uri-org}
|
395
443
|
|
396
|
-
==
|
444
|
+
== ライセンス
|
397
445
|
|
398
|
-
Copyright (C) 2012-
|
399
|
-
本ソフトウェアはMIT
|
446
|
+
Copyright (C) 2012-2020 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
|
447
|
+
本ソフトウェアはMITライセンスのもとで使用できます.
|
400
448
|
|
401
|
-
|
449
|
+
ライセンスの詳細については {uri-license}[LICENSE] ファイルを参照してください.
|
402
450
|
|
403
|
-
==
|
451
|
+
== 作者
|
404
452
|
|
405
|
-
*Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White]
|
406
|
-
このプロジェクトは
|
453
|
+
*Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] がリードし, Asciidoctorの素晴らしきコミュニティの {uri-contributors}[数多くのメンバ] からコントリビューションを受けてきました.
|
454
|
+
このプロジェクトは https://github.com/nickh[Nick Hengeveld] の {uri-prototype}[プロトタイプ] をベースに https://github.com/erebor[Ryan Waldron] により2012年から創始されました.
|
407
455
|
|
408
456
|
*AsciiDoc* は Stuart Rackham により創始され, AsciiDocコミュニティの数多くのメンバからコントリビューションを受けてきました.
|
409
457
|
|
410
458
|
ifndef::env-site[]
|
411
|
-
==
|
459
|
+
== 変更履歴
|
412
460
|
|
413
461
|
ifeval::[{safe-mode-level} < 20]
|
414
462
|
include::CHANGELOG.adoc[tag=compact,leveloffset=+1]
|
415
463
|
endif::[]
|
416
464
|
|
417
|
-
|
465
|
+
過去のリリースの完全な変更点リストについては {uri-changelog}[CHANGELOG] を参照してください.
|
418
466
|
endif::[]
|