hantang / weblog

A python static blog generator.

weblog

A python static blog generator.

Overview

Weblog is a simple static blog generator built with python.

Inspired by

• Hugo,
• Maverick
• pelican
• and mkdocs etc.

mainly techs:

• markdown parser: mistune
• math support: ketax
• date and time parsing: pendulum
• toml/yaml
• ...

Demo

Here is: https://hantang.github.io/weblog/

Snapshots:

• 
• 
• 
• 

Usage

A example is here:

# install weblog
https://github.com/hantang/weblog.git
cd weblog
pip install .

# then cd <somewhere>
# init project (default site-name is blog-site)
python -m weblog init [--path site-name] [--query] [--url url-path]

# build the site
cd <site-name>
python -m weblog build

# run local server
python -m http.server -d deploy
# then open `http://localhost:8000`

# clean deploy
python -m weblog clean

Build Packages

# ref: https://packaging.python.org/en/latest/tutorials/packaging-projects/
# pypython.toml
# install dependencies
python3 -m pip install --upgrade pip
python3 -m pip install --upgrade build

# build to wheel
python3 -m build

# install
pip install dist/weblog-0.0.2-py3-none-any.whl

Themes

theme-vanilla

• style: mainly from riggraz/no-style-please
• fonts: Megrim - John MacFarlane
• code highlight: numist/highlight-css
• favicon: created by favicon with symbol emptyset ∅.