Turn documentation websites into beautiful books.
Convert documentation websites into clean, offline-friendly Markdown, HTML, and PDF books with a single command.
✨ Features
| Feature | Status |
|---|---|
| Crawl documentation websites | ✅ |
| Merge multiple pages into one book | ✅ |
| Export Markdown | ✅ |
| Export standalone HTML | ✅ |
| Export print-ready PDF | ✅ |
| Interactive HTML Viewer | ✅ |
| Automatic Table of Contents | ✅ |
| Syntax Highlighting | ✅ |
| Offline KaTeX Rendering | ✅ |
| Mermaid Diagrams | ✅ |
| Smart Table Formatting | ✅ |
| Automatic Image Download | ✅ |
📦 Installation
pip install docbuildr
Install Chromium (required for PDF generation):
playwright install chromium
🚀 Quick Start
docbuildr https://gthlab.au/panaroo
Output:
output/
├── book.md
├── book.html
├── viewer.html
└── book.pdf
📚 Supported Content
- Markdown
- Tables
- Images
- Code blocks
- Mermaid diagrams
- KaTeX equations
- Nested headings
- Internal links
🛠 Development
Clone the repository:
git clone https://github.com/MossKW/docbuildr.git
cd docbuildr
Install development dependencies:
pip install -e ".[dev]"
Run tests:
pytest
Build package:
python -m build
🗺 Roadmap
- Markdown export
- HTML export
- PDF export
- HTML Viewer
- Mermaid support
- KaTeX support
- EPUB export
- Search index
- Theme engine
- Plugin system
🤝 Contributing
Contributions are welcome!
Please read CONTRIBUTING.md before submitting a pull request.
📄 License
Released under the MIT License.
👤 Author
Developed by Moss.kw
1 maintainer
Metadata
1 maintainer
Release files for docbuildr 1.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| docbuildr-1.0.6.tar.gz | 2.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| docbuildr-1.0.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.7 MB
Release files / docbuildr-1.0.6.tar.gz
| Download URL | docbuildr-1.0.6.tar.gz |
|---|---|
| Size | 2.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c7d4ce6dadc1b9248211996a199b71b18f3dcdc85d8733cd23f08e509348942f
|
|
BLAKE2b-256 checksum How to use checksums |
657b1b19b55fd5aa97f5e72157c7217a9464c0ad1f1e57f0ad910429061614a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.8
|
Release files / docbuildr-1.0.6-py3-none-any.whl
| Download URL | docbuildr-1.0.6-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a6e9e2d2324560ba5a46baa2fd9d471f33ce1a3370ec718f27c2e3d0e961d9b6
|
|
BLAKE2b-256 checksum How to use checksums |
8bb39cd4bb9d7c6f3fc756ef9e7983011136aaa8ebd5bade26cc46913019113b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.8
|
