https://vincenttam.gitlab.io/tags/mermaid/ Recent content in Mermaid on Solarized Sublime Sekai Hugo en Sat, 11 Jun 2022 00:14:49 +0200 https://vincenttam.gitlab.io/post/2020-08-28-pandoc-latex-mermaid-on-gitlab-ci/ Fri, 28 Aug 2020 09:26:29 +0200 https://vincenttam.gitlab.io/post/2020-08-28-pandoc-latex-mermaid-on-gitlab-ci/ <h3 id="goal">Goal</h3> <p>To provide an open-source alternative to the Docker image <a href="https://hub.docker.com/r/escalope/pandoc-mermaid-plantuml">escalope/pandoc-mermaid-plantuml</a>, whose <code>Dockerfile</code> isn&rsquo;t available.</p> <p>The rationale behind these difficult setup is simple: construct informative <a href="https://mermaid-js.github.io/">Mermaid</a> diagram with intuitive <a href="https://daringfireball.net/projects/markdown">Markdown</a> syntax in an open-source and economic way.</p> <p>This <a href="https://gitlab.com/VincentTam/pandoc-mermaid-docker/container_registry">newly constructed Docker image</a> is entirely on GitLab. No Docker Hub account is needed. For sample usage, consult <code>.gitlab-ci.yml</code> in <a href="https://gitlab.com/VincentTam/test_pandoc">my test project</a>.</p> <h3 id="difficulties">Difficulties</h3> <ol> <li>issues <a href="https://github.com/raghur/mermaid-filter/issues/51">raghur/mermaid-filter#51</a> and <a href="https://github.com/raghur/mermaid-filter/issues/52">#52</a></li> <li>issue <a href="https://gitlab.com/gitlab-org/gitlab-runner/-/issues/4566#note_199261985">gitlab-org/gitlab-runner#4566</a></li> </ol> <h3 id="useful-codearticles">Useful code/articles</h3> <ol> <li><a href="https://github.com/time-machine-project/requests-for-comments/blob/470b0c5fdb8c1375ab8726c86b453cb9945e4be2/build/Dockerfile">time-machine-project/requests-for-comments@<code>470b0c5</code></a> <code>Dockerfile</code></li> <li><a href="https://sandtable.com/reduce-docker-image-sizes-using-alpine/"><em>Reduce Docker Image Sizes Using Alpine</em></a></li> <li><a href="https://blog.callr.tech/building-docker-images-with-gitlab-ci-best-practices/"><em>Best practices for building docker images with GitLab CI</em></a> with <a href="https://gist.github.com/florentchauveau/2dc4da0299d42258606fc3b0e148fc07">the accompanying gist</a></li> <li>The code block in the highlighted comment in item 2 of the above section</li> <li><a href="https://pandoc.org/installing.html#docker">pandoc installation for Docker</a></li> <li>Sample <code>Dockerfile</code> for Alpine Linux in the <a href="https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-on-alpine">troubleshooting of Puppeteer</a></li> <li><a href="https://github.com/sc250024/docker-mermaid-cli/blob/3c9ddb5fa7f240bbc96488674ae506ec091735d8/src/puppeteerConfigFile.json">sc250024/docker-mermaid-cli@<code>3c9ddb5</code></a> <code>src/puppeteerConfigFile.json</code></li> <li><a href="https://github.com/raghur/mermaid-filter">raghur/mermaid-filter</a> project README&rsquo;s section about Puppeteer config file</li> </ol>