Installation
Requirements
The repository pins Rust 1.85.0 through rust-toolchain.toml. Install Rust with rustup so that Cargo selects the required toolchain automatically. Node.js 22 or later is recommended for building the documentation; it is not required to compile or run YL languages.
Build the CLI
git clone https://github.com/gweiermann/your-language.git
cd your-language
cargo install --path . --lockedThe binary is named yl. Ensure the Cargo binary directory is on PATH. Alternatively, run commands through Cargo without installing:
cargo run -- check examples/01-getting-started/definition/language.ylVerify the installation
yl check examples/01-getting-started/definition/language.yl
yl compile examples/01-getting-started/definition/language.yl -o getting-started.ylc
yl language getting-started.ylc ast examples/01-getting-started/programs/program.txtThe first command validates the definition. The second writes an artifact. The third writes a JSON AST containing two declarations. Paths are relative to the shell's working directory; run these examples from the repository root.
Build the documentation
The site uses VitePress. Its dependencies are locked in package-lock.json:
npm ci
npm run docs:devThe development server prints its local URL. To verify a production build and check internal links:
npm run docs:build
npm run docs:previewThe build output is docs/.vitepress/dist/. Local builds use /; the GitHub Pages workflow sets VITEPRESS_BASE=/your-language/ automatically. The published documentation is available at gweiermann.github.io/your-language.