Skip to content

This is a MkDocs Plugin adding basic blogging functionality by parsing a `blog` directory ontop of your usual `docs` directory.

License

Notifications You must be signed in to change notification settings

derJD/python-mkblog

Repository files navigation

python-mkblog

PyPI version PyPI downloads pylint

This is yet another MkDocs plugin adding basic blogging functionality. With this plugin you store your blogposts in a separate blog directory.

example tree

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.

example page

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.

Features

  • Extra directory for your blog posts
  • Utilizing markdown meta date
  • No need for date directories and subdirectories and sub sub directories

Installation

  • from pypi: pip install python-mkblog
  • from github: pip install git+https://github.com./derJD/python-mkblog.git

Local Build

git clone https://github.com/derJD/python-mkblog.git
cd python-mkblog
pip install .

Usage

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

Documentation

License

Author

About

This is a MkDocs Plugin adding basic blogging functionality by parsing a `blog` directory ontop of your usual `docs` directory.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published