72 lines
2 KiB
Text
72 lines
2 KiB
Text
@import template.nml
|
|
@nav.previous = Getting Started
|
|
%<make_doc({}, "Sections", "Sections")>%
|
|
|
|
#{first} Sections
|
|
|
|
To add a section to your document, put one or more ``Plain Text, #`` at the start of the line, followed a space and the name of your section.
|
|
|
|
|
|
Which will render as:
|
|
|
|
#+LAYOUT_BEGIN Split
|
|
:: Make sure they don't pollute the ToC
|
|
#+ Section name
|
|
##+ Subsection
|
|
##*+ Unnumbered section
|
|
##+ Unnumbered section
|
|
#+ This section is not in the ToC
|
|
|
|
#+LAYOUT_NEXT
|
|
|
|
Given by the following:
|
|
``
|
|
# Section name
|
|
## Subsection
|
|
#* Unnumbered section
|
|
#+ This section is not in the ToC
|
|
``
|
|
#+LAYOUT_END
|
|
|
|
# Sections references
|
|
|
|
You can create a referenceable section by using ``Plain Text, #{refname}``, where `refname` is an internal reference name for use only within this document.
|
|
You can then create a clickable reference to this section: ``§{refname}`` or ``§{refname}[caption=Click me!]``. Below is an example of this in action:
|
|
|
|
###{refname}+* Section
|
|
§{refname}[caption=Click me!] or §{first}[caption=First section]
|
|
|
|
``
|
|
###{refname}+* Section
|
|
§{refname}[caption=Click me!] or §{first}[caption=First section]
|
|
``
|
|
|
|
# Table of Content
|
|
|
|
Section can be automatically exported to a table of content, such as shown at the top of this document.
|
|
To create a table of content, simply add ``#+TABLE_OF_CONTENT`` somewhere in your document and it will be displayed there.
|
|
|
|
# Section styling
|
|
|
|
The styling for the section link is controlled by the style key ``style.section``
|
|
|
|
* ``link_pos``: `Before|After|None` Position of the section link.
|
|
* ``link``: `[Before, Link, After]` 3 strings-array
|
|
|
|
```JSON, Default Style
|
|
{
|
|
"link_pos": "Before",
|
|
"link": ["", "🔗", " "]
|
|
}
|
|
```
|
|
|
|
# Bindings
|
|
|
|
* ``Lua, nml.section.push(title, depth, [, kind [, reference]])``
|
|
** ``title`` *(string)* the section display title
|
|
** ``depth`` *(number)* the section depth
|
|
** ``kind`` *(string)* the section kind
|
|
**- `\*` for unnumbered
|
|
**- `+` for outside of the table of content
|
|
**- `\*+` or `+\*` for both
|
|
** ``reference`` *(string)* the section reference name
|