asciidoc-parser 0.16.0

Parser for AsciiDoc format
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

use crate::tests::prelude::*;

track_file!("docs/modules/sections/pages/abstract.adoc");

// Treating the entire file as non-normative because we don't support `doctype`.

non_normative!(
    r#"
= Abstract (Section)

An abstract is a concise overview of an article.
The abstract section style can be used in the `article` document type.

== Abstract section syntax

The `abstract` section style must be set on the first section of the article, as seen in the example below:

[source]
----
include::example$abstract.adoc[]
----

If you want to style a paragraph or an open block as an abstract, instead of a whole section, see the xref:abstract-block.adoc[abstract block style] documentation.

////
There's some sort of funkiness with book and abstract so we're putting this section on hold.

== Book abstract syntax

When the document type is book, the `abstract` section style must be placed on the first section _inside_ the chapter section.
The section must be one section level below the chapter, that is, the chapter is marked up as level 1 (`==`) so its abstract must be marked up as level 2 (`===`).
An abstract may not be used _before_ a part or chapter in a book.

[source]
----
= Book Title
:doctype: book

== Chapter Title

[abstract]
=== Summary

Documentation is a distillation of many long adventures.

=== Section
----
////
"#
);