Socket
Socket
Sign inDemoInstall

django-static-markdown-blog

Package Overview
Dependencies
5
Maintainers
1
Alerts
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies

Install

django-static-markdown-blog

Django application to create a blog based on local Markdown files


Maintainers
1

Readme

Django static Markdown blog

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.

Quick start

  1. Add "django_static_markdown_blog" to your INSTALLED_APPS setting like this:
INSTALLED_APPS = [  
    ...  
    'django_static_markdown_blog',
]
  1. In the settings file, add two variables
BLOG_FOLDER = '/tmp/markdown-files/'
BLOG_INDEX_FILE = 'main.md'
  1. Include the django_static_markdown_blog URLconf in your project urls.py like this:
path('blog/', include(('django_static_markdown_blog.urls', 'blog'))),
  1. It is useless to migrate database because it is based on local files

  2. Start the development server and visit http://127.0.0.1:8000/blog to check if everything is ok.

How to use

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).

Write your first page

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!

Supported metadata

There is the full list of the supported metadata:

  • title: set the title of your page
  • date: set a custom date for your page, else we will use the datetime of the file
  • groups: define a group list that can access the page. It means that unauthorized people will not see the page
  • icons: define an icon that will be display in the article list for a page

TODO

  • Remove all BeautifulSoup4 components
  • Remove all libaloha components

FAQs


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc