Commit Graph

6 Commits

Author SHA1 Message Date
Thomas Hallock 1adbd1a5ff feat: add CI-friendly example generation and verification
- Add 'make examples' to regenerate README images
- Add 'make verify-examples' for CI verification
- Create GitHub Action to verify examples are up to date
- Improve generate_examples.py with better error handling
- Add update-examples.sh convenience script
- Document development workflow in README

This ensures README examples always match the actual code output.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 15:55:53 -05:00
Thomas Hallock 3c9c06acc9 docs: add cutting guides examples to README
- Generate examples showing cutting guides and registration marks
- Add 'Printing Features' section to README
- Show full-page cutting guides for accurate card separation
- Include example with both cutting guides and registration marks

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 15:52:37 -05:00
Thomas Hallock 4ca23e9308 docs: add visual examples to README
- Create generate_examples.py script to convert PDFs to PNGs
- Generate example images showcasing all major features
- Add image gallery to README showing:
  - Basic soroban/numeral pairs
  - Color schemes and colored numerals
  - Different bead shapes
  - Various layouts and options
- Include front/back examples for double-sided cards

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 15:49:32 -05:00
Thomas Hallock adc5a557e2 docs: update README with new features and Node.js integration
- Document all new features (colors, shapes, scaling, skip counting)
- Add Node.js/TypeScript integration section
- Update command-line options documentation
- Include API usage examples

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 15:46:06 -05:00
Thomas Hallock 36b13bb54a Improve duplex printing support and documentation
- Clarify page ordering with detailed comments (fronts on odd, backs on even)
- Add PDF metadata for better document properties
- Improve qpdf linearization with object stream preservation
- Document duplex printing behavior in README
- Ensure consistent front/back pairing with explicit pagebreaks

The PDF now clearly alternates between soroban diagrams (odd pages)
and numerals (even pages) for reliable duplex printing with long-edge
binding.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 12:40:35 -05:00
Thomas Hallock 8b38ca6521 Add comprehensive documentation
- README.md: Main documentation with quick start, usage, and examples
- DESIGN.md: Technical implementation details and architecture decisions
- INSTALL.md: Detailed installation guide for macOS

Documentation covers soroban representation, duplex printing,
vector graphics strategy, and configuration options.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 12:14:57 -05:00