storopoli / storopoli.github.io

Personal Website

storopoli.io

This is my personal site at storopoli.io.

It is built with Hugo and the theme is WonderMod by Wonderfall. WonderMod is a fork of an original theme called PaperMod. Since PaperMod isn't interested in a few changes such as removing inline JavaScript, which I personally require to harden my websites, I am using the WonderMod fork. The search functionality needs JavaScript to be enabled. However, it doesn't break the user experience if JavaScript is disabled.

Deployment is done through a GitHub Action workflow. It is built with Hugo

JavaScript

By default, all JavaScript¹ is disabled. You can enable them in posts by setting the YAML front matter with:

javascript: true

Math Support

Math support can be enabled by setting the YAML front matter with:

math: true

This will load KaTeX under the hood, and anything between $ and $$ will be rendered as inline or equation math using JavaScript.

Check all the supported functions in KaTeX documentation.

Mermaid Support

MermaidJS support can be enabled by setting the YAML front matter with:

mermaid: true

This will load MermaidJS under the hood, and you can specify diagrams and charts with the shortcode:

{{<mermaid>}}
---
title: My Flowchart
---

flowchart LR
a --> b & c --> d
{{</mermaid>}}

They will be rendered automatically using JavaScript.

License

The code is MIT and the content is Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.

Footnotes

1. JavaScript is a security issue. JavaScript enables remote code execution. The browser is millions of lines of code, nobody truly knows what is going on, and often has escalated privileges in your computer. ↩