`beulogue` [\bøloɡ\]: french for blog. https://beulogue.ehret.me/
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
Go to file
Siegfried Ehret efb3c2cc12 🔥 remove useless import 3 years ago
docs 📝 update docs 3 years ago
spec 🚀 init project ! 4 years ago
src 🔥 remove useless import 3 years ago
.editorconfig 🚀 init project ! 4 years ago
.gitignore 🔧 update gitignore 4 years ago
.travis.yml 🚀 init project ! 4 years ago
.upignore 🔧 setup up 4 years ago
CHANGELOG.md 📝 update changelog 3 years ago
CONTRIBUTING.md 🚀 init project ! 4 years ago
LICENSE 🚀 init project ! 4 years ago
Makefile 🔧 update makefile 3 years ago
README.md 📝 update readme 3 years ago
brrr.yaml 🎁 update brrr config 3 years ago
shard.lock 🎁 replace mustache with crinja for templating 3 years ago
shard.yml ⬆️ update version 3 years ago
up.json 🔧 fix lambda runtime 3 years ago



beulogue [\bøloɡ]: french for blog.


Download binaries

  • Linux:
  • MacOS: 🚧 (MacOS versions will always come later than the Linux one)
  • Windows:

Go to the release page !

Build from source

  • Clone this repository.
  • Install Crystal and Shards.
  • Run make install then make.
  • The beulogue binary will be in the bin/ folder.


Add beulogue to your PATH and run beulogue !

📝 The documentation is available at https://beulogue.ehret.me/

Here are the possible commands:

  • beulogue or beulogue build to build the site.
  • beulogue help to show the help.
  • beulogue version to show the the version.

Possible flags:

  • -dev or --development:
    • will use an empty base instead of the one given in the configuration file to make local navigation easier
    • will add markdown in the drafts/ folder
  • -d or --debug: show some logs
  • -h or --help: show help

Protip: a few starter kits are available on these mirrors:


beulogue is an experiment to discover the Crystal programming language, 2 years after playing with the same concept with Node.js.

beulogue aims to stay simple and provide the following for the first version:

  • mardown files to html pages
  • basic templating (pages)
  • basic templating (list)
  • markdown front-matter
  • multilingual site
  • rss
  • cli, help & debug

And maybe at some point:

  • tags (in front matter)
  • shortcodes
  • links between languages
  • orphan pages
  • tags (pages)
  • drafts

And probably won't:

  • pagination

And absolutely won't:

  • livereload



Licensed under the GPLv3 license.


beulogue follows my own FibVer (Fibonacci Versioning):

  • Basically, it follows Semantic Versioning.
  • You have to use Fibonacci suite numbers when you bump the version.
  • Until you bump a major version, don't reset patch. For a version, it gives an idea of how many features and bugfixes you made.

I'll spec that one day...


Check the CONTRIBUTING.md document for some info.

  1. Fork it (https://github.com/SiegfriedEhret/beulogue/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request