BEWSoftware MDj CLI
Named Meta Blocks
A named meta block is a block of fenced text, that can be located anywhere within a document, that is used during the substitution phase. It would be cut from the document and then inserted where designated by its name.
A named meta block begins with a fence of three at signs followed by a bracketed
option containing a name that is unique within the page
context: @@@[myTOC]
,
and ends with a fence of three more at signs: @@@
. In both cases, they must be
at the beginning of an otherwise empty line.
Unlike Meta Blocks, Named Meta Blocks don't contain key/value pairs. All the
text between the two fence lines is substituted where ever its name is used:
${page.myTOC}
.
This is a copy of the text near the top of the source file for this page:
---
${page.myTOC}
---
## Named Meta Blocks
The following would produce the TOC at the top of the page:
@@@[myTOC]
### Table of Contents
- My First Heading
- Number Two Heading
- And Another One
@@@
@@@[myTOC]
Table of Contents
- My First Heading
- Number Two Heading
- And Another One
@@@
Note: The naming of this Named Meta Block was arbitrarily set to: myTOC
.
It could have been any valid text e.g.: Junk_Mail
. Valid characters are the set:
[a-zA-Z_0-9]
.
Further, the substitution could just as easily have been made into the template used for this page.