Changelog1
Notable changes to Iconoclast will be documented here. Breaking changes are marked with a 🚩.
Iconoclast adheres to semantic versioning.
- Iconoclast's new
auto
option, if set totrue
, will have Iconoclast automatically install Font Awesome Pro whenever your MkDocs site is built.
plugins:
- iconoclast:
auto: true
- Iconoclast's new
uv
option, if set totrue
, will tell Iconoclast to prefer uv's pip interface over pip. Ifuv
can't be found in your system path, Iconoclast will fall back to pip.
# mkdocs.yml
plugins:
- iconoclast:
uv: true
- A minor spelling error.
- 🚩 Iconoclast now requires Python 3.8 or later.
- 🚩
iconoclast install
, which previous installed specified Font Awesome Kit, now installs Font Awesome Pro. - 🚩
iconoclast kit
is the new command for installing a Font Awesome Kit. - 🚩 The
iconoclast setup
command has been removed and replaced byiconoclast install
.
- Font Awesome Pro can now be installed via the new
iconoclast setup
command. This command supersedes the old, package manager-dependent, ways of installing Font Awesome Pro, which still work, but are no longer documented or supported. (Docs)
- Fixed a bug where Iconoclast might fail when determining whether
iconocards
is deprecated for the installed version of Material for MkDocs.
- The
iconocards
plugin now emits a deprecation warning on versions of Material for MkDocs where it is obsolete. - Iconoclast's warning and error messages are now visually consistent with those emitted by MkDocs.
- Fixed a bug where Iconoclast's command-line interface would fail.
🚩 fa-material is now Iconoclast. To upgrade, uninstall fa-material and install Iconoclast:
pip uninstall fa-material && pip install iconoclast
- Iconoclast now has CSS support, enabling you use Font Awesome icons in block and partial overrides. (Docs)
- Iconoclast now supports Font Awesome Kits, allowing you to seamlessly bring your own custom icons to Material for MkDocs. (Docs)
- 🚩 Iconoclast's plugin is now named
iconoclast
. - 🚩 Support for Font Awesome 5 has been removed. Iconclast supports Font Awesome 6 only.
- 🚩 The
version
configuration option has also been removed.
- 🚩 The
-
fa-material now supports Font Awesome 5 (it previously only supported Font Awesome 6). To use Font Awesome 5, set the
version
option of thefontawesome-pro
plugin to5
(the default is6
).plugins: - fontawesome-pro: version: 5
- fa-material's Python version constraint has been relaxed to 3.7+.
This is the initial release of fa-material.
Footnotes
-
Based on Keep a Changelog ↩