Tale - A static story telling generator

Tale is a static site/blog generator that ships with a CLI focused on telling stories(blogging) quickly. Designed for easy theme swapping and generating. Contains a basic dev server with a bare live/reload feature. Hope you enjoy it!

Installation

Clone the repository and cd into it:

git clone https://github.com/Willyboar/tale
cd tale

Build the escript:

gleam run -m gleescript

You can use the executable if you are in the same path with:

./tale

or add it in your PATH and use it from anywhere with:

tale

Quick Start

You can use all this commands without creating an escript by changing tale with gleam run --

Create a new site

Once you have tale in your path(or not) you can create a new site with:

tale new site <name>

This command will create a new site that contains a default theme into themes/

You can start the developement server using:

tale serve

you can also set the port:

tale serve 5678

There is a basic watch that rebuilds the site in changes(still requires reload the browser though)

When you are ready you can build your site with:

tale build

and deploy the generated files into public

You can also configure a lot of things in config.toml file.

Theme creation

You can create your own theme with:

tale new theme <name>

If you want to use it in your site, copy the theme into themes/ directory on your site/blog and change the name in the config.toml

Post creation

You can create a new post in any path but the recommended way is to go into content/posts and then type:

tale new post this_is_a_wibble_wobble_post

Documentation

• Tale documentation- TODO

• Generated Internal documentation can be found at https://hexdocs.pm/tale.

License

MIT