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

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

track_file!("ref/asciidoc-lang/docs/modules/document/pages/version-label.adoc");

// Treating the entire file as non-normative because asciidoc-parser doesn't
// _consume_ the revision attribute entries anywhere. There's nothing special
// about this syntax that we need to verify.
non_normative!(
    r#"
= Version Label Attribute

The `version-label` attribute controls the version label displayed before the revision number in the byline.

[#set]
== Change the version label in the byline

By default, `version-label` is assigned the value `Version`.
This label can be changed by setting `version-label` and assigning it a new value in the document header.

.Assign a new label to version-label
[source#ex-label]
----
include::example$version-label.adoc[tag=set]
----

The result of <<ex-label>> is displayed below.

image::set-version-label.png["Byline with custom version label",role=screenshot]

Notice that when `revnumber` is implicitly set using the revision line, any preceding letters are still removed even though `version-label` is explicitly assigned a value.

[#unset]
== Unset the version label

You can remove the default version label from the byline by unsetting the `version-label` attribute.
In an attribute entry, add a bang (`!`) to the attribute's name.

.Unset version-label
[source#ex-unset-label]
----
include::example$version-label.adoc[tag=unset]
----

The result of <<ex-unset-label>> is displayed below.

image::unset-version-label.png["Byline without a version label",role=screenshot]
"#
);