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

 

Colmpeached

— foundations for the new Balsamine website

Monday, 16th January 2017 - 18:42

 

Colmsaid

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

Monday, 16th January 2017 - 19:01

 

Colmblabed out

— these are the content space for pelican

Monday, 16th January 2017 - 19:02

 

Colmsaid

— ignore .pyc

Monday, 16th January 2017 - 19:02

 

Colmironized

— written instructions for using pelican

Monday, 16th January 2017 - 19:32

 

Colmshouted

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

Monday, 16th January 2017 - 19:51

 

Colmexpressed

— adding a balsa logo svg to decorate readme

Monday, 16th January 2017 - 19:58

 

colmverbalised

— self hosted images in readme?

Monday, 16th January 2017 - 19:59

 

Colmdivulged

— do links to internal images work from the readme?

Tuesday, 17th January 2017 - 11:42

 

Pierre Huyghebaertexposed

— Added a first sketch

Tuesday, 24th January 2017 - 18:05

 

Colmtweeted

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

Monday, 23rd January 2017 - 18:54

 

Colmverbalized

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

Monday, 23rd January 2017 - 19:08

 

Alex Leraysaid

— home test

Tuesday, 24th January 2017 - 10:03

 

Pierre Huyghebaerttalked

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

Tuesday, 24th January 2017 - 18:05

 

Pierre Huyghebaertrendered

— Added a first svg layout

Tuesday, 24th January 2017 - 18:06

 

Pierre Huyghebaertsaid

— Added pictures and home screen

Wednesday, 25th January 2017 - 18:27

 

Colmdisclosed

— changes to conf file, get categories on menu

Tuesday, 24th January 2017 - 18:20

 

Colmtattled

— 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

 

Colmcomplained

— some sample content to start working on the demo

Tuesday, 24th January 2017 - 18:26

 

Colmbring out

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

Tuesday, 24th January 2017 - 18:26

 

Colmunwraped

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

Tuesday, 24th January 2017 - 18:27

 

Pierre Huyghebaerttweeted

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

Wednesday, 25th January 2017 - 18:27

 

Antoine-Gelgonsaid

— timeline with months -> layout

Wednesday, 25th January 2017 - 18:29

 

Pierre Huyghebaertexpressed

— Tuned home screen

Wednesday, 25th January 2017 - 19:03

 

Alex Leraybabbled

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

Wednesday, 25th January 2017 - 18:38

 

Alex Lerayblabed

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

Wednesday, 25th January 2017 - 18:39

 

Pierre Huyghebaertsaid

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

Wednesday, 25th January 2017 - 19:04

 

Pierre Huyghebaertverbalized

— Added 1 spectacle avec galerie

Wednesday, 25th January 2017 - 19:39

 

Colmdisclosed

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

Wednesday, 25th January 2017 - 18:21

 

Colmemited

— ignore sass-cache

Wednesday, 25th January 2017 - 18:57

 

Colmspilled the beans

— settings & type changes

Wednesday, 25th January 2017 - 18:58

 

Colmstated

— template changes

Wednesday, 25th January 2017 - 18:58

 

Colmclaimed

— extra configs for menu

Wednesday, 25th January 2017 - 19:00

 

Colmargued

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

Wednesday, 25th January 2017 - 19:15

 

Colmcried

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

Wednesday, 25th January 2017 - 19:36

 

colmclaimed

— Update template.md removing values for template

Wednesday, 25th January 2017 - 19:39

 

Pierre Huyghebaertsaid

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

Wednesday, 25th January 2017 - 19:39

 

Pierre Huyghebaertpublished

— Added 1 full navigation

Wednesday, 25th January 2017 - 20:28

 

colmpublished

— Add new file

Wednesday, 25th January 2017 - 19:54

 

colmverbalized

— Update template.md

Wednesday, 25th January 2017 - 19:56

 

Colmtalked

— file misplaced

Wednesday, 25th January 2017 - 20:02

 

colmbabbled out

— Update Uniforme.md

Wednesday, 25th January 2017 - 20:03

 

Pierre Huyghebaertlet the cat out of the bag

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

Wednesday, 25th January 2017 - 20:28

 

Sarah Magnanblabed out

— mobile sarah

Wednesday, 25th January 2017 - 21:22

 

Sarah Magnandivulged

— mobile sarah

Wednesday, 25th January 2017 - 21:36

 

Pierre Huyghebaertbring out

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

Thursday, 9th February 2017 - 09:58

 

colmcomplained

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

Thursday, 26th January 2017 - 11:49

 

Colmuttered

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

Thursday, 2nd February 2017 - 22:22

 

Pierre Huyghebaerttalked

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

Thursday, 9th February 2017 - 09:59

 

Pierre Huyghebaertsaid

— Added png and pdf version

Thursday, 9th February 2017 - 10:01

 

Sarah Magnanspoke

— beikaitoru and damier

Friday, 3rd March 2017 - 17:38

 

Pierre Huyghebaertrevealed

— Added the begin of a solution for festivals

Friday, 3rd March 2017 - 17:36

 

Sarah Magnanpublished

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

Friday, 3rd March 2017 - 17:38

 

Sarah Magnanblabed

— la boite

Friday, 3rd March 2017 - 18:44

 

Sarah Magnanrevealed

— desktop boite

Friday, 10th March 2017 - 17:42

 

Sarah Magnanverbalized

— boite desktop

Friday, 10th March 2017 - 17:54

 

Antoine-Gelgonconfessed

— début du chantier de la ume stroke stroke

Friday, 17th March 2017 - 18:34

 

Sarah Magnanblabed out

— desktop en plusieurs fenetres

Friday, 17th March 2017 - 18:31

 

Antoine-Gelgoninterpreted

— début du chantier de la ume stroke stroke

Friday, 17th March 2017 - 18:34

 

Antoine-Gelgonsaid

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

Monday, 20th March 2017 - 12:31

 

Antoine-Gelgonverbalized

— iceberg test font

Monday, 20th March 2017 - 12:51

 

Antoine-Gelgonbabbled

— bakime chaumont typp

Thursday, 6th April 2017 - 23:16

 

Colmcomplained

— start of a prototype folder for front end translations

Friday, 24th March 2017 - 15:05

 

Colmclaimed

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

Friday, 24th March 2017 - 15:06

 

Colmbabbled

— template

Thursday, 6th April 2017 - 23:11

 

Sarah Magnanpeached

— pass cartes collections

Tuesday, 4th April 2017 - 18:37

 

Alex Leraydiscovered

— Content

Monday, 3rd April 2017 - 01:27

 

Sarah Magnanverbalised

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

Tuesday, 4th April 2017 - 18:37

 

Sarah Magnanwhistled

— gradient

Wednesday, 5th April 2017 - 12:46

 

Pierre Huyghebaertlet on

— Modified mobile layout with balsa infos and gradients

Wednesday, 5th April 2017 - 12:47

 

Sarah Magnanrendered

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

Wednesday, 5th April 2017 - 13:24

 

Alex Leraywhispered

— Trying to get my head around this scrollbar thing

Thursday, 6th April 2017 - 22:50

 

Colmstated

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

Thursday, 6th April 2017 - 23:15

 

Antoine-Gelgoncried

— bakime chaumont typp

Thursday, 6th April 2017 - 23:17

 

Alex Leraycried

— Do not track generated HTML

Monday, 10th April 2017 - 15:00

 

Alex Leraylet loose

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

Monday, 10th April 2017 - 15:53

 

Antoine-Gelgonsaid

— set -> d p q r t u

Wednesday, 12th April 2017 - 01:33

 

Colm O'Neillclaimed

— 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'Neillwhistled

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

Wednesday, 12th April 2017 - 23:58

 

Colm O'Neillverbalized

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

Wednesday, 12th April 2017 - 23:59

 

Colm O'Neillstated

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

Wednesday, 12th April 2017 - 23:59

 

Antoine-Gelgonexposed

— set -> all lowercase

Wednesday, 12th April 2017 - 23:57

 

Colm O'Neilllet loose

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

Thursday, 13th April 2017 - 00:00

 

Colm O'Neillblabed

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

Thursday, 13th April 2017 - 00:57

 

Colmbring out

— 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

 

Colmuttered

— compiled css

Thursday, 13th April 2017 - 16:22

 

Colmbring out

— a Key_image key everywhere

Thursday, 13th April 2017 - 17:07

 

Colmstated

— scrollbar logic

Thursday, 13th April 2017 - 17:19

 

Alex Leraywhistled

— A pelican plugin to process start and end dates

Friday, 14th April 2017 - 17:52

 

Alex Leraygave away

— Content formatting and settings pimping

Friday, 14th April 2017 - 19:56

 

Alex Leraytold

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

Saturday, 15th April 2017 - 17:59

 

Alex Leraypublished

— Formatting content

Saturday, 15th April 2017 - 19:37

 

Alex Lerayexpressed

— We don't need start_date anymore

Saturday, 15th April 2017 - 19:44

 

Alex Lerayexposed

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

Sunday, 16th April 2017 - 01:20

 

alexandregave away

— Update billeterie.md

Monday, 17th April 2017 - 17:51

 

alexandrespilled the beans

— Update etna.md

Monday, 17th April 2017 - 18:47

 

alexandrecomplained

— Update etna.md

Monday, 17th April 2017 - 18:50

 

Alex Lerayspilled the beans

— started css for show details + cleaning

Monday, 17th April 2017 - 22:10

 

Colmshouted

— small changes to scrollbar

Saturday, 15th April 2017 - 18:03

 

Colmspilled the beans

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

Saturday, 15th April 2017 - 18:03

 

Colmtold

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

Monday, 17th April 2017 - 12:30

 

Colmlet the cat out of the bag

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

Monday, 17th April 2017 - 21:28

 

Colmargued

— URL settings for articles and pages

Monday, 17th April 2017 - 22:09

 

Alex Leraywhistled

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

Monday, 17th April 2017 - 22:12

 

Alex Leraystated

— General pages content

Monday, 17th April 2017 - 23:24

 

Colmdiscovered

— naming sections pen and paper

Monday, 17th April 2017 - 22:51

 

Antoine-Gelgonblabed

— Bientôt toutes les uppercases

Monday, 17th April 2017 - 22:24

 

Antoine-Gelgonsong

— merge

Monday, 17th April 2017 - 22:25

 

Colmlet on

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

Monday, 17th April 2017 - 22:52

 

Alex Leraywhispered

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

Monday, 17th April 2017 - 23:24

 

Colmblabed

— changes to naming sections

Tuesday, 18th April 2017 - 08:18

 

Colmtattled

— filling pratique.md

Tuesday, 18th April 2017 - 08:32

 

Colmlet loose

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

Monday, 24th April 2017 - 15:59

 

alexandrewhistled

— Update etna.md

Tuesday, 18th April 2017 - 16:41

 

alexandrelet loose

— Update etna.md

Tuesday, 18th April 2017 - 16:49

 

Antoine-Gelgonargued

— all number !!

Tuesday, 18th April 2017 - 18:06

 

Alex Leraytold

— Few changes to the content and CSS

Wednesday, 19th April 2017 - 18:35

 

Pierre Huyghebaerttalked

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

Wednesday, 19th April 2017 - 20:02

 

Alex Leraytalked

— fix layout pour la présentation

Friday, 21st April 2017 - 10:30

 

alexandrerevealed

— Update i-clit.md

Friday, 21st April 2017 - 10:51

 

alexandredivulged

— Update billeterie.md

Friday, 21st April 2017 - 11:39

 

alexandretattled

— Update billeterie.md

Friday, 21st April 2017 - 11:42

 

alexandreverbalised

— Update billeterie.md

Friday, 21st April 2017 - 11:43

 

Colmlet out

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

Monday, 24th April 2017 - 16:01