$ show little-book-of/linear-algebra
This repository is a multi-language, open-source linear algebra textbook built with Quarto. It is not a software application or a data research pipeline; it is a documentation project that produces static HTML, PDF, EPUB, and LaTeX outputs. The core code consists of a Makefile for build automation, Python scripts for machine translation of the book content into six languages (Chinese, Vietnamese, Japanese, Korean, Spanish, German), and GitHub Actions workflows for CI/CD and deployment to GitHub Pages. The translation pipeline is the most sophisticated software component, featuring chunking with math/protection, SHA-256 checkpointing for resumability, parallel workers, and verification of translation completeness. The book content itself is extensive (100+ labs) but is structured as Quarto markdown files. The repository is actively maintained with recent commits, a changelog, and issue tracking. The primary value is educational, but the translation infrastructure and Quarto multi-language book pattern are reusable assets for other documentation projects.
The LLM identified 3 files worth highlighting for reuse:
A robust, reusable translation script that translates Quarto markdown files into multiple languages. It splits content into chunks while protecting inline code and math, uses SHA-256 hashing for checkpoint-based resumability, supports parallel workers, retries on failure, and verifies that chunks are translated. It can be extracted and adapted for any multilingual documentation project using machine translation.
A GitHub Actions workflow that builds and deploys a multi-language Quarto book to GitHub Pages. It installs Quarto, renders all language versions, and uses standard GitHub Pages deployment actions. This pattern is directly reusable for any Quarto project that needs to publish multiple language editions.
A well-structured Makefile that orchestrates Quarto installation, translation, rendering, and release packaging. It defines targets for each language translation, clean, render-all, and release. The pattern of parameterizing language targets and using a central script is reusable for any multi-language documentation project.