Usually markdown processors will not process anything inside HTML tags. This looks pretty good, but we’re going to run into one big problem. ' # increment for the next collapsible context = idx + 1 content = super output = Templates are also more immediately clear about their intent. This was partly because I don’t want to expend the mental effort to plan and implement a sufficiently natural and robust syntax,Īnd partly because my future self would end up getting into an argument with my former self about his design choices. Or 2) add custom templates to generate the HTML. There are two ways to address this: 1) we can create our own markdown syntax for this and extend an existing markdown converter, A small change to our site’s stylesheets could silently break some of our old posts! Not only is this a lot of boilerplate, but we’ll also have to make sure that our classes and structure match betweenĪll of our posts. If we add this brute force, we’ll have the following plastered in each post using an accordion (per the Bootstrap example): I liked the ability to open and close different explanatory sections, to keep text close to code snippets.Īpparently, accordion blocks are not common enough in markdown (at least in kramdown) to warrant

I’m writing for Drexel University’s introductory digital logic design course. This is a story about adding a Bootstrap-style accordion to the more friendly VHDL guide If you’re interested in anything more in-depth, you’ll have to either browse the source code orįind some other kind soul’s post ( ahem). The GitHub Liquid wiki has a slightly more in depth tutorial with more examples. Jekyll has a nice little tutorial on adding Liquid tags and filters to Jekyll. If you find yourself feeling icky putting HTML in your markdown more than a few times, then read on.

Adding build hooks like post-processing the final rendered HTML.

Extending Liquid with custom templates, and.

New commands (which can overlap other categories).

Adding rules for custom generation of static files.

One really useful feature of Jekyll is the ability to extend Jekyll with plugins.Ī Jekyll plugin will fall into 1 of 5 categories: This is the first real post so I apologize in advance for any dissociative identity disorderĮxhibited in the tone and writing. I thought it would be nice to share some useful tidbits I’ve learned. Let’s start this blog off with some straight-forward informative posts.Īs I’m still updating the look of this site, which uses the popular Jekyll static site generation framework,

Converter accordion method books