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

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
zensical (changelog)	==0.0.28 → ==0.0.43

---

Release Notes

zensical/zensical (zensical)

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

v0.0.36: 0.0.36

Compare Source

Summary

This version adds the missing update of the user interface that should've been included with v0.0.35.

Changelog

Bug fixes

• d4d88f8 ui – update ui to v0.0.15

v0.0.35: 0.0.35

Compare Source

[!WARNING]

Please update to v0.0.36 – this version is missing some changes to the user interface for the new features.

Summary

This version adds native support for GLightbox, a JavaScript lightbox library to add zoom and gallery features to images. Images can be automatically annotated with the new glightbox Markdown extension. Add the following to zensical.toml:

[project.markdown_extensions.zensical.extensions.glightbox]

[!NOTE]

In order to integrate with configuration in mkdocs.yml, where GLightbox is implemented as a plugin, a compatibility shim is included, so no re-configuration is necessary if you're already using the plugin. Note that our extension is more efficient and faster than the plugin, as it does not re-parse the entire HTML of each page, but instead uses Python Markdown's native extension API.

HTML in the table of contents

Additionally, section titles in the table of contents will now render with HTML markup, so you can use emojis and other inline features in section titles and have them render correctly in the table of contents. In Material for MkDocs, this functionality was implemented with the typeset plugin. Zensical now supports this natively.

Relative links in raw HTML

Relative links in raw HTML are now correctly resolved. Initially, we carried over the link processing and resolution logic from MkDocs, which does not support relative links in raw HTML to this day. We implemented a Python Markdown postprocessor, to ensure that relative links in raw HTML are handled as well.

Changelog

Features

• 5519730 zensical, compat – render section title with markup in table of contents
• db8518d compat – add plugin compatibility shim for glightbox
• 057da7c compat – add support for image galleries using glightbox (#​290)

Bug fixes

• 64f3f33 compat – relative links in raw HTML not correctly resolved (#​258)
• 87abb2a compat – remove img attributes moved to parent in GLightboxExtension
• f7531af compat – images in raw HTML are double-processed by GLightboxExtension
• 1d8dc83 compat – ensure None attributes are not added by GlightboxExtension
• 773fa76 zensical – support uv's symlink mode (#​557)

Refactorings

• 7c977a8 compat – move GLightbox extension to regular Postprocessor

v0.0.34: 0.0.34

Compare Source

Summary

This version moves Zensical to the latest version of ZRX, the foundation for Zensical and its ecosystem. It includes the module system, as well as a ground up rewrite of the scheduler and streaming API. We did extensive testing with several hundred projects we obtained from GitHub, so we don't expect any issues. However, if you encounter any problems, please let us know.

Moreover, this version ships support for usage of TOML v1.1.0 in zensical.toml, which allows new lines in inline tables. Thus, configuration files can now be made more readable, especially when they contain long lists of items. For example:

Prior to this version

palette = [
  { scheme = "default", toggle = { icon = "lucide/sun", name = "Switch to dark mode" } },
  { scheme = "slate", toggle = { icon = "lucide/moon", name = "Switch to light mode" } },
]

With this version

palette = [
  {
    scheme = "default",
    toggle = {
      icon = "lucide/sun",
      name = "Switch to dark mode"
    }
  },
  {
    scheme = "slate",
    toggle = {
      icon = "lucide/moon",
      name = "Switch to light mode"
    }
  },
]

Additionally, Markdown pages with snippets are now rebuilt when snippets are updated, and an issue with breadcrumbs was fixed when the top-level index.md was not at the root of explicit navigation.

Changelog

Features

• 8f5f584 compat – update configuration parser to TOML v1.1.0

Bug fixes

• 2461bd6 ui – update ui to v0.0.14
• 670834f compat – inhibit instant previews on footnote backrefs
• d24ba8a zensical – Markdown pages with snippets not rebuilt when snippet changes (#​526)
• 7076f8d compat – update README.html links to index.html links when directory URLs aren't set (#​531)
• 4b9ed87 zensical – don't consider non-root index.md a homepage, like MkDocs (#​476)
• 25f9ad6 – bump rand to 0.9.4 to mitigate CVE

Refactorings

• 50aa8a5 zensical, zensical-watch – update to zrx to v0.0.21

v0.0.33: 0.0.33

Compare Source

Summary

This version updates our official Docker image to be based on Alpine Linux for better compatibility and ease of use. It also adds all recommended Markdown Extensions to the generated zensical.toml file when bootstrapping a project with zensical new, ensuring a smoother setup experience. Additionally, the user interface is updated to v0.0.13, which includes two bug fixes for anchor links in the table of contents.

Changelog

Breaking changes

• 4eb05a2 docker – switch base image to Alpine Linux for ease of use (#​510)

Features

• 6871d33 compat – add default Markdown Extensions to bootstrapped zensical.toml

Bug fixes

• bb8a7e5 ui – update ui to v0.0.13
• bb58c5d compat – out of date help message (#​524)
• 9bff25a compat – add missing configuration for default Markdown Extensions

Refactorings

• 20d94ad compat – update GitHub workflows to Node 24 (#​522)

v0.0.32: 0.0.32

Compare Source

Summary

This version fixes a bug where Markdown files used as snippets were included into auto-generated navigation, and a bug with prefix stripping when the site URL contains a path component. Additionally, the Pygments dependency was updated to mitigate a vulnerability.

Changelog

Bug fixes

• ca5d2d5 zensical-serve – strip base URL prefix as URL segment, not string (#​499)
• 3a2358a – update to latest Pygments to mitigate vulnerability (#​485)
• 92b5622 zensical – only collect markdown pages in docs directory (#​490)

v0.0.31: 0.0.31

Compare Source

Summary

This version updates the user interface to v0.0.12, which includes the removal of 19 brand icons due to the update of Lucide to v1, and the addition of 166 new icons, most of them in SimpleIcons and FontAwesome. Additionally, there are bug fixes related to the latest changes of the table of contents in the modern theme and instant navigation on anchor links.

Changelog

Bug fixes

• 198c1d6 ui – update ui to v0.0.12
• 24be9ab compat – support pymdownx blocks tab extension's slugify function (#​483)

v0.0.30: 0.0.30

Compare Source

Summary

This version adds support for mike, a tool for managing multiple versions of MkDocs projects on GitHub Pages. We created a tailored fork of mike for Zensical – all mike commands should work as expected. Please refer to our documentation for setup instructions, and mike's documentation for advanced usage patterns and options.

Note that this is a temporary solution. Zensical will ship native support for versioning in the near future, which will remove the GitHub Pages constraint and offer more flexibility in how versions are deployed and served.

The user interface is updated to v0.0.11, which adds a floating table of contents menu for mobile to the modern theme. The toggle sits at the bottom of the screen for easy thumb access, and the sidebar scrolls to accommodate arbitrarily long tables of contents. This release also includes several improvements: snappier sidebar animations, better tooltip readability, and improved inline code block sizing.

Changelog

Features

• 77a08d9 compat – add support for mike

Bug fixes

• 97cdbc8 ui – update ui to v0.0.11
• 25e8c53 compat – validate docs-directory and custom-theme-directory (#​475)

v0.0.29: 0.0.29

Compare Source

Summary

This version fixes an issue with absolute paths in links, as well as changed files not being picked up by Zensical on Windows 11.

Changelog

Bug fixes

• c1860ca compat – leave absolute links untouched (#​466)
• 6775b75 zensical – canonicalize watched paths (#​451)

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ 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.