Simon van der Veldt

Posts about webdevelopment

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

in webdevelopment

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

in webdevelopment, python

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

in webdevelopment

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

in webdevelopment

Jekyll uses redcarpet as it’s 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 it’s default config it actually doesn’t parse using the GitHub Flavored Markdown (GFM) rules.