{"id":6486,"library":"zensical","title":"Zensical Static Site Generator","description":"Zensical is a modern static site generator built by the creators of Material for MkDocs. It focuses on performance, extensibility, and a smooth developer experience, leveraging a Rust core. The current version is 0.0.33, with frequent releases addressing bugs and introducing new features.","status":"active","version":"0.0.33","language":"en","source_language":"en","source_url":"https://github.com/zensical/zensical/","tags":["static-site-generator","documentation","mkdocs-alternative","cli"],"install":[{"cmd":"pip install zensical","lang":"bash","label":"Install Zensical"}],"dependencies":[{"reason":"Zensical requires Python 3.10 or newer to run.","package":"python","version":">=3.10","optional":false},{"reason":"Used for syntax highlighting in code blocks; updated in v0.0.32 to mitigate a vulnerability.","package":"Pygments","optional":true}],"imports":[],"quickstart":{"code":"# Zensical is primarily a command-line interface (CLI) tool.\n# First, initialize a new Zensical project in the current directory:\nzensical new .\n\n# This will create a `zensical.toml` configuration file and a `docs/`\n# directory with example content.\n\n# Then, serve the site locally and watch for changes:\nzensical serve\n\n# The site will typically be available at http://127.0.0.1:8000","lang":"bash","description":"Start a new Zensical project and serve it locally for development. This demonstrates the typical CLI-first interaction with the library."},"warnings":[{"fix":"Review your project's icon usage. Consult Lucide v1 migration guides for a list of removed icons and available alternatives.","message":"The user interface update in v0.0.31, which upgraded Lucide to v1, led to the removal of 19 brand icons. Projects relying on these specific icons will need to update their configuration or choose alternative icons.","severity":"breaking","affected_versions":">=0.0.31"},{"fix":"Ensure you are using Python 3.10 or newer and update to the latest Zensical version (>=0.0.27) to avoid this specific packaging issue. Verify your Python environment if installation fails.","message":"Version 0.0.26 had a regression where manylinux x86 wheels were incorrectly built for Python 3.8 instead of the required Python 3.10+, causing installation failures on affected architectures.","severity":"gotcha","affected_versions":"0.0.26"},{"fix":"For projects initialized before v0.0.33, manually add desired Markdown Extensions to your `zensical.toml` file or consider regenerating the config if starting a new project.","message":"When bootstrapping a new project with `zensical new` prior to v0.0.33, the generated `zensical.toml` file might not include all recommended Markdown Extensions. This could lead to a less feature-rich setup out-of-the-box.","severity":"gotcha","affected_versions":"<0.0.33"},{"fix":"Be aware that the `mike` integration might evolve. Monitor Zensical's official releases and documentation for updates on native versioning support and potential migration paths from the `mike` workflow.","message":"Zensical introduced a tailored fork of `mike` (v0.0.30) for managing multiple documentation versions. This is noted as a temporary solution, with native versioning support planned for future releases. The current `mike` integration may change.","severity":"deprecated","affected_versions":">=0.0.30"}],"env_vars":null,"last_verified":"2026-04-15T00:00:00.000Z","next_check":"2026-07-14T00:00:00.000Z"}