A blog software. It's meant to be as minimal as possible (thin client), while still maintaining basic readability and styling.
| content | ||
| site | ||
| .gitignore | ||
| crablog.env | ||
| docker-compose.yml | ||
| Dockerfile | ||
| README.md | ||
Crablog
Pure rust. Built with actix, diesel, tera, serde and sqlite3.
Build instructions using docker
- Clone the repository
git clone https://github.com/leonardlorenz/crablog
cd crablog/site
- Install diesel and create a database
cargo install diesel_cli --no-default-features --features "sqlite"
diesel setup --database-url ../content/db.sqlite3
diesel migration run --database-url ../content/db.sqlite3
- Set up your configuration file (see below)
- Build and run the docker container (Will compile from source and thus take a while)
docker-compose up -d
Configuration environment file
All configuration options are defined in .env, to be created in the same directory as this readme.
An example configuration:
USERNAME=yourusername
EMAIL=me@mydomain.tld
BIND_PORT=8000
SUBMIT_TOKEN=Submit!123 # token needed for submitting
GITHUB_ACCOUNT=usernam3
TWITTER_ACCOUNT=usernam3
MASTODON_ACCOUNT=usernam3@mastodon.social
REDDIT_ACCOUNT=usernam3
DISCORD_ACCOUNT=usernam3
# only needed when not using a docker container
ROOT_PATH=/path/to/template/directory/and/sqliteDB
Routes
| Route | Description |
|---|---|
| / | shows the last 5 posts |
| /id/ | shows a single post by id |
| /all | shows all posts |
| /submit | set your submit token and create posts |
| /edit/ | edit, delete or hide posts |
| /about | information about this blog, social media accounts |
API Routes
- /api/blog/posts returns all posts as json