A Mutable Log

Head over to https://tewarid.github.io to view posts.

Some useful tips to work with this blog

• Use VS Code, and its myriad plugins, to edit and preview posts

• Run site locally in a Docker container at http://localhost:4000

  ./run-docker.sh

  This works well but I've run into a situation where the Docker container uses excessive CPU time on macOS while idling.

• Don´t use UTF-8 characters in file names of posts

• Use rename.sh Bash script to rename all posts in a folder using title specified in Front Matter

• Liquid makes Markdown less portable, I suggest using only the link filter

  [link to another post]({% link _posts/2018/2018-03-23-status-of-popular-markup-language-standards.md %})

• mermaid.js diagrams can be inserted as follows

  ```mermaid
  classDiagram
      Primate <|-- Gorilla : is a
      Primate : int id
      Primate : brainSize()
  ```
  

• LaTeX can be inserted inline $$\LaTeX$$ or as a block

  $$
  \LaTeX
  $$

  Preview in Code using the following setting for Markdown+Math plugin

  "mdmath.delimiters": "kramdown",

• A custom slate theme is configured in _config.yml and is sourced from https://github.com/tewarid/slate.