coursebuilder/README.md

43 lines
1.5 KiB
Markdown
Raw Normal View History

2023-11-02 22:17:33 +01:00
# CourseBuilder
2023-11-08 15:40:05 +01:00
Coursebuilder is a preprocessor tool for [pandoc](https://pandoc.org)
to generate multi-lingual curricula documentation tables from
structured representations as a flatfile database. Data scheme and
actual values are kept in YAML files in order to version them with git.
2023-11-02 22:17:33 +01:00
2023-11-08 15:32:41 +01:00
# Usage
```sh
$> python coursebuilder
2024-04-21 15:51:11 +02:00
usage: [-h] [-m META [META ...]] [-l LANG] [-f FIELDS [FIELDS ...]] [-s SCHEMA] [-p] [-t] [-b BOOK] [--level LEVEL]
[--table-gen TABLE_GEN]
2023-11-11 22:47:12 +01:00
versatile curricula generator
2023-11-08 15:32:41 +01:00
options:
-h, --help show this help message and exit
-m META [META ...], --meta META [META ...]
course description(s) as YAML file(s)
-l LANG, --lang LANG Language to parse from meta file (use de or en)
-f FIELDS [FIELDS ...], --fields FIELDS [FIELDS ...]
2023-11-11 22:47:12 +01:00
Fields to be used, the table will be build accordingly
2023-11-08 15:32:41 +01:00
-s SCHEMA, --schema SCHEMA
using provided schema
2023-11-11 22:47:12 +01:00
-p, --pagebreak add a pagebreak after each module
-t, --title take first value in list as title
-b BOOK, --book BOOK process a whole curriculum book with sections
2024-04-21 15:51:11 +02:00
--level LEVEL level of header tags
--table-gen TABLE_GEN
runs table generator
2023-11-08 15:32:41 +01:00
```
2023-11-08 15:40:05 +01:00
# Author
2024-04-21 15:51:11 +02:00
© Copyright 2020-2024 Hartmut Seichter
2023-11-08 15:40:05 +01:00
2023-11-02 22:17:33 +01:00
# Licence
Coursebuilder is licensed under the terms of the MIT License. For details consult https://opensource.org/license/mit/ or the attached license file
2023-11-08 15:32:41 +01:00