balsamine.www
clone your own copy | download snapshot

About

Balsamine.be web repo

Balsamine rebuild 2017 logo-balsa

Development environment

The new balsamine website is based on Pelican, a static site generator. It's built in Python, and thus, we'll use a virtual environment.

$ virtualenv venv $ . venv/bin/activate $ (venv) pip install -r requirements.txt

With these three steps, you should have setup most of the development space needed for this pelican project. Here is what was installed by pip reading requirements.txt:

Jinja2==2.8 Markdown==2.6.7 MarkupSafe==0.23 Pygments==2.1.3 Unidecode==0.04.19 argparse==1.2.1 blinker==1.4 docutils==0.12 feedgenerator==1.9 pelican==3.6.3 python-dateutil==2.5.3 pytz==2016.7 six==1.10.0 wsgiref==0.1.2

Running and using pelican

Pelican is a static site generator, built in Python that requires no databases or server-side logic. It expects content in Markdown (or reStructuredText), and handles this content in Jinja2 templates. The documentation for Pelican is well written, it's hosted here: http://docs.getpelican.com/en/stable/

Pelican comes prebuilt with a set of tools to help development and deployment. As it generates a static site, in plain html, we can run the full current website locally during build and development phases. Most of the tools that Pelican ships with are in the Makefile. Most of the configurations are in the file titled pelicanconf.py.

Expected workflow

The tool expects a simple chain of events: writing content, generating the static site, publishing the resulting html files. The structure of the folders here represent that too: writing content happens in the /content/ folder. The html files and assets that get generated all reside in the /output/ folder. When we publish, we're simply copying all the contents of /output/ to it online destination.

Generating html

In it's plainest form, one generates html simply by calling pelican, with no arguments. $ pelican If you've changed the default location of the content folder, you can tell pelican to generate from that path as an argument: $ pelican content You can also use the Makefile, which would parse all the configs from pelicanconf.py like this: $ make html But in the case of development work, a watcher tool exists, which will run the html generation whenever content is updated or added, whenever a template is changed, or whenever the css file is touched. This is the best way to work with pelican locally, you call it from the Makefile: $ make devserver The dev server is now also running, so you can visit your website locally at localhost:8000

That should be it to start off.

OSP will most lightly define it's own guidelines for working in templates and css, which will result in other wiki-readme-documents.

Working on the theme

Templates are managed with Jinja2 http://jinja.pocoo.org/

Working on the css

The stylesheets are preprocessed by Compass, and written in Sass. This is subject to change as the project progresses. Installation of Compass deploys as a Ruby Gem:

  • if you don't have Ruby Gems installed ( check by testing gem -v ) install like so:
  • sudo apt-get install rubygems build-essential
  • to install compass run
  • gem update --system
  • gem install compass
  • finally, before you start working on the css, start the compass watcher:
  • cd work.balsamine.www/theme/balsamine/static/balsa-css/
  • compass watch
  • that last command reads the configs written in config.rb, listens for changes in the css files and compiles screen.css to the right location when something is changed

Inside this repository

Log

 

Colmtalked

— foundations for the new Balsamine website

Monday, 16th January 2017 - 18:42

 

Colmlet the cat out of the bag

— these are the requirements pip requirements, also for pelican, and it's bare structure

Monday, 16th January 2017 - 19:01

 

Colmemited

— these are the content space for pelican

Monday, 16th January 2017 - 19:02

 

Colmcried

— ignore .pyc

Monday, 16th January 2017 - 19:02

 

Colmlet out

— written instructions for using pelican

Monday, 16th January 2017 - 19:32

 

Colmsong

— I think ignoring all of the output/ is the way to go for multihand pelican

Monday, 16th January 2017 - 19:51

 

Colmconfessed

— adding a balsa logo svg to decorate readme

Monday, 16th January 2017 - 19:58

 

colmspoke

— self hosted images in readme?

Monday, 16th January 2017 - 19:59

 

Colmconfessed

— do links to internal images work from the readme?

Tuesday, 17th January 2017 - 11:42

 

Pierre Huyghebaertironized

— Added a first sketch

Tuesday, 24th January 2017 - 18:05

 

Colmwhistled

— adding a link to the css file would help :)

Monday, 23rd January 2017 - 18:54

 

Colmspilled the beans

— mistake, main css file must live in theme/balsamine/static/css/

Monday, 23rd January 2017 - 19:08

 

Alex Lerayblabed out

— home test

Tuesday, 24th January 2017 - 10:03

 

Pierre Huyghebaerttold

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Tuesday, 24th January 2017 - 18:05

 

Pierre Huyghebaertconfessed

— Added a first svg layout

Tuesday, 24th January 2017 - 18:06

 

Pierre Huyghebaertcomplained

— Added pictures and home screen

Wednesday, 25th January 2017 - 18:27

 

Colmclaimed

— changes to conf file, get categories on menu

Tuesday, 24th January 2017 - 18:20

 

Colmbabbled out

— Many additions to the theme;
* a compass structure for style management
* libs/ contains structural settings and functions
* partials contains the body of the css, just split into thematics
* screen.scss gathers all of the stuffs together
* config.rb is the settings for compass to know where things are, and where to put generated files

Tuesday, 24th January 2017 - 18:21

 

Colmlet on

— some sample content to start working on the demo

Tuesday, 24th January 2017 - 18:26

 

Colmpeached

— for some reason, output/ still shows up on my git status

Tuesday, 24th January 2017 - 18:26

 

Colmshouted

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Tuesday, 24th January 2017 - 18:27

 

Pierre Huyghebaertrendered

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 18:27

 

Antoine-Gelgonlet the cat out of the bag

— timeline with months -> layout

Wednesday, 25th January 2017 - 18:29

 

Pierre Huyghebaertuttered

— Tuned home screen

Wednesday, 25th January 2017 - 19:03

 

Alex Leraystated

— started to hand-code a list of events, based on the current season

Wednesday, 25th January 2017 - 18:38

 

Alex Leraylet out

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 18:39

 

Pierre Huyghebaertbabbled out

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 19:04

 

Pierre Huyghebaertbabbled out

— Added 1 spectacle avec galerie

Wednesday, 25th January 2017 - 19:39

 

Colmtold

— weird either or condition present in base template, disableing menu include of both pages and categories

Wednesday, 25th January 2017 - 18:21

 

Colmtold

— ignore sass-cache

Wednesday, 25th January 2017 - 18:57

 

Colmpublished

— settings & type changes

Wednesday, 25th January 2017 - 18:58

 

Colmpublished

— template changes

Wednesday, 25th January 2017 - 18:58

 

Colmstated

— extra configs for menu

Wednesday, 25th January 2017 - 19:00

 

Colmbring out

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 19:15

 

Colmrevealed

— adding a template file for ref & demo's sake

Wednesday, 25th January 2017 - 19:36

 

colmgave away

— Update template.md removing values for template

Wednesday, 25th January 2017 - 19:39

 

Pierre Huyghebaertsong

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 19:39

 

Pierre Huyghebaertsaid

— Added 1 full navigation

Wednesday, 25th January 2017 - 20:28

 

colmsaid

— Add new file

Wednesday, 25th January 2017 - 19:54

 

colmverbalised

— Update template.md

Wednesday, 25th January 2017 - 19:56

 

Colmexpressed

— file misplaced

Wednesday, 25th January 2017 - 20:02

 

colmcomplained

— Update Uniforme.md

Wednesday, 25th January 2017 - 20:03

 

Pierre Huyghebaertargued

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 25th January 2017 - 20:28

 

Sarah Magnanbring out

— mobile sarah

Wednesday, 25th January 2017 - 21:22

 

Sarah Magnanargued

— mobile sarah

Wednesday, 25th January 2017 - 21:36

 

Pierre Huyghebaertconfessed

— Added an updated version, mobile with details, first desktop

Thursday, 9th February 2017 - 09:58

 

colmtweeted

— Update Should-I-stay-or-should-I-stay.md

Thursday, 26th January 2017 - 11:49

 

Colmlet loose

— beginning of working doc for new structure of Balsamine.be

Thursday, 2nd February 2017 - 22:22

 

Pierre Huyghebaertlet the cat out of the bag

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Thursday, 9th February 2017 - 09:59

 

Pierre Huyghebaertgave away

— Added png and pdf version

Thursday, 9th February 2017 - 10:01

 

Sarah Magnanclaimed

— beikaitoru and damier

Friday, 3rd March 2017 - 17:38

 

Pierre Huyghebaertlet on

— Added the begin of a solution for festivals

Friday, 3rd March 2017 - 17:36

 

Sarah Magnanunwraped

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Friday, 3rd March 2017 - 17:38

 

Sarah Magnantattled

— la boite

Friday, 3rd March 2017 - 18:44

 

Sarah Magnansaid

— desktop boite

Friday, 10th March 2017 - 17:42

 

Sarah Magnangave away

— boite desktop

Friday, 10th March 2017 - 17:54

 

Antoine-Gelgonshouted

— début du chantier de la ume stroke stroke

Friday, 17th March 2017 - 18:34

 

Sarah Magnanunwraped

— desktop en plusieurs fenetres

Friday, 17th March 2017 - 18:31

 

Antoine-Gelgondisclosed

— début du chantier de la ume stroke stroke

Friday, 17th March 2017 - 18:34

 

Antoine-Gelgonclaimed

— umeStrokeStroke, bas de casse abenmils, haut de casse, ABCDEMNSI

Monday, 20th March 2017 - 12:31

 

Antoine-Gelgonverbalised

— iceberg test font

Monday, 20th March 2017 - 12:51

 

Antoine-Gelgonverbalized

— bakime chaumont typp

Thursday, 6th April 2017 - 23:16

 

Colmwhistled

— start of a prototype folder for front end translations

Friday, 24th March 2017 - 15:05

 

Colmunwraped

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Friday, 24th March 2017 - 15:06

 

Colmargued

— template

Thursday, 6th April 2017 - 23:11

 

Sarah Magnansaid

— pass cartes collections

Tuesday, 4th April 2017 - 18:37

 

Alex Leraypeached

— Content

Monday, 3rd April 2017 - 01:27

 

Sarah Magnanuttered

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Tuesday, 4th April 2017 - 18:37

 

Sarah Magnanbabbled out

— gradient

Wednesday, 5th April 2017 - 12:46

 

Pierre Huyghebaerttold

— Modified mobile layout with balsa infos and gradients

Wednesday, 5th April 2017 - 12:47

 

Sarah Magnanbring out

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 5th April 2017 - 13:24

 

Alex Lerayspoke

— Trying to get my head around this scrollbar thing

Thursday, 6th April 2017 - 22:50

 

Colmblabed out

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Thursday, 6th April 2017 - 23:15

 

Antoine-Gelgonexposed

— bakime chaumont typp

Thursday, 6th April 2017 - 23:17

 

Alex Lerayinterpreted

— Do not track generated HTML

Monday, 10th April 2017 - 15:00

 

Alex Leraysaid

— Saison 2016-2017 -> saison-16-17

Monday, 10th April 2017 - 15:53

 

Antoine-Gelgonspilled the beans

— set -> d p q r t u

Wednesday, 12th April 2017 - 01:33

 

Colm O'Neillspoke

— loads of small mods to the content pages, pelican needs the date metadata for example, and pages/ also need titles and dates

Wednesday, 12th April 2017 - 23:57

 

Colm O'Neillconfessed

— a few extra lines to the README about compiling scss with compass

Wednesday, 12th April 2017 - 23:58

 

Colm O'Neillspilled the beans

— all the mods to the styles and index / base template to make home page

Wednesday, 12th April 2017 - 23:59

 

Colm O'Neilltweeted

— small changed in config, no pagination, no pages in nav

Wednesday, 12th April 2017 - 23:59

 

Antoine-Gelgoncomplained

— set -> all lowercase

Wednesday, 12th April 2017 - 23:57

 

Colm O'Neilltalked

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Thursday, 13th April 2017 - 00:00

 

Colm O'Neillverbalized

— small changes in prep of making the event list a template include, problem with the python scope atm

Thursday, 13th April 2017 - 00:57

 

Colmspoke

— multiple moves and progressions:

* Moved the 'timeline' logic to the base template, inside a {% block %} for the scope to be available on all pages
* outputting {{article.content}} to the timeline too, in the mobile version, it will only be .toggles() of this section
* still working on the mobile first
* unsure about the logic of the timeline links on desktop pointing to specific urls, and the mobile timeline links just being expands, is that really compatible?

Thursday, 13th April 2017 - 16:19

 

Colmbabbled

— compiled css

Thursday, 13th April 2017 - 16:22

 

Colmbring out

— a Key_image key everywhere

Thursday, 13th April 2017 - 17:07

 

Colmtold

— scrollbar logic

Thursday, 13th April 2017 - 17:19

 

Alex Lerayverbalised

— A pelican plugin to process start and end dates

Friday, 14th April 2017 - 17:52

 

Alex Lerayexposed

— Content formatting and settings pimping

Friday, 14th April 2017 - 19:56

 

Alex Lerayspoke

— WIP. S & P layout. Back to pure CSS for now.

Saturday, 15th April 2017 - 17:59

 

Alex Lerayblabed out

— Formatting content

Saturday, 15th April 2017 - 19:37

 

Alex Leraysaid

— We don't need start_date anymore

Saturday, 15th April 2017 - 19:44

 

Alex Lerayargued

— Début d'intégration de la timeline

Sunday, 16th April 2017 - 01:20

 

alexandreargued

— Update billeterie.md

Monday, 17th April 2017 - 17:51

 

alexandreblabed out

— Update etna.md

Monday, 17th April 2017 - 18:47

 

alexandreclaimed

— Update etna.md

Monday, 17th April 2017 - 18:50

 

Alex Leraywhistled

— started css for show details + cleaning

Monday, 17th April 2017 - 22:10

 

Colmdiscovered

— small changes to scrollbar

Saturday, 15th April 2017 - 18:03

 

Colmsong

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Saturday, 15th April 2017 - 18:03

 

Colmsaid

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 17th April 2017 - 12:30

 

Colmbabbled

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 17th April 2017 - 21:28

 

Colmpublished

— URL settings for articles and pages

Monday, 17th April 2017 - 22:09

 

Alex Leraydiscovered

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 17th April 2017 - 22:12

 

Alex Lerayclaimed

— General pages content

Monday, 17th April 2017 - 23:24

 

Colmconfessed

— naming sections pen and paper

Monday, 17th April 2017 - 22:51

 

Antoine-Gelgontweeted

— Bientôt toutes les uppercases

Monday, 17th April 2017 - 22:24

 

Antoine-Gelgonuttered

— merge

Monday, 17th April 2017 - 22:25

 

Colmstated

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 17th April 2017 - 22:52

 

Alex Leraydivulged

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 17th April 2017 - 23:24

 

Colmlet on

— changes to naming sections

Tuesday, 18th April 2017 - 08:18

 

Colmtalked

— filling pratique.md

Tuesday, 18th April 2017 - 08:32

 

alexandretalked

— Update etna.md

Tuesday, 18th April 2017 - 16:41

 

alexandreironized

— Update etna.md

Tuesday, 18th April 2017 - 16:49

 

Antoine-Gelgonsaid

— all number !!

Tuesday, 18th April 2017 - 18:06

 

Antoine-Gelgonlet out

— font -> []()çèà

Friday, 28th April 2017 - 00:49

 

Colmgave away

— testing languages / translations and made a rough template to use when making a new document in pages

Monday, 24th April 2017 - 15:59

 

Alex Leraylet the cat out of the bag

— Few changes to the content and CSS

Wednesday, 19th April 2017 - 18:35

 

Pierre Huyghebaertblabed

— Added details about the font and potential use on the web

Wednesday, 19th April 2017 - 20:02

 

Alex Lerayironized

— fix layout pour la présentation

Friday, 21st April 2017 - 10:30

 

alexandrestated

— Update i-clit.md

Friday, 21st April 2017 - 10:51

 

alexandrebring out

— Update billeterie.md

Friday, 21st April 2017 - 11:39

 

alexandretalked

— Update billeterie.md

Friday, 21st April 2017 - 11:42

 

alexandrebabbled out

— Update billeterie.md

Friday, 21st April 2017 - 11:43

 

Colmclaimed

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 24th April 2017 - 16:01

 

Gabrielargued

— Added a tuto for users to add content on thye website

Wednesday, 26th April 2017 - 12:52

 

Alex Leraytalked

— Fix phone number

Wednesday, 26th April 2017 - 11:04

 

Alex Leraytweeted

— Redispatached the content

Wednesday, 26th April 2017 - 12:53

 

Gabrieltold

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Wednesday, 26th April 2017 - 15:28

 

Gabrielsaid

— Cleaned how-to.md and moved screenshot to /content/images/how_to/

Wednesday, 26th April 2017 - 15:34

 

Gabrielbabbled

— New screenshot for the how to

Thursday, 27th April 2017 - 11:07

 

Gabrielcried

— Updated howto file

Thursday, 27th April 2017 - 14:18

 

Antoine-Gelgonpeached

— font -> []()çèà

Friday, 28th April 2017 - 00:50

 

Antoine-Gelgontalked

— First TTF and SFD

Friday, 28th April 2017 - 10:56

 

Alex Lerayspilled the beans

— A few classes renaming

Monday, 1st May 2017 - 16:43

 

Alex Leraypublished

— css cleaning

Monday, 1st May 2017 - 18:23

 

Alex Lerayexposed

— Simplified the requirements and markdown figures

Friday, 5th May 2017 - 00:00

 

Colmconfessed

— .sass-cache stil causing trouble

Saturday, 6th May 2017 - 13:38

 

Antoine-Gelgonbring out

— new font Versions 'thin-thin' 'fat-fat'

Monday, 8th May 2017 - 23:00

 

Antoine-Gelgonsong

— new font Versions 'thin-thin' 'fat-fat'

Monday, 8th May 2017 - 23:00

 

Colmlet the cat out of the bag

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 15th May 2017 - 16:44

 

Colmtalked

— attempting a lightened web layout

Monday, 15th May 2017 - 16:45

 

Alex Leraytweeted

— Merge branch 'master' of gitlab.constantvzw.org:osp/work.balsamine.www

Monday, 15th May 2017 - 17:17

 

Alex Lerayemited

— exemple plugin to implement postcss based on yuicompressor

Tuesday, 23rd May 2017 - 11:31

 

Alex Leraygave away

— Carroussel and a class name fixes in css

Tuesday, 23rd May 2017 - 12:30