asciidoc-parser 0.19.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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use crate::{document::InterpretedValue, tests::prelude::*};

track_file!("ref/asciidoc-lang/docs/modules/attributes/pages/boolean-attributes.adoc");

non_normative!(
    r#"
= Set Boolean Attributes
// [#boolean-attribute]

A boolean attribute is a built-in attribute that acts like a toggle.
Its sole function is to turn on a feature or behavior.

"#
);

#[test]
fn boolean_syntax() {
    verifies!(
        r#"
== Boolean attribute entry syntax

A boolean attribute is set using an attribute entry in the header or body of a document.
The value of a boolean value is always empty because boolean attributes in AsciiDoc only accept an _empty string_ value.
In AsciiDoc, an attribute that is set, but has an empty value, is interpreted as the _true_ state and an attribute which is not set is interpreted as the _false_ state.
However, a processor may interpret a value of `true` as the true state as well.

[source]
----
:name-of-a-boolean-attribute: <.>
----
<.> On a new line, type a colon (`:`), directly followed by the attribute's name and then another colon (`:`).
After the closing colon, press kbd:[Enter].
The attribute is now set and its behavior will be applied to the document.

"#
    );

    let mut parser = Parser::default();
    parser.parse(":name-of-a-boolean-attribute:");

    assert_eq!(
        parser.attribute_value("name-of-a-boolean-attribute"),
        InterpretedValue::Set
    );
}

#[test]
fn declare_boolean_attribute() {
    verifies!(
        r#"
== Declare a boolean attribute

Let's use an attribute entry to turn on the built-in boolean attribute named `sectanchors`.
When `sectanchors` is set, it xref:sections:title-links.adoc#anchor[activates an anchor in front of a section title] when a cursor hovers over it.

[source]
----
= Document Title
:sectanchors: <.>
----
<.> The value of `sectanchors` is always left empty because it's a boolean attribute.
"#
    );

    let mut parser = Parser::default();
    parser.parse("= Document Title\n:sectanchors:");

    assert_eq!(parser.attribute_value("sectanchors"), InterpretedValue::Set);
}