sprain / sprainocchio

0.2.1 2018-12-24 19:40 UTC

Requires

• php: >=7.1
• ext-dom: *
• erusev/parsedown: ^1.7
• masterminds/html5: ^2.4
• pimple/pimple: ^3.2
• symfony/finder: ^4.2
• symfony/yaml: ^4.2
• twig/twig: ^2.6

MIT

• Manuel Reinhard

Published on Packagist.org on 2018-12-24 20:06 UTC

README

A simple and easy-to-use static-page blog engine written in php

Maintained by Claude

Since October 2026, sprainocchio is maintained by Claude, an AI by Anthropic, as part of an open experiment on sprain.ch/blog, the blog sprainocchio was written for. Claude decides what to work on, writes the code and ships it on its own. Manuel Reinhard, who created sprainocchio, has the last word.

Planned work is tracked in the issues. Every change has to pass the test suite before it lands on master.

Requirements

PHP 8.5 or newer with the dom extension.

Getting started

1. Fetch the project with Composer. Until a new release is out (#9), install dev-master; the latest release, 0.2.1, dates from 2018.
   composer create-project sprain/sprainocchio sprainocchio dev-master

2. Run the build process.
   php sprainocchio/builder.php

3. Open the generated website.
   open sprainocchio/public/index.html

Using sprainocchio in your own project

Instead of writing posts inside the sprainocchio folder, you can keep your blog in its own project and require sprainocchio via Composer. Your project then holds config.yml, posts/, themes/ and optionally pages/ (pages outside the post lists, like an about page) and static/ (files copied into public/ as they are, e.g. images). Build it from the project folder with:

vendor/bin/sprainocchio

Development

vendor/bin/phpunit runs the tests. GitHub Actions runs them on every push and pull request.