https://github.com/ayarcohaila/blo

Static blog generator
https://github.com/ayarcohaila/blo

blog jinja2 python-3 seo static-site-generator

Last synced: 5 months ago
JSON representation

Static blog generator

• Host: GitHub
• URL: https://github.com/ayarcohaila/blo
• Owner: ayarcohaila
• License: bsd-3-clause
• Created: 2018-04-02T06:59:28.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2023-05-30T14:37:07.000Z (about 3 years ago)
• Last Synced: 2025-03-28T14:43:13.122Z (about 1 year ago)
• Topics: blog, jinja2, python-3, seo, static-site-generator
• Language: Python
• Size: 32.2 KB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Blo

**Blo** (*blog + bro*) - yet another static site generator for personal blogs. The aim is to make a really easy tool for creating new notes and customizing your site. Do less actions and have much opportunity to make a unique site.

## Features

 * Comfortable cli control.

 * Easy config edit in JSON files.

 * Drafts templates: default content for new notes, useful for planning new posts.

 * Page templates: easy HTML/Jinja2 customize and improve.

 * SEO friendly (as I could make it).

 * Microformats for better snippets in Google/Bing/etc.

 * Markdown with use of meta-tags to customize pages more with different data.

 * Code highlight with Pygments.

 * RSS feed generation

 * Pagination

## Installation

     pip install blo

Or download repo and execute:

     python setup.py install

## Usage

Create a new blog:

     blo create myblog

     cd myblog

Create a new page or post:

     blo post hello-world 

     

You can also use pipe with your favorite editor:

     blo post hello-world | xargs subl

Build blog:

     blo build

Run blog locally:

     blo serve

     

## Configure

Global site variables and technical paths are in `default.json`.

Templates for diffirent types of content are in `draft_templates.json`

## Customize

### Adding a custom type of content

You can add you page HTML templates for diffirent types of content. 

1. Add new HTML template to `templates` folder with a name of post type (ex. `book.html`)

2. Add new draft template to `draft_templates.json`, you can also set an URL template and default content for new type of page

3. Now you can make new type of posts: `blo post just-for-fun --type book`