Installation
============
[](https://github.com/chdemko/pandoc-latex-admonition/actions/workflows/python-package.yml)
[](https://github.com/pypa/hatch)
[](https://github.com/pre-commit/pre-commit)
[](https://pypi.org/project/black/)
[](https://coveralls.io/github/chdemko/pandoc-latex-admonition?branch=develop)
[](https://scrutinizer-ci.com/g/chdemko/pandoc-latex-admonition/)
[](https://codeclimate.com/github/chdemko/pandoc-latex-admonition/)
[](https://www.codefactor.io/repository/github/chdemko/pandoc-latex-admonition)
[](https://app.codacy.com/gh/chdemko/pandoc-latex-admonition/dashboard)
[](https://pypi.org/project/pandoc-latex-admonition/)
[](https://pypi.org/project/pandoc-latex-admonition/)
[](https://raw.githubusercontent.com/chdemko/pandoc-latex-admonition/develop/LICENSE)
[](https://pepy.tech/project/pandoc-latex-admonition)
[](https://pypi.org/project/pandoc-latex-admonition/)
[](https://pypi.org/project/pandoc-latex-admonition/)
[](https://pandoc.org/)
[](https://github.com/chdemko/pandoc-latex-admonition/releases)
[](https://github.com/chdemko/pandoc-latex-admonition/commit/develop/)
[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)
[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)
[](https://libraries.io/pypi/pandoc-latex-admonition)
[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)
*pandoc-latex-admonition* is a [pandoc] filter for adding admonition
to `div`s or `codeblock`s elements.
It uses the *tcolorbox* LaTeX package to generate admonitions and
the *footnote* LaTeX package to handle correctly footnotes in
admonition.
[pandoc]: http://pandoc.org/
Instructions
------------
*pandoc-latex-admonition* requires [python], a programming language that
comes pre-installed on linux and Mac OS X, and which is easily installed
[on Windows].
Install *pandoc-latex-admonition* using the bash command
~~~shell-session
$ pipx install pandoc-latex-admonition
~~~
To upgrade to the most recent release, use
~~~shell-session
$ pipx upgrade pandoc-latex-admonition
~~~
`pipx` is a script to install and run python applications in isolated environments from the Python Package Index, [PyPI]. It can be installed using instructions given [here](https://pipx.pypa.io/stable/).
Make sure you have the
* *tcolorbox*
* *footnote*
* *xcolor*
* *ifthen*
LaTeX packages. On linux you have to install some extra libraries **before**
*pandoc-latex-admonition*. On a Debian-based system (including Ubuntu),
you can install it as root using
~~~shell-session
$ sudo apt-get install texlive-latex-extra
~~~
[python]: https://www.python.org
[on Windows]: https://www.python.org/downloads/windows
[PyPI]: https://pypi.org
Getting Help
------------
If you have any difficulties with pandoc-latex-admonition, please feel
welcome to [file an issue] on github so that we can help.
[file an issue]: https://github.com/chdemko/pandoc-latex-admonition/issues
Contribute
==========
Instructions
------------
Install `hatch`, then run
~~~shell-session
$ hatch run pip install pre-commit
$ hatch run pre-commit install
~~~
to install `pre-commit` before working on your changes.
Tests
-----
When your changes are ready, run
~~~shell-session
$ hatch test
$ hatch fmt --check
$ hatch run lint:check
$ hatch run docs:build
$ hatch build -t wheel
~~~
for running the tests, checking the style, building the documentation
and building the wheel.
Raw data
{
"_id": null,
"home_page": null,
"name": "pandoc-latex-admonition",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.10",
"maintainer_email": "Christophe Demko <chdemko@gmail.com>",
"keywords": "admonition, filters, latex, pandoc",
"author": null,
"author_email": "Christophe Demko <chdemko@gmail.com>",
"download_url": null,
"platform": null,
"description": "Installation\n============\n\n[](https://github.com/chdemko/pandoc-latex-admonition/actions/workflows/python-package.yml)\n[](https://github.com/pypa/hatch)\n[](https://github.com/pre-commit/pre-commit)\n[](https://pypi.org/project/black/)\n[](https://coveralls.io/github/chdemko/pandoc-latex-admonition?branch=develop)\n[](https://scrutinizer-ci.com/g/chdemko/pandoc-latex-admonition/)\n[](https://codeclimate.com/github/chdemko/pandoc-latex-admonition/)\n[](https://www.codefactor.io/repository/github/chdemko/pandoc-latex-admonition)\n[](https://app.codacy.com/gh/chdemko/pandoc-latex-admonition/dashboard)\n[](https://pypi.org/project/pandoc-latex-admonition/)\n[](https://pypi.org/project/pandoc-latex-admonition/)\n[](https://raw.githubusercontent.com/chdemko/pandoc-latex-admonition/develop/LICENSE)\n[](https://pepy.tech/project/pandoc-latex-admonition)\n[](https://pypi.org/project/pandoc-latex-admonition/)\n[](https://pypi.org/project/pandoc-latex-admonition/)\n[](https://pandoc.org/)\n[](https://github.com/chdemko/pandoc-latex-admonition/releases)\n[](https://github.com/chdemko/pandoc-latex-admonition/commit/develop/)\n[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)\n[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)\n[](https://libraries.io/pypi/pandoc-latex-admonition)\n[](http://pandoc-latex-admonition.readthedocs.io/en/latest/)\n\n*pandoc-latex-admonition* is a [pandoc] filter for adding admonition\nto `div`s or `codeblock`s elements.\n\nIt uses the *tcolorbox* LaTeX package to generate admonitions and\nthe *footnote* LaTeX package to handle correctly footnotes in\nadmonition.\n\n[pandoc]: http://pandoc.org/\n\nInstructions\n------------\n\n*pandoc-latex-admonition* requires [python], a programming language that\ncomes pre-installed on linux and Mac OS X, and which is easily installed\n[on Windows].\n\nInstall *pandoc-latex-admonition* using the bash command\n\n~~~shell-session\n$ pipx install pandoc-latex-admonition\n~~~\n\nTo upgrade to the most recent release, use\n\n~~~shell-session\n$ pipx upgrade pandoc-latex-admonition\n~~~\n\n`pipx` is a script to install and run python applications in isolated environments from the Python Package Index, [PyPI]. It can be installed using instructions given [here](https://pipx.pypa.io/stable/).\n\nMake sure you have the\n\n* *tcolorbox*\n* *footnote*\n* *xcolor*\n* *ifthen*\n\nLaTeX packages. On linux you have to install some extra libraries **before**\n*pandoc-latex-admonition*. On a Debian-based system (including Ubuntu),\nyou can install it as root using\n\n~~~shell-session\n$ sudo apt-get install texlive-latex-extra\n~~~\n\n[python]: https://www.python.org\n[on Windows]: https://www.python.org/downloads/windows\n[PyPI]: https://pypi.org\n\n\nGetting Help\n------------\n\nIf you have any difficulties with pandoc-latex-admonition, please feel\nwelcome to [file an issue] on github so that we can help.\n\n[file an issue]: https://github.com/chdemko/pandoc-latex-admonition/issues\n\nContribute\n==========\n\nInstructions\n------------\n\nInstall `hatch`, then run\n\n~~~shell-session\n$ hatch run pip install pre-commit\n$ hatch run pre-commit install\n~~~\n\nto install `pre-commit` before working on your changes.\n\nTests\n-----\n\nWhen your changes are ready, run\n\n~~~shell-session\n$ hatch test\n$ hatch fmt --check\n$ hatch run lint:check\n$ hatch run docs:build\n$ hatch build -t wheel\n~~~\n\nfor running the tests, checking the style, building the documentation\nand building the wheel.\n\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "A pandoc filter for adding admonition in LaTeX",
"version": "1.3.4.3",
"project_urls": {
"Documentation": "https://pandoc-latex-admonition.readthedocs.io/",
"Homepage": "https://github.com/chdemko/pandoc-latex-admonition",
"Issues": "https://github.com/chdemko/pandoc-latex-admonition/issues",
"Repository": "https://github.com/chdemko/pandoc-latex-admonition"
},
"split_keywords": [
"admonition",
" filters",
" latex",
" pandoc"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "51042fcd9bac0e61ee14d1f61763764a45825feda2f9cccd5e81f4fd7912900c",
"md5": "c42c0cdc8eb86e91422b9f799295f6f3",
"sha256": "26b886636851f9c960912b6c10def2495ee964d23d81b41200919ff3c69306f7"
},
"downloads": -1,
"filename": "pandoc_latex_admonition-1.3.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c42c0cdc8eb86e91422b9f799295f6f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.10",
"size": 9334,
"upload_time": "2024-10-22T09:39:18",
"upload_time_iso_8601": "2024-10-22T09:39:18.509677Z",
"url": "https://files.pythonhosted.org/packages/51/04/2fcd9bac0e61ee14d1f61763764a45825feda2f9cccd5e81f4fd7912900c/pandoc_latex_admonition-1.3.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-22 09:39:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "chdemko",
"github_project": "pandoc-latex-admonition",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pandoc-latex-admonition"
}
JSON
