https://github.com/daamien/pandoc-latex-levelup
A pandoc filter to shift the level of all headers in a latex/pdf output
https://github.com/daamien/pandoc-latex-levelup
Last synced: 3 months ago
JSON representation
A pandoc filter to shift the level of all headers in a latex/pdf output
- Host: GitHub
- URL: https://github.com/daamien/pandoc-latex-levelup
- Owner: daamien
- License: bsd-3-clause
- Created: 2017-08-21T19:33:22.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-22T08:08:46.000Z (almost 8 years ago)
- Last Synced: 2025-01-11T18:49:53.189Z (5 months ago)
- Language: Python
- Size: 124 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
pandoc-latex-levelup
===============================================================================
[](https://travis-ci.org/daamien/pandoc-latex-levelup)
[](https://hub.docker.com/r/daamien/pandoc-latex-levelup/)
A pandoc filter to shift the level of all headers in a latex/pdf output
The filter is written in Python with
[panflute](http://scorreia.com/software/panflute/)
which I recommend if you want to create your own pandoc filters.
Install
-------------------------------------------------------------------------------
```
sudo pip install pandoc-latex-levelup
```
or
```
docker run -d daamien/pandoc-latex-levelup
```
Quick Start
-------------------------------------------------------------------------------
```
pandoc --filter pandoc-latex-levelup ./pandoc_latex_levelup.sample.md \
--toc -N -o ./pandoc_latex_levelup.sample.pdf
```
Configuration
-------------------------------------------------------------------------------
The filter is designed to work without any parameter, but you can use the two
options below:
```yaml
levelup: {
enable: True,
unnumbered_h1: False,
}
```
* ``enable`` is a killswitch. Set it to False and the filter will be disabled.
This is useful when you use the filter in a script and you want ot toggle it
off for certain md files (default: True)
* ``unnumbered_h1`` remove numbering from level1 headers (default: True)
Example
-------------------------------------------------------------------------------
See [pandoc-latex-levelup.sample.md](pandoc-latex-levelup.sample.md)
and [pandoc-latex-levelup.sample.pdf](pandoc-latex-levelup.sample.pdf)
Contributing & Getting Help
-------------------------------------------------------------------------------
If you have any difficulties with this software, please file an issue here :
https://github.com/daamien/pandoc-latex-levelup/issues
License
-------------------------------------------------------------------------------
This software is available under the BSD 3-Clause Licence.
see [LICENSE](LICENSE)