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

• General documentation
• Reference

• Code released under MIT License

• derJD