All pages and tag-pages with nav-weight in frontmatter go to menu. They are sorted by nav-weight from frontmatter (small values go first).

_config.dev.yml is extremely useful during development. It can alter some variables. Start Jekyll with

jekyll build --config "_config.yml,_config.dev.yml" --watch

All posts are treated as they have tag Newest. We add it in _includes/posts.html

• tag — tag to filter. Register sensetive.
• limit — number of posts. Skip to output all.
• avatar-alignment — avatar alignment
• sort — name of filed to sort. Skip to filter by date.

You can skip any of posts.html parameters.

Stories blog post are supposed to be reviewed and get feedback before being published, check our handbook: https://github.com/Praqma/handbook/blob/master/the_orange_way/blogging.md

Fire up the website to browse it locally using our gh-pages container: https://github.com/Praqma/docker-gh-pages

Use: docker run -i -t -v /home/user/mysite:/home/jenkins -p 4444:4000 praqma/gh-pages jekyll serve --watch --host=0.0.0.0

Usually posts are using published: false to start with so they are not public on our before we coordinate it.

Add the --unpublished parameter to the above command to see those get build and published on local version also.

Convention: all tags should start with capital letter.

To underline header, separate it with |---| or any other acceptable separator

To make table columns have equal width, add equal class to this table like this:

| Small text | Big text |
|-
| Sma... | Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! Big text! |
{:.equal}

It will be rendered to

Unfortunately, kramdown doesn't support caption element of table. So captions should be used like

From *Sapiens, A Brief History of Humankind (Harari)*, pp 41
{:.table-caption}

Heavy things sink to the bottom © @JKrag

Or to the right © @illus0r

Default weight of the post is 0

Employees are described in _employees/ directory. Their images are stored in images/employees/ directory, they should be .png and named after correspondent employee. For example, to add the image for lakruzz.md name it lakruzz.png.

All stories must have an avatar: A picture that will be shown along site the intro (and in the upper right corner on the full format)

The avatar picture shall be in the format 2:1 (height:width) e.g. 800x400px

Also referred to as kicker, standfirst or deck. All stories must have an intro.

• The intro shall set the expectation for the reader.
• It can contain either a summary or a teaser of the article.
• It must work with the title.
• The intro must be one whole section; It can not contain line breaks.
• You should aim for somewhere between 200-400 chars in the intro.

Feel free to reach out to Lars or Mike in case of any questions.