# Publisher for MkDocs
[](https://opensource.org/license/mit/)
[](https://pypi.org/project/mkdocs-publisher/)
[](https://www.python.org)
[](https://pypistats.org/search/mkdocs-publisher)
[](https://github.com/mkusz/mkdocs-publisher/commits/main)
[](https://github.com/pre-commit/pre-commit)
Publisher for [MkDocs](https://www.mkdocs.org/) is a set of plugins that helps with content creation and publication.
## Features
- [pub-meta](https://mkdocs-publisher.github.io/setup/general/pub-meta/) – support for:
- automatic [document navigation](https://www.mkdocs.org/user-guide/configuration/#nav) creation based on file names order,
- document publication status,
- possibility to define document and directories URL (good for SEO),
- document creation and update date (good for SEO),
- [pub-blog](https://mkdocs-publisher.github.io/setup/general/pub-blog/) – blogging capability:
- index creation,
- support for blog post teasers,
- automatic creation of pages for archive, categories and tags,
- [pub-obsidian](https://mkdocs-publisher.github.io/setup/general/pub-obsidian/) – bindings for [Obsidian.md](https://obsidian.md) that allows you to use:
- [backlinks](https://help.obsidian.md/Plugins/Backlinks),
- [callouts](https://help.obsidian.md/Editing+and+formatting/Callouts),
- [wikilinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links),
- [vega charts](https://vega.github.io/vega/) (using [Vega Visualization Plugin for Obsidian](https://github.com/Some-Regular-Person/obsidian-vega)) - advanced solution for creating charts,
- [pub-social](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-social/) – social cards for social media sharing using document metadata,
- [pub-minifier](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-minifier/) – file size optimization (good for SEO and overall page size optimization),
- [pub-debugger](https://mkdocs-publisher.github.io/setup/development/pub-debugger/) – logging on steroids with the possibility of creating of ZIP file with logs and additional information (can be used for better issue reporting).
## Installation
```commandline
pip install mkdocs-publisher
```
More information about installation methods and plugin setup can be found on this [documentation page](https://mkdocs-publisher.github.io/setup/installation/).
> [!warning]
> Before any use, make sure you have a backup of your data.
> [!note]
> As a base for any development, [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) theme was used. If you are willing to use any other theme, you may (or may not) face some issues. If this happens, please submit an [issue](https://github.com/mkdocs-publisher/mkdocs-publisher/issues).
After installation, you have to enable plugins and Material for MkDocs theme in `mkdocs.yml` file:
```yaml
theme: material
plugins:
- search # Material for MkDocs search plugin
- pub-debugger
- pub-blog
- pub-obsidian
- pub-social
- pub-meta
- pub-minifier
```
## Planned features
A full list of planned developments can be found on [this documentation page](https://mkdocs-publisher.github.io/development/other/backlog/). I'm planning to move it to the project [GitHub issues](https://github.com/mkusz/mkdocs-publisher/issues) with proper badges and longer descriptions, but it's time-consuming and at this stage I'd rather spend it developing a project.
## Version history
The entire version history can be found in the project [version history](https://mkdocs-publisher.github.io/development/changelog/) document and inside [releases](https://github.com/mkusz/mkdocs-publisher/releases).
Raw data
{
"_id": null,
"home_page": "https://mkdocs-publisher.github.io/",
"name": "mkdocs-publisher",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "mkdocs, mkdocs-plugin, blog, categories, debugger, docs, documentation, frontmatter, markdown, minifier, navigation, obsidian, publisher, tags",
"author": "Maciej 'maQ' Kusz",
"author_email": "maciej.kusz@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d3/20/b544c914fadc31b094aefffa3dcbd216542d74a44f7fdf9aa6c7ca97976a/mkdocs_publisher-1.4.3.tar.gz",
"platform": null,
"description": "# Publisher for MkDocs\n\n[](https://opensource.org/license/mit/)\n[](https://pypi.org/project/mkdocs-publisher/)\n[](https://www.python.org)\n[](https://pypistats.org/search/mkdocs-publisher)\n[](https://github.com/mkusz/mkdocs-publisher/commits/main)\n[](https://github.com/pre-commit/pre-commit)\n\n\nPublisher for [MkDocs](https://www.mkdocs.org/) is a set of plugins that helps with content creation and publication.\n\n## Features\n\n- [pub-meta](https://mkdocs-publisher.github.io/setup/general/pub-meta/) \u2013 support for:\n\t- automatic [document navigation](https://www.mkdocs.org/user-guide/configuration/#nav) creation based on file names order,\n\t- document publication status,\n\t- possibility to define document and directories URL (good for SEO),\n\t- document creation and update date (good for SEO),\n- [pub-blog](https://mkdocs-publisher.github.io/setup/general/pub-blog/) \u2013 blogging capability:\n\t- index creation,\n\t- support for blog post teasers,\n\t- automatic creation of pages for archive, categories and tags,\n- [pub-obsidian](https://mkdocs-publisher.github.io/setup/general/pub-obsidian/) \u2013 bindings for [Obsidian.md](https://obsidian.md) that allows you to use:\n\t- [backlinks](https://help.obsidian.md/Plugins/Backlinks),\n\t- [callouts](https://help.obsidian.md/Editing+and+formatting/Callouts),\n\t- [wikilinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links),\n\t- [vega charts](https://vega.github.io/vega/) (using [Vega Visualization Plugin for Obsidian](https://github.com/Some-Regular-Person/obsidian-vega)) - advanced solution for creating charts,\n- [pub-social](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-social/) \u2013 social cards for social media sharing using document metadata,\n- [pub-minifier](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-minifier/) \u2013 file size optimization (good for SEO and overall page size optimization),\n- [pub-debugger](https://mkdocs-publisher.github.io/setup/development/pub-debugger/) \u2013 logging on steroids with the possibility of creating of ZIP file with logs and additional information (can be used for better issue reporting).\n\n## Installation\n\n```commandline\npip install mkdocs-publisher\n```\n\nMore information about installation methods and plugin setup can be found on this [documentation page](https://mkdocs-publisher.github.io/setup/installation/).\n\n> [!warning]\n> Before any use, make sure you have a backup of your data.\n\n> [!note]\n> As a base for any development, [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) theme was used. If you are willing to use any other theme, you may (or may not) face some issues. If this happens, please submit an [issue](https://github.com/mkdocs-publisher/mkdocs-publisher/issues).\n\nAfter installation, you have to enable plugins and Material for MkDocs theme in `mkdocs.yml` file:\n\n```yaml\ntheme: material\n\nplugins:\n - search # Material for MkDocs search plugin\n - pub-debugger\n - pub-blog\n - pub-obsidian\n - pub-social\n - pub-meta\n - pub-minifier\n```\n\n## Planned features\n\nA full list of planned developments can be found on [this documentation page](https://mkdocs-publisher.github.io/development/other/backlog/). I'm planning to move it to the project [GitHub issues](https://github.com/mkusz/mkdocs-publisher/issues) with proper badges and longer descriptions, but it's time-consuming and at this stage I'd rather spend it developing a project.\n\n## Version history\n\nThe entire version history can be found in the project [version history](https://mkdocs-publisher.github.io/development/changelog/) document and inside [releases](https://github.com/mkusz/mkdocs-publisher/releases).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Publisher for MkDocs - set of plugins for content creators",
"version": "1.4.3",
"project_urls": {
"Bug Tracker": "https://github.com/mkdocs-publisher/mkdocs-publisher/issues",
"Documentation": "https://mkdocs-publisher.github.io/",
"Homepage": "https://mkdocs-publisher.github.io/",
"Repository": "https://github.com/mkdocs-publisher/mkdocs-publisher"
},
"split_keywords": [
"mkdocs",
" mkdocs-plugin",
" blog",
" categories",
" debugger",
" docs",
" documentation",
" frontmatter",
" markdown",
" minifier",
" navigation",
" obsidian",
" publisher",
" tags"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "70538cb97ff9bee2210585c61f43bd39877baca530f172044853e0c4a2bc3413",
"md5": "7d1393cb405a970f44c41a3653ee292e",
"sha256": "dc29352cd4c3384ff2f8ac154d2fd6dd2c54a8c9c541720254fbefcad0536a35"
},
"downloads": -1,
"filename": "mkdocs_publisher-1.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7d1393cb405a970f44c41a3653ee292e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 92215,
"upload_time": "2024-11-05T18:22:13",
"upload_time_iso_8601": "2024-11-05T18:22:13.905312Z",
"url": "https://files.pythonhosted.org/packages/70/53/8cb97ff9bee2210585c61f43bd39877baca530f172044853e0c4a2bc3413/mkdocs_publisher-1.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d320b544c914fadc31b094aefffa3dcbd216542d74a44f7fdf9aa6c7ca97976a",
"md5": "bfdf90ef27290294aad73f5f9c169080",
"sha256": "93589b7cf622337f6d8d6f3b1b6a2d18d241c81577ac3633e1aebe69c6fcd04e"
},
"downloads": -1,
"filename": "mkdocs_publisher-1.4.3.tar.gz",
"has_sig": false,
"md5_digest": "bfdf90ef27290294aad73f5f9c169080",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 44810,
"upload_time": "2024-11-05T18:22:15",
"upload_time_iso_8601": "2024-11-05T18:22:15.848807Z",
"url": "https://files.pythonhosted.org/packages/d3/20/b544c914fadc31b094aefffa3dcbd216542d74a44f7fdf9aa6c7ca97976a/mkdocs_publisher-1.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-05 18:22:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mkdocs-publisher",
"github_project": "mkdocs-publisher",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mkdocs-publisher"
}
JSON
