Mkdocs-publisher

Meta

- ✅ hidden pages not being hidden when in a hidden directory
- ✅ missing title warning display when file is an overview
- ✅ links normalization
- ✅ cross plugins errors when one of the plugins is disabled

---

> [!note]
> ❎ - added ✅ - fixed ♻️ - changed 🚫 - removed

General

- ❎ added internal ConfigChoicesEnum class for defining config choices
- ❎ added code coverage badge with current coverage % value
- ✅ documentation fixes [61](https://github.com/mkusz/mkdocs-publisher/issues/61)
- ✅ ruff linter settings
- ♻️ isort has been replaced with [ruff](https://github.com/astral-sh/ruff)
- ♻️ assert in unit tests changed to [pytest-check](https://github.com/okken/pytest-check) to use soft assertion functionality

Meta

- ❎ adding an overview functionality [overview](https://mkusz.github.io/mkdocs-publisher/setup/general/pub-meta/#overview-file)
- ❎ slug auto generation if missing in file meta-data ([63](https://github.com/mkusz/mkdocs-publisher/issues/63))
- ♻️ plugin rewrite + add unitttest

Obsidian

- ✅ fix for backlinks destroying links additional attributes like title and anchor
- ♻️ some code simplification and cleanup because of meta plugin rewrite

Debugger

- ❎ live reload time stamp removed from log message when [show_entry_time](https://mkusz.github.io/mkdocs-publisher/setup/development/pub-debugger/#+debugger.console.show_entry_time) setting is enabled (it's default value)
- ❎ adding possibility to remove deprecation warnings when [show_deprecation_warnings](https://mkusz.github.io/mkdocs-publisher/setup/development/pub-debugger/#+debugger.console.show_deprecation_warnings) setting is disabled (it's default value)

---

> [!note]
> ❎ - added ✅ - fixed ♻️ - changed 🚫 - removed

Obsidian

- ❎ support for comments syntax (issue 46)
- ✅ links for file names with space (issue 55)

Minifier

- ❎ setting for file extensions
- ❎ setting for file exclusion (issue 51)
- ❎ setting for enabling cache (issue 52)
- ✅ extensions are no longer case-sensitive
- ✅ minified file detection is no longer case-sensitive

---

> [!note]
> ❎ - added ✅ - fixed ♻️ - changed 🚫 - removed

General

- ❎ license info added to all project files
- ❎ code coverage
- ❎ unit test to part of the code (journey begins)
- ♻️️ flake8 linter has been replaced with [ruff](https://github.com/astral-sh/ruff)
- ♻️️ internal code refactoring and simplifications
- ♻️️ project dependencies has been separated into 3 groups: **general**, **test** and **dev**
- ♻️️ main project dependencies has been updated:
- `mkdocs >= 1.5.3`
- `mkdocs-material >= 9.4.3`

Blog

- ✅ relative links are fixed
- ✅ metadata key `status` collision with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/reference/#setting-the-page-status) (`>= 9.20`) solved by renaming to `publish` (the same value as in [Obsidian.md](https://help.obsidian.md/Obsidian+Publish/Publish+and+unpublish+notes#Automatically+select+notes+to+publish))
- ✅ `temp_dir` default value changed to `.pub_blog_temp`

Meta

- ✅ metadata key `status` collision with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/reference/#setting-the-page-status) (`>= 9.20`) solved by renaming to `publish` (the same value as in [Obsidian.md](https://help.obsidian.md/Obsidian+Publish/Publish+and+unpublish+notes#Automatically+select+notes+to+publish))

Minifier

- ✅ `cache_dir` default value changed to `.pub_min_cache`

Obsidian

- ✅ links and wiki links are fixed

Debugger

- ✅ configuration warnings are now captured and can be part of the log file and new console log look & feel

---

> [!note]
> ❎ - added ✅ - fixed ♻️️ - changed 🚫 - removed

General

- ♻️ rename of directory with documentation files
- ♻️ Python libraries update
- ♻️ project naming unification
- ♻️ pre-commit JSON check and obsidian file exclusion
- ♻️ some links updates in documentation
- ♻️ code type hinting updates
- ♻️ logger names unification - it's related to pub-debugger plugin
- ♻️ code refactor and cleanup
- 🚫 drop `python-frontmatter` from Python libraries

Blog

- ✅ minor fix for internal linking (still not full solution)
- ✅ deprecated warning regarding `importlib.resources`

Minifier

- ♻️ small code reformat related to shared library changes
- ♻️ files are not minified when using `mkdocs serve` (this is default behavior, but it can be changed)

Meta

- ❎ possibility to declare whole directory as hidden
- ❎ more logging messages
- ❎ better support for `pub-obsidian` plugin (template and obsidian directory are now always drafts)
- ✅ error with reading `README.md` when no empty line at the end of file
- ✅ adding again the same directory to draft directories when using `mkdocs serve`

Obsidian

- ✅ minor fix for internal linking (still not full fix)
- ✅ fix for preserving new line in callouts

Debugger (new plugin)

- ❎ console log reformatting with configuration
- ❎ logging into `*.log` file with configuration
- ❎ added old log file replacement
- ❎ ZIP file creation with log output and some additional files

---

> [!note]
> ❎ - added ✅ - fixed ♻️️ - changed 🚫 - removed

General

- ❎ internal class for HTML modifications
- ❎ project logo
- ♻️ project license to MIT
- ♻️ project `README.md` cleanup
- ♻️ internal method for importing other plugin config (needed for cross functionalities)

Auto-nav (plugin removed)

The whole functionality of this plugin has been moved to a new Meta plugin.

Blog

- ❎ exclude from search blog posts teaser/index, category, tag or archive pages
- ❎ post publication state (provided by Meta plugin)
- ✅ internal links for blog posts teaser/index, category, tag or archive pages
- 🚫 removed `edit_url` for blog teaser/index, category, tag or archive pages
- ♻️ automatic detection of the blog as starting page (config value for this setting was removed)

Social

- ♻️ code refactor of HTML modification elements and logging added

Meta (new plugin)

This plugin is a Swiss army knife that helps a lot with various tasks related to publication, SEO, etc. Take a look at the below changelog to see what is offered by this plugin.

- ❎ build navigation based on file names order
- ❎ set multiple document parameters by using its metadata:
- `title` - document title
- `slug`- URL of the document
- `status` - document publication status (published, hidden, draft)
- `date` - document creation date
- `update` - document last update date (used for sitemap and SEO optimizations)
- ❎ directory metadata and additional settings can be set in a frontmatter of `*.md` file (default to `README.md`):
- possibility to define `slug`(this affects only the directory where `README.md` is placed)
- possibility to define `skip_dir`(this affects only the directory and all subdirectories where the file is located)
- possibility to define `hidden_dir`(this affects only the directory and all subdirectories where the file is located)

Obsidian (new plugin)

This plugin is a set of functionalities and should be split into various smaller plugins, but due to some cross functionalities, it has been integrated into the bigger one. Each sub plugin can be controlled separately, so if you don't need all the functionalities, you can just disable them or simply do not enable one that are disabled by default.

General

- ❎ server watch can omit `.obsidian` directory that needs to be a part of the documentation directory that is automatically added into watch and causes server reload on (almost) any interaction with obsidian (changing settings etc.)

Links

- ❎ support for wiki links format for images and internal links
- ❎ configurable image lazy loading option (SEO optimization)
- ❎ documents and images file path solver (it doesn't affect documentation, but it's required by MkDocs for proper links generation)

Callouts

- ❎ mapping of all Obsidian callouts into Markdown admonitions

Backlinks

- ❎ auto-generation of backlinks for all internal documents (visible as a custom admonition at the bottom of the page)
- ❎ backlinks are not generated for blog temporary files like post indexes, archive, tags and categories
- ❎ backlinks are grouped per page like in Obsidian (if more than one link is pointing from one page to another, all context links will be visible)

Charts

- ❎ support for *vega* and *vega-lite* charts when added by [Vega Visualization Plugin for Obsidian](https://github.com/Some-Regular-Person/obsidian-vega)

---

> [!note]
> ❎ - added ✅ - fixed ♻️️ - changed 🚫 - removed