Chirun config schema v1

Chirun config files are YAML objects.

Download the schema in JSON-Schema format

Chirun package configuration

object

base_dir

Base directory of the output
string
locale

ISO 639 language code for localisation
string
author

Name of the author
string
institution

Author's institution
string
static_dir

Path to the static files source directory
string
code

Course code
string
year

Year
string
root_url

Root URL of the output
string
build_pdf

Build PDF files?
boolean
num_pdf_runs

Number of runs for building PDFs
number
format_version

Version number of the config format used
number
mathjax_url

URL to load MathJax from
string
structure

Structure
array

Items:

Structure item
themes_dir

Path of the themes directory
string
themes
Themes to use
array
Items:

object

source

Path to the theme
string

title

Title
string

path

Path to the theme's source
string

hidden

Hidden?
boolean
license
License information
object
- name
  
  The name of the license
  string
- by
  
  The copyright holder(s)
  string
- year
  
  The year, or range of years, that the copyright applies to
  string
- url
  
  A URL giving more information about the license
  string

Subschemas

Structure item
Structure item
object
Any of

Option 1

Introduction

type

string
= "introduction"

Option 2

Part

type

string
= "part"

content

Sub-items
array

Items:

Structure item

leading_text

Leading text
string

location

Location
string

Must be one of:

"below"

"above"

thumbnail

Path of thumbnail image
string

Option 3

Document

type

string
= "document"

splitlevel

Structure splitting level
number

Option 4

Chapter

type

string
= "chapter"

Option 5

Standalone

type

string
= "standalone"

Option 6

URL

type

string
= "url"

Option 7

HTML file

type

string
= "html"

Option 8

Slides

type

string
= "slides"

title_slide

Include a title slide?
boolean

Option 9

Numbas Exam

type

string
= "exam"

Option 10

Jupyter Notebook

type

string
= "notebook"
- type
  
  Type
  string
  
  Must be one of:
  
  "introduction"
  
  "part"
  
  "document"
  
  "chapter"
  
  "standalone"
  
  "url"
  
  "html"
  
  "extractedsection"
  
  "slides"
  
  "exam"
  
  "notebook"
- title
  
  Title
  string
- slug
  
  URL slug
  string
- author
  
  Name of the author
  string
- source
  
  Path of the item's source file.
  string
- is_hidden
  
  Is this item hidden?
  boolean
- build_pdf
  
  Build a PDF version?
  boolean
- pdf_url
  
  Output path of the PDF file
  string
- sidebar
  
  Show the sidebar?
  boolean
- topbar
  
  Show the top navigation bar?
  boolean
- footer
  
  Show the page footer?
  boolean