forked from varia/varia.website
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
mb@mb
04c2824180
|
7 years ago | |
---|---|---|
.. | ||
Readme.md | 7 years ago | |
__init__.py | 7 years ago | |
section_number.py | 7 years ago |
Readme.md
Section Number
This plugin adds section numbers to an article's context, in the form of X.X.X
. Sections are indicated via Markdown headers, which appear as <h1> – <h6>
in the generated HTML.
Settings
By default, up to three section levels will be prefixed with numbers. You can customize this value by defining SECTION_NUMBER_MAX
in your settings file:
SECTION_NUMBER_MAX = 5
Caveat
The first section in the article will be marked as the top section level. Namely, if <h3>
is the first section encountered, the plugin assumes that no <h1>
or <h2>
sections will be present. Otherwise an exception may result.
Example
The following Markdown content...
# section
blabla
## subsection
blabla
## subsection
blabla
# section
blabla
... will be rendered as:
#1 section blabla ##1.1 subsection blabla ##1.2 subsection blabla #2 section blabla