Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Sign in
Toggle navigation
Menu
Open sidebar
Sarah White
AsciiDoc Language
Commits
ac671de0
Commit
ac671de0
authored
Feb 21, 2021
by
Dan Allen
Browse files
clarify that including by tag includes all regions marked with that same tag
parent
7ea52867
Changes
2
Hide whitespace changes
Inline
Side-by-side
docs/CHANGELOG.adoc
View file @
ac671de0
...
...
@@ -19,6 +19,7 @@ Added::
Changed::
* Moved content into docs folder (#55)
* Clarify the rules for include tag filtering; emphasize that the wildcards can only be used once
* Clarify that including by tag includes all regions marked with that same tag.
* Standardize on the "link text" term instead of "linked text" (#50)
== Published Q4 2020
...
...
docs/modules/directives/pages/include-tagged-regions.adoc
View file @
ac671de0
...
...
@@ -14,6 +14,9 @@ You can eliminate this requirement by using the semi-colon as the data separator
Tags are useful when you want to identify specific regions of a file to include.
You can then select the lines between the boundaries of the include tag/end directives to include using the `tags` attribute.
Including by tag includes all regions marked with that tag.
This makes it possible to include a group of lines from different regions of the document using a single tag.
TIP: If the target file has tagged lines, and you just want to ignore those lines, use the `tags` attribute to filter them out.
See <<tag-filtering>> for details.
...
...
@@ -25,7 +28,7 @@ The example below shows how you tag a region of content inside a file containing
include::example$include.adoc[tag=tag-co]
----
<.> To indicate the start of a tagged region, insert a comment line in the code.
<.> Assign a
unique
name to the `tag` directive. In this example the tag is
call
ed _timings_.
<.> Assign a name to the `tag` directive. In this example
,
the tag is
nam
ed _timings_.
<.> Insert another comment line where you want the tagged region to end.
<.> Assign the name of the region you want to terminate to the `end` directive.
<.> This is the start of a tagged snippet named _parse_.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment