Pandoc

Background

I’m writing my guide for preparing simple documents. I hope that users can prepare documents efficiently and the prepared documents look smart.

Problem

To help readers get my message in the linked guide, I used many icons from Font Awesome. However, it doesn’t include pandoc’s logo. I tried searching that using the search string “pandoc logo filetype:svg”. Duckduckgo couldn’t find any results. Luckily, Google found many SVGs. The first result linked to a relevant discussion on Google Groups. However, all posts were collapsed, and the desired SVG didn’t show up.

1. my HTML slides
2. You may view the source code of this blog to see the source files.

Goal

To provide an introduction to the formal definition of functions for arts stream students.

I aim to

1. minimize the calculations
2. use daily-life examples
3. favor pictures over text.

IT skills used

Inkscape

1. C-S-a for alignment.
2. C-S-f for boundary and colors, and line patterns (i.e. arrows).
3. C-S-d for document size.
4. clipping process:
   1. prepare the object to be clipped.
   2. prepare the clip, which is on top of the previous object.
   3. select Object → Clip and then the first option from the top menu.

dvisvgm

Use the TEX → DVI → SVG route with latex and this tool with options --font-format=woff and -b 5 -R -d 2 to save file size and to ensure that the SVG can be correctly opened on Inkscape.

Goal

To provide an open-source alternative to the Docker image escalope/pandoc-mermaid-plantuml, whose Dockerfile isn’t available.

The rationale behind these difficult setup is simple: construct informative Mermaid diagram with intuitive Markdown syntax in an open-source and economic way.

This newly constructed Docker image is entirely on GitLab. No Docker Hub account is needed. For sample usage, consult .gitlab-ci.yml in my test project.

Difficulties

1. issues raghur/mermaid-filter#51 and #52
2. issue gitlab-org/gitlab-runner#4566

Useful code/articles

1. time-machine-project/requests-for-comments@470b0c5 Dockerfile
2. Reduce Docker Image Sizes Using Alpine
3. Best practices for building docker images with GitLab CI with the accompanying gist
4. The code block in the highlighted comment in item 2 of the above section
5. pandoc installation for Docker
6. Sample Dockerfile for Alpine Linux in the troubleshooting of Puppeteer
7. sc250024/docker-mermaid-cli@3c9ddb5 src/puppeteerConfigFile.json
8. raghur/mermaid-filter project README’s section about Puppeteer config file