holy-carpet

Crates.ioholy-carpet
lib.rsholy-carpet
version0.1.3
created_at2025-05-01 19:11:09.407062+00
updated_at2025-08-01 18:43:26.768323+00
descriptionA simple, customizable blog creator
homepage
repositoryhttps://codeberg.org/user0-07161/holy-carpet
max_upload_size
id1656775
size88,595
User0 (user0-07161)

documentation

README

Holy carpet

A simple blog generator, customizable and written in Rust.

How to use

Initialize a new blog:
holy-carpet --init --directory DIRECTORY
--OR--
holy-carpet -i -d DIRECTORY
Initializes a new blog in DIRECTORY.

Build your blog:
holy-carpet --build --directory DIRECTORY
--OR--
holy-carpet -b -d DIRECTORY
Builds static HTML files for your blog, output in DIRECTORY/html

For further information, check the command help:
holy-carpet --help
--OR--
holy-carpet -h

Building your blog

After building your blog, you may want to add posts. To do so, first delete the example posts in DIRECTORY/posts, and add your first own post. Holy carpet uses a somewhat custom markdown format to get information about your posts. For your post to be working and visible on your index page, you need to add three lines somewhere in your post file. The date has to follow the format above (YYYY/MM/DD).:

%TITLE:Hello, world!%
%DATE:1970/01/01%
%DESCRIPTION:Hello, hi!%

I think their purpose should be obvious.

To customize your index page, edit DIRECTORY/templates/index.md. Place the %POSTS% line where you want your posts list to be.

This is heavily inspired by funderscore's "seen" blog generator

Commit count: 0

cargo fmt