chore(deps): update dependency zensical to v0.0.45

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
zensical (changelog)	==0.0.36 → ==0.0.45

---

Release Notes

zensical/zensical (zensical)

v0.0.45: 0.0.45

Compare Source

Summary

This version reverts a behavior change in link validation that was introduced in 0.0.44 which is causing false positives.

Changelog

Bug fixes

• 8d9536a compat – revert "fix: brackets in indented code recognized as unresolved references (#​700)" (#​735)

v0.0.44: 0.0.44

Compare Source

Summary

This version fixes several bugs related to link validation and macros, and ensures that dotfiles are not removed from the site directory during generation.

Changelog

Bug fixes

• eb72115 compat – ignore Markdown comments [//]: ... during link validation
• c40f649 compat – brackets in indented code blocks recognized as unresolved link references (#​700)
• 93cc869 compat – snippet markers recognized as unresolved link references (#​700)
• a212c59 zensical – don't remove dotfiles from site dir (#​728)
• db1f19c compat – provide conf attribute in macros' env object
• 9b452cb zensical – improve error message when missing icon is used (#​708)
• d7ccbe6 zensical, compat – anchors with escaped chars not matched during link validation (#​703)
• 8b7e29e compat – empty footnote ref classified as link ref (#​702)

v0.0.43: 0.0.43

Compare Source

Summary

This version fixes further edge cases in link validation, and adds support for UTF-8 encoding with byte-order-marks.

Changelog

Bug fixes

• 1e873a3 compat – ignore links in code after literal dollar during link validation (#​691)
• 62a0feb zensical – report path.md/#anchor as invalid during link validation (#​690)
• 7be40c6 compat – ignore GitHub-style callouts during link validation (#​688)
• 85c3b1e compat – ignore [TOC] marker during link validation (#​686)
• daafc8b zensical – filter out icons folder when watching theme directories (#​693)
• 913fd61 zensical – strip Byte-Order-Mark (BOM) from Markdown files (#​687)

v0.0.42: 0.0.42

Compare Source

Summary

This version includes a number of bug fixes and refactorings to improve the stability and accuracy of link validation, and fixes a reload loop when the custom_dir, which is auto-watched, is explicitly added to watch. Moreover, GLightbox is now only downloaded when needed, which fixes an issue when using Zensical in air-gapped environments.

Changelog

Bug fixes

• 6b54e14 ui – update ui to v0.0.18
• cdee1e8 zensical – disabling link validation doesn't disable link and reference collection (#​659)
• 4355dad compat – harden link validation for files with CRLF line endings
• a418c6b compat – link validation doesn't ignore fenced code blocks when \r is present
• b31dd14 compat – $ at end of line breaks link validation (#​659)
• 17c67a2 compat – remove abbreviations from table of contents (#​669)
• 6eb2f4d compat – reserve theme name zensical
• a5a8641 zensical – only wait for config update after a first successful build (#​670)
• 8207554 compat – don't consider [] and [][] link references (#​663)
• c338b27 compat – two backticks with no closing run trip up link parser (#​663, #​665)
• d707aa9 compat – prevent reload loop by de-duplicating watched theme files (#​655)

Refactorings

• 53f593f compat – avoid mutating configurations list
• a77087a compat – reorganize config module

v0.0.41: 0.0.41

Compare Source

Summary

This version adds support for integrating tabular data as Markdown tables, covering the functionality of the mkdocs-table-reader-plugin, as well as the watch option to automatically rebuild on changes in unmonitored files. Table reading is implemented as part of macros, which we shipped in 0.0.40. You can now embed CSV and other file formats with:

{{ read_csv("data/team.csv") }}

Additionally, the stability of link validation has been drastically improved, reducing the rate of false positives. We're working on support for validating links using autorefs, which we'll provide in one of the next versions.

Changelog

Features

• d24ea24 compat – support table reader functionality
• 2cbb33d compat – support watch option (#​643)

Bug fixes

• 9e466fc ui – update ui to v0.0.17
• bee1c3f compat – give higher priority than superfences to macros preprocessor (#​638)

Refactorings

• 67b6ef1 compat – make extensions consistent
• bf26d1b zensical, compat – implement parser for link validation

v0.0.40: 0.0.40

Compare Source

Summary

This version adds support for macros, covering the functionality of the mkdocs-macros-plugin. Macros allow you to define custom variables and functions that can be used in your Markdown files, making it easier to manage and reuse content across your documentation.

We've implemented macros support as a Python Markdown extension, since it's essentially a Markdown preprocessor that doesn't need to be aware of the rest of Zensical's rendering process, except for the current page and configuration. The benefit is that it can now also be used in Python docstrings to build API documentation with mkdocstrings.

Changelog

Features

• 36b5131 compat – exclude macros blocks from link validation
• f7fe088 compat – support macros plugin

Bug fixes

• bdc3471 ui – update ui to v0.0.16
• 4be2374 compat – link validation doesn't catch end of MathJax when \r present (#​615)
• c6cffec compat – link validation exclusions don't catch \r\n line feeds
• 6efe0a3 compat – link validation exclusions require empty line after code block (#​618)
• 645bbe8 zensical – clear site directory contents instead of removing it (#​621)
• 814d2e9 zensical – link validation yields false positives on Windows (#​616)
• b229bac zensical-serve – zensical serve returns 404 after suspend (#​574)
• b5492ce compat – shim for mkdocs-glightbox fails when only defaults are set (#​611)

Refactorings

• 91090e9 zensical, compat – combine file watching for extensions
• b2fdc78 zensical, compat – pass rendering context into preprocessor

v0.0.39: 0.0.39

Compare Source

Summary

This version fixes several bugs related to link validation and lightbox configuration.

Changelog

Bug fixes

• fe42fc4 compat – shim for MkDocs validation syntax overrides Zensical's (#​607)
• acc2620 zensical – validation doesn't correctly map percent-encoded links (#​598)
• da317bf compat – add $...$ and $$...$$ blocks to exclusions for link validation (#​599)
• 94f0d29 zensical – anchor not extracted from combined anchor-text-fragment
• 273dd23 compat – auto-themed gallery takes precedence over explicit grouping
• c050add compat – error when setting caption_position on glightbox extension (#​604)
• 699d3be zensical – add Python backtrace on Markdown rendering error

Refactorings

• 3e27d69 compat – move glightbox config options to dataclass

v0.0.38: 0.0.38

Compare Source

Summary

This version adds link and footnote validation and strict mode – two of the most frequently requested features. Zensical now checks all internal references at build time and reports issues with precise source locations, so broken links don't make it into your published documentation. Unlike MkDocs, which only validates final rendered links, Zensical also checks for unresolved references, as well as unused and shadowed definitions – covering the full lifecycle of a reference from definition to use.

Validation

Zensical scans every Markdown file in your project and resolves all internal references against each other: inline links, reference-style links, footnotes, link definitions, and anchor targets. Every check is individually configurable and enabled by default.

$ zensical build
...
Warning: page does not exist
   ╭─[ index.md:3:14 ]
   │
 3 │ [id]: non-existent.md
   │       ───────┬───────
   │              ╰───────── page does not exist
───╯

The following checks for links and footnotes are now available:

• unresolved_references
• unresolved_footnotes
• unused_definitions
• unused_footnotes
• shadowed_definitions
• shadowed_footnotes
• invalid_links
• invalid_link_anchors

Strict mode

The new --strict command line flag causes the build to fail when any enabled validation check triggers, turning warnings into errors. This is useful for CI pipelines where you want to enforce link integrity and prevent broken documentation from being published:

$ zensical build --strict
...
Warning: unresolved link reference
   ╭─[ index.md:1:35 ]
   │
 1 │ This is an [unresolved reference][id].
   │                                   ─┬
   │                                    ╰── unresolved link reference
───╯
1 issue found
Aborted because --strict flag is set

Upgrading

No changes to your configuration are required – all checks are enabled by default. It's quite likely that you'll run into at least some warnings – as we did – when upgrading, since before, it was easy to miss unused link definitions or unresolved references. If you want to disable validation entirely, you can use:

[project]
validation = false

As always, if you run into any problems, please open an issue.

Changelog

Features

• 201c615 zensical, compat – add link and footnote validation and --strict mode (#​175)

Refactorings

• b3c1d91 zensical, compat – add custom Markdown subclasses
• ce8cbf8 zensical – simplify function definitions after zrx upgrade

v0.0.37: 0.0.37

Compare Source

Summary

This version adds support for installable themes. You can now bundle your theme overrides and package them into a custom theme which can be installed via pip.

As of now, we closely mirror the process used by MkDocs, where themes just need to register themselves in the mkdocs.themes entrypoint, to allow users that already have derivations of Material for MkDocs to run them on Zensical. In the coming months, with the advent of the component system, we'll make this process much more flexible and foster reuse at the component level. For now, this is a first step to allow sharing of theme overrides and default configurations inside organizations with dozens or even thousands of projects.

[!TIP]

If your organization has been a happy user of Material for MkDocs and is considering switching to Zensical, please support our work through Zensical Spark. Your financial contribution helps us achieve full compatibility with MkDocs much faster, gives you access to hands-on support by the core team, and allows you to shape Zensical together with us.

Changelog

Features

• 7694535 zensical, compat – installable theme extensions (#​511)

Bug fixes

• 72ba122 compat – sanitize nested metadata (#​582)
• 2fb663e compat – text adjacent to image included in link to open image in lightbox (#​579)
• dc32baf compat – anchor links preserved in table of content section titles (#​578)
• 127648e compat – attributes not applied to lightbox images

Refactorings

• 9872092 compat – subclass Markdown processors to extend functionality
• fdeb061 compat – use identical name for tree- and post-processor

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • "before 5am on saturday"
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.