This is yet another MkDocs plugin adding basic blogging functionality.
With this plugin you store your blogposts in a separate
As you can see it doesn't matter how you store your posts in the
Instead of directory structures, this plugin relies on markdown Metadata
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
- 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
--- 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