A showcase of my Jekyll creations. Most of these (except "fancy tables") were co-developed together with FoodRem, a school project undertaken in late 2022, as part of my efforts to streamline our team's developer experience with regards to documentation.
This repository simply consolidates all of my Jekyll creations into one place; feel free to browse through each submodule's repository for more information.
All of the below submodules do not require extra gems, and are therefore GitHub Pages-compatible. This means that you don't have to pre-generate your Jekyll sites before pushing them to GitHub Pages.
Ocassionally, I may add more Jekyll creations to this repository. For now, the following are available:
A Jekyll plugin that allows you to create admonition boxes easily, supporting full Markdown syntax within those boxes.
| Example 1 | Example 2 |
|---|---|
|
Markdown code like this... ```note
This is a note, which is something **you should probably remember**.
```becomes HTML like this... Note This is a note, which is something you should probably remember. |
Markdown code like this... ```warning
Don't ever run `rm -rf /` _unless_ you know what you are doing.
```becomes HTML like this... Warning Don't ever run |
A Jekyll plugin that allows you to create custom, reusable, no-JavaScript tooltips using an easy-to-write syntax.
| Example 1 |
|---|
|
Markdown code like this... * An [[ apple ]]
* Two [[ apple:apples ]]
* [[ apple:Apple ]], not to be confused with the computer company, Apple Inc.becomes HTML like this...
|
A Jekyll plugin that allows you to create tables with a bit more flair than the default Markdown table syntax.
| Example 1 | Example 2 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Markdown code like this... ```table
| OMG, I span 3 columns! \ \ |
|------------------------|------|------|
| That's... | very | nice |
```becomes HTML like this...
|
Markdown code like this... ```table
|------------------------|---------|
| Look, I span two rows! | Looks |
| ^^ | pretty! |
```becomes HTML like this...
|
|||||||||
A Jekyll plugin that adds support for puml and plantuml language tags in Markdown code blocks, allow you to easily embed PlantUML diagrams into your Jekyll sites without having to generate the images manually.
Note that this plugins requires JavaScript to be running in your site visitors' brwosers in order to dynamically generate the PlantUML diagrams on page load.
| Example 1 | Example 2 |
|---|---|
|
Markdown code like this... ```puml
Alice -> Bob: Hi there!
Bob --> Alice: Hello to you too!
```becomes HTML like this... |
Markdown code like this... *Example 2 adapted from SE-EDU's PlantUML guide. ```plantuml
A -up-> Z
B -up-> Z
C -up-> Z
D -up-> Z
A --> 1
B --> 2
C --> 3
D --> 4
'Force B C A D
B -right[hidden]- C
C -right[hidden]- A
A -right[hidden]- D
```becomes HTML like this... |