yabi 1.0

A static blog generator

YABI: Yet Another Blogging (tool) Implementation

yabi allows you to create a simple and customizable blog site with minimal effort.

Write your posts in markdown, build the blog site, and deploy it anywhere you like.

• Installation
• Getting started
• Features

Installation

The easiest way to install from PyPI is to the pip command

pip install --user yabi

If you have cloned the source code you can install it with

pip install --user .

Getting started

Say, you want to create a new blog that describes your philosophical thoughts. You call it Discourses. To create this new blog type in a terminal

yabi init Discourses

now navigate to the newly created folder

cd Discourses

To publish your first though, create a new file on, e.g., posts/my_first_thought.md. The only requirements for a post is that

1. It is somewhere inside the posts folder
2. Has set the label draft to "yes" or "no" at the file header.
3. It has a level 1 Markdown heading with the title of the post right after the label(s).

Apart from these minimal requirements, the post can have any valid Markdown syntax.

draft: no

# My first thought

I will drink more water. I will exercise more and I will wake up earlier.

No, I'm not. I rather not to.

Finally, build the website using the command

yabi build

All the contents of the website are built under the folder public. You can upload these files to any hosting service of your liking. If you wish to check how the site will look you can use the command

yabi test

which will create a local server with your website on http://localhost:9090 by default.

Features

• Simply and minimalistic user interface
• Sane defaults for the website. Have a nice blog with all the expected features: archive, categories, and a home page with the latest posts
• Markdown-format post system. No need of complex databases, the only thing needed to build your website are the markdown files containing your posts. Ideal for version control!
• Optimized build system. Only builds what you have recently added/changed.