Guides

These guides provide in-depth coverage of specific Sigil topics. Unlike the tutorial, these can be read in any order based on your needs.

Available Guides

Idiomatic Sigil: pipelines, pattern matching, transducers, function composition, and data-oriented programming.

Deep dive into the module system: library structure, resolution, exports, and best practices for organizing code.

Advanced macro techniques: procedural macros, hygiene, debugging, and when (not) to use macros.

Concurrent programming with channels and cooperative tasks. Build responsive applications with multiple concurrent actors.

The condition system, custom exceptions, and strategies for robust error handling.

Building standalone executables, bundling, and deployment strategies.

Building command-line interfaces with (sigil args): options, subcommands, validation, and help generation.

API design guidelines for Sigil libraries: naming conventions, signatures, documentation, and idiomatic patterns.

Building static websites with sigil publish: documentation sites, blogs, custom pipelines, themes, and API documentation generation.

Writing and running tests with (sigil test) and sigil test: assertions, test discovery, output formats, and CI integration.

Building games and creative applications with Sigil Studio: windowing, 2D rendering, textures, fonts, sound effects, and music.

Configuring Emacs with sigil-mode and nREPL integration. Tips for VS Code, Vim, and other editors.

Override dependency resolution during development to use local checkouts, forks, or specific branches.