zeus.ugent.be/README.md

# zeus.ugent.be
[![Build Status](https://travis-ci.org/ZeusWPI/zeus.ugent.be.svg?branch=master)](https://travis-ci.org/ZeusWPI/zeus.ugent.be)
[![Code Climate](https://codeclimate.com/github/ZeusWPI/zeus.ugent.be.png)](https://codeclimate.com/github/ZeusWPI/zeus.ugent.be)
[![PageSpeed](https://pagespeed-badges.herokuapp.com/?url=zeus.ugent.be&strat=desktop&showStratLabel=true)](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fzeus.ugent.be&tab=desktop)
[![PageSpeed](https://pagespeed-badges.herokuapp.com/?url=zeus.ugent.be&strat=mobile&showStratLabel=true)](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fzeus.ugent.be&tab=mobile)

## Setup

### Installation

```bash
bundle install
npm install
```

### Developing

```bash
bundle exec nanoc live
```
This will spawn a webserver, and automatically recompile the site
when files get changed.

### Deploying

The latest builds on master get deployed automatically using [travis](https://travis-ci.org).

For manual deployment, run

```bash
bundle exec nanoc deploy --target public
```

## Events

Events can be fetched from facebook using `nanoc fetch [facebook event id]`. A file named `.fb_token` containing an app token for facebook must be present.

## Blogposts

Posts should be written in [kramdown](http://kramdown.gettalong.org/index.html), a markdown superset which has a very complete [syntax guide](http://kramdown.gettalong.org/syntax.html).

Meta-tags:

| Name        | Type   | Required |
|-------------|--------|----------|
| :title      | String | yes      |
| :created_at | Date   | yes      |
| :description| String | no       |
| :author     | String | no       |
| :lang       | String | no       |

## Events

Example structure:

```
content/
  assets/
  events/
    15-16/
    16-17/
      battlebots/
        main.md
        intro.md
        codenight.md
        finale.md
      awk.md
      sed.md
      ruby.md
    index.erb
```

### Metadata

Every event is a `.md` file with the following metadata tags:

| Name         | Type   | Required |
|--------------|--------|----------|
| :title       | String | yes      |
| :time        | Date   | yes      |
| :location    | String | yes      |
| :description | String | no       |
| :created_at  | Date   | no       |
| :locationlink| String | no       |
| :facebook    | URL    | no       |
| :banner      | URL    | no       |
| :image       | URL    | no       |


### Grouped events

If there's a series of events (for example summer code nights) these can be grouped by creating a folder containing a `main.md`, which will need the following metadata:

| Name         | Type   | Required |
|--------------|--------|----------|
| :title       | String | yes      |
| :location    | String | no       |
| :banner      | URL    | no       |

Other `.md` files made in that folder are sub-events which need to fit the [metadata description listed earlier](#metadata)