Commit Graph

7 Commits

Author SHA1 Message Date
Didier Durand
2249346319 Fixing dangling link in README.md 2025-10-31 07:20:59 +01:00
Vijay Janapa Reddi
a4065670fd fix: standardize conclusion learning objectives and clean Purpose sections
- Move conclusion chapter learning objectives to callout format matching other chapters
- Position learning objectives before Overview section for consistency
- Remove footnotes from workflow chapter Purpose section to keep it clean
- Update footnote agent guidelines to never add footnotes to Purpose sections

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 09:49:29 -04:00
Vijay Janapa Reddi
41c98f49a5 refactor(tools): rename quarto_publish to publish and add professional compression scripts
- Rename tools/scripts/quarto_publish/ to tools/scripts/publish/ for cleaner organization
- Add compress_pdf.py: Professional PDF compression with Ghostscript
  * Cross-platform support (gs on Linux/macOS, gswin64c on Windows)
  * Multiple quality presets including minimal mode for exact compatibility
  * Consistent CLI interface with --input/-i and --output/-o flags
  * Comprehensive error handling and progress reporting
- Add compress_epub.py: Professional EPUB compression with image optimization
  * Optimizes embedded images while maintaining EPUB format compliance
  * Consistent CLI interface matching compress_pdf.py
  * Configurable quality and image size settings
- Update documentation to reflect new directory structure
- Both scripts use identical professional CLI patterns for consistency
2025-08-21 14:20:35 -04:00
Vijay Janapa Reddi
c7801da99b docs: update workflow references from quarto-build.yml to quarto-build-container.yml
- Update CONTAINER_BUILDS.md to reflect current workflow status
- Fix workflow cleanup documentation examples
- Update PUBLISH_LIVE_WORKFLOW.md references
- Clarify that container workflow is now the primary build method
2025-08-19 18:51:59 -04:00
Vijay Janapa Reddi
cbc9c575fb feat(workflows): improve container build workflows with best practices
- Add concurrency control to prevent overlapping builds
- Add timeout limits (120min Windows, 90min Linux)
- Use modern Docker Buildx and build-push-action
- Add load: true for local copy retention
- Ensure consistent push: true configuration
- Simplify output messages for cleaner logs
- Fix permission and API endpoint issues for public containers
2025-08-08 15:05:01 -04:00
Vijay Janapa Reddi
193ae009b4 docs: update documentation for new build structure and configuration
- Update all documentation to reflect new build/ directory structure
- Update configuration file references from _quarto.yml to _quarto-html.yml and _quarto-pdf.yml
- Update output paths from _book/ to build/html/ and build/pdf/
- Update disk usage commands and maintenance procedures
- Update script documentation to reflect new configuration structure
- Mark legacy cache directories appropriately
2025-07-27 10:48:37 -04:00
Vijay Janapa Reddi
4cbc8b6f8b Reorganize and standardize scripts directory structure and naming
🗂️ Major reorganization:
- Organized scripts into logical categories: build/, content/, maintenance/, testing/, utilities/, docs/
- Moved 25+ scripts from flat structure to categorized directories
- Added category-specific README files with usage examples

📝 Standardized script naming:
- Fixed abbreviations: fn_cnt.sh → count_footnotes.sh, fixbib.py → fix_bibliography.py
- Applied consistent verb_noun patterns: section_id_manager.py → manage_section_ids.py
- Improved clarity: ascii_checker.py → check_ascii.py, fixtitle.py → fix_titles.py
- Distinguished similar tools: footnote_cnt.sh → analyze_footnotes.sh

📚 Updated documentation:
- Comprehensive main README with usage examples for all categories
- Individual README files for each script category
- Updated DEVELOPMENT.md with new scripts organization section
- Synchronized all script references in documentation

🔗 Integration updates:
- Updated Makefile to use new script paths
- Fixed pre-commit hook references to moved scripts
- Maintained all existing functionality while improving organization

The scripts directory now follows professional standards with intuitive categorization,
consistent naming conventions, and comprehensive documentation.
2025-07-25 11:56:50 -04:00