This is yet another MkDocs plugin adding basic blogging functionality.
With this plugin you store your blogposts in a separate blog directory.
As you can see it doesn't matter how you store your posts in the blog directory.
Instead of directory structures, this plugin relies on markdown Metadata date.
Use this plugin alongside with the plugin awesome-pages.
awesome-pages will take care of generating the whole nav bar, so you (or this blog plugin) don't have to do it.
- Extra directory for your blog posts
- Utilizing markdown meta
date - No need for date directories and subdirectories and sub sub directories
- from pypi:
pip install python-mkblog - from github:
pip install git+https://github.com./derJD/python-mkblog.git
git clone https://github.com/derJD/python-mkblog.git
cd python-mkblog
pip install .There is an complete example directory.
Take a look by cloning this repository and issuing mkdocs serve -f example/mkdocs.yml
Most basic example mkdocs.yml:
---
site_name: basic test page
plugins:
- awesome-pages
- mkblog
This example uses material theme to make the site prettier and it uses discus extra to give people the opportunity to leave a comment:
---
site_name: test page with comments
theme:
name: material
features:
- tabs
palette:
primary: green
accent: yellow
plugins:
- mkblog
- search
- awesome-pages
extra:
disqus: <YOUR DISQUS TOKEN>
You can configure the name of your blog directory:
---
plugins:
- mkblog:
blog_dir: bloggiemcblogger
- Code released under MIT License