Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/badosu/coil
Coil is a minimalistic static content engine written in elixir
https://github.com/badosu/coil
Last synced: about 2 months ago
JSON representation
Coil is a minimalistic static content engine written in elixir
- Host: GitHub
- URL: https://github.com/badosu/coil
- Owner: badosu
- License: other
- Created: 2013-09-10T21:43:18.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2014-03-30T20:49:32.000Z (over 10 years ago)
- Last Synced: 2024-10-14T20:11:35.875Z (about 2 months ago)
- Language: Elixir
- Homepage:
- Size: 431 KB
- Stars: 68
- Watchers: 10
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- freaking_awesome_elixir - Elixir - Minimalistic static content engine. (Static Page Generation)
- fucking-awesome-elixir - coil - Minimalistic static content engine. (Static Page Generation)
- awesome-elixir - coil - Minimalistic static content engine. (Static Page Generation)
README
Coil
====
Coil is a minimalistic static content engine written in elixir.
Requirements
-------
You must have the latest stable version of elixir installed,
[v0.12.5](https://github.com/elixir-lang/elixir/releases/tag/v0.12.5) as of
the writing of this.
Install
-------
Clone the repo, fetch dependencies and compile:
```bash
git clone https://github.com/badosu/coil
cd coil && mix do deps.get, compile
```
Bootstrap a sample coil blog:
```bash
mix coil ../blog
cd ../blog && mix deps.get
```
Apply your configuration:
```bash
$EDITOR config.yml
```
Usage
-----
Add an article: `mix post`.
Run (on port 8080): `PORT=8080 mix run --no-halt`.
Deploy to Heroku:
```bash
heroku create --buildpack "https://github.com/goshakkk/heroku-buildpack-elixir.git"
git push heroku master
```
Customize
---------
If you have a `mix.exs` file requiring the coil lib properly, like
[this one](/example/mix.exs), you have only to follow the structure
below to get it working:
.
|-- articles
| `-- YYYY-mm-dd-article-title.md
|-- assets
| `-- example.css
|-- config.yml
|-- mix.exs
|-- pages
| `-- title.md
`-- templates
|-- archives.html.eex
|-- article.html.eex
|-- index.html.eex
|-- index.xml.eex
|-- layout.html.eex
`-- page.html.eex
### Routes
* Index: `/`
* Page: `/title`
* Resource: `/assets/example.css`
* Article: `/articles/YYYY-mm-dd-article-title`
* RSS feed: `/feed`
* Archives: `/archives`
### Templates
Templates are embedded elixir files
(see the [EEx docs](http://elixir-lang.org/docs/stable/EEx.html)), and can be
customized to suit your design:
* `layout.html.eex` The template in which all other templates are embedded
* `index.html.eex` Renders the home page
* `article.html.eex` Renders the article page
* `page.html.eex` Renders the page page
* `archives.html.eex` Renders the archives page
* `index.xml.eex` Renders the rss feed
License
-------
The MIT License, see LICENSE