Changeset View
Changeset View
Standalone View
Standalone View
autotests/folding/asciidoc.adoc.fold
1 | = AsciiDoc Syntax Highlighting | 1 | <beginfold id='1'>= </beginfold id='1'>AsciiDoc Syntax Highlighting | ||
---|---|---|---|---|---|
2 | // There are multiple level 0 sections, so use book instead of article. | 2 | // There are multiple level 0 sections, so use book instead of article. | ||
3 | :doctype: book | 3 | :doctype: book | ||
4 | // For nice admonition and callout icons. | 4 | // For nice admonition and callout icons. | ||
Context not available. | |||||
11 | Further sections are intended for testing the supported features of AsciiDoc. | 11 | Further sections are intended for testing the supported features of AsciiDoc. | ||
12 | 12 | | |||
13 | 13 | | |||
14 | = Known Not to Work | 14 | <endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Known Not to Work | ||
15 | 15 | | |||
16 | There are a couple of things that are known not to work. | 16 | There are a couple of things that are known not to work. | ||
17 | 17 | | |||
18 | 18 | | |||
19 | == Block | 19 | <beginfold id='1'>== </beginfold id='1'>Block | ||
20 | 20 | | |||
21 | * Highlighting of attributes inside a block title. | 21 | * Highlighting of attributes inside a block title. | ||
22 | 22 | | |||
Context not available. | |||||
34 | * Multiple lines of meta data. | 34 | * Multiple lines of meta data. | ||
35 | + | 35 | + | ||
36 | .For delimited blocks, Asciidoctor supports something like this: | 36 | .For delimited blocks, Asciidoctor supports something like this: | ||
37 | <beginfold id='2'>-----</beginfold id='2'> | 37 | <beginfold id='3'>-----</beginfold id='3'> | ||
38 | [source] | 38 | [source] | ||
39 | [, options="nowrap"] | 39 | [, options="nowrap"] | ||
40 | ---- | 40 | ---- | ||
41 | puts 'hello' | 41 | puts 'hello' | ||
42 | ---- | 42 | ---- | ||
43 | <endfold id='2'>-----</endfold id='2'> | 43 | <endfold id='3'>-----</endfold id='3'> | ||
44 | + | 44 | + | ||
45 | Syntax highlighting does not recognize the additional meta data lines and will rather interpret this as a contiguous block. | 45 | Syntax highlighting does not recognize the additional meta data lines and will rather interpret this as a contiguous block. | ||
46 | 46 | | |||
47 | * https://asciidoctor.org/docs/user-manual/#discrete-headings[Discrete headings] inside block. | 47 | * https://asciidoctor.org/docs/user-manual/#discrete-headings[Discrete headings] inside block. | ||
48 | + | 48 | + | ||
49 | <beginfold id='2'>-----</beginfold id='2'> | 49 | <beginfold id='3'>-----</beginfold id='3'> | ||
50 | **** | 50 | **** | ||
51 | Some text. | 51 | Some text. | ||
52 | 52 | | |||
Context not available. | |||||
55 | 55 | | |||
56 | Some more text. | 56 | Some more text. | ||
57 | **** | 57 | **** | ||
58 | <endfold id='2'>-----</endfold id='2'> | 58 | <endfold id='3'>-----</endfold id='3'> | ||
59 | + | 59 | + | ||
60 | Syntax highlighting does not recognize discrete headings inside a block. | 60 | Syntax highlighting does not recognize discrete headings inside a block. | ||
61 | If a normal section title is marked as being discrete, highlighting works. | 61 | If a normal section title is marked as being discrete, highlighting works. | ||
62 | 62 | | |||
63 | 63 | | |||
64 | == Custom Styles | 64 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Custom Styles | ||
65 | 65 | | |||
66 | * Highlighting of formatted text within the phrase to be styled. | 66 | * Highlighting of formatted text within the phrase to be styled. | ||
67 | + | 67 | + | ||
Context not available. | |||||
69 | 69 | | |||
70 | * Highlighting of styles with a phrase that spans multiple lines. | 70 | * Highlighting of styles with a phrase that spans multiple lines. | ||
71 | + | 71 | + | ||
72 | <beginfold id='2'>----</beginfold id='2'> | 72 | <beginfold id='3'>----</beginfold id='3'> | ||
73 | [big]#this | 73 | [big]#this | ||
74 | is | 74 | is | ||
75 | not | 75 | not | ||
76 | highlighted# | 76 | highlighted# | ||
77 | <endfold id='2'>----</endfold id='2'> | 77 | <endfold id='3'>----</endfold id='3'> | ||
78 | 78 | | |||
79 | 79 | | |||
80 | == Formatted/Quoted Text | 80 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Formatted/Quoted Text | ||
81 | 81 | | |||
82 | * Highlighting of formatted/quoted text (e.g. monospaced) that spans multiple lines. | 82 | * Highlighting of formatted/quoted text (e.g. monospaced) that spans multiple lines. | ||
83 | 83 | | |||
Context not available. | |||||
105 | And even more complex combinations. | 105 | And even more complex combinations. | ||
106 | 106 | | |||
107 | 107 | | |||
108 | == List | 108 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>List | ||
109 | 109 | | |||
110 | * Inside a list, indented lines without leading asterisks or hyphen start highlighting for a verbatim paragraph. | 110 | * Inside a list, indented lines without leading asterisks or hyphen start highlighting for a verbatim paragraph. | ||
111 | Asciidoctor renders this as normal text. | 111 | Asciidoctor renders this as normal text. | ||
112 | 112 | | |||
113 | 113 | | |||
114 | == Macro | 114 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Macro | ||
115 | 115 | | |||
116 | * Highlighting of macros with a text argument that spans multiple lines. | 116 | * Highlighting of macros with a text argument that spans multiple lines. | ||
117 | + | 117 | + | ||
118 | <beginfold id='2'>----</beginfold id='2'> | 118 | <beginfold id='3'>----</beginfold id='3'> | ||
119 | xref:id[this works just fine] | 119 | xref:id[this works just fine] | ||
120 | 120 | | |||
121 | xref:id[ | 121 | xref:id[ | ||
Context not available. | |||||
123 | a text that spans multiples | 123 | a text that spans multiples | ||
124 | does not work | 124 | does not work | ||
125 | ] | 125 | ] | ||
126 | <endfold id='2'>----</endfold id='2'> | 126 | <endfold id='3'>----</endfold id='3'> | ||
127 | 127 | | |||
128 | 128 | | |||
129 | == Quote, Verse | 129 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Quote, Verse | ||
130 | 130 | | |||
131 | * Highlighting for single quote symbol `"`. | 131 | * Highlighting for single quote symbol `"`. | ||
132 | + | 132 | + | ||
Context not available. | |||||
135 | * Highlighting for Markdown style quotes. | 135 | * Highlighting for Markdown style quotes. | ||
136 | 136 | | |||
137 | 137 | | |||
138 | == Replacement | 138 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Replacement | ||
139 | 139 | | |||
140 | Highlighting for replacements is limited to those listed in the https://asciidoctor.org/docs/user-manual/#replacements[Asciidoctor Manual] and numerical character references. | 140 | Highlighting for replacements is limited to those listed in the https://asciidoctor.org/docs/user-manual/#replacements[Asciidoctor Manual] and numerical character references. | ||
141 | 141 | | |||
Context not available. | |||||
151 | * `+φ+` resulting in φ | 151 | * `+φ+` resulting in φ | ||
152 | 152 | | |||
153 | 153 | | |||
154 | == Section | 154 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Section | ||
155 | 155 | | |||
156 | * Setext style for section titles. | 156 | * Setext style for section titles. | ||
157 | + | 157 | + | ||
Context not available. | |||||
163 | ** #marked# | 163 | ** #marked# | ||
164 | ** `monospaced` | 164 | ** `monospaced` | ||
165 | 165 | | |||
166 | * Code folding. | | |||
167 | + | | |||
168 | Attempts made so far delivered unsatisfactory results. | | |||
169 | | ||||
170 | 166 | | |||
171 | == Table | 167 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Table | ||
172 | 168 | | |||
173 | * Highlighting of tables with custom separator. | 169 | * Highlighting of tables with custom separator. | ||
174 | ** The custom separator will _not_ be highlighted. | 170 | ** The custom separator will _not_ be highlighted. | ||
Context not available. | |||||
185 | 181 | | |||
186 | 182 | | |||
187 | 183 | | |||
188 | = Admonition | 184 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Admonition | ||
189 | 185 | | |||
190 | == Simple Format | 186 | <beginfold id='1'>== </beginfold id='1'>Simple Format | ||
191 | 187 | | |||
192 | NOTE: A simple note. | 188 | NOTE: A simple note. | ||
193 | 189 | | |||
194 | <beginfold id='1'>////</beginfold id='1'> | 190 | <beginfold id='2'>////</beginfold id='2'> | ||
195 | FIXME: In the paragraph below is no note as it is started in the middle of the paragraph. | 191 | FIXME: In the paragraph below is no note as it is started in the middle of the paragraph. | ||
196 | This is problematic as we would need to know that the note line is not the first line in the paragraph. | 192 | This is problematic as we would need to know that the note line is not the first line in the paragraph. | ||
197 | <endfold id='1'>////</endfold id='1'> | 193 | <endfold id='2'>////</endfold id='2'> | ||
198 | Some text. | 194 | Some text. | ||
199 | NOTE: This is not a separate note as it is part of the paragraph started with the line above. | 195 | NOTE: This is not a separate note as it is part of the paragraph started with the line above. | ||
200 | 196 | | |||
Context not available. | |||||
225 | WARNING: This is a WARNING. | 221 | WARNING: This is a WARNING. | ||
226 | 222 | | |||
227 | 223 | | |||
228 | == Block Format | 224 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Block Format | ||
229 | 225 | | |||
230 | .Contiguous | 226 | .Contiguous | ||
231 | [NOTE] | 227 | [NOTE] | ||
Context not available. | |||||
241 | .Delimited | 237 | .Delimited | ||
242 | [NOTE] | 238 | [NOTE] | ||
243 | [[delimited-note-id]] | 239 | [[delimited-note-id]] | ||
244 | <beginfold id='2'>====</beginfold id='2'> | 240 | <beginfold id='3'>====</beginfold id='3'> | ||
245 | This is a *note* in block format. | 241 | This is a *note* in block format. | ||
246 | As a block, the note may have a title | 242 | As a block, the note may have a title | ||
247 | // comment inside block | 243 | // comment inside block | ||
248 | 244 | | |||
249 | In block format, multiple lines, paragraphs etc. are possible. | 245 | In block format, multiple lines, paragraphs etc. are possible. | ||
250 | <endfold id='2'>====</endfold id='2'> | 246 | <endfold id='3'>====</endfold id='3'> | ||
251 | 247 | | |||
252 | There is no delimited admonition block without block name. | 248 | There is no delimited admonition block without block name. | ||
253 | Using `====` delimiter without a block name results in an example block. | 249 | Using `====` delimiter without a block name results in an example block. | ||
254 | 250 | | |||
255 | .Using open block | 251 | .Using open block | ||
256 | [NOTE] | 252 | [NOTE] | ||
257 | <beginfold id='2'>--</beginfold id='2'> | 253 | <beginfold id='3'>--</beginfold id='3'> | ||
258 | Inside the open block note. | 254 | Inside the open block note. | ||
259 | <endfold id='2'>--</endfold id='2'> | 255 | <endfold id='3'>--</endfold id='3'> | ||
260 | 256 | | |||
261 | 257 | | |||
262 | = [[main-1]]An[[main-2]]chor[[main-3]] and Cross Reference | 258 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= [[main-1]]An[[main-2]]chor[[main-3]] and Cross Reference | ||
263 | 259 | | |||
264 | == [[section-1]][[section-2]] An[[section-3]][[section-4]]chor[[section-5]] | 260 | <beginfold id='1'>== </beginfold id='1'>[[section-1]][[section-2]] An[[section-3]][[section-4]]chor[[section-5]] | ||
265 | 261 | | |||
266 | [[isolated-anchor]] | 262 | [[isolated-anchor]] | ||
267 | Isolated anchor. | 263 | Isolated anchor. | ||
Context not available. | |||||
289 | Also not after the closing `]`. | 285 | Also not after the closing `]`. | ||
290 | 286 | | |||
291 | 287 | | |||
292 | === Not an anchor | 288 | <beginfold id='1'>=== </beginfold id='1'>Not an anchor | ||
293 | 289 | | |||
294 | [[ not-an-anchor]] | 290 | [[ not-an-anchor]] | ||
295 | because of the space after the opening brackets. | 291 | because of the space after the opening brackets. | ||
Context not available. | |||||
314 | Also [#not-an-anchor]because of missing referred text (e.g. `#some text#`). | 310 | Also [#not-an-anchor]because of missing referred text (e.g. `#some text#`). | ||
315 | 311 | | |||
316 | 312 | | |||
317 | === Escaped | 313 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
318 | 314 | | |||
319 | This is an escaped \[[anchor-id, some #anchor# label]] anchor. | 315 | This is an escaped \[[anchor-id, some #anchor# label]] anchor. | ||
320 | 316 | | |||
Context not available. | |||||
324 | 320 | | |||
325 | \[[anchor-id]] | 321 | \[[anchor-id]] | ||
326 | 322 | | |||
327 | <beginfold id='1'>////</beginfold id='1'> | 323 | <beginfold id='2'>////</beginfold id='2'> | ||
328 | FIXME: highlighting differs | 324 | FIXME: highlighting differs | ||
329 | Asciidoctor seems to just pass through the anchor when escaping it. | 325 | Asciidoctor seems to just pass through the anchor when escaping it. | ||
330 | This behaviour is rather unexpected, as in other cases the escaped contents is subject to further highlighting. | 326 | This behaviour is rather unexpected, as in other cases the escaped contents is subject to further highlighting. | ||
331 | 327 | | |||
332 | We currently only consume the opening bracket. | 328 | We currently only consume the opening bracket. | ||
333 | <endfold id='1'>////</endfold id='1'> | 329 | <endfold id='2'>////</endfold id='2'> | ||
334 | This is an escaped \[#shorthand-id]#anchor in shorthand form#. | 330 | This is an escaped \[#shorthand-id]#anchor in shorthand form#. | ||
335 | 331 | | |||
336 | Some \[#shorthand-id]. | 332 | Some \[#shorthand-id]. | ||
Context not available. | |||||
340 | \[#shorthand-id]# | 336 | \[#shorthand-id]# | ||
341 | 337 | | |||
342 | 338 | | |||
343 | == Cross References | 339 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Cross References | ||
344 | 340 | | |||
345 | <<main-1>> | 341 | <<main-1>> | ||
346 | 342 | | |||
Context not available. | |||||
371 | <<block-anchor>> | 367 | <<block-anchor>> | ||
372 | 368 | | |||
373 | 369 | | |||
374 | === Escaped | 370 | <beginfold id='1'>=== </beginfold id='1'>Escaped | ||
375 | 371 | | |||
376 | This is not a reference \<<section-1>>. | 372 | This is not a reference \<<section-1>>. | ||
377 | 373 | | |||
378 | 374 | | |||
379 | = Attribute | 375 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Attribute | ||
380 | 376 | | |||
381 | == No Value | 377 | <beginfold id='1'>== </beginfold id='1'>No Value | ||
382 | 378 | | |||
383 | :some-attribute: | 379 | :some-attribute: | ||
384 | This line should not be highlighted. | 380 | This line should not be highlighted. | ||
Context not available. | |||||
386 | :not-an-attribute: as the line is indented. | 382 | :not-an-attribute: as the line is indented. | ||
387 | 383 | | |||
388 | 384 | | |||
389 | == Single Line Value | 385 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Single Line Value | ||
390 | 386 | | |||
391 | Attributes with values that are rendered as a single line, even if their definition spans multiple lines. | 387 | Attributes with values that are rendered as a single line, even if their definition spans multiple lines. | ||
392 | 388 | | |||
Context not available. | |||||
413 | text | 409 | text | ||
414 | 410 | | |||
415 | 411 | | |||
416 | == Multi Line Value | 412 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Multi Line Value | ||
417 | 413 | | |||
418 | Attributes with values including hard line breaks. | 414 | Attributes with values including hard line breaks. | ||
419 | 415 | | |||
Context not available. | |||||
427 | ##before##{multi-line}##after## | 423 | ##before##{multi-line}##after## | ||
428 | 424 | | |||
429 | 425 | | |||
430 | == Inline Definition | 426 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Inline Definition | ||
431 | 427 | | |||
432 | Inline attribute definitions {set:inline-attribute:just fine} works {inline-attribute}. | 428 | Inline attribute definitions {set:inline-attribute:just fine} works {inline-attribute}. | ||
433 | 429 | | |||
Context not available. | |||||
442 | {single-line:some value} | 438 | {single-line:some value} | ||
443 | 439 | | |||
444 | 440 | | |||
445 | == Unsetting | 441 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Unsetting | ||
446 | 442 | | |||
447 | :!_custom_2-: | 443 | :!_custom_2-: | ||
448 | :_custom_2-!: | 444 | :_custom_2-!: | ||
Context not available. | |||||
455 | {some-attribute} is not set anymore. | 451 | {some-attribute} is not set anymore. | ||
456 | 452 | | |||
457 | 453 | | |||
458 | == Not an Attribute | 454 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Not an Attribute | ||
459 | 455 | | |||
460 | :not-an-attribute:as there is no space after the terminating column of the identifier | 456 | :not-an-attribute:as there is no space after the terminating column of the identifier | ||
461 | 457 | | |||
462 | :not-an-attribute: as it is indented | 458 | :not-an-attribute: as it is indented | ||
463 | 459 | | |||
464 | 460 | | |||
465 | == Combination with Other Highlighting | 461 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Combination with Other Highlighting | ||
466 | 462 | | |||
467 | <beginfold id='2'>****</beginfold id='2'> | 463 | <beginfold id='3'>****</beginfold id='3'> | ||
468 | :inside-a-block: inside a block | 464 | :inside-a-block: inside a block | ||
469 | Using an attribute {inside-a-block} works too. | 465 | Using an attribute {inside-a-block} works too. | ||
470 | <endfold id='2'>****</endfold id='2'> | 466 | <endfold id='3'>****</endfold id='3'> | ||
471 | 467 | | |||
472 | :inside-formatting: inside formatting | 468 | :inside-formatting: inside formatting | ||
473 | An attribute used `{inside-formatting}` is not highlighting as attribute. | 469 | An attribute used `{inside-formatting}` is not highlighting as attribute. | ||
474 | 470 | | |||
475 | 471 | | |||
476 | == Escaped | 472 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Escaped | ||
477 | 473 | | |||
478 | \:attr-1: escaped attribute definition + \ | 474 | \:attr-1: escaped attribute definition + \ | ||
479 | second line of escaped attribute definition | 475 | second line of escaped attribute definition | ||
Context not available. | |||||
490 | This is not an inline attribute definition \{set:attr-2:some other attribute}. + | 486 | This is not an inline attribute definition \{set:attr-2:some other attribute}. + | ||
491 | {attr-2} is not set. | 487 | {attr-2} is not set. | ||
492 | 488 | | |||
493 | <beginfold id='2'>****</beginfold id='2'> | 489 | <beginfold id='3'>****</beginfold id='3'> | ||
494 | :inside-a-block: inside a block | 490 | :inside-a-block: inside a block | ||
495 | Escaping an attribute \{inside-a-block} works too. | 491 | Escaping an attribute \{inside-a-block} works too. | ||
496 | <endfold id='2'>****</endfold id='2'> | 492 | <endfold id='3'>****</endfold id='3'> | ||
497 | 493 | | |||
498 | 494 | | |||
499 | = Bibliography | 495 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Bibliography | ||
500 | 496 | | |||
501 | == Using References | 497 | <beginfold id='1'>== </beginfold id='1'>Using References | ||
502 | 498 | | |||
503 | The first reference has no label, so its id <<ref-1>> is rendered. | 499 | The first reference has no label, so its id <<ref-1>> is rendered. | ||
504 | 500 | | |||
Context not available. | |||||
515 | 511 | | |||
516 | 512 | | |||
517 | [bibliography] | 513 | [bibliography] | ||
518 | == References | 514 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>References | ||
519 | 515 | | |||
520 | - [[[ref-1]]] This is reference 1. | 516 | - [[[ref-1]]] This is reference 1. | ||
521 | - [[[r2,2]]]This is reference 2. | 517 | - [[[r2,2]]]This is reference 2. | ||
Context not available. | |||||
526 | * [[[r6,strange]]] Using an asterisk yields a strange result. | 522 | * [[[r6,strange]]] Using an asterisk yields a strange result. | ||
527 | 523 | | |||
528 | 524 | | |||
529 | = Block | 525 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Block | ||
530 | 526 | | |||
531 | [abstract] | 527 | [abstract] | ||
532 | .Abstract - contiguous block | 528 | .Abstract - contiguous block | ||
Context not available. | |||||
536 | 532 | | |||
537 | [abstract] | 533 | [abstract] | ||
538 | .Abstract - delimited open block | 534 | .Abstract - delimited open block | ||
539 | <beginfold id='2'>--</beginfold id='2'> | 535 | <beginfold id='3'>--</beginfold id='3'> | ||
540 | Using the delimited block form ... | 536 | Using the delimited block form ... | ||
541 | 537 | | |||
542 | enables having empty lines in the abstract. | 538 | enables having empty lines in the abstract. | ||
543 | <endfold id='2'>--</endfold id='2'> | 539 | <endfold id='3'>--</endfold id='3'> | ||
544 | 540 | | |||
545 | 541 | | |||
546 | == General | 542 | <beginfold id='1'>== </beginfold id='1'>General | ||
547 | 543 | | |||
548 | NOTE: Starting and ending delimiter must be balanced, meaning they must have the same length. | 544 | NOTE: Starting and ending delimiter must be balanced, meaning they must have the same length. | ||
549 | 545 | | |||
550 | .Block title #before# block meta data | 546 | .Block title #before# block meta data | ||
551 | [literal] | 547 | [literal] | ||
552 | <beginfold id='2'>....</beginfold id='2'> | 548 | <beginfold id='3'>....</beginfold id='3'> | ||
553 | Inside the block. | 549 | Inside the block. | ||
554 | <endfold id='2'>....</endfold id='2'> | 550 | <endfold id='3'>....</endfold id='3'> | ||
555 | 551 | | |||
556 | [literal] | 552 | [literal] | ||
557 | .Block title `after` block meta data | 553 | .Block title `after` block meta data | ||
558 | <beginfold id='2'>....</beginfold id='2'> | 554 | <beginfold id='3'>....</beginfold id='3'> | ||
559 | Inside the block. | 555 | Inside the block. | ||
560 | <endfold id='2'>....</endfold id='2'> | 556 | <endfold id='3'>....</endfold id='3'> | ||
561 | 557 | | |||
562 | .Invalid block name | 558 | .Invalid block name | ||
563 | [ literal] | 559 | [ literal] | ||
564 | <beginfold id='2'>....</beginfold id='2'> | 560 | <beginfold id='3'>....</beginfold id='3'> | ||
565 | This block has invalid meta data as there is a space between the opening square bracket and the block name. | 561 | This block has invalid meta data as there is a space between the opening square bracket and the block name. | ||
566 | <endfold id='2'>....</endfold id='2'> | 562 | <endfold id='3'>....</endfold id='3'> | ||
567 | 563 | | |||
568 | .Block with attributes | 564 | .Block with attributes | ||
569 | [literal, some, attributes] | 565 | [literal, some, attributes] | ||
570 | <beginfold id='2'>....</beginfold id='2'> | 566 | <beginfold id='3'>....</beginfold id='3'> | ||
571 | Inside the block. | 567 | Inside the block. | ||
572 | <endfold id='2'>....</endfold id='2'> | 568 | <endfold id='3'>....</endfold id='3'> | ||
573 | 569 | | |||
574 | .Anchor before block name for contiguous block | 570 | .Anchor before block name for contiguous block | ||
575 | [[contiguous_block_id_before_name]] | 571 | [[contiguous_block_id_before_name]] | ||
Context not available. | |||||
584 | .Anchor after block name for delimited block | 580 | .Anchor after block name for delimited block | ||
585 | [literal] | 581 | [literal] | ||
586 | [#delimited_block_id] | 582 | [#delimited_block_id] | ||
587 | <beginfold id='2'>....</beginfold id='2'> | 583 | <beginfold id='3'>....</beginfold id='3'> | ||
588 | Inside the block. | 584 | Inside the block. | ||
589 | <endfold id='2'>....</endfold id='2'> | 585 | <endfold id='3'>....</endfold id='3'> | ||
590 | 586 | | |||
591 | .Option definition | 587 | .Option definition | ||
592 | [literal%some-option, some, attributes] | 588 | [literal%some-option, some, attributes] | ||
Context not available. | |||||
604 | Link to <<shorthand-id>>. | 600 | Link to <<shorthand-id>>. | ||
605 | 601 | | |||
606 | 602 | | |||
607 | == Admonition | 603 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Admonition | ||
608 | 604 | | |||
609 | See `admonition.adoc`. | 605 | See `admonition.adoc`. | ||
610 | 606 | | |||
611 | 607 | | |||
612 | == Comment | 608 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Comment | ||
613 | 609 | | |||
614 | See `comment.adoc`. | 610 | See `comment.adoc`. | ||
615 | 611 | | |||
616 | 612 | | |||
617 | == Example | 613 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Example | ||
618 | 614 | | |||
619 | .Contiguous | 615 | .Contiguous | ||
620 | [example] | 616 | [example] | ||
Context not available. | |||||
630 | // some comment | 626 | // some comment | ||
631 | [[example-block-id]] | 627 | [[example-block-id]] | ||
632 | // some comment | 628 | // some comment | ||
633 | <beginfold id='2'>====</beginfold id='2'> | 629 | <beginfold id='3'>====</beginfold id='3'> | ||
634 | // some comment | 630 | // some comment | ||
635 | Inside the delimited example block. | 631 | Inside the delimited example block. | ||
636 | <endfold id='2'>====</endfold id='2'> | 632 | <endfold id='3'>====</endfold id='3'> | ||
637 | 633 | | |||
638 | .Delimited without block name | 634 | .Delimited without block name | ||
639 | [[example-block-id]] | 635 | [[example-block-id]] | ||
640 | <beginfold id='2'>====</beginfold id='2'> | 636 | <beginfold id='3'>====</beginfold id='3'> | ||
641 | Inside the delimited example block. | 637 | Inside the delimited example block. | ||
642 | <endfold id='2'>====</endfold id='2'> | 638 | <endfold id='3'>====</endfold id='3'> | ||
643 | 639 | | |||
644 | .Using an open block | 640 | .Using an open block | ||
645 | [example] | 641 | [example] | ||
646 | [[example-block-id]] | 642 | [[example-block-id]] | ||
647 | <beginfold id='2'>--</beginfold id='2'> | 643 | <beginfold id='3'>--</beginfold id='3'> | ||
648 | Inside the open block example. | 644 | Inside the open block example. | ||
649 | <endfold id='2'>--</endfold id='2'> | 645 | <endfold id='3'>--</endfold id='3'> | ||
650 | 646 | | |||
651 | 647 | | |||
652 | == Fenced | 648 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Fenced | ||
653 | 649 | | |||
654 | NOTE: According to the https://asciidoctor.org/docs/user-manual/#built-in-blocks-summary[Asciidoctor manual], fenced blocks do not support block names. | 650 | NOTE: According to the https://asciidoctor.org/docs/user-manual/#built-in-blocks-summary[Asciidoctor manual], fenced blocks do not support block names. | ||
655 | 651 | | |||
656 | .Delimited without block name | 652 | .Delimited without block name | ||
657 | [#fenced-block-id] | 653 | [#fenced-block-id] | ||
658 | <beginfold id='2'>```</beginfold id='2'> | 654 | <beginfold id='3'>```</beginfold id='3'> | ||
659 | Inside the fenced block. | 655 | Inside the fenced block. | ||
660 | The block contents is rendered verbatim. | 656 | The block contents is rendered verbatim. | ||
661 | So there is *no* text formatting. | 657 | So there is *no* text formatting. | ||
662 | <endfold id='2'>```</endfold id='2'> | 658 | <endfold id='3'>```</endfold id='3'> | ||
663 | 659 | | |||
664 | .This is not a fenced block | 660 | .This is not a fenced block | ||
665 | `````` | 661 | `````` | ||
Context not available. | |||||
667 | `````` | 663 | `````` | ||
668 | 664 | | |||
669 | 665 | | |||
670 | == Listing | 666 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Listing | ||
671 | 667 | | |||
672 | .Contiguous | 668 | .Contiguous | ||
673 | [listing] | 669 | [listing] | ||
Context not available. | |||||
681 | [listing] | 677 | [listing] | ||
682 | [[listing-block-id]] | 678 | [[listing-block-id]] | ||
683 | // comment before the opening block delimiter | 679 | // comment before the opening block delimiter | ||
684 | <beginfold id='1'>////</beginfold id='1'> | 680 | <beginfold id='2'>////</beginfold id='2'> | ||
685 | block comment | 681 | block comment | ||
686 | <endfold id='1'>////</endfold id='1'> | 682 | <endfold id='2'>////</endfold id='2'> | ||
687 | <beginfold id='2'>----</beginfold id='2'> | 683 | <beginfold id='3'>----</beginfold id='3'> | ||
688 | First line inside the *listing* block. | 684 | First line inside the *listing* block. | ||
689 | Last line inside the block. | 685 | Last line inside the block. | ||
690 | <endfold id='2'>----</endfold id='2'> | 686 | <endfold id='3'>----</endfold id='3'> | ||
691 | 687 | | |||
692 | .Delimited without block name | 688 | .Delimited without block name | ||
693 | [[listing-block-id]] | 689 | [[listing-block-id]] | ||
694 | <beginfold id='2'>----</beginfold id='2'> | 690 | <beginfold id='3'>----</beginfold id='3'> | ||
695 | Inside the delimited listing block. | 691 | Inside the delimited listing block. | ||
696 | <endfold id='2'>----</endfold id='2'> | 692 | <endfold id='3'>----</endfold id='3'> | ||
697 | 693 | | |||
698 | .Using an open block | 694 | .Using an open block | ||
699 | [listing] | 695 | [listing] | ||
700 | [[listing-block-id]] | 696 | [[listing-block-id]] | ||
701 | <beginfold id='2'>--</beginfold id='2'> | 697 | <beginfold id='3'>--</beginfold id='3'> | ||
702 | Inside the open block listing. | 698 | Inside the open block listing. | ||
703 | <endfold id='2'>--</endfold id='2'> | 699 | <endfold id='3'>--</endfold id='3'> | ||
704 | 700 | | |||
705 | 701 | | |||
706 | == Literal | 702 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Literal | ||
707 | 703 | | |||
708 | .Contiguous | 704 | .Contiguous | ||
709 | [literal] | 705 | [literal] | ||
Context not available. | |||||
724 | // some comment | 720 | // some comment | ||
725 | [#literal-block-id] | 721 | [#literal-block-id] | ||
726 | // some comment | 722 | // some comment | ||
727 | <beginfold id='2'>..........</beginfold id='2'> | 723 | <beginfold id='3'>..........</beginfold id='3'> | ||
728 | Inside the delimited literal block. | 724 | Inside the delimited literal block. | ||
729 | // this should not be highlighted as comment | 725 | // this should not be highlighted as comment | ||
730 | .this should not be highlighted as title | 726 | .this should not be highlighted as title | ||
731 | <endfold id='2'>..........</endfold id='2'> | 727 | <endfold id='3'>..........</endfold id='3'> | ||
732 | 728 | | |||
733 | .Delimited without block name | 729 | .Delimited without block name | ||
734 | [[literal-block-id]] | 730 | [[literal-block-id]] | ||
735 | // some comment | 731 | // some comment | ||
736 | <beginfold id='2'>..........</beginfold id='2'> | 732 | <beginfold id='3'>..........</beginfold id='3'> | ||
737 | Inside the delimited literal block. | 733 | Inside the delimited literal block. | ||
738 | <endfold id='2'>..........</endfold id='2'> | 734 | <endfold id='3'>..........</endfold id='3'> | ||
739 | 735 | | |||
740 | .Using an open block | 736 | .Using an open block | ||
741 | [literal] | 737 | [literal] | ||
742 | // some comment | 738 | // some comment | ||
743 | [[literal-block-id]] | 739 | [[literal-block-id]] | ||
744 | // some comment | 740 | // some comment | ||
745 | <beginfold id='2'>--</beginfold id='2'> | 741 | <beginfold id='3'>--</beginfold id='3'> | ||
746 | // this should not be highlighted as comment | 742 | // this should not be highlighted as comment | ||
747 | Inside the open block listing. | 743 | Inside the open block listing. | ||
748 | <endfold id='2'>--</endfold id='2'> | 744 | <endfold id='3'>--</endfold id='3'> | ||
749 | 745 | | |||
750 | .Using leading spaces for first line | 746 | .Using leading spaces for first line | ||
751 | When using some leading spaces, the whole paragraph is treated as literal. | 747 | When using some leading spaces, the whole paragraph is treated as literal. | ||
Context not available. | |||||
754 | This line is not part of the literal paragraph anymore. | 750 | This line is not part of the literal paragraph anymore. | ||
755 | 751 | | |||
756 | 752 | | |||
757 | == Open | 753 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Open | ||
758 | 754 | | |||
759 | NOTE: The open block does not have a contiguous form. | 755 | NOTE: The open block does not have a contiguous form. | ||
760 | 756 | | |||
761 | .Delimited | 757 | .Delimited | ||
762 | [#open-block-id] | 758 | [#open-block-id] | ||
763 | <beginfold id='2'>--</beginfold id='2'> | 759 | <beginfold id='3'>--</beginfold id='3'> | ||
764 | An open block's delimiter length is _exactly_ 2. | 760 | An open block's delimiter length is _exactly_ 2. | ||
765 | 761 | | |||
766 | Last line of the #open# block. | 762 | Last line of the #open# block. | ||
767 | <endfold id='2'>--</endfold id='2'> | 763 | <endfold id='3'>--</endfold id='3'> | ||
768 | 764 | | |||
769 | 765 | | |||
770 | == Passthrough | 766 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Passthrough | ||
771 | 767 | | |||
772 | .Contiguous | 768 | .Contiguous | ||
773 | [pass] | 769 | [pass] | ||
Context not available. | |||||
780 | .Delimited with block name | 776 | .Delimited with block name | ||
781 | [pass] | 777 | [pass] | ||
782 | [[delimited-passthrough-id]] | 778 | [[delimited-passthrough-id]] | ||
783 | <beginfold id='2'>++++++</beginfold id='2'> | 779 | <beginfold id='3'>++++++</beginfold id='3'> | ||
784 | Inside the delimited passthrough block with block name. | 780 | Inside the delimited passthrough block with block name. | ||
785 | <endfold id='2'>++++++</endfold id='2'> | 781 | <endfold id='3'>++++++</endfold id='3'> | ||
786 | 782 | | |||
787 | .Delimited without block name | 783 | .Delimited without block name | ||
788 | [[delimited-passthrough-id]] | 784 | [[delimited-passthrough-id]] | ||
789 | <beginfold id='2'>++++</beginfold id='2'> | 785 | <beginfold id='3'>++++</beginfold id='3'> | ||
790 | Inside the delimited passthrough block without block name. | 786 | Inside the delimited passthrough block without block name. | ||
791 | <endfold id='2'>++++</endfold id='2'> | 787 | <endfold id='3'>++++</endfold id='3'> | ||
792 | 788 | | |||
793 | According to the https://asciidoctor.org/docs/user-manual/#built-in-blocks-summary[Asciidoctor Manual], passthrough using an open block is not supported. | 789 | According to the https://asciidoctor.org/docs/user-manual/#built-in-blocks-summary[Asciidoctor Manual], passthrough using an open block is not supported. | ||
794 | 790 | | |||
795 | 791 | | |||
796 | == Quote | 792 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Quote | ||
797 | 793 | | |||
798 | See `quote_verse.adoc`. | 794 | See `quote_verse.adoc`. | ||
799 | 795 | | |||
800 | 796 | | |||
801 | == Sidebar | 797 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Sidebar | ||
802 | 798 | | |||
803 | .Contiguous | 799 | .Contiguous | ||
804 | [sidebar] | 800 | [sidebar] | ||
Context not available. | |||||
811 | .Delimited with block name | 807 | .Delimited with block name | ||
812 | [sidebar] | 808 | [sidebar] | ||
813 | [[sidebar-block-id]] | 809 | [[sidebar-block-id]] | ||
814 | <beginfold id='2'>**********</beginfold id='2'> | 810 | <beginfold id='3'>**********</beginfold id='3'> | ||
815 | Inside the *sidebar* block. | 811 | Inside the *sidebar* block. | ||
816 | <endfold id='2'>**********</endfold id='2'> | 812 | <endfold id='3'>**********</endfold id='3'> | ||
817 | 813 | | |||
818 | .Delimited without block name | 814 | .Delimited without block name | ||
819 | [[sidebar-block-id]] | 815 | [[sidebar-block-id]] | ||
820 | <beginfold id='2'>****</beginfold id='2'> | 816 | <beginfold id='3'>****</beginfold id='3'> | ||
821 | Inside the sidebar block. | 817 | Inside the sidebar block. | ||
822 | <endfold id='2'>****</endfold id='2'> | 818 | <endfold id='3'>****</endfold id='3'> | ||
823 | 819 | | |||
824 | .Using an open block | 820 | .Using an open block | ||
825 | [sidebar] | 821 | [sidebar] | ||
826 | [[sidebar-block-id]] | 822 | [[sidebar-block-id]] | ||
827 | <beginfold id='2'>--</beginfold id='2'> | 823 | <beginfold id='3'>--</beginfold id='3'> | ||
828 | Inside the sidebar block. | 824 | Inside the sidebar block. | ||
829 | <endfold id='2'>--</endfold id='2'> | 825 | <endfold id='3'>--</endfold id='3'> | ||
830 | 826 | | |||
831 | 827 | | |||
832 | == Source | 828 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Source | ||
833 | 829 | | |||
834 | .Contiguous | 830 | .Contiguous | ||
835 | [source,ruby] | 831 | [source,ruby] | ||
Context not available. | |||||
849 | .Delimited with block name | 845 | .Delimited with block name | ||
850 | [source , ruby ] | 846 | [source , ruby ] | ||
851 | [[source-block-id]] | 847 | [[source-block-id]] | ||
852 | <beginfold id='2'>----</beginfold id='2'> | 848 | <beginfold id='3'>----</beginfold id='3'> | ||
853 | # This is Ruby source code. | 849 | # This is Ruby source code. | ||
854 | # NOTE: in delimited source blocks, having a space after the `#` in the comment is OK. | 850 | # NOTE: in delimited source blocks, having a space after the `#` in the comment is OK. | ||
855 | import 'needed' | 851 | import 'needed' | ||
856 | 852 | | |||
857 | IO.puts "hello" | 853 | IO.puts "hello" | ||
858 | <endfold id='2'>----</endfold id='2'> | 854 | <endfold id='3'>----</endfold id='3'> | ||
859 | 855 | | |||
860 | .Delimited with block name using option syntax | 856 | .Delimited with block name using option syntax | ||
861 | [source%mixed,php] | 857 | [source%mixed,php] | ||
862 | <beginfold id='2'>----</beginfold id='2'> | 858 | <beginfold id='3'>----</beginfold id='3'> | ||
863 | <p> | 859 | <p> | ||
864 | <?php echo "Hello, World!"; ?> | 860 | <?php echo "Hello, World!"; ?> | ||
865 | </p> | 861 | </p> | ||
866 | <endfold id='2'>----</endfold id='2'> | 862 | <endfold id='3'>----</endfold id='3'> | ||
867 | 863 | | |||
868 | .Delimited without block name | 864 | .Delimited without block name | ||
869 | [[source-block-id]] | 865 | [[source-block-id]] | ||
870 | <beginfold id='2'>----</beginfold id='2'> | 866 | <beginfold id='3'>----</beginfold id='3'> | ||
871 | # This is Ruby source code. | 867 | # This is Ruby source code. | ||
872 | # NOTE: in delimited source blocks, having a space after the `#` in the comment is OK. | 868 | # NOTE: in delimited source blocks, having a space after the `#` in the comment is OK. | ||
873 | import 'needed' | 869 | import 'needed' | ||
874 | 870 | | |||
875 | IO.puts "hello" | 871 | IO.puts "hello" | ||
876 | <endfold id='2'>----</endfold id='2'> | 872 | <endfold id='3'>----</endfold id='3'> | ||
877 | 873 | | |||
878 | .Using an open block | 874 | .Using an open block | ||
879 | [source,ruby] | 875 | [source,ruby] | ||
880 | [[source-block-id]] | 876 | [[source-block-id]] | ||
881 | <beginfold id='2'>--</beginfold id='2'> | 877 | <beginfold id='3'>--</beginfold id='3'> | ||
882 | import 'needed' | 878 | import 'needed' | ||
883 | 879 | | |||
884 | IO.puts "hello" | 880 | IO.puts "hello" | ||
885 | <endfold id='2'>--</endfold id='2'> | 881 | <endfold id='3'>--</endfold id='3'> | ||
886 | 882 | | |||
887 | 883 | | |||
888 | == Stem | 884 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Stem | ||
889 | 885 | | |||
890 | .Contiguous | 886 | .Contiguous | ||
891 | [stem] | 887 | [stem] | ||
Context not available. | |||||
898 | .Delimited with block name | 894 | .Delimited with block name | ||
899 | [stem] | 895 | [stem] | ||
900 | [[stem-block-id]] | 896 | [[stem-block-id]] | ||
901 | <beginfold id='2'>++++++</beginfold id='2'> | 897 | <beginfold id='3'>++++++</beginfold id='3'> | ||
902 | Inside the delimited stem block with block name. | 898 | Inside the delimited stem block with block name. | ||
903 | <endfold id='2'>++++++</endfold id='2'> | 899 | <endfold id='3'>++++++</endfold id='3'> | ||
904 | 900 | | |||
905 | .Delimited without block name | 901 | .Delimited without block name | ||
906 | [[stem-block-id]] | 902 | [[stem-block-id]] | ||
907 | <beginfold id='2'>++++</beginfold id='2'> | 903 | <beginfold id='3'>++++</beginfold id='3'> | ||
908 | Inside the delimited stem block without block name. | 904 | Inside the delimited stem block without block name. | ||
909 | <endfold id='2'>++++</endfold id='2'> | 905 | <endfold id='3'>++++</endfold id='3'> | ||
910 | 906 | | |||
911 | 907 | | |||
912 | == Table | 908 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Table | ||
913 | 909 | | |||
914 | See `table.adoc`. | 910 | See `table.adoc`. | ||
915 | 911 | | |||
916 | 912 | | |||
917 | == Verse | 913 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Verse | ||
918 | 914 | | |||
919 | .Contiguous | 915 | .Contiguous | ||
920 | [verse] | 916 | [verse] | ||
Context not available. | |||||
927 | .Delimited with block name | 923 | .Delimited with block name | ||
928 | [verse] | 924 | [verse] | ||
929 | [[verse-block-id]] | 925 | [[verse-block-id]] | ||
930 | <beginfold id='2'>____</beginfold id='2'> | 926 | <beginfold id='3'>____</beginfold id='3'> | ||
931 | Inside the *verse* block. | 927 | Inside the *verse* block. | ||
932 | <endfold id='2'>____</endfold id='2'> | 928 | <endfold id='3'>____</endfold id='3'> | ||
933 | 929 | | |||
934 | .Delimited without block name | 930 | .Delimited without block name | ||
935 | This would be rendered as a quote block as the same delimiters are used. | 931 | This would be rendered as a quote block as the same delimiters are used. | ||
Context not available. | |||||
937 | .Using an open block | 933 | .Using an open block | ||
938 | [verse] | 934 | [verse] | ||
939 | [[verse-block-id]] | 935 | [[verse-block-id]] | ||
940 | <beginfold id='2'>--</beginfold id='2'> | 936 | <beginfold id='3'>--</beginfold id='3'> | ||
941 | Inside the *verse* block. | 937 | Inside the *verse* block. | ||
942 | <endfold id='2'>--</endfold id='2'> | 938 | <endfold id='3'>--</endfold id='3'> | ||
943 | 939 | | |||
944 | 940 | | |||
945 | == Nested Blocks | 941 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Nested Blocks | ||
946 | 942 | | |||
947 | <beginfold id='2'>====</beginfold id='2'> | 943 | <beginfold id='3'>====</beginfold id='3'> | ||
948 | Start of outer example block. | 944 | Start of outer example block. | ||
949 | 945 | | |||
950 | .Nested example block | 946 | .Nested example block | ||
951 | <beginfold id='2'>=====</beginfold id='2'> | 947 | <beginfold id='3'>=====</beginfold id='3'> | ||
952 | Inside the inner example block. | 948 | Inside the inner example block. | ||
953 | // some comment | 949 | // some comment | ||
954 | 950 | | |||
955 | .Nested literal block | 951 | .Nested literal block | ||
956 | [literal] | 952 | [literal] | ||
957 | // some comment | 953 | // some comment | ||
958 | <beginfold id='2'>----</beginfold id='2'> | 954 | <beginfold id='3'>----</beginfold id='3'> | ||
959 | Inside the literal block within the inner example block. | 955 | Inside the literal block within the inner example block. | ||
960 | -- | 956 | -- | ||
961 | Trying to use a block within a verbatim block results in verbatim text, of course. | 957 | Trying to use a block within a verbatim block results in verbatim text, of course. | ||
962 | -- | 958 | -- | ||
963 | <endfold id='2'>----</endfold id='2'> | 959 | <endfold id='3'>----</endfold id='3'> | ||
964 | <endfold id='2'>=====</endfold id='2'> | 960 | <endfold id='3'>=====</endfold id='3'> | ||
965 | Line in outer block. | 961 | Line in outer block. | ||
966 | [listing] | 962 | [listing] | ||
967 | <beginfold id='2'>----</beginfold id='2'> | 963 | <beginfold id='3'>----</beginfold id='3'> | ||
968 | Inside the inner listing block. | 964 | Inside the inner listing block. | ||
969 | <endfold id='2'>----</endfold id='2'> | 965 | <endfold id='3'>----</endfold id='3'> | ||
970 | End of outer block. | 966 | End of outer block. | ||
971 | <endfold id='2'>====</endfold id='2'> | 967 | <endfold id='3'>====</endfold id='3'> | ||
972 | 968 | | |||
973 | .Admonition inside some other block | 969 | .Admonition inside some other block | ||
974 | <beginfold id='2'>====</beginfold id='2'> | 970 | <beginfold id='3'>====</beginfold id='3'> | ||
975 | Some text. | 971 | Some text. | ||
976 | 972 | | |||
977 | NOTE: This is a note in simple format inside a block. | 973 | NOTE: This is a note in simple format inside a block. | ||
978 | 974 | | |||
979 | Some more text. | 975 | Some more text. | ||
980 | <endfold id='2'>====</endfold id='2'> | 976 | <endfold id='3'>====</endfold id='3'> | ||
981 | 977 | | |||
982 | 978 | | |||
983 | = Callout | 979 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Callout | ||
984 | // Add `:icons: font` for nice callout icons. | 980 | // Add `:icons: font` for nice callout icons. | ||
985 | 981 | | |||
986 | Callouts are usually used with listing/source blocks, but Asciidoctor renders them also without a listing block. | 982 | Callouts are usually used with listing/source blocks, but Asciidoctor renders them also without a listing block. | ||
Context not available. | |||||
994 | 990 | | |||
995 | <3> | 991 | <3> | ||
996 | 992 | | |||
997 | <beginfold id='1'>////</beginfold id='1'> | 993 | <beginfold id='2'>////</beginfold id='2'> | ||
998 | FIXME This should not be highlighted as callout. | 994 | FIXME This should not be highlighted as callout. | ||
999 | As it depends on the kind of line before, this is problematic. | 995 | As it depends on the kind of line before, this is problematic. | ||
1000 | <endfold id='1'>////</endfold id='1'> | 996 | <endfold id='2'>////</endfold id='2'> | ||
1001 | The line below is not rendered as callout as it is part of this paragraph. | 997 | The line below is not rendered as callout as it is part of this paragraph. | ||
1002 | <4> This should _not_ be highlighted as callout. | 998 | <4> This should _not_ be highlighted as callout. | ||
1003 | 999 | | |||
1004 | .Callouts with manual numbering | 1000 | .Callouts with manual numbering | ||
1005 | [source,sh] | 1001 | [source,sh] | ||
1006 | <beginfold id='2'>----</beginfold id='2'> | 1002 | <beginfold id='3'>----</beginfold id='3'> | ||
1007 | ls -l <2> | 1003 | ls -l <2> | ||
1008 | ls -la <1> | 1004 | ls -la <1> | ||
1009 | <endfold id='2'>----</endfold id='2'> | 1005 | <endfold id='3'>----</endfold id='3'> | ||
1010 | <1> Explanation for callout number 1. | 1006 | <1> Explanation for callout number 1. | ||
1011 | <2> Explanation for callout number 2. | 1007 | <2> Explanation for callout number 2. | ||
1012 | \<3> This is not a callout as it is escaped. | 1008 | \<3> This is not a callout as it is escaped. | ||
1013 | 1009 | | |||
1014 | .Callouts with automatic numbering | 1010 | .Callouts with automatic numbering | ||
1015 | [source,sh] | 1011 | [source,sh] | ||
1016 | <beginfold id='2'>----</beginfold id='2'> | 1012 | <beginfold id='3'>----</beginfold id='3'> | ||
1017 | ls -l <.> | 1013 | ls -l <.> | ||
1018 | ls -la <.> | 1014 | ls -la <.> | ||
1019 | <endfold id='2'>----</endfold id='2'> | 1015 | <endfold id='3'>----</endfold id='3'> | ||
1020 | <.> Explanation for callout number 1. | 1016 | <.> Explanation for callout number 1. | ||
1021 | <.> Explanation for callout number 2. | 1017 | <.> Explanation for callout number 2. | ||
1022 | 1018 | | |||
1023 | 1019 | | |||
1024 | = Comment | 1020 | <endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Comment | ||
1025 | 1021 | | |||
1026 | TIP: Comment highlighting supports the standard https://cgit.kde.org/syntax-highlighting.git/tree/data/syntax/alert.xml[KDE alerts] (TODO, FIXME, ...) in both single-line and multi-line comments. | 1022 | TIP: Comment highlighting supports the standard https://cgit.kde.org/syntax-highlighting.git/tree/data/syntax/alert.xml[KDE alerts] (TODO, FIXME, ...) in both single-line and multi-line comments. | ||
1027 | 1023 | | |||
1028 | 1024 | | |||
1029 | == Single Line | 1025 | <beginfold id='1'>== </beginfold id='1'>Single Line | ||
1030 | 1026 | | |||
1031 | Single-line comments start with exactly `//`. | 1027 | Single-line comments start with exactly `//`. | ||
1032 | If there are any characters - including spaces - before the `//`, the line will be rendered. | 1028 | If there are any characters - including spaces - before the `//`, the line will be rendered. | ||
Context not available. | |||||
1058 | // DANGER: testing alerts | 1054 | // DANGER: testing alerts | ||
1059 | 1055 | | |||
1060 | 1056 | | |||
1061 | == Multi Line | 1057 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Multi Line | ||
1062 | 1058 | | |||
1063 | .Contiguous block | 1059 | .Contiguous block | ||
1064 | [comment] | 1060 | [comment] | ||
Context not available. | |||||
1076 | This line is not part of the contiguous block comment anymore. | 1072 | This line is not part of the contiguous block comment anymore. | ||
1077 | 1073 | | |||
1078 | .Delimited block without name | 1074 | .Delimited block without name | ||
1079 | <beginfold id='1'>//////</beginfold id='1'> | 1075 | <beginfold id='2'>//////</beginfold id='2'> | ||
1080 | This is a multi-line comment. | 1076 | This is a multi-line comment. | ||
1081 | It spans multiple lines. | 1077 | It spans multiple lines. | ||
1082 | 1078 | | |||
Context not available. | |||||
1090 | DANGER: testing alerts | 1086 | DANGER: testing alerts | ||
1091 | 1087 | | |||
1092 | This is the comment's last line. | 1088 | This is the comment's last line. | ||
1093 | <endfold id='1'>//////</endfold id='1'> | 1089 | <endfold id='2'>//////</endfold id='2'> | ||
1094 | 1090 | | |||
1095 | [comment] | 1091 | [comment] | ||
1096 | .Delimited block with name | 1092 | .Delimited block with name | ||
1097 | <beginfold id='1'>////</beginfold id='1'> | 1093 | <beginfold id='2'>////</beginfold id='2'> | ||
1098 | This is a multi-line comment. | 1094 | This is a multi-line comment. | ||
1099 | It spans multiple lines. | 1095 | It spans multiple lines. | ||
1100 | 1096 | | |||
Context not available. | |||||
1108 | DANGER: testing alerts | 1104 | DANGER: testing alerts | ||
1109 | 1105 | | |||
1110 | This is the comment's last line. | 1106 | This is the comment's last line. | ||
1111 | <endfold id='1'>////</endfold id='1'> | 1107 | <endfold id='2'>////</endfold id='2'> | ||
1112 | 1108 | | |||
1113 | .Using open block | 1109 | .Using open block | ||
1114 | [comment] | 1110 | [comment] | ||
Context not available. | |||||
1117 | -- | 1113 | -- | ||
1118 | 1114 | | |||
1119 | 1115 | | |||
1120 | = Counter | 1116 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Counter | ||
1121 | 1117 | | |||
1122 | == Use and Render | 1118 | <beginfold id='1'>== </beginfold id='1'>Use and Render | ||
1123 | 1119 | | |||
1124 | .Start with 1 and render value | 1120 | .Start with 1 and render value | ||
1125 | New value for `c1` is {counter:c1}. | 1121 | New value for `c1` is {counter:c1}. | ||
Context not available. | |||||
1131 | Current value is {c1}. | 1127 | Current value is {c1}. | ||
1132 | 1128 | | |||
1133 | 1129 | | |||
1134 | == Use Without Rendering | 1130 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Use Without Rendering | ||
1135 | 1131 | | |||
1136 | .Define the new counter | 1132 | .Define the new counter | ||
1137 | No new value to be {counter2:c2}seen. | 1133 | No new value to be {counter2:c2}seen. | ||
Context not available. | |||||
1146 | Current value is {c2}. | 1142 | Current value is {c2}. | ||
1147 | 1143 | | |||
1148 | 1144 | | |||
1149 | == Using a Start Value | 1145 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Using a Start Value | ||
1150 | 1146 | | |||
1151 | .Start with 3 and render value | 1147 | .Start with 3 and render value | ||
1152 | New value for `c3` is {counter:c3:99}. | 1148 | New value for `c3` is {counter:c3:99}. | ||
Context not available. | |||||
1161 | And now it is {counter:c4}. | 1157 | And now it is {counter:c4}. | ||
1162 | 1158 | | |||
1163 | 1159 | | |||
1164 | == About using Spaces | 1160 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>About using Spaces | ||
1165 | 1161 | | |||
1166 | CAUTION: If you leave spaces after the `:` or before the closing `}`, Asciidoctor will make them part of the counter attribute name. + | 1162 | CAUTION: If you leave spaces after the `:` or before the closing `}`, Asciidoctor will make them part of the counter attribute name. + | ||
1167 | So it's probably wise to avoid spaces here. | 1163 | So it's probably wise to avoid spaces here. | ||
Context not available. | |||||
1195 | 1191 | | |||
1196 | 1192 | | |||
1197 | 1193 | | |||
1198 | = Text Formatting | 1194 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Text Formatting | ||
1199 | 1195 | | |||
1200 | TIP: Asciidoctor uses also the term _quoted text_. | 1196 | TIP: Asciidoctor uses also the term _quoted text_. | ||
1201 | 1197 | | |||
1202 | == Custom Styles | 1198 | <beginfold id='1'>== </beginfold id='1'>Custom Styles | ||
1203 | 1199 | | |||
1204 | [big]#big text# | 1200 | [big]#big text# | ||
1205 | 1201 | | |||
Context not available. | |||||
1217 | 1213 | | |||
1218 | [big]##*text*## | 1214 | [big]##*text*## | ||
1219 | 1215 | | |||
1220 | <beginfold id='1'>////</beginfold id='1'> | 1216 | <beginfold id='2'>////</beginfold id='2'> | ||
1221 | FIXME Highlighting differs. | 1217 | FIXME Highlighting differs. | ||
1222 | The phrase is rendered as marked. | 1218 | The phrase is rendered as marked. | ||
1223 | The trailing hash is therefore not visible. | 1219 | The trailing hash is therefore not visible. | ||
1224 | <endfold id='1'>////</endfold id='1'> | 1220 | <endfold id='2'>////</endfold id='2'> | ||
1225 | [big]###text### | 1221 | [big]###text### | ||
1226 | 1222 | | |||
1227 | [fo[o]#some text# | 1223 | [fo[o]#some text# | ||
Context not available. | |||||
1242 | [underline]**strong and underlined** | 1238 | [underline]**strong and underlined** | ||
1243 | 1239 | | |||
1244 | 1240 | | |||
1245 | === Not rendered as custom style | 1241 | <beginfold id='1'>=== </beginfold id='1'>Not rendered as custom style | ||
1246 | 1242 | | |||
1247 | [fo]o]#not a custom style# because of surplus `]`. | 1243 | [fo]o]#not a custom style# because of surplus `]`. | ||
1248 | 1244 | | |||
Context not available. | |||||
1259 | Before [foo]#the phrase#after because of missing non-word character after clause. | 1255 | Before [foo]#the phrase#after because of missing non-word character after clause. | ||
1260 | 1256 | | |||
1261 | 1257 | | |||
1262 | === Escaped | 1258 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1263 | 1259 | | |||
1264 | This is not \[underline]#underlined text#. | 1260 | This is not \[underline]#underlined text#. | ||
1265 | 1261 | | |||
1266 | 1262 | | |||
1267 | == Emphasized | 1263 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Emphasized | ||
1268 | 1264 | | |||
1269 | === Rendered formatted | 1265 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1270 | 1266 | | |||
1271 | This line contains a _sequence_ of _multiple emphasized_ words. | 1267 | This line contains a _sequence_ of _multiple emphasized_ words. | ||
1272 | 1268 | | |||
Context not available. | |||||
1299 | aa__ bb __cc | 1295 | aa__ bb __cc | ||
1300 | 1296 | | |||
1301 | 1297 | | |||
1302 | === Rendered as-is | 1298 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1303 | 1299 | | |||
1304 | This line does not contain _some emphasized _ text as there is a surplus space. | 1300 | This line does not contain _some emphasized _ text as there is a surplus space. | ||
1305 | 1301 | | |||
Context not available. | |||||
1319 | That is a bit strange. | 1315 | That is a bit strange. | ||
1320 | 1316 | | |||
1321 | 1317 | | |||
1322 | === Escaped | 1318 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1323 | 1319 | | |||
1324 | Not \_emphasized_ as it is escaped. | 1320 | Not \_emphasized_ as it is escaped. | ||
1325 | 1321 | | |||
1326 | Still \__emphasized__ as only the outermost level is escaped. | 1322 | Still \__emphasized__ as only the outermost level is escaped. | ||
1327 | 1323 | | |||
1328 | 1324 | | |||
1329 | == Marked | 1325 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Marked | ||
1330 | 1326 | | |||
1331 | === Rendered formatted | 1327 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1332 | 1328 | | |||
1333 | Some # marked # text. | 1329 | Some # marked # text. | ||
1334 | 1330 | | |||
Context not available. | |||||
1354 | ##marked## | 1350 | ##marked## | ||
1355 | 1351 | | |||
1356 | 1352 | | |||
1357 | === Rendered as-is | 1353 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1358 | 1354 | | |||
1359 | Not rendered # marked# because of space after the leading hash. | 1355 | Not rendered # marked# because of space after the leading hash. | ||
1360 | 1356 | | |||
Context not available. | |||||
1371 | Some [big]##big marked## text. | 1367 | Some [big]##big marked## text. | ||
1372 | 1368 | | |||
1373 | 1369 | | |||
1374 | === Escaped | 1370 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1375 | 1371 | | |||
1376 | Not \#marked# as it is escaped. | 1372 | Not \#marked# as it is escaped. | ||
1377 | 1373 | | |||
1378 | Still \##marked## as only the outermost level is escaped. | 1374 | Still \##marked## as only the outermost level is escaped. | ||
1379 | 1375 | | |||
1380 | 1376 | | |||
1381 | == Monospaced | 1377 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Monospaced | ||
1382 | 1378 | | |||
1383 | === Rendered formatted | 1379 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1384 | 1380 | | |||
1385 | This line contains a `sequence of ` multiple monospaced` words. | 1381 | This line contains a `sequence of ` multiple monospaced` words. | ||
1386 | 1382 | | |||
Context not available. | |||||
1413 | aa`` bb ``cc | 1409 | aa`` bb ``cc | ||
1414 | 1410 | | |||
1415 | 1411 | | |||
1416 | === Rendered as-is | 1412 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1417 | 1413 | | |||
1418 | Not rendered ` monospaced` because of leading space. | 1414 | Not rendered ` monospaced` because of leading space. | ||
1419 | 1415 | | |||
Context not available. | |||||
1424 | Not rendered `monospaced`as there is a space missing. | 1420 | Not rendered `monospaced`as there is a space missing. | ||
1425 | 1421 | | |||
1426 | 1422 | | |||
1427 | === Escaped | 1423 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1428 | 1424 | | |||
1429 | Not \`monospaced` as it is escaped. | 1425 | Not \`monospaced` as it is escaped. | ||
1430 | 1426 | | |||
1431 | Still \``monospaced`` as only the outermost level is escaped. | 1427 | Still \``monospaced`` as only the outermost level is escaped. | ||
1432 | 1428 | | |||
1433 | 1429 | | |||
1434 | == Passthrough | 1430 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Passthrough | ||
1435 | 1431 | | |||
1436 | === Rendered passed through | 1432 | <beginfold id='1'>=== </beginfold id='1'>Rendered passed through | ||
1437 | 1433 | | |||
1438 | This text is +passed _as_ is+ with no further formatting. | 1434 | This text is +passed _as_ is+ with no further formatting. | ||
1439 | 1435 | | |||
Context not available. | |||||
1453 | This text is +++passed _as_ is+++ with no further formatting. | 1449 | This text is +++passed _as_ is+++ with no further formatting. | ||
1454 | 1450 | | |||
1455 | 1451 | | |||
1456 | === Rendered as-is | 1452 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1457 | 1453 | | |||
1458 | No+passthrough+ as there is no space before the leading `+`. | 1454 | No+passthrough+ as there is no space before the leading `+`. | ||
1459 | 1455 | | |||
Context not available. | |||||
1464 | No +passthrough + as there is a space after the trailing plus. | 1460 | No +passthrough + as there is a space after the trailing plus. | ||
1465 | 1461 | | |||
1466 | 1462 | | |||
1467 | === Escaped | 1463 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1468 | 1464 | | |||
1469 | This text \+is _not_ passed through+ because of escaping. | 1465 | This text \+is _not_ passed through+ because of escaping. | ||
1470 | 1466 | | |||
Context not available. | |||||
1473 | This text \+++is _still_ passed through+++ as only the outermost level is escaped. | 1469 | This text \+++is _still_ passed through+++ as only the outermost level is escaped. | ||
1474 | 1470 | | |||
1475 | 1471 | | |||
1476 | == Strong | 1472 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Strong | ||
1477 | 1473 | | |||
1478 | === Rendered formatted | 1474 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1479 | 1475 | | |||
1480 | This line contains a *sequence of * multiple strong* words. | 1476 | This line contains a *sequence of * multiple strong* words. | ||
1481 | 1477 | | |||
Context not available. | |||||
1510 | aa** bb **cc | 1506 | aa** bb **cc | ||
1511 | 1507 | | |||
1512 | 1508 | | |||
1513 | === Rendered as-is | 1509 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1514 | 1510 | | |||
1515 | This line does _not_ contain *some strong * text as there is a space before the trailing asterisk. | 1511 | This line does _not_ contain *some strong * text as there is a space before the trailing asterisk. | ||
1516 | 1512 | | |||
Context not available. | |||||
1534 | That is a bit strange. | 1530 | That is a bit strange. | ||
1535 | 1531 | | |||
1536 | 1532 | | |||
1537 | === Escaped | 1533 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1538 | 1534 | | |||
1539 | Not \*strong* as it is escaped. | 1535 | Not \*strong* as it is escaped. | ||
1540 | 1536 | | |||
1541 | Still \**strong** as only the outermost level is escaped. | 1537 | Still \**strong** as only the outermost level is escaped. | ||
1542 | 1538 | | |||
1543 | 1539 | | |||
1544 | == Subscript | 1540 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Subscript | ||
1545 | 1541 | | |||
1546 | === Rendered formatted | 1542 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1547 | 1543 | | |||
1548 | H~2~O | 1544 | H~2~O | ||
1549 | 1545 | | |||
1550 | 1546 | | |||
1551 | === Rendered as-is | 1547 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1552 | 1548 | | |||
1553 | Not rendered sub~sc ript~ as there is a space within. | 1549 | Not rendered sub~sc ript~ as there is a space within. | ||
1554 | 1550 | | |||
1555 | 1551 | | |||
1556 | === Escaped | 1552 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1557 | 1553 | | |||
1558 | Not \~subscript~ as it is escaped. | 1554 | Not \~subscript~ as it is escaped. | ||
1559 | 1555 | | |||
1560 | 1556 | | |||
1561 | == Superscript | 1557 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Superscript | ||
1562 | 1558 | | |||
1563 | === Rendered formatted | 1559 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1564 | 1560 | | |||
1565 | E = m c^2^ | 1561 | E = m c^2^ | ||
1566 | 1562 | | |||
1567 | 1563 | | |||
1568 | === Rendered as-is | 1564 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1569 | 1565 | | |||
1570 | Not rendered super^sc ript^ as there is a space within. | 1566 | Not rendered super^sc ript^ as there is a space within. | ||
1571 | 1567 | | |||
1572 | 1568 | | |||
1573 | === Escaped | 1569 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1574 | 1570 | | |||
1575 | Not \^superscript^ as it is escaped. | 1571 | Not \^superscript^ as it is escaped. | ||
1576 | 1572 | | |||
1577 | 1573 | | |||
1578 | == Combinations | 1574 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Combinations | ||
1579 | 1575 | | |||
1580 | IMPORTANT: Combinations are supported by Asciidoctor, as long as the markup sets are entered in the right order. | 1576 | IMPORTANT: Combinations are supported by Asciidoctor, as long as the markup sets are entered in the right order. | ||
1581 | The monospace markup must be the outermost set, then the strong set, and the emphasized markup must always be the innermost set. | 1577 | The monospace markup must be the outermost set, then the strong set, and the emphasized markup must always be the innermost set. | ||
1582 | 1578 | | |||
1583 | 1579 | | |||
1584 | === Rendered formatted | 1580 | <beginfold id='1'>=== </beginfold id='1'>Rendered formatted | ||
1585 | 1581 | | |||
1586 | This is *_strong emphasized_* text. | 1582 | This is *_strong emphasized_* text. | ||
1587 | 1583 | | |||
Context not available. | |||||
1627 | `*_strong emphasized monospaced_*` | 1623 | `*_strong emphasized monospaced_*` | ||
1628 | 1624 | | |||
1629 | 1625 | | |||
1630 | === Unsupported | 1626 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Unsupported | ||
1631 | 1627 | | |||
1632 | Highlighting for other combinations is currently not supported, as there would be a large number of rules and styles necessary. | 1628 | Highlighting for other combinations is currently not supported, as there would be a large number of rules and styles necessary. | ||
1633 | 1629 | | |||
Context not available. | |||||
1649 | And even more complex ones. | 1645 | And even more complex ones. | ||
1650 | 1646 | | |||
1651 | 1647 | | |||
1652 | === Rendered as-is | 1648 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Rendered as-is | ||
1653 | 1649 | | |||
1654 | This is no *_ strong emphasized_* text, it's *strong* only. | 1650 | This is no *_ strong emphasized_* text, it's *strong* only. | ||
1655 | 1651 | | |||
Context not available. | |||||
1660 | This is no _`emphasized monospaced`_ text, it's _emphasized_ only. | 1656 | This is no _`emphasized monospaced`_ text, it's _emphasized_ only. | ||
1661 | 1657 | | |||
1662 | 1658 | | |||
1663 | === Escaped | 1659 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
1664 | 1660 | | |||
1665 | This is not rendered \`_emphasized monospaced_`. + | 1661 | This is not rendered \`_emphasized monospaced_`. + | ||
1666 | But it is rendered emphasized. | 1662 | But it is rendered emphasized. | ||
Context not available. | |||||
1675 | But it is rendered emphasized strong. | 1671 | But it is rendered emphasized strong. | ||
1676 | 1672 | | |||
1677 | 1673 | | |||
1678 | = Horizontal Rules | 1674 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Horizontal Rules | ||
1679 | 1675 | | |||
1680 | == Simple patterns | 1676 | <beginfold id='1'>== </beginfold id='1'>Simple patterns | ||
1681 | 1677 | | |||
1682 | ''' | 1678 | ''' | ||
1683 | --- | 1679 | --- | ||
1684 | *** | 1680 | *** | ||
1685 | 1681 | | |||
1686 | 1682 | | |||
1687 | == Patterns with spaces | 1683 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Patterns with spaces | ||
1688 | 1684 | | |||
1689 | - - - | 1685 | - - - | ||
1690 | * * * | 1686 | * * * | ||
Context not available. | |||||
1693 | ' ' ' | 1689 | ' ' ' | ||
1694 | 1690 | | |||
1695 | 1691 | | |||
1696 | == Arbitrary length | 1692 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Arbitrary length | ||
1697 | 1693 | | |||
1698 | NOTE: Although the https://asciidoctor.org/docs/user-manual/#markdown-style-horizontal-rules[Asciidoctor Manual] states that horizontal rule patterns are only supporting up to three characters (ignoring the optional spaces), some longer patterns work too. | 1694 | NOTE: Although the https://asciidoctor.org/docs/user-manual/#markdown-style-horizontal-rules[Asciidoctor Manual] states that horizontal rule patterns are only supporting up to three characters (ignoring the optional spaces), some longer patterns work too. | ||
1699 | 1695 | | |||
1700 | ''''''' | 1696 | ''''''' | ||
1701 | 1697 | | |||
1702 | <beginfold id='1'>////</beginfold id='1'> | 1698 | <beginfold id='2'>////</beginfold id='2'> | ||
1703 | These patterns don't work, as they start delimited blocks, item lists etc.. | 1699 | These patterns don't work, as they start delimited blocks, item lists etc.. | ||
1704 | -------- | 1700 | -------- | ||
1705 | ****** | 1701 | ****** | ||
1706 | - - - - - - | 1702 | - - - - - - | ||
1707 | * * * * * * * * * | 1703 | * * * * * * * * * | ||
1708 | <endfold id='1'>////</endfold id='1'> | 1704 | <endfold id='2'>////</endfold id='2'> | ||
1709 | 1705 | | |||
1710 | 1706 | | |||
1711 | == Inside blocks | 1707 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Inside blocks | ||
1712 | 1708 | | |||
1713 | <beginfold id='2'>****</beginfold id='2'> | 1709 | <beginfold id='3'>****</beginfold id='3'> | ||
1714 | Horizontal rules work also inside blocks. | 1710 | Horizontal rules work also inside blocks. | ||
1715 | They eventually need an empty line before them, though. | 1711 | They eventually need an empty line before them, though. | ||
1716 | 1712 | | |||
1717 | ''' | 1713 | ''' | ||
1718 | After the horizontal rule. | 1714 | After the horizontal rule. | ||
1719 | <endfold id='2'>****</endfold id='2'> | 1715 | <endfold id='3'>****</endfold id='3'> | ||
1720 | 1716 | | |||
1721 | 1717 | | |||
1722 | = Include | 1718 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Include | ||
1723 | :includedir: include | 1719 | :includedir: include | ||
1724 | 1720 | | |||
1725 | == Included Contents Rendered | 1721 | <beginfold id='1'>== </beginfold id='1'>Included Contents Rendered | ||
1726 | 1722 | | |||
1727 | IMPORTANT: The include directive is _always_ processed, even withing passthrough blocks. | 1723 | IMPORTANT: The include directive is _always_ processed, even within passthrough blocks. | ||
1728 | 1724 | | |||
1729 | NOTE: Using file names with spaces works. | 1725 | NOTE: Using file names with spaces works. | ||
1730 | 1726 | | |||
Context not available. | |||||
1741 | 1737 | | |||
1742 | .Inside delimited block with name | 1738 | .Inside delimited block with name | ||
1743 | [literal] | 1739 | [literal] | ||
1744 | <beginfold id='2'>----</beginfold id='2'> | 1740 | <beginfold id='3'>----</beginfold id='3'> | ||
1745 | This line shall be highlighted as verbatim. | 1741 | This line shall be highlighted as verbatim. | ||
1746 | include::{includedir}/demo.adoc[lines=2..3] | 1742 | include::{includedir}/demo.adoc[lines=2..3] | ||
1747 | This line shall be highlighted as verbatim. | 1743 | This line shall be highlighted as verbatim. | ||
1748 | <endfold id='2'>----</endfold id='2'> | 1744 | <endfold id='3'>----</endfold id='3'> | ||
1749 | 1745 | | |||
1750 | .Inside delimited block without name | 1746 | .Inside delimited block without name | ||
1751 | <beginfold id='2'>....</beginfold id='2'> | 1747 | <beginfold id='3'>....</beginfold id='3'> | ||
1752 | This line shall be highlighted as verbatim. | 1748 | This line shall be highlighted as verbatim. | ||
1753 | include::{includedir}/demo.adoc[lines=2..3] | 1749 | include::{includedir}/demo.adoc[lines=2..3] | ||
1754 | This line shall be highlighted as verbatim. | 1750 | This line shall be highlighted as verbatim. | ||
1755 | <endfold id='2'>....</endfold id='2'> | 1751 | <endfold id='3'>....</endfold id='3'> | ||
1756 | 1752 | | |||
1757 | .It is also processed within passthrough blocks | 1753 | .It is also processed within passthrough blocks | ||
1758 | [pass] | 1754 | [pass] | ||
Context not available. | |||||
1768 | -- | 1764 | -- | ||
1769 | 1765 | | |||
1770 | .Inside table | 1766 | .Inside table | ||
1771 | <beginfold id='2'>|===</beginfold id='2'> | 1767 | <beginfold id='3'>|===</beginfold id='3'> | ||
1772 | |row 1 col 1|row 2 col 2 | 1768 | |row 1 col 1|row 2 col 2 | ||
1773 | | | 1769 | | | ||
1774 | // the include directive must have its own line with nothing else | 1770 | // the include directive must have its own line with nothing else | ||
Context not available. | |||||
1777 | 1773 | | |||
1778 | |row 3 col 1 | 1774 | |row 3 col 1 | ||
1779 | |row 3 col 2 | 1775 | |row 3 col 2 | ||
1780 | <endfold id='2'>|===</endfold id='2'> | 1776 | <endfold id='3'>|===</endfold id='3'> | ||
1781 | 1777 | | |||
1782 | 1778 | | |||
1783 | = Index | 1779 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Index | ||
1784 | 1780 | | |||
1785 | == Rendered as Index Term | 1781 | <beginfold id='1'>== </beginfold id='1'>Rendered as Index Term | ||
1786 | 1782 | | |||
1787 | This is a ((flow)) index term. | 1783 | This is a ((flow)) index term. | ||
1788 | 1784 | | |||
Context not available. | |||||
1803 | Some ((((index term)))). | 1799 | Some ((((index term)))). | ||
1804 | 1800 | | |||
1805 | 1801 | | |||
1806 | == Rendered as-is | 1802 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Rendered as-is | ||
1807 | 1803 | | |||
1808 | This is (()) not an index term as it is empty. | 1804 | This is (()) not an index term as it is empty. | ||
1809 | 1805 | | |||
Context not available. | |||||
1812 | This is ((not an index term) as there is a `)` missing. | 1808 | This is ((not an index term) as there is a `)` missing. | ||
1813 | 1809 | | |||
1814 | 1810 | | |||
1815 | == Escaped | 1811 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Escaped | ||
1816 | 1812 | | |||
1817 | This is \((not an indexterm)) as it is escaped. | 1813 | This is \((not an indexterm)) as it is escaped. | ||
1818 | 1814 | | |||
Context not available. | |||||
1826 | 1822 | | |||
1827 | 1823 | | |||
1828 | [index] | 1824 | [index] | ||
1829 | == Index Catalog | 1825 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Index Catalog | ||
1830 | 1826 | | |||
1831 | WARNING: HTML output currently does not support the creation of the index catalog. | 1827 | WARNING: HTML output currently does not support the creation of the index catalog. | ||
1832 | 1828 | | |||
1833 | 1829 | | |||
1834 | = Link | 1830 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Link | ||
1835 | 1831 | | |||
1836 | == ftp, irc | 1832 | <beginfold id='1'>== </beginfold id='1'>ftp, irc | ||
1837 | 1833 | | |||
1838 | * ftp://some.org/some/where/file.extension | 1834 | * ftp://some.org/some/where/file.extension | ||
1839 | * irc://some.org/some/where/file.extension | 1835 | * irc://some.org/some/where/file.extension | ||
1840 | 1836 | | |||
1841 | 1837 | | |||
1842 | == http(s) | 1838 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>http(s) | ||
1843 | 1839 | | |||
1844 | * http://some.org/some/where/file.extension | 1840 | * http://some.org/some/where/file.extension | ||
1845 | * https://some.org/some/where/file.extension | 1841 | * https://some.org/some/where/file.extension | ||
Context not available. | |||||
1884 | * >https://some.org | 1880 | * >https://some.org | ||
1885 | 1881 | | |||
1886 | 1882 | | |||
1887 | === Not rendered as Link | 1883 | <beginfold id='1'>=== </beginfold id='1'>Not rendered as Link | ||
1888 | 1884 | | |||
1889 | * {https://some.org | 1885 | * {https://some.org | ||
1890 | * }https://some.org | 1886 | * }https://some.org | ||
Context not available. | |||||
1893 | * :https://some.org | 1889 | * :https://some.org | ||
1894 | 1890 | | |||
1895 | 1891 | | |||
1896 | == link | 1892 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>link | ||
1897 | 1893 | | |||
1898 | * link:relative/path - not rendered as link as `[]` are misssing | 1894 | * link:relative/path - not rendered as link as `[]` are misssing | ||
1899 | * link:relative/path[] | 1895 | * link:relative/path[] | ||
Context not available. | |||||
1907 | * link:url[optional link text, optional target attribute, optional role attribute] | 1903 | * link:url[optional link text, optional target attribute, optional role attribute] | ||
1908 | 1904 | | |||
1909 | 1905 | | |||
1910 | 1906 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>E-Mail | |||
1911 | 1907 | | |||
1912 | * some.person@org.com | 1908 | * some.person@org.com | ||
1913 | * some.person@org.com[some one] - brackets supported only with leading `mailto:` | 1909 | * some.person@org.com[some one] - brackets supported only with leading `mailto:` | ||
Context not available. | |||||
1923 | * mailto:[some one] - not rendered as link because of missing address | 1919 | * mailto:[some one] - not rendered as link because of missing address | ||
1924 | 1920 | | |||
1925 | 1921 | | |||
1926 | == Escaped | 1922 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Escaped | ||
1927 | 1923 | | |||
1928 | * \ftp://some.org/some/where/file.extension | 1924 | * \ftp://some.org/some/where/file.extension | ||
1929 | * \irc://some.org/some/where/file.extension | 1925 | * \irc://some.org/some/where/file.extension | ||
Context not available. | |||||
1936 | * \mailto:some.person@org.com[] | 1932 | * \mailto:some.person@org.com[] | ||
1937 | 1933 | | |||
1938 | 1934 | | |||
1939 | = List | 1935 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= List | ||
1940 | 1936 | | |||
1941 | == Bulleted List | 1937 | <beginfold id='1'>== </beginfold id='1'>Bulleted List | ||
1942 | 1938 | | |||
1943 | <beginfold id='1'>////</beginfold id='1'> | 1939 | <beginfold id='2'>////</beginfold id='2'> | ||
1944 | FIXME The *** without text in the list below should not be highlighted as a horizontal line. | 1940 | FIXME The *** without text in the list below should not be highlighted as a horizontal line. | ||
1945 | This is going to be problematic, as we would need to know that we are currently inside a list. | 1941 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
1946 | <endfold id='1'>////</endfold id='1'> | 1942 | <endfold id='2'>////</endfold id='2'> | ||
1947 | .using asterisks | 1943 | .using asterisks | ||
1948 | * item 1 | 1944 | * item 1 | ||
1949 | * * item 2 | 1945 | * * item 2 | ||
Context not available. | |||||
1972 | - item 2 | 1968 | - item 2 | ||
1973 | -- item 2.1 is not an item as using hyphens is only supported for flat lists | 1969 | -- item 2.1 is not an item as using hyphens is only supported for flat lists | ||
1974 | 1970 | | |||
1975 | <beginfold id='1'>////</beginfold id='1'> | 1971 | <beginfold id='2'>////</beginfold id='2'> | ||
1976 | FIXME: The line above should not be highlighted as literal. | 1972 | FIXME: The line above should not be highlighted as literal. | ||
1977 | This is going to be problematic, as we would need to know that we are currently inside a list. | 1973 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
1978 | <endfold id='1'>////</endfold id='1'> | 1974 | <endfold id='2'>////</endfold id='2'> | ||
1979 | 1975 | | |||
1980 | .inside a block | 1976 | .inside a block | ||
1981 | <beginfold id='2'>****</beginfold id='2'> | 1977 | <beginfold id='3'>****</beginfold id='3'> | ||
1982 | * item 1 | 1978 | * item 1 | ||
1983 | ** item 1.1 | 1979 | ** item 1.1 | ||
1984 | <endfold id='2'>****</endfold id='2'> | 1980 | <endfold id='3'>****</endfold id='3'> | ||
1985 | 1981 | | |||
1986 | 1982 | | |||
1987 | == Checklist | 1983 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Checklist | ||
1988 | 1984 | | |||
1989 | <beginfold id='1'>////</beginfold id='1'> | 1985 | <beginfold id='2'>////</beginfold id='2'> | ||
1990 | FIXME The invalid checklist items below should not be highlighted as bulleted list items. | 1986 | FIXME The invalid checklist items below should not be highlighted as bulleted list items. | ||
1991 | This is going to be problematic, as we would need to know that we are currently inside a checklist. | 1987 | This is going to be problematic, as we would need to know that we are currently inside a checklist. | ||
1992 | <endfold id='1'>////</endfold id='1'> | 1988 | <endfold id='2'>////</endfold id='2'> | ||
1993 | 1989 | | |||
1994 | .using asterisks | 1990 | .using asterisks | ||
1995 | * [*] checked | 1991 | * [*] checked | ||
Context not available. | |||||
2007 | -- [*] _not a list item_ as hyphens are only supported for flat lists | 2003 | -- [*] _not a list item_ as hyphens are only supported for flat lists | ||
2008 | -- [*] _not a list item_ as hyphens are only supported for flat lists | 2004 | -- [*] _not a list item_ as hyphens are only supported for flat lists | ||
2009 | 2005 | | |||
2010 | <beginfold id='1'>////</beginfold id='1'> | 2006 | <beginfold id='2'>////</beginfold id='2'> | ||
2011 | FIXME: the line above should not be highlighted as literal. | 2007 | FIXME: the line above should not be highlighted as literal. | ||
2012 | This is going to be problematic, as we would need to know that we are currently inside a list. | 2008 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
2013 | <endfold id='1'>////</endfold id='1'> | 2009 | <endfold id='2'>////</endfold id='2'> | ||
2014 | 2010 | | |||
2015 | 2011 | | |||
2016 | == Description List | 2012 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Description List | ||
2017 | 2013 | | |||
2018 | .Normal format | 2014 | .Normal format | ||
2019 | Term normal:: This is a description. | 2015 | Term normal:: This is a description. | ||
Context not available. | |||||
2037 | .;Strange Term = !?*:: This one has a strange term. | 2033 | .;Strange Term = !?*:: This one has a strange term. | ||
2038 | Term 9 : : A space between the double `:` does _not_ work. | 2034 | Term 9 : : A space between the double `:` does _not_ work. | ||
2039 | 2035 | | |||
2040 | <beginfold id='1'>////</beginfold id='1'> | 2036 | <beginfold id='2'>////</beginfold id='2'> | ||
2041 | FIXME The line with the "Strange Term" abvoe should not be highlighted as title in this case. | 2037 | FIXME The line with the "Strange Term" abvoe should not be highlighted as title in this case. | ||
2042 | This is going to be problematic, as we would need to know that we are currently inside a list. | 2038 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
2043 | <endfold id='1'>////</endfold id='1'> | 2039 | <endfold id='2'>////</endfold id='2'> | ||
2044 | 2040 | | |||
2045 | .Term and description on the same line | 2041 | .Term and description on the same line | ||
2046 | [horizontal] | 2042 | [horizontal] | ||
Context not available. | |||||
2049 | Term 3:: first level again. | 2045 | Term 3:: first level again. | ||
2050 | 2046 | | |||
2051 | 2047 | | |||
2052 | == Numbered List | 2048 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Numbered List | ||
2053 | 2049 | | |||
2054 | .using numbers | 2050 | .using numbers | ||
2055 | 1. item 1 | 2051 | 1. item 1 | ||
Context not available. | |||||
2070 | .... item 2.2.1.1 | 2066 | .... item 2.2.1.1 | ||
2071 | . item 3 | 2067 | . item 3 | ||
2072 | 2068 | | |||
2073 | <beginfold id='1'>////</beginfold id='1'> | 2069 | <beginfold id='2'>////</beginfold id='2'> | ||
2074 | FIXME The line above starting with "..not an item" should not be highlighted as title in this case. | 2070 | FIXME The line above starting with "..not an item" should not be highlighted as title in this case. | ||
2075 | This is going to be problematic, as we would need to know that we are currently inside a list. | 2071 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
2076 | <endfold id='1'>////</endfold id='1'> | 2072 | <endfold id='2'>////</endfold id='2'> | ||
2077 | 2073 | | |||
2078 | 2074 | | |||
2079 | == Question and Answer List | 2075 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Question and Answer List | ||
2080 | 2076 | | |||
2081 | <beginfold id='1'>////</beginfold id='1'> | 2077 | <beginfold id='2'>////</beginfold id='2'> | ||
2082 | FIXME Indented answer is highlighted as verbatim block, messing up further question. | 2078 | FIXME Indented answer is highlighted as verbatim block, messing up further question. | ||
2083 | This is going to be problematic, as we would need to know that we are currently inside a list. | 2079 | This is going to be problematic, as we would need to know that we are currently inside a list. | ||
2084 | <endfold id='1'>////</endfold id='1'> | 2080 | <endfold id='2'>////</endfold id='2'> | ||
2085 | 2081 | | |||
2086 | [qanda] | 2082 | [qanda] | ||
2087 | What is Asciidoctor?:: | 2083 | What is Asciidoctor?:: | ||
Context not available. | |||||
2091 | What is the answer to the Ultimate Question?:: 42 | 2087 | What is the answer to the Ultimate Question?:: 42 | ||
2092 | 2088 | | |||
2093 | 2089 | | |||
2094 | = Macro | 2090 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Macro | ||
2095 | // for `btn:`, `kbd:`, `menu:` | 2091 | // for `btn:`, `kbd:`, `menu:` | ||
2096 | :experimental: | 2092 | :experimental: | ||
2097 | // for icon:tags[] etc. | 2093 | // for icon:tags[] etc. | ||
Context not available. | |||||
2099 | // needed to use macro `toc::[]` | 2095 | // needed to use macro `toc::[]` | ||
2100 | :toc: macro | 2096 | :toc: macro | ||
2101 | 2097 | | |||
2102 | == General Information | 2098 | <beginfold id='1'>== </beginfold id='1'>General Information | ||
2103 | 2099 | | |||
2104 | NOTE: There is no space needed before the macro name or after the closing `]`. | 2100 | NOTE: There is no space needed before the macro name or after the closing `]`. | ||
2105 | 2101 | | |||
2106 | 2102 | | |||
2107 | == Anchor | 2103 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Anchor | ||
2108 | 2104 | | |||
2109 | There is a macro form anchor:anchor-id[Macro Anchor] for anchor definition. | 2105 | There is a macro form anchor:anchor-id[Macro Anchor] for anchor definition. | ||
2110 | 2106 | | |||
2111 | See `anchor.adoc` for other forms. | 2107 | See `anchor.adoc` for other forms. | ||
2112 | 2108 | | |||
2113 | 2109 | | |||
2114 | == Cross Reference | 2110 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Cross Reference | ||
2115 | 2111 | | |||
2116 | xref:anchor-id[macro xref] | 2112 | xref:anchor-id[macro xref] | ||
2117 | 2113 | | |||
Context not available. | |||||
2125 | \xref:anchor-id[macro xref] escaped | 2121 | \xref:anchor-id[macro xref] escaped | ||
2126 | 2122 | | |||
2127 | 2123 | | |||
2128 | == Footnote | 2124 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Footnote | ||
2129 | 2125 | | |||
2130 | This text has a foonotefootnote:[A simple footnote.]. | 2126 | This text has a foonotefootnote:[A simple footnote.]. | ||
2131 | 2127 | | |||
2132 | This text has a foonote with idfootnoteref:[fn-1, A footnote reference.]. | 2128 | This text has a foonote with idfootnoteref:[fn-1, A footnote reference.]. | ||
2133 | 2129 | | |||
2134 | 2130 | | |||
2135 | == Icon | 2131 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Icon | ||
2136 | 2132 | | |||
2137 | This is a tag icon:tags[] icon with no color set. | 2133 | This is a tag icon:tags[] icon with no color set. | ||
2138 | 2134 | | |||
Context not available. | |||||
2141 | This is a big green icon:tags[role="green", size="2x"] tag. | 2137 | This is a big green icon:tags[role="green", size="2x"] tag. | ||
2142 | 2138 | | |||
2143 | 2139 | | |||
2144 | == Image | 2140 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Image | ||
2145 | 2141 | | |||
2146 | An imageimage:logo-outline-color.svg[Logo,25]within some text. | 2142 | An imageimage:logo-outline-color.svg[Logo,25]within some text. | ||
2147 | 2143 | | |||
2148 | 2144 | | |||
2149 | == Keyboard Shortcut | 2145 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Keyboard Shortcut | ||
2150 | 2146 | | |||
2151 | kbd:[Ctrl+M] | 2147 | kbd:[Ctrl+M] | ||
2152 | 2148 | | |||
2153 | 2149 | | |||
2154 | == Menu Selection | 2150 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Menu Selection | ||
2155 | 2151 | | |||
2156 | menu:File[Save] | 2152 | menu:File[Save] | ||
2157 | 2153 | | |||
2158 | menu:View[Zoom > 1:1] | 2154 | menu:View[Zoom > 1:1] | ||
2159 | 2155 | | |||
2160 | 2156 | | |||
2161 | == Pass | 2157 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Pass | ||
2162 | 2158 | | |||
2163 | // TODO Would be nice to highlight the text within the square bracktes as passthrough. | 2159 | // TODO Would be nice to highlight the text within the square brackets as passthrough. | ||
2164 | 2160 | | |||
2165 | Some pass:[<u>passthrough</u>] HTML. | 2161 | Some pass:[<u>passthrough</u>] HTML. | ||
2166 | 2162 | | |||
Context not available. | |||||
2169 | Some pass:q[<u>passthrough with *quoted* text</u>] HTML. | 2165 | Some pass:q[<u>passthrough with *quoted* text</u>] HTML. | ||
2170 | 2166 | | |||
2171 | 2167 | | |||
2172 | == Table of Contents | 2168 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Table of Contents | ||
2173 | 2169 | | |||
2174 | toc::[] | 2170 | toc::[] | ||
2175 | 2171 | | |||
2176 | 2172 | | |||
2177 | == UI Buttons | 2173 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>UI Buttons | ||
2178 | 2174 | | |||
2179 | Press the btn:[OK] button when you are finished. | 2175 | Press the btn:[OK] button when you are finished. | ||
2180 | 2176 | | |||
2181 | 2177 | | |||
2182 | == Escaped | 2178 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Escaped | ||
2183 | 2179 | | |||
2184 | This is no anchor \anchor:macro-anchor[Macro Anchor]. | 2180 | This is no anchor \anchor:macro-anchor[Macro Anchor]. | ||
2185 | 2181 | | |||
Context not available. | |||||
2200 | This is no passthrough \pass:[<u>passthrough</u>]. | 2196 | This is no passthrough \pass:[<u>passthrough</u>]. | ||
2201 | 2197 | | |||
2202 | 2198 | | |||
2203 | = Media | 2199 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Media | ||
2204 | // The name `imagesdir` is a bit misleading as audio and video use also this prefix. | 2200 | // The name `imagesdir` is a bit misleading as audio and video use also this prefix. | ||
2205 | :imagesdir: media | 2201 | :imagesdir: media | ||
2206 | 2202 | | |||
2207 | == Audio | 2203 | <beginfold id='1'>== </beginfold id='1'>Audio | ||
2208 | 2204 | | |||
2209 | audio::test.mp3[] | 2205 | audio::test.mp3[] | ||
2210 | 2206 | | |||
Context not available. | |||||
2214 | \audio::test.mp3[] | 2210 | \audio::test.mp3[] | ||
2215 | 2211 | | |||
2216 | 2212 | | |||
2217 | == Image | 2213 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Image | ||
2218 | 2214 | | |||
2219 | === Block Format | 2215 | <beginfold id='1'>=== </beginfold id='1'>Block Format | ||
2220 | 2216 | | |||
2221 | .Test SVG | 2217 | .Test SVG | ||
2222 | [#logo] | 2218 | [#logo] | ||
Context not available. | |||||
2224 | image::test.svg[Test, 100] | 2220 | image::test.svg[Test, 100] | ||
2225 | 2221 | | |||
2226 | 2222 | | |||
2227 | ==== Not highlighted | 2223 | <beginfold id='1'>==== </beginfold id='1'>Not highlighted | ||
2228 | 2224 | | |||
2229 | .leading spaces, literal paragraph | 2225 | .leading spaces, literal paragraph | ||
2230 | image::test.svg[Test, 100] | 2226 | image::test.svg[Test, 100] | ||
Context not available. | |||||
2233 | image::test.svg[Test, 100] trailing | 2229 | image::test.svg[Test, 100] trailing | ||
2234 | 2230 | | |||
2235 | 2231 | | |||
2236 | ==== Escaped | 2232 | <endfold id='1'></endfold id='1'><beginfold id='1'>==== </beginfold id='1'>Escaped | ||
2237 | 2233 | | |||
2238 | \image::test.svg[Asciidoctor Logo, 100] | 2234 | \image::test.svg[Asciidoctor Logo, 100] | ||
2239 | 2235 | | |||
2240 | 2236 | | |||
2241 | === Inline Format | 2237 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Inline Format | ||
2242 | 2238 | | |||
2243 | Withinimage:logo-outline-color.svg[Tree, 25]some text. | 2239 | Withinimage:logo-outline-color.svg[Tree, 25]some text. | ||
2244 | 2240 | | |||
Context not available. | |||||
2251 | (image:logo-outline-color.svg[Tree, 25]) wrapped in non-space characters. | 2247 | (image:logo-outline-color.svg[Tree, 25]) wrapped in non-space characters. | ||
2252 | 2248 | | |||
2253 | 2249 | | |||
2254 | ==== Not highlighted | 2250 | <beginfold id='1'>==== </beginfold id='1'>Not highlighted | ||
2255 | 2251 | | |||
2256 | image | 2252 | image | ||
2257 | 2253 | | |||
Context not available. | |||||
2264 | some image:[] | 2260 | some image:[] | ||
2265 | 2261 | | |||
2266 | 2262 | | |||
2267 | ==== Escaped | 2263 | <endfold id='1'></endfold id='1'><beginfold id='1'>==== </beginfold id='1'>Escaped | ||
2268 | 2264 | | |||
2269 | Within\image:logo-outline-color.svg[Tree, 25]some text. | 2265 | Within\image:logo-outline-color.svg[Tree, 25]some text. | ||
2270 | 2266 | | |||
2271 | 2267 | | |||
2272 | == Video | 2268 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Video | ||
2273 | 2269 | | |||
2274 | video::test.mp4[width=300] | 2270 | video::test.mp4[width=300] | ||
2275 | 2271 | | |||
Context not available. | |||||
2279 | \video::test.mp4[] | 2275 | \video::test.mp4[] | ||
2280 | 2276 | | |||
2281 | 2277 | | |||
2282 | = Page break | 2278 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Page break | ||
2283 | 2279 | | |||
2284 | == Rendered as page break | 2280 | <beginfold id='1'>== </beginfold id='1'>Rendered as page break | ||
2285 | 2281 | | |||
2286 | <<< | 2282 | <<< | ||
2287 | 2283 | | |||
2288 | 2284 | | |||
2289 | == Not rendered as page break | 2285 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Not rendered as page break | ||
2290 | 2286 | | |||
2291 | .Not a page break as it is indented | 2287 | .Not a page break as it is indented | ||
2292 | <<< | 2288 | <<< | ||
Context not available. | |||||
2298 | \<<< | 2294 | \<<< | ||
2299 | 2295 | | |||
2300 | 2296 | | |||
2301 | = Preprocessor | 2297 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Preprocessor | ||
2302 | 2298 | | |||
2303 | == If Defined | 2299 | <beginfold id='1'>== </beginfold id='1'>If Defined | ||
2304 | 2300 | | |||
2305 | :!attr-1: | 2301 | :!attr-1: | ||
2306 | ifdef::attr-1[] | 2302 | ifdef::attr-1[] | ||
Context not available. | |||||
2316 | ifdef::attr-1[The attribute `attr-1` is defined] | 2312 | ifdef::attr-1[The attribute `attr-1` is defined] | ||
2317 | 2313 | | |||
2318 | 2314 | | |||
2319 | == If Not Defined | 2315 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>If Not Defined | ||
2320 | 2316 | | |||
2321 | :!attr-1: | 2317 | :!attr-1: | ||
2322 | ifndef::some-attribute[] | 2318 | ifndef::some-attribute[] | ||
Context not available. | |||||
2327 | ifndef::some-attribute[The attribute `attr-1` is _not_ defined] | 2323 | ifndef::some-attribute[The attribute `attr-1` is _not_ defined] | ||
2328 | 2324 | | |||
2329 | 2325 | | |||
2330 | == Any (or) | 2326 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Any (or) | ||
2331 | 2327 | | |||
2332 | :!attr-1: | 2328 | :!attr-1: | ||
2333 | :!attr-2: | 2329 | :!attr-2: | ||
Context not available. | |||||
2344 | endif::[] | 2340 | endif::[] | ||
2345 | 2341 | | |||
2346 | 2342 | | |||
2347 | == None (nor) | 2343 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>None (nor) | ||
2348 | 2344 | | |||
2349 | :!attr-1: | 2345 | :!attr-1: | ||
2350 | :!attr-2: | 2346 | :!attr-2: | ||
Context not available. | |||||
2361 | endif::[] | 2357 | endif::[] | ||
2362 | 2358 | | |||
2363 | 2359 | | |||
2364 | == All (and) | 2360 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>All (and) | ||
2365 | 2361 | | |||
2366 | :attr-1: | 2362 | :attr-1: | ||
2367 | :attr-2: | 2363 | :attr-2: | ||
Context not available. | |||||
2378 | endif::[] | 2374 | endif::[] | ||
2379 | 2375 | | |||
2380 | 2376 | | |||
2381 | == Not All (nand) | 2377 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Not All (nand) | ||
2382 | 2378 | | |||
2383 | :attr-1: | 2379 | :attr-1: | ||
2384 | :attr-2: | 2380 | :attr-2: | ||
Context not available. | |||||
2395 | endif::[] | 2391 | endif::[] | ||
2396 | 2392 | | |||
2397 | 2393 | | |||
2398 | == If Eval | 2394 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>If Eval | ||
2399 | 2395 | | |||
2400 | :two: 2 | 2396 | :two: 2 | ||
2401 | ifeval::[{two} > 1] | 2397 | ifeval::[{two} > 1] | ||
Context not available. | |||||
2408 | endif::[] | 2404 | endif::[] | ||
2409 | 2405 | | |||
2410 | 2406 | | |||
2411 | == Escaped | 2407 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Escaped | ||
2412 | 2408 | | |||
2413 | :!attr-1: | 2409 | :!attr-1: | ||
2414 | \ifdef::attr-1[] | 2410 | \ifdef::attr-1[] | ||
Context not available. | |||||
2426 | \endif::[] | 2422 | \endif::[] | ||
2427 | 2423 | | |||
2428 | 2424 | | |||
2429 | = Quote and Verse | 2425 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Quote and Verse | ||
2430 | 2426 | | |||
2431 | == Quote | 2427 | <beginfold id='1'>== </beginfold id='1'>Quote | ||
2432 | 2428 | | |||
2433 | .Contiguous block / paragraph | 2429 | .Contiguous block / paragraph | ||
2434 | [quote, attribution, citation title and information] | 2430 | [quote, attribution, citation title and information] | ||
Context not available. | |||||
2441 | .Delimited with block name | 2437 | .Delimited with block name | ||
2442 | [quote, attribution, citation title and information] | 2438 | [quote, attribution, citation title and information] | ||
2443 | [[quote-block-id]] | 2439 | [[quote-block-id]] | ||
2444 | <beginfold id='2'>____</beginfold id='2'> | 2440 | <beginfold id='3'>____</beginfold id='3'> | ||
2445 | Inside the *delimited block quote*. | 2441 | Inside the *delimited block quote*. | ||
2446 | 2442 | | |||
2447 | May contain emtpy lines. | 2443 | May contain emtpy lines. | ||
2448 | <endfold id='2'>____</endfold id='2'> | 2444 | <endfold id='3'>____</endfold id='3'> | ||
2449 | 2445 | | |||
2450 | .Delimited without block name | 2446 | .Delimited without block name | ||
2451 | [[quote-block-id]] | 2447 | [[quote-block-id]] | ||
2452 | <beginfold id='2'>____</beginfold id='2'> | 2448 | <beginfold id='3'>____</beginfold id='3'> | ||
2453 | Inside the *delimited block quote*. | 2449 | Inside the *delimited block quote*. | ||
2454 | 2450 | | |||
2455 | May contain emtpy lines. | 2451 | May contain emtpy lines. | ||
2456 | <endfold id='2'>____</endfold id='2'> | 2452 | <endfold id='3'>____</endfold id='3'> | ||
2457 | 2453 | | |||
2458 | .Using an open block | 2454 | .Using an open block | ||
2459 | [quote] | 2455 | [quote] | ||
2460 | [[quote-block-id]] | 2456 | [[quote-block-id]] | ||
2461 | <beginfold id='2'>--</beginfold id='2'> | 2457 | <beginfold id='3'>--</beginfold id='3'> | ||
2462 | Inside the *open block quote*. | 2458 | Inside the *open block quote*. | ||
2463 | <endfold id='2'>--</endfold id='2'> | 2459 | <endfold id='3'>--</endfold id='3'> | ||
2464 | 2460 | | |||
2465 | .Nested block quote | 2461 | .Nested block quote | ||
2466 | [quote, outer attribution, outer citation title and information] | 2462 | [quote, outer attribution, outer citation title and information] | ||
2467 | [[quote-block-id]] | 2463 | [[quote-block-id]] | ||
2468 | <beginfold id='2'>____</beginfold id='2'> | 2464 | <beginfold id='3'>____</beginfold id='3'> | ||
2469 | First line of outer quote. | 2465 | First line of outer quote. | ||
2470 | [quote, inner attribution, inner citation title and information] | 2466 | [quote, inner attribution, inner citation title and information] | ||
2471 | [[quote-block-id]] | 2467 | [[quote-block-id]] | ||
2472 | <beginfold id='2'>______</beginfold id='2'> | 2468 | <beginfold id='3'>______</beginfold id='3'> | ||
2473 | Inside the inner quote. | 2469 | Inside the inner quote. | ||
2474 | <endfold id='2'>______</endfold id='2'> | 2470 | <endfold id='3'>______</endfold id='3'> | ||
2475 | Last line of outer quote. | 2471 | Last line of outer quote. | ||
2476 | <endfold id='2'>____</endfold id='2'> | 2472 | <endfold id='3'>____</endfold id='3'> | ||
2477 | 2473 | | |||
2478 | // Currently no specific highlighting supported. | 2474 | // Currently no specific highlighting supported. | ||
2479 | .Quoted paragraph | 2475 | .Quoted paragraph | ||
Context not available. | |||||
2484 | 2480 | | |||
2485 | .Air quote | 2481 | .Air quote | ||
2486 | [,attribution, citation title and information] | 2482 | [,attribution, citation title and information] | ||
2487 | <beginfold id='2'>"" </beginfold id='2'> | 2483 | <beginfold id='3'>"" </beginfold id='3'> | ||
2488 | Inside the *air quote*. | 2484 | Inside the *air quote*. | ||
2489 | 2485 | | |||
2490 | Supports empty lines. | 2486 | Supports empty lines. | ||
2491 | <endfold id='2'>""</endfold id='2'> | 2487 | <endfold id='3'>""</endfold id='3'> | ||
2492 | 2488 | | |||
2493 | // Currently no specific highlighting supported. | 2489 | // Currently no specific highlighting supported. | ||
2494 | .Markdown style | 2490 | .Markdown style | ||
Context not available. | |||||
2511 | > End of outer quote. | 2507 | > End of outer quote. | ||
2512 | 2508 | | |||
2513 | 2509 | | |||
2514 | == Verse | 2510 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Verse | ||
2515 | 2511 | | |||
2516 | .Contiguous block / paragraph | 2512 | .Contiguous block / paragraph | ||
2517 | [verse, attribution, citation title and information] | 2513 | [verse, attribution, citation title and information] | ||
Context not available. | |||||
2524 | .Delimited block with name | 2520 | .Delimited block with name | ||
2525 | [verse, attribution, citation title and information] | 2521 | [verse, attribution, citation title and information] | ||
2526 | [[verse-block-id]] | 2522 | [[verse-block-id]] | ||
2527 | <beginfold id='2'>____</beginfold id='2'> | 2523 | <beginfold id='3'>____</beginfold id='3'> | ||
2528 | Inside the *delimited block verse*. | 2524 | Inside the *delimited block verse*. | ||
2529 | 2525 | | |||
2530 | Supports empty lines. | 2526 | Supports empty lines. | ||
2531 | <endfold id='2'>____</endfold id='2'> | 2527 | <endfold id='3'>____</endfold id='3'> | ||
2532 | 2528 | | |||
2533 | .Delimited block without name | 2529 | .Delimited block without name | ||
2534 | This would be rendered as a quote block as the same delimiters are used. | 2530 | This would be rendered as a quote block as the same delimiters are used. | ||
Context not available. | |||||
2536 | .Using an open block | 2532 | .Using an open block | ||
2537 | [verse, attribution, citation title and information] | 2533 | [verse, attribution, citation title and information] | ||
2538 | [[verse-block-id]] | 2534 | [[verse-block-id]] | ||
2539 | <beginfold id='2'>--</beginfold id='2'> | 2535 | <beginfold id='3'>--</beginfold id='3'> | ||
2540 | Inside the *open block verse*. | 2536 | Inside the *open block verse*. | ||
2541 | <endfold id='2'>--</endfold id='2'> | 2537 | <endfold id='3'>--</endfold id='3'> | ||
2542 | 2538 | | |||
2543 | 2539 | | |||
2544 | = Replacement | 2540 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Replacement | ||
2545 | 2541 | | |||
2546 | TIP: See also the https://asciidoctor.org/docs/user-manual/#replacements[corresponding section] in the Asciidoctor manual. | 2542 | TIP: See also the https://asciidoctor.org/docs/user-manual/#replacements[corresponding section] in the Asciidoctor manual. | ||
2547 | 2543 | | |||
2548 | 2544 | | |||
2549 | == Textual symbol replacements | 2545 | <beginfold id='1'>== </beginfold id='1'>Textual symbol replacements | ||
2550 | 2546 | | |||
2551 | <beginfold id='2'>|===</beginfold id='2'> | 2547 | <beginfold id='3'>|===</beginfold id='3'> | ||
2552 | |Name |Syntax |Escaped | 2548 | |Name |Syntax |Escaped | ||
2553 | 2549 | | |||
2554 | |copyright |(C) |\(C) | 2550 | |copyright |(C) |\(C) | ||
Context not available. | |||||
2563 | |right single arrow |-> |\-> | 2559 | |right single arrow |-> |\-> | ||
2564 | |left double arrow |<= |\<= | 2560 | |left double arrow |<= |\<= | ||
2565 | |right double arrow |=> |\=> | 2561 | |right double arrow |=> |\=> | ||
2566 | <endfold id='2'>|===</endfold id='2'> | 2562 | <endfold id='3'>|===</endfold id='3'> | ||
2567 | 2563 | | |||
2568 | 2564 | | |||
2569 | === Not replaced | 2565 | <beginfold id='1'>=== </beginfold id='1'>Not replaced | ||
2570 | 2566 | | |||
2571 | // Single apostrophe must be surrounded by alphabetic characters. | 2567 | // Single apostrophe must be surrounded by alphabetic characters. | ||
2572 | * a' | 2568 | * a' | ||
Context not available. | |||||
2576 | * .'a | 2572 | * .'a | ||
2577 | 2573 | | |||
2578 | 2574 | | |||
2579 | == Numerical Character Reference | 2575 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Numerical Character Reference | ||
2580 | 2576 | | |||
2581 | === Decimal | 2577 | <beginfold id='1'>=== </beginfold id='1'>Decimal | ||
2582 | 2578 | | |||
2583 | § | 2579 | § | ||
2584 | 2580 | | |||
Context not available. | |||||
2587 | § | 2583 | § | ||
2588 | 2584 | | |||
2589 | 2585 | | |||
2590 | === Hexadecimal | 2586 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Hexadecimal | ||
2591 | 2587 | | |||
2592 | § | 2588 | § | ||
2593 | 2589 | | |||
Context not available. | |||||
2596 | § | 2592 | § | ||
2597 | 2593 | | |||
2598 | 2594 | | |||
2599 | === Escaped | 2595 | <endfold id='1'></endfold id='1'><beginfold id='1'>=== </beginfold id='1'>Escaped | ||
2600 | 2596 | | |||
2601 | \§ | 2597 | \§ | ||
2602 | \§ | 2598 | \§ | ||
Context not available. | |||||
2604 | \§ | 2600 | \§ | ||
2605 | 2601 | | |||
2606 | 2602 | | |||
2607 | == HTML/XML Character Entity References | 2603 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>HTML/XML Character Entity References | ||
2608 | 2604 | | |||
2609 | See e.g. https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references[Wikipedia]. | 2605 | See e.g. https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references[Wikipedia]. | ||
2610 | 2606 | | |||
Context not available. | |||||
2612 | There are just too many of them. | 2608 | There are just too many of them. | ||
2613 | 2609 | | |||
2614 | // some examples | 2610 | // some examples | ||
2615 | <beginfold id='2'>====</beginfold id='2'> | 2611 | <beginfold id='3'>====</beginfold id='3'> | ||
2616 | ≠ | 2612 | ≠ | ||
2617 | ≡ | 2613 | ≡ | ||
2618 | <endfold id='2'>====</endfold id='2'> | 2614 | <endfold id='3'>====</endfold id='3'> | ||
2619 | 2615 | | |||
2620 | 2616 | | |||
2621 | = Section L0 | 2617 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Section L0 | ||
2622 | 2618 | | |||
2623 | [abstract] | 2619 | [abstract] | ||
2624 | == Abstract | 2620 | <beginfold id='1'>== </beginfold id='1'>Abstract | ||
2625 | 2621 | | |||
2626 | This document is used for testing various aspects of syntax highlighting regarding sections. | 2622 | This document is used for testing various aspects of syntax highlighting regarding sections. | ||
2627 | 2623 | | |||
2628 | :title-attribute: with attribute | 2624 | :title-attribute: with attribute | ||
2629 | 2625 | | |||
2630 | == Section L1 | 2626 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Section L1 | ||
2631 | 2627 | | |||
2632 | === Section L2 | 2628 | <beginfold id='1'>=== </beginfold id='1'>Section L2 | ||
2633 | 2629 | | |||
2634 | ==== Section L3 | 2630 | <beginfold id='1'>==== </beginfold id='1'>Section L3 | ||
2635 | 2631 | | |||
2636 | ===== Section L4 | 2632 | <beginfold id='1'>===== </beginfold id='1'>Section L4 | ||
2637 | 2633 | | |||
2638 | ====== Section L5 | 2634 | <beginfold id='1'>====== </beginfold id='1'>Section L5 | ||
2639 | 2635 | | |||
2640 | ======= This is not a new section | 2636 | ======= This is not a new section | ||
2641 | 2637 | | |||
Context not available. | |||||
2643 | Only sections up to level 5 (having 6 leading `=`) are supported. | 2639 | Only sections up to level 5 (having 6 leading `=`) are supported. | ||
2644 | 2640 | | |||
2645 | 2641 | | |||
2646 | #### Section L3 | 2642 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>#### </beginfold id='1'>Section L3 | ||
2647 | 2643 | | |||
2648 | Using Markdown section syntax works too. | 2644 | Using Markdown section syntax works too. | ||
2649 | 2645 | | |||
Context not available. | |||||
2651 | Use either `=` or `#`, but not mixed. | 2647 | Use either `=` or `#`, but not mixed. | ||
2652 | 2648 | | |||
2653 | 2649 | | |||
2654 | ===== [[id-1]] [[id-2]] Section L4 | 2650 | <beginfold id='1'>===== </beginfold id='1'>[[id-1]] [[id-2]] Section L4 | ||
2655 | 2651 | | |||
2656 | This section has leading additional achors. | 2652 | This section has leading additional achors. | ||
2657 | 2653 | | |||
2658 | 2654 | | |||
2659 | ==== Section L3 [[id-1]][[id-2]] | 2655 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>==== </beginfold id='1'>Section L3 [[id-1]][[id-2]] | ||
2660 | 2656 | | |||
2661 | This section has trailing additional anchors. | 2657 | This section has trailing additional anchors. | ||
2662 | 2658 | | |||
2663 | 2659 | | |||
2664 | ==== [[id-1]][[id-2]]Section L3[[id-3]][[id-4]] | 2660 | <endfold id='1'></endfold id='1'><beginfold id='1'>==== </beginfold id='1'>[[id-1]][[id-2]]Section L3[[id-3]][[id-4]] | ||
2665 | 2661 | | |||
2666 | This section has both leading and trailing additional anchors. | 2662 | This section has both leading and trailing additional anchors. | ||
2667 | 2663 | | |||
2668 | 2664 | | |||
2669 | ==== Section L3 {title-attribute} in Title | 2665 | <endfold id='1'></endfold id='1'><beginfold id='1'>==== </beginfold id='1'>Section L3 {title-attribute} in Title | ||
2670 | 2666 | | |||
2671 | .Title {title-attribute} | 2667 | .Title {title-attribute} | ||
2672 | This section has an attribute in its title. | 2668 | This section has an attribute in its title. | ||
2673 | 2669 | | |||
2674 | 2670 | | |||
2675 | [discrete] | 2671 | [discrete] | ||
2676 | == Discrete Section | 2672 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Discrete Section | ||
2677 | 2673 | | |||
2678 | This section will not be shown in the table of contents. | 2674 | This section will not be shown in the table of contents. | ||
2679 | 2675 | | |||
2680 | <beginfold id='1'>////</beginfold id='1'> | 2676 | <beginfold id='2'>////</beginfold id='2'> | ||
2681 | == Section with _emphasized_ text | 2677 | == Section with _emphasized_ text | ||
2682 | 2678 | | |||
2683 | === Section with escaped \_emphasized_ text | 2679 | === Section with escaped \_emphasized_ text | ||
2684 | <endfold id='1'>////</endfold id='1'> | 2680 | <endfold id='2'>////</endfold id='2'> | ||
2685 | 2681 | | |||
2686 | 2682 | | |||
2687 | == Section with #marked# text | 2683 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Section with #marked# text | ||
2688 | 2684 | | |||
2689 | === Section with escaped \#marked# text | 2685 | <beginfold id='1'>=== </beginfold id='1'>Section with escaped \#marked# text | ||
2690 | 2686 | | |||
2691 | 2687 | | |||
2692 | == Section with `monospaced` text | 2688 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Section with `monospaced` text | ||
2693 | 2689 | | |||
2694 | === Section with escaped \`monospaced` text | 2690 | <beginfold id='1'>=== </beginfold id='1'>Section with escaped \`monospaced` text | ||
2695 | 2691 | | |||
2696 | <beginfold id='1'>////</beginfold id='1'> | 2692 | <beginfold id='2'>////</beginfold id='2'> | ||
2697 | == Section with *strong* text | 2693 | == Section with *strong* text | ||
2698 | 2694 | | |||
2699 | === Section with escaped \*strong* text | 2695 | === Section with escaped \*strong* text | ||
2700 | <endfold id='1'>////</endfold id='1'> | 2696 | <endfold id='2'>////</endfold id='2'> | ||
2697 | | ||||
2701 | 2698 | | |||
2699 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Another Section at Level 0 | ||||
2702 | 2700 | | |||
2703 | = Another Section at Level 0 | 2701 | Some text in the second level 0 section. | ||
2702 | | ||||
2703 | <beginfold id='1'>== </beginfold id='1'>Section 2.1 | ||||
2704 | | ||||
2705 | Some text. | ||||
2704 | 2706 | | |||
2705 | 2707 | | |||
2706 | = Table | 2708 | <endfold id='1'></endfold id='1'><endfold id='1'></endfold id='1'><beginfold id='1'></beginfold id='1'>= Table | ||
2707 | 2709 | | |||
2708 | == Default Separator | 2710 | <beginfold id='1'>== </beginfold id='1'>Default Separator | ||
2709 | 2711 | | |||
2710 | .PSV | 2712 | .PSV | ||
2711 | // some comment | 2713 | // some comment | ||
Context not available. | |||||
2713 | [.some-role] | 2715 | [.some-role] | ||
2714 | [#table-shorthand] | 2716 | [#table-shorthand] | ||
2715 | // some comment | 2717 | // some comment | ||
2716 | <beginfold id='2'>|===</beginfold id='2'> | 2718 | <beginfold id='3'>|===</beginfold id='3'> | ||
2717 | // some comment | 2719 | // some comment | ||
2718 | | header col 1 | header col 2 | header col 3 | 2720 | | header col 1 | header col 2 | header col 3 | ||
2719 | // some comment | 2721 | // some comment | ||
Context not available. | |||||
2748 | e|row 10 col 1 is emphasized (italic) | 2750 | e|row 10 col 1 is emphasized (italic) | ||
2749 | s|row 10 col 2 is strong (bold) | 2751 | s|row 10 col 2 is strong (bold) | ||
2750 | m|row 10 col 3 is monospaced | 2752 | m|row 10 col 3 is monospaced | ||
2751 | <endfold id='2'>|===</endfold id='2'> | 2753 | <endfold id='3'>|===</endfold id='3'> | ||
2752 | 2754 | | |||
2753 | 2755 | | |||
2754 | == Custom Separator | 2756 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Custom Separator | ||
2755 | 2757 | | |||
2756 | IMPORTANT: Highlighting of tables with custom separator is not supported. | 2758 | IMPORTANT: Highlighting of tables with custom separator is not supported. | ||
2757 | All `|` inside the table will be falsly highlighted. | 2759 | All `|` inside the table will be falsly highlighted. | ||
2758 | 2760 | | |||
2759 | [separator=!] | 2761 | [separator=!] | ||
2760 | <beginfold id='2'>|===</beginfold id='2'> | 2762 | <beginfold id='3'>|===</beginfold id='3'> | ||
2761 | // the `|` in the line below should not be highlighted. | 2763 | // the `|` in the line below should not be highlighted. | ||
2762 | !row 1 | col 1 !row 1 col 2 | 2764 | !row 1 | col 1 !row 1 col 2 | ||
2763 | s!row 2 col 1 !row 2 col 2 | 2765 | s!row 2 col 1 !row 2 col 2 | ||
2764 | <endfold id='2'>|===</endfold id='2'> | 2766 | <endfold id='3'>|===</endfold id='3'> | ||
2765 | 2767 | | |||
2766 | [separator=a] | 2768 | [separator=a] | ||
2767 | <beginfold id='2'>|===</beginfold id='2'> | 2769 | <beginfold id='3'>|===</beginfold id='3'> | ||
2768 | arow 1 col 1 arow 1 col 2 | 2770 | arow 1 col 1 arow 1 col 2 | ||
2769 | sarow 2 col 1 arow 2 col 2 | 2771 | sarow 2 col 1 arow 2 col 2 | ||
2770 | <endfold id='2'>|===</endfold id='2'> | 2772 | <endfold id='3'>|===</endfold id='3'> | ||
2771 | 2773 | | |||
2772 | 2774 | | |||
2773 | == Delimiter-Separated Values | 2775 | <endfold id='1'></endfold id='1'><beginfold id='1'>== </beginfold id='1'>Delimiter-Separated Values | ||
2774 | 2776 | | |||
2775 | IMPORTANT: Highlighting for tables with delimiter-separated values is not supported. | 2777 | IMPORTANT: Highlighting for tables with delimiter-separated values is not supported. | ||
2776 | All `|` inside the table will be falsly highlighted. | 2778 | All `|` inside the table will be falsly highlighted. | ||
2777 | 2779 | | |||
2778 | [format=csv] | 2780 | [format=csv] | ||
2779 | <beginfold id='2'>|===</beginfold id='2'> | 2781 | <beginfold id='3'>|===</beginfold id='3'> | ||
2780 | Col 1 ,Col 2 ,Col 3 | 2782 | Col 1 ,Col 2 ,Col 3 | ||
2781 | 2783 | | |||
2782 | // the `|` in the line below should not be highlighted. | 2784 | // the `|` in the line below should not be highlighted. | ||
Context not available. | |||||
2784 | row 2 col 2,row 2 col 2,row 2 col 3 | 2786 | row 2 col 2,row 2 col 2,row 2 col 3 | ||
2785 | 2787 | | |||
2786 | row 3 col 3 , "row ""3"", col 2" , row 3 col 3 | 2788 | row 3 col 3 , "row ""3"", col 2" , row 3 col 3 | ||
2787 | <endfold id='2'>|===</endfold id='2'> | 2789 | <endfold id='3'>|===</endfold id='3'> | ||
2788 | 2790 | | |||
2789 | 2791 | | |||
2790 | === Shorthand Notation for Data Tables | 2792 | <beginfold id='1'>=== </beginfold id='1'>Shorthand Notation for Data Tables | ||
2791 | 2793 | | |||
2792 | .CSV | 2794 | .CSV | ||
2793 | ,=== | 2795 | ,=== | ||
Context not available. |