# Changelog ## 0.15.2 (2021-12-10) - Fix HTML shortcodes ## 0.15.1 (2021-12-08) - Fix markdown shortcodes not being rendered correctly - Fix config data not getting to the templates ## 0.15.0 (2021-12-05) - 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 the `lang` context - Add prompt before replacing the output directory with `zola build` if the `output-dir` flag is given - Shortcode handling has been completely rewritten, solving many issues - Also add internal links starting with `#` without any internal Zola link ## 0.14.1 (2021-08-24) - 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 the `section` variable in templates ## 0.14.0 (2021-07-19) ### Breaking - 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 needed - `get_file_hash` now has the `base64` option set to `true` by default (from `false`) 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 1. taxonomies don't have a `lang` anymore in the config, you need to declare them in their respective language section 2. the `config` variable in templates has been changed and is now a stripped down language aware version of the previous `config` object 3. Search settings are now language specific 4. Translations are now nested in the languages table - Paths unification: 1. `get_url` does not load automatically from the `static` folder anymore 2. New path resolving logic for all on-disk files: replace `@/` by `content/`, trim leading `/` and search in $BASE_DIR + $path, $BASE_DIR + static + $path and $BASE_DIR + content + $path 3. `get_file_hash` now returns base64 encoded hash by default 4. all functions working on files can now only load files in the Zola directory 5. `resize_image` return value has changed 6. `page.assets` now start with a `/` to match `section.assets` and other paths ### Other - Internal links are now resolved in the `markdown` filter in the templates (#1296 #1316) - Add a `required` argument to `load_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` and `get_taxonomy_url` are now marked as safe, no need to call `| safe` on their output - Add `allow_missing` optional argument to `get_image_metadata` to not error if the file is not found - Add `permalink` to `Taxonomy` in templates - Syntax highlighting improvements, see documentation for details on each 1. Add CSS class based syntax highlighting 2. Allow hiding specific lines 3. Allow showing line numbers ## 0.13.0 (2021-01-09) - Enable HTML minification - Support `output_dir` in `config.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 `` block and as `data-lang` - Add bibtex to `load_data` - Add a `[markdown]` section to `config.toml` to configure rendering - Add `highlight_code` and `highlight_theme` to a `[markdown]` section in `config.toml` - Add `external_links_target_blank`, `external_links_no_follow` and `external_links_no_referrer` - Add a `smart_punctuation` option in the `[markdown]` section in `config.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` ## 0.12.2 (2020-09-28) - Fix `zola serve` being broken on reload ## 0.12.1 (2020-09-27) - 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 ## 0.12.0 (2020-09-04) ### Breaking - 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 ### Other - Add 2 syntax highlighting themes: `green` and `railsbase16-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 to `zola 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 ## 0.11.0 (2020-05-25) ### Breaking - 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 to `atom.xml` (change to `rss.xml` to reinstate the old behaviour) - Config value `rss_limit` is renamed to `feed_limit` - Config value `languages.*.rss` is renamed to `languages.*.feed` - Config value `generate_rss` is renamed to `generate_feed` - Taxonomy value `rss` is renamed to `feed` 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. - The feed template variable `last_build_date` is renamed to `last_updated` to more accurately reflect its semantics - The sitemap template’s `SitemapEntry` type’s `date` field has been renamed to `updated` to reflect that it will use the `updated` front-matter field if available, rather than `date` - Code blocks are now wrapped in `
` instead of just `
`

### Other
- Add `updated` front-matter field for pages, which sitemap templates will use for the `SitemapEntry.date` field instead of the `date` front-matter field, and which the default Atom feed template will use
- Add `lang` to the feed template context
- Add `taxonomy` and `term` 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

## 0.10.1 (2020-03-12)

- Set user agent for HTTP requests
- Add nyx-bold highlight theme
- Add lyric and subtitles highlighting
- Enable strikethrough in markdown filter

## 0.10.0 (2020-02-17)

### Breaking
- Remove `toc` variable in section/page context and pass it to `page.toc` and `section.toc` instead so they are
accessible everywhere

### Other
- 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 `` instead of a `

` - Update livereload.js - Add --root global argument ## 0.9.0 (2019-09-28) ### Breaking - Add `--drafts` flag to `build`, `serve` and `check` to load drafts. Drafts are never loaded by default anymore - Using `fit` in `resize_image` on an image smaller than the given height/width is now a no-op and will not upscale images anymore ### Other - 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 to `get_taxonomy` and `get_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 ## 0.8.0 (2019-06-22) ### Breaking - 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. ### Other - 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 ## 0.7.0 (2019-04-28) ### Breaking - Remove --base-path option, it broke `serve` on Windows and wasn't properly tested ### Other - Strip wrapping whitespaces from shortcodes - Sort sitemap elements by `permalink` ## 0.6.0 (2019-03-25) ### Breaking - `earlier/later` and `lighter/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 the `page`/`section` variable - Default directory for `load_data` is now the root of the site instead of the `content` directory - Change variable sent to the sitemap template, see documentation for details ### Other - 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, unless `format` 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 to `build` and `serve` ## 0.5.1 (2018-12-14) - 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 ## 0.5.0 (2018-11-17) ### Breaking - 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 the `get_section` Tera function - Table of content now strips HTML from the titles to avoid various issues - `gutenberg-anchor` CSS class has been renamed `zola-anchor` - `data` is now a reserved variable name in templates, it is unused right now but might change soon. ### Others - 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 renamed `processed_images` to avoid issues with GitHub Pages - Syntax highlighting default was mistakenly `true`, it has been set to `false` - 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 the `get_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 the `serve` 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 a `posts` 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 ## 0.4.2 (2018-09-03) - 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 ## 0.4.1 (2018-08-06) - 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 ## 0.4.0 (2018-08-04) ### Breaking - Taxonomies have been rewritten from scratch to allow custom ones with RSS and pagination - `order` sorting has been removed in favour of only having `weight` - `page.next/page.previous` have been renamed to `page.later/page.earlier` and `page.heavier/page.lighter` depending on the sort method ### Others - 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` and `day` 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 ## 0.3.4 (2018-06-22) - `cargo update` as some dependencies didn't compile with current Rust version - Add CMake syntax highlighting and update other syntax highlighting ## 0.3.3 (2018-03-29) - 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` and `continue` in loops - Gutenberg now creates an anchor link at the position of the `` 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 ## 0.3.2 (2018-03-05) - 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 ## 0.3.1 (2018-02-15) - Update Tera and other dependencies - Add option for inline (ie no `

...

` wrapping) in markdown filter - Allow to specify both interface and base_url in `gutenberg serve` for usage in Docker ## 0.3.0 (2018-01-25) ### Breaking - Change names of individual taxonomies to be plural (ie `tags/my-tag` instead of `tag/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"` becomes `date = 2001-10-10` - `language_code` has been renamed `default_language` in preparations of i18n support ### Others - 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` to `build` and `serve` to generate the site in a folder other than `public` - Add Prolog syntax highlighting and update all current syntaxes - Live reloading now works on shortcode template changes - `gutenberg serve` now reloads site on `config.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 to `config.default_language` if not given - `gutenberg serve` cleans after itself and deletes the output directory on CTRL+C ## 0.2.2 (2017-11-01) - 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` and `section.components` that are equivalent to `path.split('/')` - Expose `page.draft` in the template ## 0.2.1 (2017-10-17) - Fix `base-url` argument to `gutenberg build` being called `base` - Add syntaxes: Crystal, Elixir, Kotlin ## 0.2.0 (2017-10-05) - Fix `section.subsections` not being filled correctly - `section.subsections` can now be sorted by a `weight` 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 to `insert_anchor_links` - Remove `insert_anchor_links` from the config: it wasn't used - Add `class` variable to `gist` 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 of `get_url` - Add 1337 color scheme - Defaults to compressed Sass output - Fix regression wrt co-located assets slug detecting - Rename `url` from page front-matter to `path` to be consistent - Add a `base-url` flag to the `build` command to override the URL from config.toml ## 0.1.3 (2017-08-31) - Add themes support ## 0.1.2 (2017-08-10) - 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 of `get_url` in favour of `path` to be consistent ## 0.1.1 (2017-07-16) - Fix RSS feed not behaving (https://github.com/Keats/gutenberg/issues/101) ## 0.1.0 (2017-07-14) - Parallelize all the things - Add weight sorting - Remove `section` from the `page` rendering context: this is too expensive. Use the global function `get_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 ## 0.0.7 (2017-06-19) - Sort individual tag/category pages by date - Add extra builtin shortcode for Streamable videos - `path` and `permalink` 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) ## 0.0.6 (2017-05-24) - Fix missing serialized data for sections - Change the single item template context for categories/tags - Add a `get_url` and a `get_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 ## 0.0.5 (2017-05-15) - Fix XML templates overriding and reloading - `title` and `description` 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` and `order` 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 ## 0.0.4 (2017-04-23) - Fix RSS feed link and description - Renamed `Page::url` and `Section::url` to `Page::path` and `Section::path` - Pass `current_url` and `current_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` ## 0.0.3 (2017-04-05) - 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` and `base64_decode` filters to the Tera instance of Gutenberg - Work on Windows!