- Fix
config.generate_feeds
being still serialized asconfig.generate_feed
. Both are available for now - Fix
zola serve
not reacting to changes on some OSes
- Updates the pulldown-cmark dependency to v0.11.0. This improves footnote handling, and may also introduce some minor behavior changes such as reducing the amount of unnecessary HTML-escaping of text content.
- Add bottom footnotes with backreference option
- Fix link check report inconsistency
- Fix resizing for images with EXIF orientation
- Add MIME type to get_image_metadata
- Fix hot loading for config.toml in some cases
- Add
render = false
capability to pages - Handle string dates in YAML front-matter
- Add support for fuse.js search format
- Added support for generating multiple kinds of feeds at once
- Changed config options named
generate_feed
togenerate_feeds
(both in config.toml and in section front-matter) - Changed config option
feed_filename: String
tofeed_filenames: Vec<String>
- The config file no longer allows arbitrary fields outside the
[extra]
section
- Fix LFI in
zola serve
- Do not panic when root directory or config file not found
- Fix base_url link attributes in atom templates
- Use all authors for atom templates
- Always sort page/section assets by filename
- Allow setting attributes to lazy load all images from Config.toml
- Fix HTML generated in class based highlighting with line numbers
- Add a
replace_re
filter - Speed up
zola check
and only checks external links once, even if present in multiple languages - Add
search.index_format
into the serialized config in the templates - Add --force flag in
zola serve
if the directory is not empty - Add
ignored_static
to the config to ignore specific files from the static directory - Add Hungarian support for search
- Actually remove codeblocks from search index
- Fix taxonomies missing lang in sitemap
- Fix one more invalid error with colocated directories
- Revert "Recognize links starting with
www
as external for the link checker" as they won't be external links in practice - Use page.summary for atom.xml if available
- Fix cachebusting not working with binary files
- Fix warning message for multilingual sites
- Fix bugs with colocated directories in the root
content
directory - Fix
zola serve
not respectingpreserve_dotfiles_in_output
- Add
generate_feed
field to thesection
object in templates
get_file_hash
is removed, useget_hash
instead. Arguments do not change- Replace libsass by a Rust implementation: grass. See https://sass-lang.com/documentation/breaking-changes for breaking changes with libsass: look for "beginning in Dart Sass"
- Merge settings for the default language set in the root of
config.toml
and in the[languages.{default_lang}]
section. This will error if the same keys are defined multiple times - Code blocks content are no longer included in the search index
- Remove built-ins shortcodes
- Having a file called
index.md
in a folder with a_index.md
is now an error - Ignore temp files from vim/emacs/macos/etc as well as files without extensions when getting colocated assets
- Now integrates the file stem of the original file into the processed images filename: {stem}.{hash}.{extension}
- Add
get_taxonomy_term
function - Add
slugify.paths_keep_dates
option - Add command to generate shell completions
- Fix link generation to co-located assets other than images
- Add
get_hash
Tera function - Minify CSS and JS embedded in HTML
- Fix slow image processing
- Fix
current_url
in taxonomy term - Add new flag
zola serve --no_port_append
to give the ability to remove port from base url config.markdown
is now available in templates- Add
preserve_dotfiles_in_output
option in the config - Add Elasticlunr JSON output for the search index
- Add sorting by slug for pages
- Enable locale date formatting for the Tera
date
filter - Cachebust fingerprint is now only 20 chars long
- Add
text
alias for plain text highlighting (before, onlytxt
was used) - Adds a new field to
page
:colocated_path
that points to the folder of the current file being rendered if it's a colocated folder. None otherwise. - Add
author
as a first-class property to the config andauthors
to pages - Allows using external URL for
redirect_to
- Recognize links starting with
www
as external for the link checker
- Fix many Windows bugs
- Fix overriding built-in shortcodes
- Support .yml files with
load_data
- Switch to pulldown-cmark anchor system rather than ours, some (very niche) edge cases are not supported anymore, you can also specify classes on headers now
- Now outputs empty taxonomies instead of ignoring them
- Unify all pages sorting variable names in templates to
lower
/higher
in order to make it easy to re-use templates and it was becoming hard to come up with names to be honest
- Fix markup for fenced code with linenos
- Make
ignored_content
work with nested paths and directories zola serve/build
can now run from anywhere in a zola directory- Add XML support to
load_data
- Add YAML support to
load_data
skip_prefixes
is now checked before parsing external link URLs- Add
render
attribute to taxonomies configuration inconfig.toml
, for when you don't want to render any pages related to that taxonomy - Serialize
transparent
field from front-matter of sections - Use Zola Tera instance for markdown filter: this means you have access to the same Tera functions as in shortcodes
- Ignore sections with
render=false
when looking for path collisions - Add support for backlinks
- Add a warning mode for internal/external link checking in case you don't want zola to stop the build on invalid links
- Always follow symlinks when loading the site/assets
- Add
rel="alternate"
to Atom post links - Fix taxonomy
current_path
- Fix feed location for taxonomies not in the default language
- Add
title_bytes
sorting method - Add
insert_anchor = "heading"
, which allows users to use the entire heading as a link - Apply orientation transformation based on EXIF data
- Fix generated homepages not having their
translations
filled properly
- Fix shortcodes not being rendered in code blocks
- Fix colocated assets with no extensions being ignored
- Add
headers
parameters toload_data
- Fix themes
robots.txt
not being rendered - Check for local internal anchors in HTML content of markdown files
- Fix issues loading custom syntaxes if highlight_theme = css
- Fix HTML shortcodes
- Fix markdown shortcodes not being rendered correctly
- Fix config data not getting to the templates
- Fix config file watching
- Support custom syntax highlighting themes
- Add a
required
argument to taxonomy template functions to allow them to return empty taxonomies - Support colocating subfolders
- Shortcodes and
anchor-link.html
can now access thelang
context - Add prompt before replacing the output directory with
zola build
if theoutput-dir
flag is given - Shortcode handling has been completely rewritten, solving many issues
- Also add internal links starting with
#
without any internal Zola link
- HTML minification now respects HTML spec (it still worked before because browsers can handle invalid HTML well and minifiers take advantage of it)
- Show all errors on
zola serve
zola serve
now properly returns a 404- Fix
zola serve
having issues with config files in separate dir - Fix code blocks content not being escaped when not using syntax highlighting
- Add missing
draft
attribute to thesection
variable in templates
- Newlines are now required after the closing
+++
of front-matter resize_image
now returns an object:{url, static_path}
instead of just the URL so you can follow up with other functions on the new file if neededget_file_hash
now has thebase64
option set totrue
by default (fromfalse
) since it's mainly used for integrity hashes which are base64- i18n rework: languages now have their sections in
config.toml
to set up all their options- taxonomies don't have a
lang
anymore in the config, you need to declare them in their respective language section - the
config
variable in templates has been changed and is now a stripped down language aware version of the previousconfig
object - Search settings are now language specific
- Translations are now nested in the languages table
- taxonomies don't have a
- Paths unification:
get_url
does not load automatically from thestatic
folder anymore- New path resolving logic for all on-disk files: replace
@/
bycontent/
, trim leading/
and search in $BASE_DIR + $path, $BASE_DIR + static + $path and $BASE_DIR + content + $path get_file_hash
now returns base64 encoded hash by default- all functions working on files can now only load files in the Zola directory
resize_image
return value has changedpage.assets
now start with a/
to matchsection.assets
and other paths
- Internal links are now resolved in the
markdown
filter in the templates (#1296 #1316) - Add a
required
argument toload_data
so it can be allowed to fail get_file_hash
now supports returning the base64 encoded hash- The
markdown
filter not renders shortcodes - Image processing now supports WebP
- Fix
zola serve
failing for some static files - Fix
zola serve
not picking up directory renaming - Add
path
to the taxonomy terms to be on par with pages and sections - Add the
base16-aterlierdune-light
syntax highlight theme - Improve link checking: less concurrency and try to not overload the servers
- Allow using POST for
load_data
, along with a body to POST and allow it to fail - Add Zig and Protobuf syntax highlighting
- Footnotes links are now stripped from summaries - they were not linking to anything.
get_url
andget_taxonomy_url
are now marked as safe, no need to call| safe
on their output- Add
allow_missing
optional argument toget_image_metadata
to not error if the file is not found - Add
permalink
toTaxonomy
in templates - Syntax highlighting improvements, see documentation for details on each
- Add CSS class based syntax highlighting
- Allow hiding specific lines
- Allow showing line numbers
- Enable HTML minification
- Support
output_dir
inconfig.toml
- Allow sections to be drafted
- Allow specifying default language in filenames
- Render emoji in Markdown content if the
render_emoji
option is enabled - Enable YouTube privacy mode for the YouTube shortcode
- Add language as class to the
<code>
block and asdata-lang
- Add bibtex to
load_data
- Add a
[markdown]
section toconfig.toml
to configure rendering - Add
highlight_code
andhighlight_theme
to a[markdown]
section inconfig.toml
- Add
external_links_target_blank
,external_links_no_follow
andexternal_links_no_referrer
- Add a
smart_punctuation
option in the[markdown]
section inconfig.toml
to turn elements like dots and dashes into their typographic forms - Add iteration count variable
nth
for shortcodes to know how many times a shortcode has been invoked in a given content - Update some highlighting syntaxes and the TS syntax will now be used instead of JS due to issues with it
- Remove
zola serve --watch-only
: since we build the HTML in memory and not on disk, it doesn't make sense anymore - Update clojure syntax
- Prefer extra syntaxes to the default ones if we have a match for language
- Fix
zola serve
having issues with non-ascii paths - 404 page now gets the site default language as
lang
- Fix
zola serve
being broken on reload
- Add line highlighting in code blocks
- Fix the new
zola serve
being broken on Windows - Fix slugified taxonomies not being rendered at the right path
- Fix issues with shortcodes with newlines and read more
- All paths like
current_path
,page.path
,section.path
(except colocated assets) now have a leading/
- Search index generation for Chinese and Japanese has been disabled by default as it leads to a big increase in binary size
- Add 2 syntax highlighting themes:
green
andrailsbase16-green-screen-dark
- Enable task lists in Markdown
- Add support for SVG in
get_image_metadata
- Fix parsing of dates in arrays in
extra
- Add a
--force
argument tozola init
to allow creating a Zola site in a non-empty directory - Make themes more flexible:
include
can now be used - Make search index generation configurable, see docs for examples
- Fix Sass trying to load folders starting with
_
, causing issues with frameworks - Update livereload.js version
- Add Markdown-outputting shortcodes
- Taxonomies with the same name but different casing are now merged, eg Author and author
-
RSS feed support has been altered to allow, and default to, Atom feeds, Atom being technically superior and just as widely-supported in normal use cases.
- New config value
feed_filename
, defaulting toatom.xml
(change torss.xml
to reinstate the old behaviour) - Config value
rss_limit
is renamed tofeed_limit
- Config value
languages.*.rss
is renamed tolanguages.*.feed
- Config value
generate_rss
is renamed togenerate_feed
- Taxonomy value
rss
is renamed tofeed
Users with existing feeds should either set
feed_filename = "rss.xml"
in config.toml to keep things the same, or set up a 3xx redirect from rss.xml to atom.xml so that existing feed consumers aren’t broken. - New config value
-
The feed template variable
last_build_date
is renamed tolast_updated
to more accurately reflect its semantics -
The sitemap template’s
SitemapEntry
type’sdate
field has been renamed toupdated
to reflect that it will use theupdated
front-matter field if available, rather thandate
-
Code blocks are now wrapped in
<pre><code>
instead of just<pre>
- Add
updated
front-matter field for pages, which sitemap templates will use for theSitemapEntry.date
field instead of thedate
front-matter field, and which the default Atom feed template will use - Add
lang
to the feed template context - Add
taxonomy
andterm
to the feed template context for taxonomy feeds - Fix link checker not looking for anchor with capital id/name
- Pass missing
lang
template parameter to taxonomy list template - Fix default index section not having its path set to '/'
- Change cachebust strategy to use SHA256 instead of timestamp
- Set user agent for HTTP requests
- Add nyx-bold highlight theme
- Add lyric and subtitles highlighting
- Enable strikethrough in markdown filter
- Remove
toc
variable in section/page context and pass it topage.toc
andsection.toc
instead so they are accessible everywhere
- Add zenburn syntax highlighting theme
- Fix
zola init .
- Add
total_pages
to paginator - Do not prepend URL prefix to links that start with a scheme
- Allow skipping anchor checking in
zola check
for some URL prefixes - Allow skipping prefixes in
zola check
- Check for path collisions when building the site
- Fix bug in template extension with themes
- Use Rustls instead of openssl
- The continue reading HTML element is now a
<span>
instead of a<p>
- Update livereload.js
- Add --root global argument
- Add
--drafts
flag tobuild
,serve
andcheck
to load drafts. Drafts are never loaded by default anymore - Using
fit
inresize_image
on an image smaller than the given height/width is now a no-op and will not upscale images anymore
- Add
--open
flag to open server URL in default browser - Fix sitemaps namespace & do not urlencode URLs
- Update livereload
- Add
hard_link_static
config option to hard link things in the static directory instead of copying - Add warning for old style internal links since they would still function silently
- Print some counts when running
zola check
- Re-render all pages/sections when
anchor-link.html
is changed - Taxonomies can now have the same name in multiple languages
zola init
can now be create sites inside the current directory- Fix table of contents generation for deep heading levels
- Add
lang
in all templates context except sitemap, robots - Add
lang
parameter toget_taxonomy
andget_taxonomy_url
- Rebuild whole site on changes in
themes
changes - Add one-dark syntax highlighting theme
- Process images on changes in
zola serve
if needed after change
- Allow specifying heading IDs. It is a breaking change in the unlikely case you are using
{#..}
in your heading - Internal links are now starting by
@/
rather than./
to avoid confusion with relative links - Latest Tera version now cares about where the
safe
filter is, always put it at the end of an expression.
- Fix image processing not happening if called from the template
- Add a
zola check
command to that validates the site and checks all external links - Sections can have
aliases
as well - Anchors in internal links are now checked for existence
- Remove --base-path option, it broke
serve
on Windows and wasn't properly tested
- Strip wrapping whitespaces from shortcodes
- Sort sitemap elements by
permalink
earlier/later
andlighter/heavier
are not set anymore on pages when rendering a section- The table of content for a page/section is now only available as the
toc
variable when rendering it and not anymore on thepage
/section
variable - Default directory for
load_data
is now the root of the site instead of thecontent
directory - Change variable sent to the sitemap template, see documentation for details
- Add support for content in multiple languages
- Lower latency on serve before rebuilding from 2 to 1 second
- Allow processing PNG and produced images are less blurry
- Add an id (
zola-continue-reading
) to the paragraph generated after a summary - Add Dracula syntax highlighting theme
- Fix using inline styles in headers
- Fix sections with render=false being shown in sitemap
- Sitemap is now split when there are more than 30 000 links in it
- Add link to sitemap in robots.txt
- Markdown rendering is now fully CommonMark compliant
load_data
now defaults to loading file as plain text, unlessformat
is passed or the extension matches csv/toml/json- Sitemap entries get an additional
extra
field for pages only - Add a
base-path
command line option tobuild
andserve
- Fix deleting markdown file in
zola serve
- Fix pagination for taxonomies being broken and add missing documentation for it
- Add missing pager pages from the sitemap
- Allow and parse full RFC339 datetimes in filenames
- Live reload is now enabled for the 404 page on serve
- Gutenberg has changed name to
zola
! - The
pagers
variable of Paginator objects has been removed section.subsections
is now an array of paths to be used with theget_section
Tera function- Table of content now strips HTML from the titles to avoid various issues
gutenberg-anchor
CSS class has been renamedzola-anchor
data
is now a reserved variable name in templates, it is unused right now but might change soon.
- Many many times faster (x5-x40) for most sites
- Update dependencies, fixing a few bugs with templates
- Load only .html files in themes from the templates folder
- Background colour is set fewer times when highlighting syntaxes, resulting in smaller HTML filesize
- Link checker will not try to validate email links anymore
- Load table and footnote markdown extensions in
markdown
filter get_url
now defaults to not adding a trailing slash- Fix
--base-url
not overriding processed images URLs - Add more Emacs temp file to the ignored patterns in
gutenberg serve
- Files starting with
.
are not considered pages anymore even if they end with.md
_processed_images
folder for image processing has been renamedprocessed_images
to avoid issues with GitHub Pages- Syntax highlighting default was mistakenly
true
, it has been set tofalse
- Add NO_COLOR and CLICOLOR support for having colours or not in CLI output
- Fix
robots.txt
template not being used - RSS feed now takes all available articles by default instead of limiting to 10000
templates
directory is now optional- Add Reason and F# syntax highlighting
- Add
ancestors
to pages and sections pointing to the relative path of all ancestor sections up to the index to be used with theget_section
Tera function - Add a
load_data
Tera function to load local CSV/TOML/JSON files - Add
relative_path
to pages and sections in templates - Do not have a trailing slash for the RSS permalinks
serve
will now try to find other ports than 1111 rather than panicking- Ensure content directory exists before rendering aliases
- Do not include drafts in pagination
- Pages filenames starting by a date will now use that date as page date if there isn't one defined in frontmatter
- Accept markdown files starting with BOM
- Add a
watch-only
flag to theserve
command for when you don't want a webserver - Add
transparent
sections, for when you want to separate content by sections but want to group them at a higher level (think aposts
folder with years that want to use pagination on the index). - Add
page_template
to section front-matter for when you want to specify the template to use for every page under it - Improves to
zola serve
: now handles directories renaming
- Add assets to section indexes
- Allow users to add custom highlighting syntaxes
- Add Swift, MiniZinc syntaxes and update others
- Handle post summaries better: no more cutting references
- Fix live reload of a section content change getting no pages data
- Fix critical bug in
serve
in some OSes - Update deps, should now build and work correctly on BSDs
- Taxonomies have been rewritten from scratch to allow custom ones with RSS and pagination
order
sorting has been removed in favour of only havingweight
page.next/page.previous
have been renamed topage.later/page.earlier
andpage.heavier/page.lighter
depending on the sort method
- Fix
serve
not working with the config flag - Websocket port on
live
will not get the first available port instead of a fixed one - Rewrite markdown rendering to fix all known issues with shortcodes
- Add array arguments to shortcodes and allow single-quote/backtick strings
- Co-located assets are now permalinks
- Words are now counted using unicode rather than whitespaces
- Aliases can now be pointing directly to specific HTML files
- Add
year
,month
andday
variables to pages with a date - Fix panic when live reloading a change on a file without extensions
- Add image resizing support
- Add a 404 template
- Enable preserve-order feature of Tera
- Add an external link checker
- Add
get_taxonomy
global function to return the full taxonomy
cargo update
as some dependencies didn't compile with current Rust version- Add CMake syntax highlighting and update other syntax highlighting
- Fixed config flag in CLI
- Sitemap entries are now sorted by permalinks to avoid random ordering
- Preserve directory structure from sass folder when copying compiled css files to the public directory
- Do not require themes to have a static folder
- Now supports indented Sass syntax
- Add search index building
- Update Tera: now has
break
andcontinue
in loops - Gutenberg now creates an anchor link at the position of the
<!-- more -->
tag if you want to link directly to it - Fix many shortcode parsing issues
- Correctly copy themes shortcodes so they are useable in content
- Fix internal links not working for markdown files directly in
content
directory
- Fix
serve
command trying to read all files as markdown - Add many syntax highlighting themes
- Fix date being serialised incorrectly in page
extra
section of front-matter
- Update Tera and other dependencies
- Add option for inline (ie no
<p>...</p>
wrapping) in markdown filter - Allow to specify both interface and base_url in
gutenberg serve
for usage in Docker
- Change names of individual taxonomies to be plural (ie
tags/my-tag
instead oftag/my-tag
) - Front matter now uses TOML dates rather strings: remove quotes from your date value to fix it.
For example:
date = "2001-10-10"
becomesdate = 2001-10-10
language_code
has been renameddefault_language
in preparations of i18n support
- Add
get_taxonomy_url
to retrieve the permalink of a tag/category - Fix bug when generating permalinks for taxonomies
- Update to Tera 0.11
- Better UX on first
serve
thanks to some default templates. - Add
output-dir
tobuild
andserve
to generate the site in a folder other thanpublic
- Add Prolog syntax highlighting and update all current syntaxes
- Live reloading now works on shortcode template changes
gutenberg serve
now reloads site onconfig.toml
changes: you will need to F5 to see any changes though- Add a
trans
global function that will get return the translation of the given key for the given lang, defaulting toconfig.default_language
if not given gutenberg serve
cleans after itself and deletes the output directory on CTRL+C
- Fix shortcodes without arguments being ignored
- Fix shortcodes with markdown chars (_, *, etc) in name and args being ignored
- Fix subsections of index not being filled without a
_index.md
- Fix generated index section not found in
get_section
global function - Fix permalink generation for index page
- Add Nim syntax highlighting
- Allow static folder to be missing
- Fix shortcodes args being only passed as strings
- Add
page.components
andsection.components
that are equivalent topath.split('/')
- Expose
page.draft
in the template
- Fix
base-url
argument togutenberg build
being calledbase
- Add syntaxes: Crystal, Elixir, Kotlin
- Fix
section.subsections
not being filled correctly section.subsections
can now be sorted by aweight
attribute on a section front-matter- Do nothing on directory adding/removal in livereload
- Add back
draft
on pages that was wrongly removed - Page and Section
path
field is not starting with a/
anymore - All Tera global fns are now rebuilt on changes
- Use flags for port/interface in
gutenberg serve
- Fix various issues with headers markdown rendering
- Rename
insert_anchor
in section front-matter toinsert_anchor_links
- Remove
insert_anchor_links
from the config: it wasn't used - Add
class
variable togist
shortcode - Add reading analytics to sections content
- Add config to sitemap template
- Add
permalink
to all taxonomy items (tags & categories) - Tags in the tags page are now sorting alphabetically instead of by number of pages in them
- Remove deprecated
link
param ofget_url
- Add 1337 color scheme
- Defaults to compressed Sass output
- Fix regression wrt co-located assets slug detecting
- Rename
url
from page front-matter topath
to be consistent - Add a
base-url
flag to thebuild
command to override the URL from config.toml
- Add themes support
- Add
redirect_to
to section front matter to redirect when landing on section root page - Make
title
in config optional - Improved
gutenberg init
UX and users first experience - Make
get_url
work for any path with optional cachebusting. - Deprecates
link
param ofget_url
in favour ofpath
to be consistent
- Fix RSS feed not behaving (getzola#101)
- Parallelize all the things
- Add weight sorting
- Remove
section
from thepage
rendering context: this is too expensive. Use the global functionget_section
if you need to get it - Put back a 20 page limit on rss feed by default (configurable)
- Remove index page getting all sections: use the
get_section
global fn instead to only get the ones you need - Remove pages from pagers in pagination: they were not supposed to be there
- Add built-in Sass compilation support
- Sort individual tag/category pages by date
- Add extra builtin shortcode for Streamable videos
path
andpermalink
now end with a/
- Generate table of contents for each page
- Add
section
to a page Tera context if there is one - Add
aliases
to pages for when you are changing urls but want to redirect to the new one - Name the homepage section
index
(previously empty string)
- Fix missing serialized data for sections
- Change the single item template context for categories/tags
- Add a
get_url
and aget_section
global Tera function - Add a config option to control how many articles to show in RSS feed
- Move
insert_anchor_links
from config to being a section option and it can now be insert left or right
- Fix XML templates overriding and reloading
title
anddescription
are now optional in the front matter- Add GenericConfig, Vim, Jinja2 syntax
- Add
_index.md
for homepage as well and make that into a normal section - Allow sorting by
none
,date
andorder
for sections - Add pagination
- Add a
get_page
global function to tera - Revamp index page, no more
pages
variables - Fix livereload stopping randomly
- Smarter re-rendering in
serve
command
- Fix RSS feed link and description
- Renamed
Page::url
andSection::url
toPage::path
andSection::path
- Pass
current_url
andcurrent_path
to every template - Add id to headers to allow anchor linking
- Make relative link work with anchors
- Add option to render an anchor link automatically next to headers
- Only copy the static files that changed, not the whole directory in
gutenberg serve
- Use summary if available in RSS feed
- Add tables and footnotes support in markdown
- Add more language syntaxes
- Only load templates ending by
.html
- Add some colours in console
- Allow using a file other than config.toml for config
- Add sections to the index page context
- Fix page rendering not working when containing
+++
- Add shortcodes (see README for details)
- Allow relative links to other content in markdown links
- Add
markdown
,base64_encode
andbase64_decode
filters to the Tera instance of Gutenberg - Work on Windows!