Accueil Explorer Aide
Connexion
gitoyen
/
site
5
0
Fork 0
Fichiers Tickets 0 Pull Requests 0 Wiki

Site web Gitoyen https://gitoyen.net/

Branche: master
Branches Tags
site
Sebastien Badia 1a9cfe3005 blog: 2019 - New ressources for baionet - fix il y a 6 ans
content 1a9cfe3005 blog: 2019 - New ressources for baionet - fix il y a 6 ans
plugins 36c78a6a8c Avoid nested ul when not needed il y a 9 ans
templates 0055e078d4 Simplify dev environment installation il y a 9 ans
theme 0ef9cfa3c5 optimisation des images il y a 8 ans
.gitignore 1d7fc75e63 added a little makefile to help publishing il y a 7 ans
Makefile 479637420c make: silence pip command il y a 7 ans
README.md a60b79666b Initial commit :) il y a 9 ans
filters.py d4c3906123 correctly handle the active page in navbar il y a 9 ans
gitoyen.py e99e383df0 fix path stuff il y a 8 ans
pelicanconf.py 2cdf06d585 pelican-4.1: (conf) use slug keyword il y a 6 ans
setup.py 0055e078d4 Simplify dev environment installation il y a 9 ans
todo.md 105035ec03 pages: Added decix and clean todo il y a 8 ans

README.md

Gitoyen website

The gitoyen website is build on pelican, this repo contains the source code and content needed to generate the static website.

Getting started

Pelican is based on python in order to make the site works you will need at least python and pip installed. Once this has been done run the following commands into this repository folder:

Virtualenv

If you want to keep things isolated on your machine you will have to install virtualenv, this step is not mandatory but is recommended. On debian just type: apt-get install python-virtualenv

Create a virtualenv in the root of the repository: virtualenv ./venv

Source the virtualenv in order to isolate your current session: source venv/bin/activate, you can disable it later by typing deactivate in the same shell session.

Install and run

  • pip install -e . will install the dependencies needed by pelican
  • gitoyen serve will serve the website in development mode (i.e: livereload, local port)

Repository organisation

The website is build on multiple sources:

  • gitoyen.py this is the command line helper file, it provides a list of usefull command for development. This script is installed when running pip install -e .. It is based on Click
  • pelicanconf.py is a python file for the configuration of the pelican engine. It contains for example the path of the different directories which will be used to build the website.
  • filters.py some jinja2 filters which will add features for generating the website.
  • content/ contains the site content in Markdown files, it is separated in two subdirs: pages, blog the first subdir contains the pages of the site, the second contains a list of blog articles.
  • templates/ some jinja templates for administration, it is used by gitoyen.py file.
  • theme/ jinja templates and static files for generating the website.
  • plugins/ pelican plugins, currently there is only one installed to generate tables of content.
  • setup.py contains instructions on how to install the gitoyen cli and the dependencies for running the dev environment.

Liste

Architecture