gitlab-training icon indicating copy to clipboard operation
gitlab-training copied to clipboard

Evaluate Pandoc for converting README.md to README.html

Open htriem opened this issue 3 years ago • 1 comments

While the solution using Python and Pygments is working like a charm, new types of exercises/tests/demonstrations for CI/CD would be welcome. It might be a good idea to take a look at Pandoc and it's usefulness for the exercises.

htriem avatar May 06 '21 14:05 htriem

IIRC using pandoc would have caused students to type much more, causing more errors than using a Python module. Side benefit of the exercise was that students learn how to install dependencies in a CI/CD job. One possible iteration could be using a requirements.txt in the repo first, and then run pip install -r requirements.txt in the before_script section.

Part of the 2019 OSMC workshop and advanced training material was building Go code. In my community workshops at GitLab, I have been expanding on this and we built a Go Tanuki to fix and build, and run. Could be an idea for you as well.

https://about.gitlab.com/handbook/marketing/community-relations/developer-evangelism/projects/#workshops has more insights and links the template repository.

dnsmichi avatar May 13 '21 08:05 dnsmichi

Will close this in favour of #201 - Michis arguments are pretty solid here and I think we will stick with the pygments and build on that :)

theFeu avatar Feb 16 '23 12:02 theFeu