Contributing
Woohoo thanks! 🎉
Create issues
Please use the issue tracker.
Developing
About dependencies
You may notice that there are two files where dependencies are defined:
pyproject.toml
: used to publish themkdocs-tooltips
module, which depends on themkdocs
module;requirements.txt
: used to build themkdocs-tooltips
documentation website, which also depends onmkdocs-material
andmkdocs-tooltips
.
Generating a documentation that uses mkdocs-tooltips
is not only good for demonstration purpose, it's also useful test the local version when developing.
Install MkDocs Tooltips for development
git clone https://framagit.org/roipoussiere/mkdocs-tooltips.git
cd mkdocs-tooltips
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
You can re-build the local module and the local documentation each time you add modifications:
pip install . && mkdocs serve