Skip to main content

MkDocs plugin for blogging

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkblog-1.2.0.tar.gz (105.3 kB view hashes)

Uploaded Source

Built Distribution

mkblog-1.2.0-py3-none-any.whl (5.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page