mb@mb
5a0927f244
|
6 years ago | |
---|---|---|
content | 6 years ago | |
pelican-plugins@8de8e847ce | 7 years ago | |
plugins-custom@06abd8f6b3 | 6 years ago | |
themes/varia | 6 years ago | |
.gitignore | 7 years ago | |
.gitmodules | 7 years ago | |
LICENSE | 7 years ago | |
Makefile | 7 years ago | |
README.md | 6 years ago | |
develop_server.sh | 7 years ago | |
pelicanconf.py | 6 years ago | |
publishconf.py | 7 years ago | |
requirements.txt | 6 years ago |
README.md
Varia website
Cloning
The folder 'plugins' is linked to the Pelican project 'pelican-plugins' repository. To clone both the varia.website and pelican-plugins repository, add the --recurse-submodules option in your git clone command:
git clone https://git.vvvvvvaria.org/varia/varia.website.git --recurse-submodules
Install
$ pip3 install -r requirements.txt
Start
You can make use of the makefile, for example by running the following command to start a python server:
$ make devserver
Visit the website at localhost:8000
Update submodules
We are currently using two submodules:
- pelican-plugins (https://github.com/getpelican/pelican-plugins)
- plugins-custom (https://git.vvvvvvaria.org/varia/plugins-custom)
To update these submodules within your (already) cloned repository, first init the submodule, and then update it:
cd /path/to/submodule
git submodule init
git submodule update
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
Articles are written in a markup language called markdown. Here is an overview of the syntax. You can also use the online editor in gitlab to help you.
Layout & theme
todo
Editing templates
todo