Skip to content

Commit fa8cc74

Browse files
authored
👌 IMPROVE: setup file, version and README (#9)
* updated README and version * added badges
1 parent 1c3a9be commit fa8cc74

File tree

3 files changed

+34
-4
lines changed

3 files changed

+34
-4
lines changed

README.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,33 @@
1-
# sphinx-multitoc-numbering
1+
# sphinx-parttoc-numbering
22

3-
A Sphinx extension to support continuous numbering of sections across multiple tocs in HTML output.
3+
[![Github-CI][github-ci]][github-link]
4+
[![Coverage Status][codecov-badge]][codecov-link]
5+
6+
**A Sphinx extension to support continuous numbering of sections across multiple tocs in HTML output**.
7+
8+
This package contains a [Sphinx](http://www.sphinx-doc.org/en/master/) extension to continuously number sections across multiple toctrees present in the same document. Also quite useful in [jupyter-book](https://jupyterbook.org/) projects for continuous numbering of chapters across different parts.
9+
10+
## Get started
11+
12+
To get started with `sphinx-multitoc-numbering`, first install it through `pip`:
13+
14+
```
15+
pip install sphinx-multitoc-numbering
16+
```
17+
18+
then, add `sphinx_multitoc_numbering` to your sphinx `extensions` in the `conf.py`
19+
20+
```python
21+
...
22+
extensions = ["sphinx_multitoc_numbering"]
23+
...
24+
```
25+
26+
## Contributing
27+
28+
We welcome all contributions! See the [EBP Contributing Guide](https://executablebooks.org/en/latest/contributing.html) for general details.
29+
30+
[github-ci]: https://github.com/executablebooks/sphinx-multitoc-numbering/workflows/continuous-integration/badge.svg?branch=master
31+
[github-link]: https://github.com/executablebooks/sphinx-multitoc-numbering
32+
[codecov-badge]: https://codecov.io/gh/executablebooks/sphinx-multitoc-numbering/branch/master/graph/badge.svg
33+
[codecov-link]: https://codecov.io/gh/executablebooks/sphinx-multitoc-numbering

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
long_description_content_type="text/markdown",
1616
packages=find_packages(),
1717
license="MIT",
18-
install_requires=["sphinx"],
18+
install_requires=["sphinx>=3"],
1919
extras_require={
2020
"code_style": ["flake8<3.8.0,>=3.7.0", "black", "pre-commit==1.17.0"],
2121
"testing": [

sphinx_multitoc_numbering/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818

1919
logger = logging.getLogger(__name__)
2020

21-
__version__ = "0.0.1"
21+
__version__ = "0.1.0"
2222
"""sphinx-multitoc-numbering version"""
2323

2424

0 commit comments

Comments
 (0)