Skip to content

edinburghhacklab/hacklab-training-generator

Repository files navigation

Hacklab training generator

Generate training documentation from Markdown sources.

Getting started

Prerequisites

jinja2
mistune
pdflatex
python3
texlive-latex-base
texlive-latex-extra

Usage

./generate.py <syllabus_dir> <output_dir>

Syllabus layout

The source syllabuses are written in Markdown and should be named syllabus.md.

Each syllabus should be in its own directory, and directories may be nested to create categories and sub-categories. A syllabus directory may also include related materials, which may be copied to the output directory in a future version.

Example

Directory layout:

./syllabuses/
    Workshop/
        CNC Mill/
            syllabus.md
            materials/
                checklist.pdf
        Bandsaw/
            syllabus.md
./output/

Run:

./generate.py syllabuses/ output/

About

Training documentation generator scripts

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages