asciidoctor 2.0.8 → 2.0.13

Sign up to get free protection for your applications and to get access to all the features.
Files changed (76) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.adoc +171 -5
  3. data/LICENSE +1 -1
  4. data/README-de.adoc +13 -14
  5. data/README-fr.adoc +11 -15
  6. data/README-jp.adoc +242 -185
  7. data/README-zh_CN.adoc +17 -18
  8. data/README.adoc +133 -131
  9. data/asciidoctor.gemspec +6 -6
  10. data/data/locale/attributes-ar.adoc +4 -3
  11. data/data/locale/attributes-be.adoc +23 -0
  12. data/data/locale/attributes-bg.adoc +4 -3
  13. data/data/locale/attributes-ca.adoc +6 -5
  14. data/data/locale/attributes-cs.adoc +4 -3
  15. data/data/locale/attributes-da.adoc +6 -5
  16. data/data/locale/attributes-de.adoc +4 -4
  17. data/data/locale/attributes-en.adoc +4 -4
  18. data/data/locale/attributes-es.adoc +6 -5
  19. data/data/locale/attributes-fa.adoc +4 -3
  20. data/data/locale/attributes-fi.adoc +4 -3
  21. data/data/locale/attributes-fr.adoc +6 -5
  22. data/data/locale/attributes-hu.adoc +4 -3
  23. data/data/locale/attributes-id.adoc +4 -3
  24. data/data/locale/attributes-it.adoc +6 -5
  25. data/data/locale/attributes-ja.adoc +4 -3
  26. data/data/locale/{attributes-kr.adoc → attributes-ko.adoc} +4 -3
  27. data/data/locale/attributes-nb.adoc +4 -3
  28. data/data/locale/attributes-nl.adoc +6 -5
  29. data/data/locale/attributes-nn.adoc +4 -3
  30. data/data/locale/attributes-pl.adoc +8 -7
  31. data/data/locale/attributes-pt.adoc +6 -5
  32. data/data/locale/attributes-pt_BR.adoc +6 -5
  33. data/data/locale/attributes-ro.adoc +4 -3
  34. data/data/locale/attributes-ru.adoc +6 -5
  35. data/data/locale/attributes-sr.adoc +4 -4
  36. data/data/locale/attributes-sr_Latn.adoc +4 -4
  37. data/data/locale/attributes-sv.adoc +4 -4
  38. data/data/locale/attributes-tr.adoc +4 -3
  39. data/data/locale/attributes-uk.adoc +6 -5
  40. data/data/locale/attributes-zh_CN.adoc +4 -3
  41. data/data/locale/attributes-zh_TW.adoc +4 -3
  42. data/data/reference/syntax.adoc +14 -7
  43. data/data/stylesheets/asciidoctor-default.css +30 -30
  44. data/lib/asciidoctor.rb +37 -11
  45. data/lib/asciidoctor/abstract_block.rb +15 -8
  46. data/lib/asciidoctor/abstract_node.rb +18 -8
  47. data/lib/asciidoctor/attribute_list.rb +63 -71
  48. data/lib/asciidoctor/cli/invoker.rb +2 -0
  49. data/lib/asciidoctor/cli/options.rb +10 -9
  50. data/lib/asciidoctor/convert.rb +167 -162
  51. data/lib/asciidoctor/converter.rb +13 -12
  52. data/lib/asciidoctor/converter/docbook5.rb +4 -8
  53. data/lib/asciidoctor/converter/html5.rb +58 -45
  54. data/lib/asciidoctor/converter/manpage.rb +61 -38
  55. data/lib/asciidoctor/converter/template.rb +3 -0
  56. data/lib/asciidoctor/document.rb +28 -42
  57. data/lib/asciidoctor/extensions.rb +2 -4
  58. data/lib/asciidoctor/helpers.rb +20 -15
  59. data/lib/asciidoctor/inline.rb +1 -1
  60. data/lib/asciidoctor/load.rb +101 -101
  61. data/lib/asciidoctor/parser.rb +38 -30
  62. data/lib/asciidoctor/path_resolver.rb +14 -12
  63. data/lib/asciidoctor/reader.rb +20 -13
  64. data/lib/asciidoctor/rx.rb +6 -4
  65. data/lib/asciidoctor/substitutors.rb +61 -39
  66. data/lib/asciidoctor/syntax_highlighter.rb +15 -7
  67. data/lib/asciidoctor/syntax_highlighter/coderay.rb +1 -1
  68. data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +12 -4
  69. data/lib/asciidoctor/syntax_highlighter/prettify.rb +7 -4
  70. data/lib/asciidoctor/syntax_highlighter/pygments.rb +4 -5
  71. data/lib/asciidoctor/syntax_highlighter/rouge.rb +33 -19
  72. data/lib/asciidoctor/table.rb +52 -23
  73. data/lib/asciidoctor/version.rb +1 -1
  74. data/man/asciidoctor.1 +8 -8
  75. data/man/asciidoctor.adoc +4 -4
  76. metadata +16 -15
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1ef189b83754a55b816f7a460e35f774c88caaad9ff226ce55c1c52cbc412164
4
- data.tar.gz: d1df841d432830e57c6e09fd01d3dd862e8d15f4e3f5c6c18dcb1ee5ce837ae2
3
+ metadata.gz: a9e72633de0c6754af3817cb79f6dbb3837a14b6ed1dd4c9f2e22bb600460bff
4
+ data.tar.gz: ad8533870d76be07168b23cec5c8e53aa9e6128e30535650d827ffade7fad92d
5
5
  SHA512:
6
- metadata.gz: 0166e0df2ecdfef13e74befcdcc30bc4eaf52a0df358438350a5891c8f4ffa1346bc2d5d2c8be76d40fa931e88017be6748dd34cbd9184583ad631cfc91aa205
7
- data.tar.gz: 2eaf29c5ac50b229214da2bf11f933767fc9bf43d3ff6b86d859501e1b1c446945d2845825cb4f5010e891a1c5af47e552f170533d3f4c48eaa19d7f1e30ff30
6
+ metadata.gz: db1c156201c46129fea64fdfa08b40a7892ef655856ec679e81caad32fa5601da67de7bfd5e47f7a811813cf6efe78c3f958e4b294ac29fbf105ebb6725115d9
7
+ data.tar.gz: d6656dca3af8847229c556063bf0ed2ec5db03129a7af0d2bfaf65e400e5bb95fb571b9378c367ed2305b967fb33ce0c7085cc2e1740d653c360d079fff386f5
data/CHANGELOG.adoc CHANGED
@@ -14,6 +14,166 @@ This document provides a high-level view of the changes introduced in Asciidocto
14
14
  For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
15
15
 
16
16
  // tag::compact[]
17
+ == 2.0.13 (2021-04-10) - @mojavelinux
18
+
19
+ Bug Fixes::
20
+
21
+ * Rollback change for #3470, which added logic to remove leading and trailing empty lines in an AsciiDoc include file; instead skip empty lines before processing document header (#3997)
22
+ * Don't allow `counter` and `counter2` attribute directives to override locked attributes (#3939) (*@mogztter*)
23
+ * Fix crash when resolving next value in sequence for counter with non-numeric value (#3940)
24
+ * Honor list of tags following negated wildcard on include directive (#3932)
25
+ * Update default stylesheet to remove dash in front of cite on nested quote block (#3847)
26
+ * Don't mangle formatting macros when uppercasing section titles in man page output (#3892)
27
+ * Don't escape hyphen in `manname` in man page output
28
+ * Remove extra `.sp` line before content of verse block in man page output
29
+ * Fix layout of footnotes in man page output (#3989)
30
+ * Fix formatting of footnote text with URL in man page output (#3988)
31
+ * Remove redundant trailing space on URL followed by non-adjacent text in man page output (#4004)
32
+ * Use `.bp` macro at location of page break in man page output (#3992)
33
+
34
+ Improvements::
35
+
36
+ * Extract method to create lexer and formatter in Rouge adapter (#3953) (*@Oblomov*)
37
+ * Add support for pygments.rb 2.x (#3969) (*@slonopotamus*)
38
+ * Allow `NullLogger` to be enabled by setting the `:logger` option to a falsy value (#3982)
39
+ * Substitute attributes in manpurpose part of NAME section in manpage doctype (#4000)
40
+ * Output all mannames in name section of HTML output for manpage doctype (#3757)
41
+
42
+ Build / Infrastructure::
43
+
44
+ * Enable running tests as root (PR #3874) (*@mikemckiernan*)
45
+ * Run tests against both pygments.rb 1.x and 2.x (#3969) (*@slonopotamus*)
46
+ * Speed up CI by using Bundler cache (PR #3901) (*@slonopotamus*)
47
+
48
+ Documentation::
49
+
50
+ * Import documentation for processor into this repository (#3861) (*@graphitefriction*)
51
+ * Add Belarusian translation of built-in attributes (PR #3928) (*@morganov*)
52
+
53
+ // end::compact[]
54
+ == 2.0.12 (2020-11-10) - @mojavelinux
55
+
56
+ Bug Fixes::
57
+
58
+ * Set type and target property on unresolved footnote reference and unset id property (fixes regression) (#3825)
59
+ * Fix crash when inlining an SVG if the explicit width or height value on the image node is not a string (#3829)
60
+ * Reset word wrap behavior to normal on tables, then reenable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)
61
+
62
+ Improvements::
63
+
64
+ * Pass through role to DocBook output for inline image (#3832)
65
+
66
+ Compliance::
67
+
68
+ * Defer use of Ruby >= 2.3 constructs to restore compatibility with Ruby 2.0 until at least next minor release (#3827)
69
+ * Don't append the default px unit identifier to the explicit width or height value when inlining an SVG (#3829)
70
+
71
+ Build / Infrastructure::
72
+
73
+ * Migrate Linux CI jobs to GitHub Actions (#3837)
74
+ * Migrate Windows CI jobs to GitHub Actions (#3839)
75
+ * Run CI job on macOS (#3842)
76
+
77
+ == 2.0.11 (2020-11-02) - @mojavelinux
78
+
79
+ Bug Fixes::
80
+
81
+ * Fix infinite loop when callout list with obsolete syntax is found inside list item (#3472)
82
+ * Fix infinite loop when xreftext contains a circular reference path in HTML and manpage converters (#3543)
83
+ * Apply text formatting to table cells in implicit header row when column has the "a" or "l" style (#3760)
84
+ * Fix errant reference warning for valid reference when running in compat mode (#3555)
85
+ * Initialize backend traits for converter (if not previously initialized) using assigned basebackend; mimics Asciidoctor < 2 behavior (#3341)
86
+ * Set source_location on preamble block when sourcemap option is enabled (#3799)
87
+ * Link the notitle and showtitle attributes so they act as opposites for the same toggle (#3804)
88
+ * Pass options to constructor of Rouge lexer instead of #lex method; restores compatibility with Rouge >= 3.4 (#3336)
89
+ * Don't clobber cgi-style options on language when enabling start_inline option on the Rouge PHP lexer (#3336)
90
+ * Fix parsing of wrapped link and xref text, including when an attrlist signature is detected (#3331)
91
+ * Restore deprecated writable number property on AbstractBlock
92
+ * Always use title as xreftext if target block has an empty caption, regardless of xrefstyle value (#3745)
93
+ * Allow a bibliography reference to be used inside a footnote (#3325)
94
+ * Fix bottom margin collapsing on AsciiDoc table cell (#3370)
95
+ * Remove excess hard line break in multi-line AsciiMath blocks (#3407)
96
+ * Only strip trailing spaces from lines of AsciiDoc include file (#3436)
97
+ * Remove errant optional flag in regexp for menu macro that breaks Asciidoctor.js (#3433)
98
+ * Preserve repeating backslashes when generating manpage output (#3456)
99
+ * Honor percentage width specified on macro of inline SVG (#3464)
100
+ * Removing leading and trailing blank lines in AsciiDoc include file to match assumption of parser (#3470)
101
+ * Activate extensions when :extensions option is set even if Extensions API is not yet loaded (#3570)
102
+ * Don't activate global extensions if :extensions option is false (#3570)
103
+ * Escape ellipsis at start of line in manpage output (#3645) (*@jnavila*)
104
+ * Don't register footnote with ID if a footnote is already registered with that ID (#3690)
105
+ * Honor start attribute on ordered list in manpage output (#3714)
106
+ * Warn instead of crashing if SVG to inline is empty (#3638) (*@mogztter*)
107
+ * Compute highlight line ranges on source block relative to value of start attribute (#3519) (*@mogztter*)
108
+ * Prevent collapsible block from incrementing example number by assigning an empty caption (#3639)
109
+ * Use custom init function for highlight.js to select the correct `code` elements (#3761)
110
+ * Fix resolved value of :to_dir when both :to_file and :to_dir options are set to absolute paths (#3778)
111
+ * 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)
112
+ * Fix crash if value passed by API for `copycss` attribute is not a string (#3592)
113
+ * Restore label in front of each bibliography entry in DocBook output that was dropped by fix for #3085 (#3782)
114
+ * Apply max width to each top-level container instead of body in HTML output (#3513)
115
+ * Don't apply border-collapse: separate to HTML for table blocks; fixes double border at boundary of colspan/rowspan (#3793) (*@ahus1*)
116
+ * Don't remove right border on last table cell in row (#2563)
117
+ * 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)
118
+
119
+ Compliance::
120
+
121
+ * Add support for muted option to self-hosted video (#3408)
122
+ * Move style tag for convert-time syntax highlighters (coderay, rouge, pygments) into head (#3462)
123
+ * Move style tag for client-side syntax highlighters (highlight.js, prettify) into head (#3503)
124
+ * 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)
125
+ * Retain attribute order on HTML code tag for source block to remain consistent with output from 1.5.x (#3786)
126
+ * Correct language code for Korean language file from kr to ko (#3807) (*@jnavila*)
127
+
128
+ Improvements::
129
+
130
+ * Apply word wrap (i.e., `word-wrap: anywhere`) to body in default stylesheet (#3544)
131
+ * Allow `nobreak` and `nowrap` roles to be used on any inline element (#3544)
132
+ * Add CSS class to support pre-wrap role to preserve leading, trailing, and repeating spaces in phrase (#3815)
133
+ * Preserve guard around XML-style callout when icons are not enabled (#3319)
134
+ * Use `.fam C` command to switch font family for verbatim blocks to monospaced text in manpage output (#3561)
135
+ * Remove redundant test for halign and valign attributes on table cell in DocBook converter
136
+ * Allow encoding of include file to be specified using encoding attribute (#3248)
137
+ * Allow template to be used to override outline by only specifying the outline template (#3491)
138
+ * Upgrade MathJax from 2.7.5 to 2.7.9
139
+ * 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)
140
+ * Skip unused default attribute assignments for embedded document
141
+ * Allow a URL macro to have a preceding single or double quote (#3376)
142
+ * Add support for erubi template engine; use it in place of erubis in test suite; note the use of erubis is deprecated (#3737)
143
+ * Download and embed remote custom stylesheet if allow-uri-read is set (#3765)
144
+ * Remove direction property from default stylesheet (#3753) (*@abdnh*)
145
+ * remove max width setting on content column for print media in default stylesheet (#3802)
146
+ * Normalize frame value "topbot" to "ends" in HTML output (consistently use frame-ends class) (#3797)
147
+ * Add role setter method on AbstractNode (#3614)
148
+ * Map chapter-signifier and part-signifier attributes in locale attribute files to replace chapter-label and part-label (#3817)
149
+
150
+ Build / Infrastructure::
151
+
152
+ * Run test suite on TruffleRuby nightly (*@mogztter*, *@erebor*)
153
+ * Upgrade TruffleRuby to 20.0.0 (*@mogztter*)
154
+ * Trigger upstream builds for AsciidoctorJ on Github Actions (*@robertpanzer*)
155
+
156
+ == 2.0.10 (2019-05-31) - @mojavelinux
157
+
158
+ Bug Fixes::
159
+
160
+ * fix Asciidoctor.convert_file to honor `header_footer: false` option when writing to file (#3316)
161
+ * fix placement of title on excerpt block (#3289)
162
+ * always pass same options to SyntaxHighlighter#docinfo, regardless of value of location argument
163
+ * fix signature of SyntaxHighlighter#docinfo method (#3300)
164
+ * when `icons` is set to `image`, enable image icons, but don't use it as the value of the `icontype` attribute (#3308)
165
+
166
+ == 2.0.9 (2019-04-30) - @mojavelinux
167
+
168
+ Bug Fixes::
169
+
170
+ * process multiple single-item menu macros in same line (#3279)
171
+ * register images in catalog correctly (#3283)
172
+ * rename AbstractNode#options method to AbstractNode#enabled_options so it doesn't get shadowed by Document#options (#3282)
173
+ * don't fail to convert document if alt attribute is not set on block or inline image (typically by an extension)
174
+ * fix lineno of source location on blocks that follow a detached list continuation (#3281)
175
+ * assume inline image type is "image" if not set (typically by an extension)
176
+
17
177
  == 2.0.8 (2019-04-22) - @mojavelinux
18
178
 
19
179
  Bug Fixes::
@@ -31,7 +191,6 @@ Improvements::
31
191
  * use module_function keyword to define methods in Helpers
32
192
  * move regular expression definitions to separate source file (internal change)
33
193
 
34
- // end::compact[]
35
194
  == 2.0.7 (2019-04-13) - @mojavelinux
36
195
 
37
196
  Bug Fixes::
@@ -127,7 +286,7 @@ Enhancements / Compliance::
127
286
 
128
287
  * drop support for Ruby < 2.3 and JRuby < 9.1 and remove workarounds (#2764)
129
288
  * drop support for Slim < 3 (#2998)
130
- * drop the converter for the docbook45 backend (#3005)
289
+ * drop the converter for the docbook45 backend from core; moved to https://github.com/asciidoctor/asciidoctor-docbook45 (#3005)
131
290
  * apply substitutions to section and block titles in normal substitution order (#1173)
132
291
  * make syntax highlighter pluggable; extract all logic into adapter classes (#2106)
133
292
  * add syntax highlighter adapter for Rouge (#1040)
@@ -163,6 +322,7 @@ Enhancements / Compliance::
163
322
  * use the third argument of AbstractNode#attr / AbstractNode#attr? to set the name of a fallback attribute to look for on the document (#1934)
164
323
  * change default value of third argument to Abstractnode#attr / AbstractNode#attr? to nil so attribute doesn't inherit by default (#3059)
165
324
  * look for table-frame, table-grid, and table-stripes attributes on document as fallback for frame, grid, and stripes attributes on table (#3059)
325
+ * add support for hover mode for table stripes (stripes=hover) (#3110)
166
326
  * always assume the target of a shorthand interdocument xref is a reference to an AsciiDoc document (source-to-source) (#3021)
167
327
  * if the target of a formal xref macro has a file extension, assume it's a path reference (#3021)
168
328
  * never assume target of a formal xref macro is a path reference unless a file extension or fragment is present (#3021)
@@ -215,6 +375,7 @@ Improvements::
215
375
  * value comparison in AbstractNode#attr? is only performed if expected value is truthy
216
376
  * align default CodeRay style with style for other syntax highlighters (#2106)
217
377
  * ensure linenos class is added to linenos column when source highlighter is pygments and pygments-css=style
378
+ * disable table stripes by default (#3110)
218
379
  * rename CSS class of Pygments line numbering table to linenotable (to align with Rouge) (#1040)
219
380
  * remove unused Converter#convert_with_options method (#2891)
220
381
  * add -e, --embedded CLI flag as alias for -s, --no-header-footer (require long option to specify eRuby impl) (#1444)
@@ -314,6 +475,7 @@ Enhancements::
314
475
  * add support for start attribute on source block to set starting line number when converting to DocBook (#2915)
315
476
  * track imagesdir for image on node and in catalog (#2779)
316
477
  * allow starting line number to be set using start attribute when highighting source block with Pygments or CodeRay (#1742)
478
+ * add intrinsic attribute named `pp` that effectively resolves to `++` (#2807)
317
479
  * upgrade highlight.js to 9.13.1
318
480
 
319
481
  Bug Fixes::
@@ -398,6 +560,11 @@ Enhancements::
398
560
 
399
561
  * BREAKING: drop XML tags, character refs, and non-word characters (except hyphen, dot, and space) when auto-generating section IDs (#794)
400
562
  ** hyphen, dot, and space are replaced with value of idseparator, if set; otherwise, spaces are dropped
563
+ * BREAKING: disable interdocument xrefs in compat mode (#2740)
564
+ * BREAKING: automatically parse attributes in link macro if equals is present, ignoring linkattrs (except in compat mode) (#2059)
565
+ * pass non-AsciiDoc file extensions in target of xref through unprocessed (#2740)
566
+ * process any known AsciiDoc file extension in target of shorthand interdocument xref if hash is also present (e.g., `<<target.asciidoc#,text>>`) (#2740)
567
+ * only allow .adoc to be used in target of formal xref macro to create an interdocument xref (with or without a hash) (#2740)
401
568
  * allow attribute names to contain any word character defined by Unicode (#2376, PR #2393)
402
569
  * do not recognize attribute entry line if name contains a colon (PR #2377)
403
570
  * route all processor messages through a logger instead of using Kernel#warn (#44, PR #2660)
@@ -517,7 +684,6 @@ Improvements / Refactoring::
517
684
  * move callouts into document catalog (PR #2394)
518
685
  * document ID defined in block attribute line takes precedence over ID defined inside document title line
519
686
  * don't look for link and window attributes on document when resolving these attributes for an image
520
- * when linkattrs is set, only parse attributes in link macro if equals is present
521
687
  * skip line comments in name section of manpage (#2584, PR #2585)
522
688
  * always activate extension registry passed to processor (PR #2379)
523
689
  * skip extension registry activation if no groups are registered (PR #2373)
@@ -894,7 +1060,7 @@ Enhancements::
894
1060
  * Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (#1721) (*@JojoBoulix*)
895
1061
  * Add reversed attribute to ordered list if reversed option is enabled (#1830)
896
1062
  * Add support for additional docinfo locations (e.g., :header)
897
- * Configure default stylesheet to break monospace word if exceeds length of line; add roles to prevent breaks (#1814)
1063
+ * 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)
898
1064
  * Introduce translation file for built-in labels (*@ciampix*)
899
1065
  * 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)
900
1066
  * Translate README to Chinese (*@diguage*)
@@ -1148,7 +1314,7 @@ Improvements::
1148
1314
  * define JAVASCRIPT_PLATFORM constant to simplify conditional logic in the JavaScript environment (#897)
1149
1315
  * provide access to destination directory, outfile and outdir via Document object (#1203)
1150
1316
  * print encoding information in version report produced by `asciidoctor -v` (#1210)
1151
- * add intrinsic attribute named `cpp` with value `C++` (#1208)
1317
+ * add intrinsic attribute named `cpp` that effectively resolves to `C++` (#1208)
1152
1318
  * preserve URI targets passed to `stylesheet` and related attributes (#1192)
1153
1319
  * allow numeric characters in block attribute name (#1103)
1154
1320
  * support custom YouTube playlists (#1105)
data/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, and the
3
+ Copyright (C) 2012-2021 Dan Allen, Sarah White, Ryan Waldron, and the
4
4
  individual contributors to Asciidoctor.
5
5
 
6
6
  Permission is hereby granted, free of charge, to any person obtaining a copy
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.8, 2019-04-22
3
+ v2.0.13, 2021-04-10
4
4
  // settings:
5
5
  :idprefix:
6
6
  :idseparator: -
@@ -17,7 +17,7 @@ ifdef::env-github[]
17
17
  :warning-caption: :warning:
18
18
  endif::[]
19
19
  // Variables:
20
- :release-version: 2.0.8
20
+ :release-version: 2.0.13
21
21
  // URIs:
22
22
  :uri-org: https://github.com/asciidoctor
23
23
  :uri-repo: {uri-org}/asciidoctor
@@ -40,8 +40,8 @@ endif::[]
40
40
  :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
41
41
  :uri-license: {uri-rel-file-base}LICENSE
42
42
  :uri-tests: {uri-rel-tree-base}test
43
- :uri-discuss: http://discuss.asciidoctor.org
44
- :uri-irc: irc://irc.freenode.org/#asciidoctor
43
+ :uri-discuss: https://discuss.asciidoctor.org
44
+ :uri-chat: https://asciidoctor.zulipchat.com
45
45
  :uri-rubygem: https://rubygems.org/gems/asciidoctor
46
46
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
47
47
  :uri-user-manual: {uri-docs}/user-manual
@@ -85,12 +85,11 @@ endif::[]
85
85
  * {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax-Referenz]
86
86
 
87
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&amp;passingText=green%20bar&amp;failingText=%23fail&amp;pendingText=building%2E%2E%2E[Build Status (AppVeyor), link=https://ci.appveyor.com/project/asciidoctor/asciidoctor]
91
- //image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
92
- //image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
93
- image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
88
+ image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
89
+ image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
90
+ image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
91
+ image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs,link=https://inch-ci.org/github/asciidoctor/asciidoctor]
92
+ image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[project chat,link=https://asciidoctor.zulipchat.com/]
94
93
  endif::[]
95
94
 
96
95
  == Sponsoren
@@ -435,9 +434,9 @@ Asciidoctor wurde entwickelt, um Ihnen das Schreiben und Veröffentlichen Ihrer
435
434
  Aber wir können es nicht ohne ihr Feedback machen!
436
435
  Wir ermutigen Sie, Fragen zu stellen und alle Aspekte des Projekts auf der Diskussionsliste, auf Twitter oder im Chatroom zu diskutieren.
437
436
 
438
- Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
437
+ Chat (Zulip):: {uri-chat}
439
438
  Discussionsliste (Nabble):: {uri-discuss}
440
- Twitter:: https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] hashtag or https://twitter.com/asciidoctor[@asciidoctor] mention
439
+ Twitter:: Follow https://twitter.com/asciidoctor[@asciidoctor] or search for the https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] hashtag
441
440
 
442
441
  ifdef::env-github[]
443
442
  Weitere Informationen und Dokumentation zu Asciidoctor finden Sie auf der Website des Projekts.
@@ -453,14 +452,14 @@ Asciidoctor Organization auf GitHub:: {uri-org}
453
452
 
454
453
  == Lizenz
455
454
 
456
- Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, und die einzelnen Mitarbeiter von Asciidoctor.
455
+ Copyright (C) 2012-2021 Dan Allen, Sarah White, Ryan Waldron, und die einzelnen Mitarbeiter von Asciidoctor.
457
456
  Die Nutzung dieser Software wird unter den Bedingungen der MIT-Lizenz gewährt.
458
457
 
459
458
  Siehe die {uri-license}[LIZENZ] für den vollen Lizenztext.
460
459
 
461
460
  == Authoren
462
461
 
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} in Asciidoctors großartiger Gemeinschaft erhalten.
462
+ *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
463
  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
464
 
466
465
  *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.8, 2019-04-22
3
+ v2.0.13, 2021-04-10
4
4
  // settings:
5
5
  :idprefix:
6
6
  :idseparator: -
@@ -17,7 +17,7 @@ ifdef::env-github[]
17
17
  :warning-caption: :warning:
18
18
  endif::[]
19
19
  // Variables:
20
- :release-version: 2.0.8
20
+ :release-version: 2.0.13
21
21
  // URIs:
22
22
  :uri-org: https://github.com/asciidoctor
23
23
  :uri-repo: {uri-org}/asciidoctor
@@ -40,8 +40,8 @@ endif::[]
40
40
  :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
41
41
  :uri-license: {uri-rel-file-base}LICENSE
42
42
  :uri-tests: {uri-rel-tree-base}test
43
- :uri-discuss: http://discuss.asciidoctor.org
44
- :uri-irc: irc://irc.freenode.org/#asciidoctor
43
+ :uri-discuss: https://discuss.asciidoctor.org
44
+ :uri-chat: https://asciidoctor.zulipchat.com
45
45
  :uri-rubygem: https://rubygems.org/gems/asciidoctor
46
46
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
47
47
  :uri-user-manual: {uri-docs}/user-manual
@@ -82,12 +82,11 @@ endif::[]
82
82
  * {uri-docs}/user-manual[Manuel Utilisateur Asciidoctor]
83
83
 
84
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&amp;passingText=green%20bar&amp;failingText=%23fail&amp;pendingText=building%2E%2E%2E[Build Status (AppVeyor), link=https://ci.appveyor.com/project/asciidoctor/asciidoctor]
88
- //image:https://img.shields.io/coveralls/asciidoctor/asciidoctor/master.svg[Coverage Status, link=https://coveralls.io/r/asciidoctor/asciidoctor]
89
- //image:https://codeclimate.com/github/asciidoctor/asciidoctor/badges/gpa.svg[Code Climate, link="https://codeclimate.com/github/asciidoctor/asciidoctor"]
90
- image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs, link="https://inch-ci.org/github/asciidoctor/asciidoctor"]
85
+ image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
86
+ image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
87
+ image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
88
+ image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs,link=https://inch-ci.org/github/asciidoctor/asciidoctor]
89
+ image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[project chat,link=https://asciidoctor.zulipchat.com/]
91
90
  endif::[]
92
91
 
93
92
  == Sponsors
@@ -401,12 +400,9 @@ Asciidoctor est développé dans le but de vous aider à écrire et publier du c
401
400
  Mais nous ne pouvons pas le faire sans vos avis !
402
401
  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
402
 
404
- Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
403
+ Chat (Zulip):: {uri-chat}
405
404
  Forum (Nabble):: {uri-discuss}
406
405
  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
406
 
411
407
  ifdef::env-github[]
412
408
  De plus amples informations et documentations sur Asciidoctor peuvent être trouvées sur le site web du projet.
@@ -422,7 +418,7 @@ L'organisation Asciidoctor sur GitHub:: {uri-org}
422
418
 
423
419
  == Licence
424
420
 
425
- Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
421
+ Copyright (C) 2012-2021 Dan Allen, Sarah White, Ryan Waldron, et les contributeurs individuels d'Asciidoctor.
426
422
  Une utilisation libre de ce logiciel est autorisée sous les termes de la licence MIT.
427
423
 
428
424
  Consultez le fichier {uri-license}[LICENSE] pour plus de détails.
data/README-jp.adoc CHANGED
@@ -1,8 +1,7 @@
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.8, 2019-04-22
3
+ v2.0.13, 2021-04-10
4
4
  // settings:
5
- :page-layout: base
6
5
  :idprefix:
7
6
  :idseparator: -
8
7
  :source-language: ruby
@@ -18,13 +17,17 @@ ifdef::env-github[]
18
17
  :warning-caption: :warning:
19
18
  endif::[]
20
19
  // Variables:
21
- :release-version: 2.0.8
20
+ :release-version: 2.0.13
22
21
  // URIs:
23
22
  :uri-org: https://github.com/asciidoctor
24
23
  :uri-repo: {uri-org}/asciidoctor
25
24
  :uri-asciidoctorj: {uri-org}/asciidoctorj
26
25
  :uri-asciidoctorjs: {uri-org}/asciidoctor.js
26
+ :uri-gradle-plugin: {uri-org}/asciidoctor-gradle-plugin
27
+ :uri-maven-plugin: {uri-org}/asciidoctor-maven-plugin
28
+ :uri-asciidoclet: {uri-org}/asciidoclet
27
29
  :uri-project: https://asciidoctor.org
30
+ :uri-gem: https://rubygems.org/gems/asciidoctor
28
31
  ifdef::env-site[:uri-project: link:]
29
32
  :uri-docs: {uri-project}/docs
30
33
  :uri-news: {uri-project}/news
@@ -33,7 +36,7 @@ ifdef::env-site[:uri-project: link:]
33
36
  :uri-contributors: {uri-repo}/graphs/contributors
34
37
  :uri-rel-file-base: link:
35
38
  :uri-rel-tree-base: link:
36
- ifdef::env-site[]
39
+ ifdef::env-site,env-yard[]
37
40
  :uri-rel-file-base: {uri-repo}/blob/master/
38
41
  :uri-rel-tree-base: {uri-repo}/tree/master/
39
42
  endif::[]
@@ -41,85 +44,100 @@ endif::[]
41
44
  :uri-contribute: {uri-rel-file-base}CONTRIBUTING.adoc
42
45
  :uri-license: {uri-rel-file-base}LICENSE
43
46
  :uri-tests: {uri-rel-tree-base}test
44
- :uri-discuss: http://discuss.asciidoctor.org
45
- :uri-irc: irc://irc.freenode.org/#asciidoctor
47
+ :uri-discuss: https://discuss.asciidoctor.org
48
+ :uri-chat: https://asciidoctor.zulipchat.com
46
49
  :uri-rubygem: https://rubygems.org/gems/asciidoctor
47
50
  :uri-what-is-asciidoc: {uri-docs}/what-is-asciidoc
48
51
  :uri-user-manual: {uri-docs}/user-manual
49
52
  :uri-install-docker: https://github.com/asciidoctor/docker-asciidoctor
50
53
  //:uri-install-doc: {uri-docs}/install-toolchain
51
- :uri-install-osx-doc: {uri-docs}/install-asciidoctor-macosx
52
- :uri-render-doc: {uri-docs}/render-documents
54
+ :uri-install-macos-doc: {uri-docs}/install-asciidoctor-macos
55
+ :uri-convert-doc: {uri-docs}/convert-documents
53
56
  :uri-themes-doc: {uri-docs}/produce-custom-themes-using-asciidoctor-stylesheet-factory
54
57
  :uri-gitscm-repo: https://github.com/git/git-scm.com
55
58
  :uri-prototype: {uri-gitscm-repo}/commits/master/lib/asciidoc.rb
56
59
  :uri-freesoftware: https://www.gnu.org/philosophy/free-sw.html
57
60
  :uri-foundation: https://foundation.zurb.com
61
+ :uri-opal: https://opalrb.com
58
62
  :uri-tilt: https://github.com/rtomayko/tilt
59
- :uri-ruby: https://ruby-lang.org
63
+ :uri-ruby: https://www.ruby-lang.org
60
64
  // images:
61
65
  :image-uri-screenshot: https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/screenshot.png
62
66
 
63
- {uri-project}/[Asciidoctor] _高速な_ テキストプロセッサで {uri-what-is-asciidoc}[AsciiDoc] をHTML 5, DocBook 5や他のフォーマットに変換するツールチェインを配布しています.
64
- AsciidoctorはRubyで書かれており, RubyGemとしてパッケージされ, {uri-rubygem}[RubyGems.org] で配布されています.
65
- gemはいくつかのLinuxディストリビューション, Fedora, Debian, Ubuntuにも含まれています.
66
- Asciidoctorはオープンソース {uri-repo}[hosted on GitHub] で {uri-license}[the MIT licence]のもとに配布されます.
67
-
68
- ifndef::env-site[]
69
- Translations of this document are available in the following languages:
70
-
71
- * {uri-rel-file-base}README-zh_CN.adoc[汉语]
72
- * {uri-rel-file-base}README.adoc[English]
73
- * {uri-rel-file-base}README-fr.adoc[Français]
67
+ {uri-project}[Asciidoctor]は, {uri-what-is-asciidoc}[AsciiDoc] で書かれたコンテンツをHTML5, DocBook, PDFなどのフォーマットに変換する, _高速で_ {uri-license}[オープンソース] のテキストプロセッサおよびパブリッシングツールチェインです.
68
+ AsciidoctorはRubyで書かれており, すべての主要オペレーティングシステムで動作します.
69
+ Asciidoctorプロジェクトは {uri-repo}[GitHubにホスティング] されています.
70
+
71
+ インストールをシンプルにするため, AsciidoctorはRubyGem(gem)パッケージとして, {uri-rubygem}[RubyGems.org] で配布されています.
72
+ さらに, Asciidoctorは主要なLinuxディストリビューション用およびmacOS用パッケージとしても配布されています.
73
+ AsciidctorはRubyで動作するだけでなく, {uri-asciidoctorj}[AsciidoctorJ]としてJVM上でも動作します. また, {uri-asciidoctorjs}[Asciidoctor.js]としてどのようなJavaScript環境(ブラウザを含む)でも実行できます.
74
+
75
+ ifndef::env-site,env-yard[]
76
+ このドキュメントには以下の言語版が存在します: +
77
+ {uri-rel-file-base}README.adoc[English]
78
+ |
79
+ {uri-rel-file-base}README-zh_CN.adoc[汉语]
80
+ |
81
+ {uri-rel-file-base}README-de.adoc[Deutsch]
82
+ |
83
+ {uri-rel-file-base}README-fr.adoc[Français]
74
84
  endif::[]
75
85
 
76
- .Key documentation
86
+ .主なドキュメント
77
87
  [.compact]
78
88
  * {uri-docs}/what-is-asciidoc[What is AsciiDoc?]
79
89
  * {uri-docs}/asciidoc-writers-guide[AsciiDoc Writer's Guide]
80
- * {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
81
90
  * {uri-docs}/user-manual[Asciidoctor User Manual]
82
-
83
- .Rubyの行く先, Asciidoctorの追うところ
84
- ****
85
- AsciidoctorはJRubyを用いてJVM上でも実行できます.
86
- Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには, {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
87
- AsciidoctorJに基づいた, AsciidoctorプロセッサをApache Maven, GradleやJavadocに統合するプラグインがあります.
88
-
89
- AsciidoctorはJavaScriptでも実行可能です.
90
- {uri-asciidoctorjs}[Asciidoctor.js], WebブラウザやNode.jsのようなJavaScript環境で動くAsciidoctorの完全機能版, を生成するために, RubyのソースをJavaScriptにトランスパイルするのに https://opalrb.com[Opal]を使います.
91
- Asciidoctor.jsはChrome, Atom, Brackets や他のウェブベースのツールの拡張機能としてAsciiDocのプレビューのために使われます.
92
- ****
91
+ * {uri-docs}/asciidoc-syntax-quick-reference[AsciiDoc Syntax Reference]
93
92
 
94
93
  ifdef::status[]
95
- .*Project health*
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&amp;passingText=green%20bar&amp;failingText=%23fail&amp;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"]
94
+ image:https://img.shields.io/gem/v/asciidoctor.svg[Latest Release, link={uri-gem}]
95
+ image:https://img.shields.io/badge/rubydoc.info-{release-version}-blue.svg[library (API) docs,link=https://www.rubydoc.info/gems/asciidoctor/{release-version}]
96
+ image:https://github.com/asciidoctor/asciidoctor/workflows/CI/badge.svg[Build Status (GitHub Actions),link={uri-repo}/actions]
97
+ image:https://inch-ci.org/github/asciidoctor/asciidoctor.svg?branch=master[Inline docs,link=https://inch-ci.org/github/asciidoctor/asciidoctor]
98
+ image:https://img.shields.io/badge/zulip-join_chat-brightgreen.svg[project chat,link=https://asciidoctor.zulipchat.com/]
101
99
  endif::[]
102
100
 
103
- == The Big Picture
101
+ == スポンサー
102
+
103
+ {uri-project}/supporters[スポンサー] のみなさまが, このプロジェクトをサポートし, より良いテクニカルドキュメンテーションの実現にコミットメントをしてくださっていることに感謝します.
104
+ スポンサーのみなさま, ありがとうございます!
105
+ みなさまの多くのサポートなくしてAsciidoctorは実現不可能です.
104
106
 
105
- Asciidoctorは下図の左側のパネルに示されるように, 平文で書かれた内容を読み, 右のパネルに描かれるようにHTML 5に変換します.
106
- Asciidoctorは枠にとらわれない快適なエクスペリエンスのためにデフォルトスタイルシートをHTML 5ドキュメントに適用します.
107
+ https://opencollective.com/asciidoctor[OpenCollective] を通じてスポンサーになることにより, このプロジェクトを支援することができます.
107
108
 
108
- image::{image-uri-screenshot}[Preview of AsciiDoc source and corresponding rendered HTML]
109
+ == 全体像
109
110
 
110
- == AsciiDoc Processing
111
- AsciidoctorはAsciiDoc文法で書かれたテキストを読み込み解釈し, それからHTML 5, DocBook 5やman(ual)を出力するために内蔵コンバータセットにパースツリーを渡します.
112
- 生成された出力をカスタマイズ, あるいは追加のフォーマットをつくるためにあなた自身のコンバータを使うことや {uri-tilt}[Tilt]-supported テンプレートを読み込むオプションがあります.
111
+ Asciidoctorは, 下図左側のようなプレーンテキストを読み込んで, 右側のようなHTML5に変換します.
112
+ 特別な設定をしなくてもきれいな表示が得られるよう, HTML5の出力にはデフォルトのスタイルシートが適用されます.
113
113
 
114
- NOTE: AsciidoctorはオリジナルのAsciiDoc Pythonプロセッサ(`asciidoc.py`)の完全互換です.
115
- Asciidoctorテストスイートは {uri-tests}[> 1,600 tests] をAsciiDoc文法との互換性を保証するために有しています.
114
+ image::{image-uri-screenshot}[AsciiDocソースとレンダリングされたHTMLのプレビュー]
116
115
 
117
- クラシックなAsciiDoc文法に加えて, Asciidoctorは追加のマークアップとフォントベースのicons(例えば, `+icon:fire[]+`)などのフォーマッティングオプションとUIエレメント(`+button:[Save]+`)を 受け付けます.
118
- AsciidoctorはHTML 5出力をスタイルするため, モダンで, {uri-foundation}[Foundation] に基づいたレスポンシブテーマをも提供します.
116
+ == AsciiDocの処理
119
117
 
120
- == Requirements
118
+ Asciidoctorは, AsciiDoc文法で書かれたテキストを読み込んでパースします. 次に内蔵コンバータにパースツリーを渡します. これによりHTML5, DocBook 5やman(マニュアルmanページ)が出力されます.
119
+ 出力をカスタマイズしたりフォーマットを追加したりしたいときは, ユーザ独自のコンバータや {uri-tilt}[Tilt] 対応テンプレートを使用することができます.
121
120
 
122
- AsciidoctorはLinux, OS X (Mac)とWindowsで動き, 下記の {uri-ruby}[Ruby]実装の一つを必要とします.
121
+ AsciidoctorはオリジナルのAsciiDoc Pythonプロセッサ(`asciidoc.py`)に完全互換です.
122
+ Asciidoctorのテストスイートには, AsciiDoc文法との互換性を保証するために {uri-tests}[2350個を超えるテスト] が入っています.
123
+
124
+ Asciidoctorでは, AsciiDocの従来の文法のほかに, Asciidoctorで追加されたマークアップとフォーマッティングオプションが使用できます. フォントベースのアイコン (例えば, `+icon:fire[]+`) やUIエレメント(`+button:[Save]+`)がそれにあたります.
125
+ またAsciidoctorは, HTML5出力時のスタイルとして {uri-foundation}[Foundation] に基づいたモダンでレスポンシブなテーマも提供します.
126
+
127
+ == RubyのあるところAsciidoctorも動く
128
+
129
+ AsciidoctorはJRubyを用いてJVM上でも実行できます.
130
+ Javaや他のJVM言語からAsciidoctor APIを直接呼び出すには, {uri-asciidoctorj}[AsciidoctorJ] を使ってください.
131
+ AsciidoctorJを使ったAsciiDocの処理をビルドに直接組み込むビルドツール用プラグインとして, {uri-maven-plugin}[Apache Maven用], {uri-gradle-plugin}[Gradle用], および {uri-asciidoclet}[Javadoc用] が存在します.
132
+
133
+ AsciidoctorはJavaScriptでも実行可能です.
134
+ Rubyで書かれたソースを {uri-opal}[Opal] を使ってJavaScriptにトランスパイルすることで {uri-asciidoctorjs}[Asciidoctor.js] が作成されています.
135
+ Asciidoctor.jsはどんなJavaScript環境(WebブラウザやNode.jsを含む)でも動作する, JavaScript版の完全なAsciidoctorです.
136
+ Chrome, Atom, Bracketsやその他のウェブベースのツールで, AsciiDocをプレビューするための拡張機能にAsciidoctor.jsが使われています.
137
+
138
+ == 必要条件
139
+
140
+ AsciidoctorはLinux, macOS, およびWindowsで動作し, 下記の {uri-ruby}[Ruby]実装の一つを必要とします.
123
141
 
124
142
  * CRuby (aka MRI) 2.3 - 2.6
125
143
  * JRuby 9.1 - 9.2
@@ -128,58 +146,121 @@ AsciidoctorはLinux, OS X (Mac)とWindowsで動き, 下記の {uri-ruby}[Ruby]
128
146
 
129
147
  [CAUTION]
130
148
  ====
131
- もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError` に遭遇するでしょう.
132
- これを解決するには使っているコンソールの有効なコードページをUTF-8:
149
+ もし非英語環境のWindowsを使っているなら, Asciidoctorを起動した時に `Encoding::UndefinedConversionError` に遭遇するかもしれません.
150
+ これを解決するには, 以下のコマンドにより, 使っているコンソールの有効なコードページをUTF-8に変更することを推奨します:
133
151
 
134
152
  chcp 65001
135
153
 
136
- に変更することを推奨します.
137
154
  一度この変更をすると, Unicode関連の頭痛の種は消えるでしょう.
138
155
  もしEclipseのようなIDEを使っているなら, 同様にエンコーディングをUTF-8にするのを忘れないでください.
139
- AsciidoctorはUTF-8が使われているところで最高の働きを見せます.
156
+ AsciidoctorはUTF-8の環境において最も良好に動作します.
140
157
  ====
141
158
 
142
- == Installation
159
+ == インストール
143
160
 
144
- Asciidoctor (a) `gem install` コマンド, (b) Bundler あるいは (c) 有名Linuxディストリビューションのパッケージマネージャ を用いてインストールされます.
161
+ Asciidoctorは, (a) 主なLinuxディストリビューションのパッケージマネージャ, (b) macOSのHomebrew, (c) `gem install` コマンド(Windowsユーザに推奨), (d) Asciidoctor Dockerイメージ, あるいは(e) Bundlerを用いてインストールできます.
145
162
 
146
- TIP: Linuxパッケージマネージャを用いてインストールすることの利点は, もしRubyやRubyGemsライブラリがまだインストールされていなかったら, それらを処理してくれることです.
147
- 欠点はgemのリリース直後にはすぐには有効にならないことです.
148
- もし最新バージョンを使いたければ, 必ず `gem` コマンドを使いましょう.
163
+ Linuxパッケージマネージャを用いてインストールする利点は, もしRubyやRubyGemsライブラリがまだインストールされていなかったら, それらをインストールしてくれることです.
149
164
 
150
- === (a) gem install
165
+ === (a) Linuxのパッケージマネージャ
151
166
 
152
- ターミナルを開き, 入力しましょう (先頭の`$`は除く):
167
+ パッケージマネージャによってインストールされるAsciidoctorは最新バージョンではないかもしれません.
168
+ ディストリビューションの各リリースにおいてどのバージョンのAsciidoctorがパッケージされているかを確認するには, パッケージリポジトリを参照してください.
153
169
 
154
- $ gem install asciidoctor
170
+ * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
171
+ * https://www.archlinux.org/packages/?name=asciidoctor[Arch Linux (asciidoctor)]
172
+ * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
173
+ * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (asciidoctor)]
174
+ * https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
175
+ * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
155
176
 
156
- もし, 先行リリースバージョン(例えばリリース候補版)をインストールしたければ
177
+ パッケージマネージャによってインストールされるバージョンよりも新しいAsciidoctorを使用したい場合は, <<gem-install,gemのインストール方法>> を参照してください.
157
178
 
158
- $ gem install asciidoctor --pre
179
+ ==== apk (Alpine Linux)
159
180
 
160
- .アップグレード
161
- [TIP]
162
- ====
163
- もしAsciidoctorの以前のバージョンがインストール済みであれば, 以下によってアップデートできます:
181
+ Alpine Linuxにgemをインストールするには, ターミナルを開き, 以下を入力してください:
164
182
 
165
- $ gem update asciidoctor
183
+ $ sudo apk add asciidoctor
166
184
 
167
- もし gem update の代わりに `gem install` を使ってgemを新バージョンにした場合, 複数バージョンがインストールされるでしょう.
168
- そのときは, 以下のgemコマンドで古いバージョンを削除しましょう:
185
+ ==== pacman (Arch Linux)
169
186
 
170
- $ gem cleanup asciidoctor
171
- ====
187
+ Archベースのディストリビューションにgemをインストールするには, ターミナルを開き, 以下を入力してください:
188
+
189
+ $ sudo pacman -S asciidoctor
190
+
191
+ ==== APT
192
+
193
+ Debian, またはUbuntuなどDebianベースのディストリビューションでは, APTを使ってAsciidoctorをインストールしてください.
194
+ Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
195
+
196
+ $ sudo apt-get install -y asciidoctor
197
+
198
+ ==== DNF
199
+
200
+ Fedora, CentOS, RHELなどRPMベースのLinuxディストリビューションでは, DNFパッケージマネージャを使ってAsciidoctorをインストールしてください.
201
+ Asciidoctorパッケージをインストールするには, ターミナルを開き, 以下を入力してください:
202
+
203
+ $ sudo dnf install -y asciidoctor
204
+
205
+ === (b) Homebrew (macOS)
206
+
207
+ macOSでは, パッケージマネージャHomebrewを使用してAsciidoctorをインストールすることができます.
208
+ Homebrewをお持ちでない場合は, まず https://brew.sh/[brew.sh] の説明に従ってHomebrewをインストールしてください.
209
+ Homebrewをインストールできたら, `asciidoctor` gemをインストールすることができます.
210
+ ターミナルを開き, 以下を入力してください:
211
+
212
+ $ brew install asciidoctor
213
+
214
+ Homebrewにより, システムレベルのgemとは別の独立したprefixのパスに `asciidoctor` gemがインストールされます.
215
+
216
+ === (c) Windows
172
217
 
173
- === (b) Bundler
218
+ WindowsでAsciidoctorを使う場合は, 簡単な方法が2つあります.
174
219
 
175
- . プロジェクトフォルダーのルート(かカレントディレクトリ)にGemfileを作成
220
+ ==== Chocolatey
221
+
222
+ すでにお使いのマシンで https://chocolatey.org[chocolatey] を使用しているなら, 以下の方法を使用することができます:
223
+
224
+ [source]
225
+ ----
226
+ choco install ruby
227
+ ----
228
+
229
+ そのあとは <<gem-install,gemのインストール方法>> に従ってください.
230
+
231
+ ==== Rubyinstaller
232
+
233
+ https://rubyinstaller.org/downloads/[Rubyinstaller] を使用したい場合は, お使いのWindowsのバージョンに適したRubyinstallerをダウンロードしてRubyをインストールしたあと, <<gem-install,gemのインストール方法>> に従ってください.
234
+
235
+ [#gem-install]
236
+ === (d) gem install
237
+
238
+ Asciidoctorを `gem install` を使ってインストールするのであれば, その前に https://rvm.io[RVM] を使ってhomeディレクトリ(つまりユーザ領域)にRubyをインストールしておくべきです.
239
+ そうすれば, `gem` コマンドを使用して安全にAsciidoctor gemのインストールやアップデートができます.
240
+ RVMを使用すると, システムから隔離された場所にgemがインストールされます.
241
+
242
+ ターミナルを開き, 以下のように入力してください:
243
+
244
+ $ gem install asciidoctor
245
+
246
+ もし, 先行リリースバージョン(例えばリリース候補版)をインストールしたければ以下のようにします.
247
+
248
+ $ gem install asciidoctor --pre
249
+
250
+ === (e) Docker
251
+
252
+ {uri-install-docker}[Installing Asciidoctor using Docker]を参照してください.
253
+
254
+ === (f) Bundler
255
+
256
+ . プロジェクトのルートフォルダ(またはカレントディレクトリ)にGemfileを作成
176
257
  . `asciidoctor` gemをGemfileに以下のように追加:
177
258
  +
178
259
  [source,subs=attributes+]
179
260
  ----
180
261
  source 'https://rubygems.org'
181
262
  gem 'asciidoctor'
182
- # or specify the version explicitly
263
+ # または明示的にバージョンを指定
183
264
  # gem 'asciidoctor', '{release-version}'
184
265
  ----
185
266
 
@@ -189,111 +270,89 @@ gem 'asciidoctor'
189
270
  $ bundle
190
271
 
191
272
  gemをアップグレードするには, Gemfileで新バージョンを指定し, `bundle` を再び実行してください.
192
- `bundle update` は他のgemもアップデートするため推奨されて *いない* ので, 思わぬ結果になるかも知れません.
273
+ `bundle update` を(gemを指定せずに)行うことは推奨 *されません* . 他のgemもアップデートされて思わぬ結果になるかもしれないためです.
193
274
 
194
- === (c) Linux package managers
275
+ == アップグレード
195
276
 
196
- ==== DNF (Fedora 21 or greater)
277
+ オペレーティングシステムのパッケージマネージャでAsciidoctorをインストールしたのであれば, おそらくパッケージは自動的にアップデートされるように設定されています. その場合は, gemを手動でアップデートする必要はありません.
197
278
 
198
- dnfを使いFedora21かそれ以上にインストールするには, ターミナルを開き, 以下を入力してください:
279
+ === apk (Alpine Linux)
199
280
 
200
- $ sudo dnf install -y asciidoctor
201
-
202
- gemをアップグレードするには:
203
-
204
- $ sudo dnf update -y asciidoctor
205
-
206
- TIP: お使いのシステムは自動的にrpmパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
281
+ gemをアップグレードするには, 以下を使用してください:
207
282
 
208
- ==== apt-get (Debian, Ubuntu, Mint)
209
-
210
- Debian, UbuntuまたはMintにインストールするには, ターミナルを開き, 以下を入力してください:
283
+ $ sudo apk add -u asciidoctor
211
284
 
212
- $ sudo apt-get install -y asciidoctor
285
+ === APT
213
286
 
214
- gemをアップグレードするには:
287
+ gemをアップグレードするには, 以下を使用してください:
215
288
 
216
289
  $ sudo apt-get upgrade -y asciidoctor
217
290
 
218
- TIP: お使いのシステムは自動的にdebパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
219
-
220
- パッケージマネージャ(apt-get)によってインストールされたバージョンのAsciidoctorは最新リリースのAsciidoctorではないかもしれません.
221
- ディストリビューションのリリース毎に, どのバージョンがパッケージされているかはパッケージリポジトリを調べてください.
222
-
223
- * https://packages.debian.org/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[asciidoctor package by Debian release]
224
- * https://packages.ubuntu.com/search?keywords=asciidoctor&searchon=names&exact=1&suite=all&section=all[asciidoctor package by Ubuntu release]
225
- * https://community.linuxmint.com/software/view/asciidoctor[asciidoctor package by Mint release]
291
+ === DNF
226
292
 
227
- [CAUTION]
228
- ====
229
- パッケージマネージャによって管理されているgemをアップデートするのに `gem udpate` コマンドを使うなといわれるでしょう.
230
- そのようなことをするのは, パッケージマネージャがファイル(/usr/local下にインストールされた)を追跡できなくなるためにシステムが不安定な状態にするためです.
231
- 単純に, システムgemはパッケージマネージャによってのみ管理されるべきです.
293
+ gemをアップグレードするには, 以下を使用してください:
232
294
 
233
- もし, パッケージマネージャによってインストールされたのより新しいバージョンのAsciidoctorを使いたければ, https://rvm.io[RVM] https://github.com/rbenv/rbenv[rbenv]を使ってRubyをホームディレクトリ(すなわち, ユーザースペース)にインストールするべきです.
234
- それから, 安心して `gem` コマンドをAsciidoctorのアップデート, インストールのために使うことができます.
235
- RVMやrbenvを使っているなら, gemはシステムからは孤立した場所にインストールされます.
236
- ====
295
+ $ sudo dnf update -y asciidoctor
237
296
 
238
- ==== apk (Alpine Linux)
297
+ === Homebrew (macOS)
239
298
 
240
- Alpine Linuxにgemをインストールするには, ターミナルを開き, 以下を入力してください:
299
+ gemをアップグレードするには, 以下を使用してください:
241
300
 
242
- $ sudo apk add asciidoctor
301
+ $ brew update
302
+ $ brew upgrade asciidoctor
243
303
 
244
- gemをアップグレードするには:
304
+ === gem install
245
305
 
246
- $ sudo apk add -u asciidoctor
306
+ `gem` コマンドを使ってAsciidoctorをインストールした場合は, 新しいバージョンのAsciidoctorがリリースされたら手動でアップグレードする必要があります.
307
+ 以下を入力することでアップグレードできます:
247
308
 
248
- TIP: お使いのシステムは自動的にapkパッケージをアップデートするよう設定されているかも知れません.その場合, gemのアップデートのためにあなたがすべきことはありません.
309
+ $ gem install asciidoctor
249
310
 
250
- === Other installation options
311
+ `gem install` を使って新しいバージョンのgemをインストールすると, 複数のバージョンがインストールされた状態になります.
312
+ 以下のコマンドを使って古いバージョンを削除してください.
251
313
 
252
- * {uri-install-docker}[Installing Asciidoctor using Docker]
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]
314
+ $ gem cleanup asciidoctor
256
315
 
257
- == Usage
316
+ == 使い方
258
317
 
259
- Asciidoctorのインストールに成功すれば, `asciidoctor` コマンドラインインターフェース(CLI)がPATH中で有効になります.
260
- 確認のために, 以下をターミナルで実行しましょう:
318
+ Asciidoctorのインストールが成功すると, `asciidoctor` コマンドがPATHに存在するようになり, Asciidoctorのコマンドラインインターフェース(CLI)が使用できるようになります.
319
+ 確認のために, ターミナルで以下を実行しましょう:
261
320
 
262
321
  $ asciidoctor --version
263
322
 
264
- AsciidoctorのバージョンとRuby環境についての情報がターミナルに出力されたのを見ることができるはずです.
323
+ AsciidoctorのバージョンとRuby環境についての情報がターミナルに出力されるはずです.
265
324
 
266
325
  [.output,subs=attributes+]
267
326
  ....
268
327
  Asciidoctor {release-version} [https://asciidoctor.org]
269
- Runtime Environment (ruby 2.4.1p111 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
328
+ Runtime Environment (ruby 2.6.0p0 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)
270
329
  ....
271
330
 
272
- AsciidoctorはAPIを提供します.
273
- APIは他のRubyソフトウェア, Rails, SinatraGitHub, そして他の言語, Java (via {uri-asciidoctorj}[AsciidoctorJ] )JavaScript (via {uri-asciidoctorjs}[Asciidoctor.js])との統合を意図しています.
331
+ AsciidoctorはAPIも提供します.
332
+ APIは他のRubyソフトウェア, たとえばRails, Sinatra, GitHub, そして他の言語, たとえばJava ({uri-asciidoctorj}[AsciidoctorJ] 経由)JavaScript ({uri-asciidoctorjs}[Asciidoctor.js] 経由)と組み合わせて使用するためのものです.
274
333
 
275
- === Command line interface (CLI)
334
+ === コマンドラインインターフェース (CLI)
276
335
 
277
- `asciidoctor` コマンドはAsciidoctorをコマンドライン(つまりターミナル)から起動することを可能にします.
336
+ `asciidoctor` コマンドによりコマンドライン(つまりターミナル)からAsciidoctorを起動することができます.
278
337
 
279
- 次のコマンドはファイルREADME.adocHTMLに変換し, 結果を同じディレクトリのREADME.htmlに保存します.
280
- 生成されたHTMLファイルの名前はソースファイル依存し, その拡張子を `.html` に変えます.
338
+ 次のコマンドにより, README.adocというファイルがHTMLに変換され, 結果が同じディレクトリのREADME.htmlとして保存されます.
339
+ 生成されるHTMLファイルの名前は, ソースファイルのファイル名の拡張子を `.html` に替えたものとなります.
281
340
 
282
341
  $ asciidoctor README.adoc
283
342
 
284
- Asciidoctorプロセッサに様々なフラグやスイッチを与えることで制御できます.それは以下を用いて調べることができます:
343
+ さまざまなフラグやスイッチを与えることでAsciidoctorプロセッサをコントロールすることができます. フラグやスイッチの説明は以下のコマンドで表示されます:
285
344
 
286
345
  $ asciidoctor --help
287
346
 
288
- 例えば, ファイルを異なるディレクトリに書き出すには:
347
+ 例えば, ファイルを異なるディレクトリに書き出すには以下を使用します:
289
348
 
290
349
  $ asciidoctor -D output README.adoc
291
350
 
292
- `asciidoctor` {uri-manpage}[man page] はコマンドライン・インタフェースの完全なリファレンスを提供します.
351
+ コマンドラインインタフェースの完全なリファレンスは `asciidoctor` {uri-manpage}[manページ] にあります.
293
352
 
294
- `asciidoctor` コマンドの使い方についてもっと学ぶには以下を参照してください.
353
+ `asciidoctor` コマンドの使い方の詳細については以下を参照してください.
295
354
 
296
- * {uri-render-doc}[How do I convert a document?]
355
+ * {uri-convert-doc}[How do I convert a document?]
297
356
  * {uri-themes-doc}[How do I use the Asciidoctor stylesheet factory to produce custom themes?]
298
357
 
299
358
  === Ruby API
@@ -303,16 +362,16 @@ Asciidoctorをアプリケーションの中で使うには, まずgemをrequire
303
362
  [source]
304
363
  require 'asciidoctor'
305
364
 
306
- それから, AsciiDocソースファイルをHTMLファイルに変換できます:
365
+ そうすると, 以下のようにしてAsciiDocソースファイルをHTMLファイルに変換できます:
307
366
 
308
367
  [source]
309
368
  Asciidoctor.convert_file 'README.adoc', to_file: true, safe: :safe
310
369
 
311
- WARNING: AsciidoctorをAPI経由で使っている時, デフォルトのセーフモードは `:secure` です.
312
- セキュアモードでは, `include` ディレクティブを含むいくつかのコア機能は無効化されています.
313
- もしこれらの機能を有効化したい場合, 明示的にセーフモードを `:server` (推奨)か `:safe` にする必要があります.
370
+ WARNING: AsciidoctorをAPI経由で使っているとき, デフォルトのセーフモードは `:secure` (セキュアモード)です.
371
+ セキュアモードでは, `include` ディレクティブを含むいくつかのコア機能が無効化されています.
372
+ これらの機能を有効化したい場合, 明示的にセーフモードを `:server` (推奨)か `:safe` にする必要があります.
314
373
 
315
- AsciiDoc文字列を埋め込みHTML(HTMLページヘの挿入)へ変換することもできます:
374
+ AsciiDoc文字列を, 埋め込み用HTML(HTMLページヘの挿入用)に変換することもできます:
316
375
 
317
376
  [source]
318
377
  ----
@@ -320,7 +379,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
320
379
  Asciidoctor.convert content, safe: :safe
321
380
  ----
322
381
 
323
- もし完全なHTMLドキュメントを求めるのであれば, `header_footer` オプションを以下の通り有効にしてください:
382
+ もし完全なHTMLドキュメントが必要であれば, 以下のように `header_footer` オプションを有効にしてください:
324
383
 
325
384
  [source]
326
385
  ----
@@ -328,7 +387,7 @@ content = '_Zen_ in the art of writing https://asciidoctor.org[AsciiDoc].'
328
387
  html = Asciidoctor.convert content, header_footer: true, safe: :safe
329
388
  ----
330
389
 
331
- パースされたドキュメントにアクセスしたいのなら, 変換を個々のステップに分割することが出来ます:
390
+ パースされたドキュメントにアクセスしたい場合は, 変換を複数のステップに分割します:
332
391
 
333
392
  [source]
334
393
  ----
@@ -338,81 +397,79 @@ puts document.doctitle
338
397
  html = document.convert
339
398
  ----
340
399
 
341
- Asciidoctorの生成する出力が気に入らないのであれば, _あなたはそれを変更できる_ ことを忘れないでください!
342
- Asciidoctorはパースされたドキュメントを生成された出力に変換する処理を扱うカスタムコンバーターをサポートしています.
400
+ Asciidoctorの生成する出力が気に入らない場合は, _あなたはそれを変更できる_ ことを忘れないでください!
401
+ パースされたドキュメントを出力形式に変換するコンバータは, カスタマイズが可能です.
343
402
 
344
- 断片的な出力をカスタマイズする簡単な方法の一つはテンプレートコンバーターを使うことです.
345
- テンプレートコンバーターによって, ドキュメント中のあらゆるノードの変換を扱うために {uri-tilt}[Tilt]-supportedテンプレートファイルを使うことができます.
403
+ 出力を部分的にカスタマイズする簡単な方法としてはテンプレートコンバータがあります.
404
+ テンプレートコンバータでは, ドキュメントの各ノードの変換に {uri-tilt}[Tilt]対応テンプレートファイルを使うことができます.
346
405
 
347
- そのようにすれば, 出力を100%制御することが _できます_ .
348
- APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[user manual] を参照してください.
406
+ さまざまな方法を使って出力は100%制御することが _できます_ .
407
+ APIの使い方や出力のカスタマイズ方法についてのより詳しい情報は {uri-user-manual}[ユーザマニュアル] を参照してください.
349
408
 
350
- == Contributing
409
+ == コントリビューション
351
410
 
352
- {uri-freesoftware}[free software] の精神においては, _everyone_ がこのプロジェクトを改良するのをたすけることが勧められています.
353
- もしエラーや手抜かりをソースコード, ドキュメント, あるいはウェブサイトに見つけたのなら, 恥じることなく修正と共にpull requestの開設やissueの送信をしてください.
354
- New contributors are always welcome!
411
+ 新しいコントリビューションを常に歓迎します!
412
+ もしソースコード, ドキュメント, あるいはウェブサイトに間違いや不備を見つけたら遠慮なく, イシューを作成するか, 修正をおこなってpull requestを作成してください.
355
413
 
356
- *あなた* にもできることがあります:
414
+ *あなた* にもできることがあります:
357
415
 
358
- * 先行バージョン(alpha, beta or preview)の使用
416
+ * 先行バージョン(alpha, beta, またはpreview)の使用
359
417
  * バグレポート
360
418
  * 新機能提案
361
- * ドキュメントの執筆
362
- * 仕様の執筆
363
- * コーディング -- _パッチでも, 足りなすぎるなんてことはありません_
419
+ * ドキュメントの執筆または編集
420
+ * テストをつけてコードを書くこと -- _どのようなパッチであれ小さすぎるなどということはありません_
364
421
  ** typoの修正
365
422
  ** コメントの追加
366
423
  ** 一貫性のないホワイトスペースの除去
367
424
  ** テストの記述!
368
425
  * リファクタリング
369
- * {uri-issues}[issues] の修正
370
- * パッチの批評
426
+ * {uri-issues}[イシュー] の解決
427
+ * パッチのレビュー
371
428
 
372
- {uri-contribute}[Contributing] ガイドはどうやってスタイルをつくるか, issueを送るか, 機能リクエスト, コーディング, ドキュメンテーションをAsciidoctor Projectにするかについての情報を提供しています.
429
+ Asciidoctorプロジェクトにイシュー, 機能リクエスト, コード, ドキュメントを送る際の, 作成方法, スタイル, および送り方は, {uri-contribute}[Contributing] ガイドに記載されています.
373
430
 
374
- == Getting Help
431
+ == 助けを得る
375
432
 
376
- Asciidoctorプロジェクトはあなたが簡単に著作を書いて, 配布するのをたすけるため開発されています.
377
- しかしあなたのフィードバックなしにはできません!
378
- ディスカッションリストで, Twitterで, チャットルームで, 質問し, プロジェクトのあらゆる側面について話し合うようお勧めします.
433
+ Asciidoctorは, コンテンツの執筆と公開を簡単にするために開発されています.
434
+ しかしあなたからのフィードバックがなくてはAsciidoctorの開発は進みません!
435
+ ディスカッションリスト, Twitter, チャットルームを使って, 質問をしたりプロジェクトのさまざまな側面について話し合ったりすることをお勧めします.
379
436
 
380
- Discussion list (Nabble):: {uri-discuss}
381
- Twitter:: #asciidoctor hashtag or @asciidoctor mention
382
- Chat (Gitter):: image:https://badges.gitter.im/Join%20In.svg[Gitter, link=https://gitter.im/asciidoctor/asciidoctor]
437
+ チャット(Zulip):: {uri-chat}
438
+ ディスカッションリスト(Nabble):: {uri-discuss}
439
+ Twitter:: ハッシュタグ https://twitter.com/search?f=tweets&q=%23asciidoctor[#asciidoctor] またはメンション https://twitter.com/asciidoctor[@asciidoctor]
383
440
 
384
441
  ifdef::env-github[]
385
- 以下のプロジェクトサイトに、Asciidoctorに関するさらに詳しい情報やドキュメントがあります。
442
+ 以下のプロジェクトサイトに, Asciidoctorに関するさらに詳しい情報やドキュメントがあります.
386
443
 
387
- {uri-project}/[Home] | {uri-news}[News] | {uri-docs}[Docs]
444
+ {uri-project}[Home] | {uri-news}[News] | {uri-docs}[Docs]
388
445
  endif::[]
389
446
 
390
- GitHub上のAsciidoctorはプロジェクトのソースコード, イシュートラッカー, サブプロジェクトを管理しています.
447
+ GitHub上のAsciidoctorのorganizationではプロジェクトのソースコード, イシュートラッカー, サブプロジェクトが管理されています.
391
448
 
392
- Source repository (git):: {uri-repo}
393
- Issue tracker:: {uri-issues}
394
- Asciidoctor organization on GitHub:: {uri-org}
449
+ ソースリポジトリ(git):: {uri-repo}
450
+ イシュートラッカー:: {uri-issues}
451
+ GitHub上のAsciidoctororganization:: {uri-org}
395
452
 
396
- == Copyright and Licensing
453
+ == ライセンス
397
454
 
398
- Copyright (C) 2012-2019 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
399
- 本ソフトウェアはMITライセンスのもとで自由に使用できます.
455
+ Copyright (C) 2012-2021 Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
456
+ 本ソフトウェアはMITライセンスのもとで使用できます.
400
457
 
401
- 詳細は {uri-license}[LICENSE] ファイルを参照してください.
458
+ ライセンスの詳細については {uri-license}[LICENSE] ファイルを参照してください.
402
459
 
403
- == Authors
460
+ == 作者
404
461
 
405
- *Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] が先導し, Asciidoctorの素晴らしきコミュニティの数多くのメンバからコントリビューションを受けてきました.
406
- このプロジェクトは2012年から https://github.com/nickh[Nick Hengeveld] の {uri-prototype}[プロトタイプ] をベースに https://github.com/erebor[Ryan Waldron] により創始されました.
462
+ *Asciidoctor* は https://github.com/mojavelinux[Dan Allen] と https://github.com/graphitefriction[Sarah White] がリードし, Asciidoctorの素晴らしきコミュニティの {uri-contributors}[数多くのメンバ] からコントリビューションを受けてきました.
463
+ このプロジェクトは https://github.com/nickh[Nick Hengeveld] の {uri-prototype}[プロトタイプ] をベースに https://github.com/erebor[Ryan Waldron] により2012年から創始されました.
407
464
 
408
465
  *AsciiDoc* は Stuart Rackham により創始され, AsciiDocコミュニティの数多くのメンバからコントリビューションを受けてきました.
409
466
 
410
467
  ifndef::env-site[]
411
- == Changelog
468
+ == 変更履歴
412
469
 
413
470
  ifeval::[{safe-mode-level} < 20]
414
471
  include::CHANGELOG.adoc[tag=compact,leveloffset=+1]
415
472
  endif::[]
416
473
 
417
- リリースごとの変更一覧は {uri-changelog}[CHANGELOG] を参照してください.
474
+ 過去のリリースの完全な変更点リストについては {uri-changelog}[CHANGELOG] を参照してください.
418
475
  endif::[]