varia.website/README.md

# Varia website

> https://varia.zone

## Getting Started

### Clone

```
$ git clone https://git.vvvvvvaria.org/varia/varia.website.git
$ cd varia.website
$ git clone https://github.com/getpelican/pelican-plugins/
$ git clone https://git.vvvvvvaria.org/varia/plugins-custom
```

### Install

```
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
```

### Serve

```
$ pelican --autoreload
```

Visit the website at [localhost:8000](http://localhost:8000)

## Tools

The Varia website is made with Pelican, a static site generator written in
Python. This means that the website is first generated on a computer (using
Python, Jinja and Pelican) into a set of html pages, files and images. This set
of documents is then uploaded to the server.

One of the things that Pelican uses is _plugins_. They are used to add extra
features to the generation process of the website.

In this repository there is a folder called 'plugins' and another one called
'plugins-custom'.

The first one, 'plugins', is linked to the offical collection of plugins from
the Pelican project '[pelican-plugins](https://github.com/getpelican/pelican-plugins/)'.

The other one, 'plugins-custom', consists of plugins that we wrote ourself.

## Posting Content

We're using Pelican to generate a static website. The main way to add content
to the website is by making 'posts' in the folder `content`. This can be done
either locally or via the gitlab interface by creating a new file. Make sure
that each article contains at least the following at the top of the document:

    Title: een nieuw initiatief
    Date: 2017-07-07 18:32
    Category: news
    Tags: event, workshop
    slug: the-name-of-the-html-page
    lang: nl OR en
    event_start: 2017-07-07 18:32
    event_duration:4h
    featured_image: /images/image.png

Articles are written in a markup language called markdown.
[Here](https://daringfireball.net/projects/markdown/syntax) is an overview of
the syntax. You can also use the online editor in this Gitea interface to help
you.