All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Improve the
cards
plugin to automatically use cards' titles for thealt
property of their images, whenalt
is not specified. See #63, reported by @Valerie-ts.
- Show event description in Gantt diagrams, by @changbowen
- Add possibility to configure months time format in Gantt diagrams, by @yasamoka
- Adds support for running tests using Python 3.12, and adds Python 3.12 to the
build matrix. Note: only tests code did not support Python 3.12 because it
used
pkg_resources
.
- Unpins the dependencies on
mkdocs
andhttpx
, to fix #42.
- Adds support for icons in cards (by @Andy2003).
- Adds support for anchors with target="_blank" in cards.
- Fixes detail in the
contribs
plugin: when the name is specified for a contributor by email address, it is used. - Improves
pyproject.toml
. - Adds
py.typed
files.
- Improves the
contribs
plugin, adding the possibility to document contributors for a page also using.txt
files close to.md
files. This can be useful in several cases: -
- To document contributors who worked outside of Git, for example when providing pictures for the page, or written content provided to someone who is adding content to the MkDocs site.
-
- To document contributors following a Git history re-write
- Improves the
contribs
plugin, adding the possibility to exclude files by glob patterns (fix #33). - Improves the
contribs
plugin, adding the possibility to merge contributors by name, for scenarios when the same person commits using different names (Git reports different contributors in such cases) and it is preferred displaying information aggregated as single contributor.
- Adds the possibility to specify a
class
for the root HTML element ofcards
. - Fixes a bug in the
contribs
plugin (adds a carriage return before the contribution fragment). - Modifies the packages to group all extensions under
neoteroi.mkdocs
namespace. - Replaces
setup.py
withpyproject.toml
.
- Corrects the pattern handling name and email for the
contribs
plugin. - Adds tests for the
contribs
plugin.
- Corrects bug in the
contribs
plugin, causing failures in certain CI/CD solutions and improves its safety and performance (removesshell=True
!). - Adds option to apply a class to specific contributors, for simpler styling.
- Minor improvements to styles.
- Improves the
contributors
plugin: -
- Adds the possibility to exclude contributor information (for example to not display contributions from bots)
-
- Adds the possibility to merge contributors' information for cases in which the same person commits using two different email addresses
-
- Adds the possibility to display an element with the count of contributors
- Resolves a small issue in pip package resolution
- Improves the Gantt extension:
-
- now supports multiple periods in the same row
-
- now supports activities using the start date from the previous activity (automatic dates)
- Adds a contributors plugin (
neoteroi.contribs
) to display contributors' information in each page, obtaining information from the Git repository at build time ⭐
- Adds common classes to enable custom extensions reading configuration from:
-
- YAML, JSON, or CSV embedded in the markdown source
-
- YAML, JSON, or CSV fetched from a URL at build time (simple HTTP GET), with the option to define a custom fetcher for example for use cases that require authentication
- Adds the
Cards
extension, to render cards - Adds the
Timeline
extension, to render timelines - Adds the
Projects
extension, with a control to renderGantt
diagrams ✨ - Adds the link to the documentation site
- Drops support for Python 3.7 in the build pipeline (code might still work but is not ensured)
- Adds support for OAD specification organized in different files (fix #5)
- Improves
mkdocsoad.css
- Fixes a bug in
setup.py
(#4) - Fixes entry_points related but (#7)
- Publishes the first extension for Python Markdown of the repository:
spantable
, custom Markdown table with support forcolspan
androwspan
- Improves the support for Material for MkDocs themes in
mkdocsoad
- First release with plugin for OpenAPI Documentation