Django application to create a blog based on local Markdown files
pip install django-static-markdown-blog==0.1.2
The purpose of this application is to provide an Internet blog based on local files. Those files can be Markdown formatted to add some style to your notes. This app has to be integrated into an existing django website.
INSTALLED_APPS = [
...
'django_static_markdown_blog',
]
BLOG_FOLDER = '/tmp/markdown-files/'
BLOG_INDEX_FILE = 'main.md'
path('blog/', include(('django_static_markdown_blog.urls', 'blog'))),
It is useless to migrate database because it is based on local files
Start the development server and visit http://127.0.0.1:8000/blog to check if everything is ok.
To use the software, you must have defined the variable BLOG_FOLDER which indicates the name of the directory where the Markdown files are located, as well as the variable BLOG_INDEX_FILE which corresponds to the main file of each directory (it is possible to create an unlimited tree structure).
Your first file is the one at the root of the BLOG_FOLDER directory and must be named as the BLOG_INDEX_FILE variable. This is the entry point of your blog, the page seen by your visitors when they arrive on your blog.
To write a Markdown file, the principle is very simple. It is divided into two parts separated by at least one empty line. The first part contains the metadata of the file which are filled a little lower. The second part is the content of your page, formattable with Markdown.
There is an exemple of a home page:
title: Welcome on my blog
Hello everyone, and welcome to my **blog**.
Feel free to visit my project page on [PyPI](https://pypi.org/project/django-static-markdown-blog/) or directly on [GitLab](https://gitlab.com/aloha68/django-static-markdown-blog/).
Enjoy your visit!
There is the full list of the supported metadata: