(ky-run)

Note

The Chirun project is under active development and so the contents of this documentation are subject to change.

As of February 2024, the Chirun LTI tool and web builder/editor are usable, but we are still working on writing documentation.

Chirun produces flexible and accessible course notes, in a variety of formats, from LaTeX or Markdown source. It is aimed primarily at notes in the mathematical sciences.

Multiple outputs are supported automatically. So, for example, the same source document can produce an HTML web page that can be easily viewed on desktop, mobile or tablet; slides that can be used to give a presentation or lecture; a PDF ready for printing; or a Jupyer notebook.

Chirun can be used to convert either a single input file at a time, or a collection of files combined as a package. It generates static output which can be uploaded to a web server or learning management system for distribution to learners.

There are two parts to Chirun: the processing tool, and a web frontend.

The web frontend at lti.chirun.org.uk is the usual point of entry for most authors.

Users with more particular requirements can use the command-line processing tool on its own.

Introduction

• Sample Course Demonstration
• Licensing and OSS Stack

Information for Authors

• Tutorial
• Reference
  • The structure of a Chirun package
  • Package-level settings
  • Content item types
  • Chirun Markdown Extensions
  • LaTeX compatibility
  • Chirun LaTeX package
• The Chirun web frontend
  • Managing packages
  • Standalone use on the web
  • Using Chirun through LTI
• The Chirun Python package
  • Installation Instructions
  • Command line arguments
  • Compile a Chirun course package

Development information

• Documentation to-do list
• Reporting bugs