Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 0 additions & 11 deletions .claude/settings.local.json

This file was deleted.

5 changes: 0 additions & 5 deletions .github/workflows/build-and-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,11 +47,6 @@ jobs:
- name: Cargo fmt
run: cargo fmt --check

- name: Cargo build (Native TLS)
run: |
cargo build --all --no-default-features --features=native-tls
cargo clean

- name: Cargo build (Rust TLS)
run: cargo build --all

Expand Down
2 changes: 2 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,8 @@ jobs:
fail_on_unmatched_files: true
body: |
Welcome to this new release of Zola ${{ github.ref_name }}!

See the full changelog at https://github.com/getzola/zola/blob/master/CHANGELOG.md

All artifacts are signed with this repos identity using Sigstore.
You can verify the signatures using the `GitHub` CLI.
Expand Down
32 changes: 32 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,37 @@
# Changelog

## 0.23.x (unrelease)

This is probably the most breaking version of Zola that will happen.
Depending on how you use it though, it might not be too long to migrate. It took about 20 minutes to upgrade the Zola docs
and it was mostly because it contains a lot of Tera syntax (as we will see later).

### Breaking

- remove `native-tls` feature to build zola
- `get_page` and `get_section` no longer work with paths containing language code, eg "content/some.fr.md". Use the canonical path + `lang` argument
- `get_taxonomy_url` `name` param has been renamed to `term`
- Tera, the template engine, has been updated to v2. See its own migration guide: <https://github.com/Keats/tera2/blob/master/MIGRATION.md>
- shortcodes have been removed, see Migration section below for more details

#### Migration

As mentioned, shortcodes have been completely removed.
Instead, you can now completely template the content of a page/section from the .md file, as well as use the new Tera
components. No more weird separation of shortcode/macros, just use Tera, the same components you can use elsewhere in your site.
This means you will need to rewrite your shortcodes into components most likely, see [Tera documentation](TODO: insert link) for
more details.
If you use a theme, it will most likely need to be updated to work with Zola 0.23 before you can update.

Follow the Tera migration guide (<https://github.com/Keats/tera2/blob/master/MIGRATION.md>) for the changes in the template itself.

If you have Tera syntax in your content, you will need to wrap it in `{% raw %}..{% endraw %}` to avoid errors.

### Other

- `get_taxonomy_url` `name` parameter is deprecated. Use `term` to be consistent with the other functions
- Add `data_attr_position` to the markdown highlighting config to handle where all the data attributes should be passed

## 0.22.1 (2026-01-22)

- Update deps to fix some JPEG decoding issue + highlighting speed
Expand Down
Loading