Posts about webdevelopment

GitHub Pages with GitHub Flavored Markdown, footnotes and syntax highlighting simplified

Another update regarding the use of GitHub Flavored Markdown on GitHub Pages. GitHub Pages has updated its Jekyll version to 3.0 on the first of February 2016.
This update includes a switch to kramdown as its Markdown parser as well as only supporting Rouge as syntax highlighter. This means we’re effectively back to the original setup from 2013 but because all of these components have received some updates in the meantime everything is now supported out of the box.

GitHub Pages, now with GitHub Flavored Markdown, footnotes and syntax highlighting

Update: As of the first of February 2016 GitHub Pages handles GFM, footnotes and syntax highlighting out of the box, no configuration required.
See this new post for more details.

In contrast to what I wrote 1,5 years ago it’s now possible to use all of GitHub Flavored Markdown’s features combined with footnotes and syntax highlighting on your Jekyll site whilst still having GitHub Pages build your site for you.
Building your site locally and then pushing the resulting HTML is a thing of the past! :)

Configuring Nikola

After I decided to switch this blog over from Jekyll to Nikola the first thing to do was to configure Nikola to my liking.
Nikola offers plenty of options to configure, as of this writing it has more than 100 settings for all of its options! Since I want something as lean as possible some tweaking and workarounds were necessary to make it work the way I wanted to. This post will cover the way I configured Nikola.

HTML heading styling inside a section vs inside a div

Just quick heads-up in case someone is wondering why his or hers <h1> isn’t looking like they expect.
Modern browsers apply different styling for <h1> elements inside a <div> vs inside one of the new semantic elements like <article>, <aside>, <nav> or <section>.
This is because these new semantic elements influence the document outline and the modern browsers try to show that to you in a graphical way.

Jekyll, Github Flavored Markdown and footnotes

Update: As of Jekyll 2.0.0 it’s possible to have our GitHub Pages cake and eat it :)
See this new post for more details.

Jekyll uses redcarpet as its default Markdown parser for newly generated sites as of version v1.1.0. It does so by setting markdown: redcarpet in _config.yml.
Redcarpet is the markdown parser used by GitHub, but in its default config it actually doesn’t parse using the GitHub Flavored Markdown (GFM) rules.