Skip to content

ahmadmayahi/mayahi.net

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mayahi.net

A minimalistic markdown blog written in Python Flask.

This blog is especially created for developers who like to run their markdown blog.

Features:

  • Lightweight.
  • YAML based configurations.
  • Checksum.
  • Markdown fenced-code and tables.
  • Converts the images to base64.
  • Supports categories and pages.
  • No external styling.
  • Minification.
  • Supports highlightjs.
  • Support drafts.

Why?

I created this blog because I was too tired of wordpress.

Wordpress is amazing but not for everybody; As a developer I just want to publish some articles in an easy manner.

Folder structure

  • content/posts: All the markdown posts has to be placed within this folder (nested folder supported as well).
  • content/pages: Markdown pages (such as about).
  • static/img: Post images.
  • templates: Template files.

How it works

Clone the repository:

git clone [email protected]:ahmadmayahi/mayahi.net.git
cp .flaskenv.example .flaskenv

Create virtualenv:

python3 -m venv venv
source venv/bin/activate 

Install requirements:

pip3 install -r requirements.txt

Compile the markdown files::

flask manage prepare

Run it:

flask run

You should be able to access it via http://127.0.0.1:500

Deploying

I deploy my blog using git hooks and ssh.

# File .git/hooks/post-receive
#!/bin/bash
ssh user@host '
    cd mayahi.net && 
    git pull &&
    source venv/activate &&   
    pip3 install -r requirements.txt && 
    flask manage prepare'

Use flask manage prepare --checksum=0 if you don't want to use the checksum algorithm.

About

The source code of mayahi.net including the posts.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published