minibook 0.0.3

Minibook for reporting

📦 minibook

📚 MiniBook

MiniBook is a simple tool that creates a minibook from a list of links. It supports two different output formats:

1. HTML - A clean, responsive webpage using Jinja2 templates and Tailwind CSS
2. MkDocs - A complete MkDocs project structure that can be built into a static site

🚀 Getting Started

🔧 Set Up Environment

make install

This installs/updates uv, creates your virtual environment and installs dependencies.

For adding or removing packages:

uv add/remove requests  # for main dependencies
uv add/remove requests --dev  # for dev dependencies

✅ Configure Pre-commit Hooks

make fmt

Installs hooks to maintain code quality and formatting.

📝 Update Project Info

• Edit pyproject.toml to update authors and email addresses
• Configure GitHub Pages (branch: gh-pages) in repository settings

📋 Usage

MiniBook can be used to create either an HTML page or a MkDocs project from a list of links.

Examples

HTML Output

Create an HTML page with a custom title and three links:

./run_minibook.py --title "My Favorite Sites"
                  --format html
                  --links python;https://www.python.org,github;https://www.github.com,wikipedia;https://www.wikipedia.org

MkDocs Output

Create a MkDocs project with a custom title and three links:

./run_minibook.py --title "My Favorite Sites" --format mkdocs --output minibook_site --links https://www.python.org https://www.github.com https://www.wikipedia.org

After generating the MkDocs project, you can build and serve it using MkDocs:

cd minibook_site
mkdocs build  # Build the site
mkdocs serve  # Serve the site locally at http://127.0.0.1:8000/

Using Links Tuples

You can also provide links as tuples with custom names for each link:

./run_minibook.py --title "My Favorite Sites" --links-tuples '[("Python", "https://www.python.org"), ("GitHub", "https://www.github.com"), ("Wikipedia", "https://www.wikipedia.org")]'

This allows you to specify a different name for each link, rather than using the URL as the name.

🛠️ Development Commands

make tests   # Run test suite
make marimo  # Start Marimo notebooks

👥 Contributing

• 🍴 Fork the repository
• 🌿 Create your feature branch (git checkout -b feature/amazing-feature)
• 💾 Commit your changes (git commit -m 'Add some amazing feature')
• 🚢 Push to the branch (git push origin feature/amazing-feature)
• 🔍 Open a Pull Request