Admonition Support | Translation Updates | Bug Fixes and Performance Improvements
This update to Zettlr brings three major improvements and changes alongside a mix of various performance improvements. Most importantly, we are proud to announce that Zettlr now has support for admonitions! Then, we have received numerous updates to translations from our community so that the localized support is now much better — shoutout to the various community members who made this a reality. Check out the new contributors at the end of this changelog. Lastly, we have changed a long-standing severe logical bug in the search functionality.
Please make sure to thoroughly read this changelog before updating so that you know what's coming. We have also taken the time to write a long release note over on the Zettlr blog introducing all of these changes and explaining the admonition syntax in depths. So head over to the blog and get to know everything that's new in this version.
Happy writing!
Do you enjoy Zettlr? Then consider making a donation to help us pay for the development costs. You can donate monthly on Patreon or once via PayPal. Additionally, you can directly sponsor Hendrik Erz on GitHub or send a tip on Ko-Fi. Thanks for your support!
Changelog
Admonitions
After more than six years in the making, we are proud to announce admonitions as
a new feature for Zettlr. The app now supports the more and more common syntax
that GitHub and other Markdown editors already support, using Blockquotes with a
custom header. You can create notes, tips, warnings, important blocks,
and caution blocks like so:
[!note] This is the note's title
This is the content of the note.
The title after the keyword is optional, and you can use both uppercase keywords
and lowercase keywords.
Zettlr comes with a built-in renderer so that you can immediately see what the
admonitions might look like upon export (note that the final styling depends on
the export option chosen and support for this type of element). The renderer can
be enabled or disabled exactly like the existing renderers.
When you "copy" a selection that contains an admonition using the "with style"
option, Zettlr will transform the admonition correctly, but whether the
admonition retains its styles depend on the application into which you paste
this code.
Note that admonition support upon exporting requires the alerts extension. You
can enable it manually in your export profile configuration, or enforce support
(where available) via the export settings.
Deprecation Note: Dropping Support for OS Versions in Next Release
This is the last Zettlr release shipping with Electron version 43. The next
release will switch to Electrion version 44, which drops support for the
following operating systems:
- Ubuntu 17.04 or earlier
- macOS 12 (Monterey)
Please make sure to update your operating system before the next version of
Zettlr ships if you are affected by this change.
GUI and Functionality
- Feature: Admonitions are here! Zettlr now supports a broad range of
admonitions (sometimes also referred to as alerts or callouts). You can use
admonitions to emphasize certain content in your documents using Blockquote
syntax with a special header (see PR. #6497 for details). This closes a long-
standing feature request (#532). Some notes:
- Admonitions come with support of five keywords: note (gray), tip
(green), warning (yellow), important (purple), and caution (red).
- Zettlr supports custom titles for admonitions (full compatibility with other
popular Markdown editors).
- The app ships with a renderer for admonitions that you can turn on and off
just like any other renderer.
- Note that, to make admonitions survive exports, you will need to enable the
alerts-extension of Pandoc in the reader of the profile in question.
- Zettlr will use similar HTML-syntax when you copy text with admonitions
using the "Copy with Styles" option, but whether this survives pasting into
other applications depends on support on their side.
- Feature: You can now choose whether you want to automatically accept the
selected autocomplete suggestion when pressing Tab, Enter, both, or
disable automatic accepting entirely (#6485).
- Change: The old mark setting has been replaced by a new settings
category that enforces support for several Pandoc extensions during export. If
you have disabled the mark support in the import/export settings previously,
you will need to disable this again after updating Zettlr.
- Change: Fixed a fundamental issue with the full-text search that would
turn AND-searches implicitly into OR searches. If you relied on how
the full-text search actually worked, and not how it was described in the
documentation, you will now have to explicitly add pipe-operators (|)
between your search terms to mark them as alternatives. By default, the full-
text search now requires all operators separated by a space to be present in a
file to be considered a valid result (#6517).
- New Translation: Zettlr now ships with an additional language:
Azerbaijani. See PR #6548 for details.
- Improved the custom title bar style on both Linux (if native appearance is
turned off) and Windows. Here's what changed:
- The logo is now an actual element rather than background, and has been
scaled down to better fit into the menu bar.
- The window controls now use a transparent background and a light/dark color
depending on which theme the app is currently using.
- Improved the spacing around the menu items to make them less menacing.
- Fixed the about window's debug tab: No more horizontal scrolling, and the
PATH-variable is properly split into segments.
- Fixed some alignment issues with custom symbols on toolbar buttons; now the
buttons should all be properly centered.
- Fixed an issue where in some places instead of showing you a proper file
title, the app would default to only showing you the filename, and neither a
heading or YAML title, if you specified it as such. Now, the logic has been
centralized and everywhere you expect a proper file title it should now show
you one (see #6471).
- Set default mode for LanguageTool to standard for new installations. If you
prefer picky, simply set it accordingly.
- Fixed an issue where configuration changes emitted from the onboarding dialog
for new users were one-way-only, with no way to undo the changes. This has now
been changed: the buttons accurately reflect the actual configuration state,
and pressing the buttons multiple times toggles between the two sets of
suggested settings (#6429).
- Update translations:
- ko-KO (#6478).
- de-DE.
- ja-JP (#6480).
- ca-ES (#6530).
- pt-BR (#6537).
- tr-TR (#6533).
- az-AZ (#6548).
- Renamed "Remove line breaks" to "Remove excess line breaks."
- Fixed an issue in full text search where multiple search terms separated by
whitespace would use an 'OR' operator rather than the documented 'AND'
operator. Now, search terms separated by whitespace correctly use the 'AND'
operator (#6517).
- Fixed an issue that prevented inserting a new row when the cursor is placed in
the final row of the table (#6512; #6513).
Under the Hood
- Update Electron to v43.6.0.
- Zettlr now checks whether a Pandoc extension it seeks to enable during export
is actually supported by the reader to avoid errors when, e.g., using the
commonmark reader which does not support the mark extension.
- Updates to the translations are now deterministic (#6538). This causes minimal
diffs between iterations and should also reduce the risks for merge conflicts
between open translation PRs and POT update PRs.
New Contributors
- @JasonCutter made their first contribution in https://github.com/Zettlr/Zettlr/pull/6478
- @samuelnello made their first contribution in https://github.com/Zettlr/Zettlr/pull/6530
- @laurentbrunetm made their first contribution in https://github.com/Zettlr/Zettlr/pull/6518
- @bay0rdek made their first contribution in https://github.com/Zettlr/Zettlr/pull/6533
- @xtqqczze made their first contribution in https://github.com/Zettlr/Zettlr/pull/6488
- @atirna made their first contribution in https://github.com/Zettlr/Zettlr/pull/6513
- @jamalkamaladdin made their first contribution in https://github.com/Zettlr/Zettlr/pull/6548
Full Changelog: https://github.com/Zettlr/Zettlr/compare/v4.7.0...v4.8.0
