The Chirun web frontend

Note

This page is still to be written, sorry!

The Chirun web frontend provides an interface to edit and build Chirun packages, as well as an LTI 1.3 tool for integrating Chirun material with learning management systems.

Unauthenticated use on the web

You can use the Chirun web frontend without creating an account.

On the index page, click Create a new package.

Upload your source file(s), and click Create.

You are shown the configuration form for your package. If you uploaded a config.yml file, the form is already filled in with the values from that file, otherwise it begins blank and you must fill out the package’s structure.

Once you have saved the configuration, the package is built. Click on View the generated content to go to the package’s management page <web-package-management.

Access to the package is granted only by knowing the address of this page, so make sure to bookmark it. The URL is shown at the top of the management page so you can copy it.

Managing packages

The management page for a package shows links to configure or edit the package; links to view the output; and a log of times the package has been built.

The Configure link takes you to the course configuration editor. Use this to change package-level settings and edit the structure of the package. After you save the configuration, the package is automatically rebuilt.

The View or edit files in this package link takes you to the source file editor. You can edit existing files or create new files. The course is not automatically rebuilt after you make changes to source files: you must go back to the management page and click the Build button.

Note

There isn’t a link to download the output as a zip file at the moment. This will be added very soon!

The build process

While a package is being built, you are shown the text output of the build process.

If the build process fails with an error, you should look through this text for a hint about what went wrong. It’s best to read from the bottom up: the most useful error message is normally towards the end.

Note

At the moment, the public web frontend at lti.chirun.org.uk doesn’t show the live build process. You’ll have to reload the page until the build process has finished.

If the build process is successful, you’re shown a link labelled View the generated content, which takes you back to the package management page.