hls-cookbook: A Git-Native Recipe Collaboration and Automated Publishing System

hls-cookbook is an innovative open-source project that demonstrates a new model of Git-native document collaboration and automated publishing. It collects submissions via GitHub Issue forms, processes them with intelligent workflows for standardization, and uses a Typst pipeline to automatically generate print-ready PDF/EPUB recipe books. By introducing modern software development practices like version control and continuous integration into content creation, it reduces collaboration costs and enables end-to-end automated publishing.

Traditional recipe publishing faces pain points such as difficult collection (non-uniform formats, heavy organization), chaotic version management, high collaboration costs, and delayed updates. hls-cookbook takes "Git-native" as its core concept: treating recipes as code to leverage Git's version management and branch collaboration capabilities; prioritizing automation to reduce manual intervention; and enabling open collaboration to lower participation barriers, thus redefining knowledge management and collaborative publishing models.

The project designs a complete automated publishing pipeline: 1. Submission Collection: GitHub Issue structured forms guide contributors to fill in standardized recipe information (name, ingredients, steps, etc.), which is user-friendly for non-technical users and supports community interaction; 2. Intelligent Standardization: GitHub Actions Workflow parses Issue data, automatically standardizes formats, validates content, converts it to YAML, and submits a PR for review; 3. Versioned Management: YAML files are stored in a Git repository, supporting semantic versioning, branch collaboration, diff comparison, and rollback; 4. Automated Publishing: Typst template-driven generation of multi-format publications like PDF and EPUB, with automatic content aggregation to generate table of contents and indexes.

1. GitHub Issue as CMS: Zero-cost infrastructure, built-in permission management, community-native interface, and notification integration; 2. Agentic Workflow: Structured data extraction, intelligent content understanding, automatic format conversion, and quality control; 3. Typst Typesetting: Concise syntax, fast compilation, modern font support, and programmability—offering modern advantages over LaTeX.

This model can be extended to scenarios such as: technical documentation (collecting feedback, automatically generating manuals), academic paper collections (submission review, automatic formatting), enterprise internal knowledge bases (employee sharing, automatic archiving), and educational materials (teacher contributions, version tracking to generate textbooks).

Implementation Experience: Form design requires progressive disclosure, example guidance, and real-time feedback; workflows need idempotency, error handling, and manual review; version management uses semantic versioning, branch strategies, and change logs. Limitations: Maintenance requires knowledge of Git and CI/CD; complex multimedia processing needs extension; Issue management may become a bottleneck in large-scale collaboration; highly customized typesetting requires professional knowledge of Typst.

In the future, we will enhance multi-language support, rich media integration, and interactive content; expand to platforms like GitLab/Bitbucket, provide independent deployment options and mobile applications; and build a template market, plugin ecosystem, and training resources to promote community development.

hls-cookbook introduces best practices from software development into content creation, enabling end-to-end automation from submission to publishing. Its value lies in redefining the boundaries of knowledge collaboration—allowing anyone to contribute content through a familiar interface while professional publishing processes are automatically completed in the background. This model provides an example for improving collaboration efficiency and reducing publishing costs, and is expected to promote the democratization of knowledge sharing in more fields. Project URL: https://github.com/samueltauil/hls-cookbook