Features¶

• Trace template usage when an environment variable NIKOLA_TEMPLATES_TRACE is set to any non-empty value.

• Give user control over the raw underlying template engine (either mako.lookup.TemplateLookup or jinja2.Environment) via an optional conf.py method TEMPLATE_ENGINE_FACTORY.

• Switch to pyproject.toml

• Add path handler slug_source linking to source of post.

Bugfixes¶

• Ignore errors in parsing SVG files for shrinking them, copy original file to output instead (Issue #3785)

• Restore annotation_helper.tmpl with dummy content - fix themes still mentioning it (Issue #3764, #3773)

• Fix compatibility with watchdog 4 (Issue #3766)

• nikola serve now works with non-root SITE_URL.

• Stack traces meaningless for end users now more reliably suppressed (Issue #3838).

Other¶

• Changed filter for tidy from tidy5 to tidy.

Features¶

• Support passing --poll to nikola auto to better deal with symlink farms.

Bugfixes¶

• Remove insecure HTTP fallback from nikola plugin

• Fix the nikola plugin command not working (Issue #3736, #3737)

• Fix nikola new_post --available-formats crashing with TypeError (Issue #3750)

• Fix the new plugin manager not loading plugins if the plugin folder is a symlink (Issue #3741)

• Fix the nikola plugin command not working (Issue #3736)

• Remove no longer used leftovers of annotations support (Issue #3764)

Other¶

• Nikola now requires Python 3.8 or newer.

• Nikola has adopted a policy for Python version support, promising support for versions supported by the Python core team, Ubuntu LTS, or Debian stable, and taking into consideration Debian oldstable and PyPy.

• Remove polyfill from polyfill.io.

Features¶

• Implement a new plugin manager from scratch to replace Yapsy, which does not work on Python 3.12 due to Python 3.12 carelessly removing parts of the standard library (Issue #3719)

• Support for Discourse as comment system (Issue #3689)

Bugfixes¶

• Fix loading of templates from plugins with __init__.py files (Issue #3725)

• Fix margins of paragraphs at the end of sections (Issue #3704)

• Ignore .DS_Store files in listing indexes (Issue #3698)

• Fix baguetteBox.js invoking in the base theme (Issue #3687)

• Fix development (preview) server nikola auto for non-root SITE_URL, in particular when URL_TYPE is full_path. (Issue #3715)

For plugin developers¶

Nikola now requires the .plugin file to contain a [Nikola] section with a PluginCategory entry set to the name of the plugin category class. This was already required by plugins.getnikola.com, but you may have custom plugins that don’t have this set.

Features¶

• Add a -q, --ignore-query-strings option to ignore query strings for internal links, allowing their use for cache busting

• Update reST stylesheets (Issue #3657)

• Add a --timeout parameter to the check plugin, defaulting to 30s. (Issue #3643)

• GZIP compression is now deterministic for automatic deploys (Issue #3650)

Bugfixes¶

• Fix failures to build with a "Document is empty" error in default themes (Issue #3679)

• Fix PAGE_INDEX skipping generation when there exists a conflicting post

• Fix RSS generation of galleries containing WebP images, which caused an unhandled exception due to not having a known MIME type (Issue #3671)

• Fix auto command infinite loop (Issue #3677)

• Fix API URL in CSS and JS minifiers (Issue #3658)

• Fix :align: center for images in reST (Issue #3657)

• GZIP_COMMAND parsing on win32 platforms (Issue #3649)

Features¶

• Add emphasize_lines directive to code blocks (Issue #3607)

• Gallery index pages support the status flag (Issue #3598)

• Add start_at option to youtube directive (Issue #3603)

Bugfixes¶

• Add data files to dependency file (Issue #3608)

• Compatibility with doit 0.36.0 (Issue #3612)

Note: nikola doit_auto is not available if using doit>=0.36.0. You can still use nikola auto.

Features¶

• Add category_titles, category_descriptions, tag_titles, tag_descriptions to default context of tags page (Issue #3584)

• Add Maori translation

• Add Occitan translation

• New auto_command_starting signal when nikola auto is starting

• typogrify_custom filter adds a default value for typogrify_filters so that ignore_tags can be specified as the only option.

• The default ignore_tags are appended to the user-supplied ignore_tags added via typogrify_custom.

• Allow adding comment systems from a plugin (Issue #3544)

• New CommentSystem plugin category (Issue #3544)

Bugfixes¶

• Fix changes to INDEX_READ_MORE_LINK and FEED_READ_MORE_LINK not triggering rebuilds

• Make CATEGORY_TITLES, CATEGORY_DESCRIPTIONS, TAG_TITLES, TAG_DESCRIPTIONS translatable settings for consistency (Issue #3584)

• Fix bug with posts after the first one appearing shifted due to a <div> closed too early (Issue #3573, #3564)

• Fix support for files outside of site root directory on Windows

• Support passing --backend and --db-file to nikola auto

• Support blank values in certain WordPress-imported structures (Issue #3535)

• Typogrify ignores div elements with .math CSS class. (Issue #3512)

• Adjust panorama aspect ratio to 3:1 and document behaviour.

Features¶

• Provide the full GLOBAL_CONTEXT to the post list shortcode plugin (Issue #3481)

• Add BasePlugin.register_auto_watched_folder()

• Allow different PANDOC_OPTIONS values based on input extensions by specifying a dict of {".extension": [options]} (Issue #3492)

• Allow boolean/integer pretty_url post meta values in YAML/TOML (Issue #3503)

Bugfixes¶

• Fix an UnboundLocalError crash in nikola deploy (Issue #3479)

Other¶

• For nikola github_deploy, the ghp-import PyPI package is now recommended instead of ghp-import2. Both versions should work, but you can’t have both installed at the same time. (Issue #3499)

Features¶

• Support for multiple authors per post — comma-separated, enabled by MULTIPLE_AUTHORS_PER_POST setting (Issue #3252)

• Add navbar_custom_bg theme option to bootstrap4 and document options for bootstrap4 better (Issue #3443)

• Add Marathi translation

• Restore caps typogrify filter (wraps strings of capital letters with <span class="caps"> (via Issue #3405)

• Improve nikola auto performance with rate-limiting, support -n argument to pass to nikola build (Issue #3401)

• Add support for the Utterances comment system

Bugfixes¶

• Fix previewimages (post- and root-relative) in bootblog4/galleries featured posts for non-server-root sites (Issue #3471)

• Windows: Also fix symlinks when installing from source with pip; if possible, enable Developer Mode and run git config --global core.symlinks true before cloning the Nikola repo

• Fix clicking on links to image files. baguetteBox now requires a link (<a>) to have an <img> as a child in order to make the link activate the lightbox. (Issue #3472)

• Fix LINK_CHECK_WHITELIST having issues due to mixing Unicode and bytestrings (Issue #3466)

• Add support for nbconvert>=6.0.0 (Issue #3457)

• Read files as utf-8-sig to allow BOM in input files

• Don’t break slugs with slashes in doc directive (Issue #3450)

• Avoid warnings from type annotations in auto caused by missing aiohttp (Issue #3451)

• Ensure query strings and fragments are kept with URL_TYPE = "full_path" (Issue #3448)

• Don’t run typogrify filters on <title> tag to avoid adding extra tags (Issue #3405)

• Fix handling of duplicate plugins on Windows

• Allow else clause in post-list plugin. (Issue #3436)

• Ensure type metadata value from plugins is preserved (Issue 3445)

• Fix path handlers with slashes on Windows