#blog_posts

CI-focused static blogging "framework" written in Bash.

Converts Markdown files to HTML files constructed with templates.

Creates a RSS file for news readers.

Best used with Github Actions and Github Pages.

Mainly tailored for use with Miaoutage.

#How to use

Markdown format is Simple MarkUp.

Add a file in src with the following content:

## TITLE
(...)

This is a blog post.

Put smu in your $PATH.

git commit and run bash bin/pushact.

Dates are determined from first commit date.

Generated file in posts//index.html.

#Github Actions

The repository contains workflows that do all the work for you, all you need to do is to push a markdown file in src.

In order to use these, you need to create a fine-grained personal access token on Github, with rights to change workflow files, deploy actions and push on your repository.

Modify the checkout action in ".github/workflows/generate.yml" and change "denisebitca/blog_posts" to your repository.

Add the PAT as a repository secret called PAT_TOKEN.

#Sourcehut Pages / Builds

The repository contains a .build.yml file that you can use, no need to modify, just fork this repo on Sourcehut.

#Templates

HTML templates are in templates. Modify them to your heart's content.

#Acknowledgements

HTML and CSS based on perfect motherfucking website, under CC0.

Requires smu.

#License

License is AGPL 3.0. All content owned by me in src is CC BY-SA 4.0 unless specified otherwise.