There are lots of site and blog static generators. Most of them are full of tons of features and configuration options that needs pages of documentation and tutorias to get started. Mery Claire is a tiny blog generator, with just the feature you need.
- Clone this repository and install the dependencies (
mix deps.get) - Customize the files in the
_templatesfolder. These are the containers of your blog, so you can style them adding images and css classes (use the_assetsforlder for external files like css) - Add some posts in the
_postsfolder. These are your articles written in markdown. In the header section you can define as many attribute as you like and you can use them in the templates (liketitle) - Test you blog running
mix serveand openin your browser athttps://localhost:4000 - If everything seems ok your blog is ready in the
docsfolder, push on your own hosting or on Github.
You can change the folders names editing the config.exs file. I'm using docs for outoput so it's easy to host the site on github pages.
mix gen generates the output in the destination folder
mix serve generates the output and run a webserver to test the pages. When the server is active a watcher rebuilds all the pages when something change
In the file ./config/config.exs there are the main settings, for the generation engine. Most of all are source and destination folders.
posts: the folders that contains the posts in markdown (default./_posts)templates: the folder that contains theheextemplates to build the pages. These areskeleton.html.heexthat is the main HTML structure, andindex.html.heex,post.html.heexarchive.html.heexabout.html.heex. All the pages are composed mixing the the skeleton with the content page (index, post, ...) (default./_templates)- destination: the output folder (default
./docs) - scss: the main file that contain the stile (default
./_scss/app.scss) - assets: the assets folder for images, fonts, etc... (default
./_assets)