Website

This website is built using Docusaurus, a modern static website generator.

Note

Compatible with @docusaurus/faster (rspack and swc).

ENV

Variable	For	Default	Example	Description
APP_URL	Production	http://localhost:3000		Domain of the hosted app
BACKEND_URL	Production	http://localhost:3002		Url of the API Endpoint
CLIENT_ID	Production			Azure ID: Client ID
TENANT_ID	Production			Azure AD: Tenant Id
API_URI	Production			Azure AD: API Url
STUDENT_USERNAME_PATTERN	Production		@edu	Users with usernames matching this RegExp pattern are displayed as students (regardless of admin status). If unset, all non-admin users are displayed as students.
DEFAULT_TEST_USER	Development		admin.bar@bazz.ch	To log in offline. Email of the user to be selected by default. Must correspond to a user email found in the API's database.*
OFFLINE_API	Dev/Production	memory	true	memory
SENTRY_DSN	Production			Sentry DSN for error tracking
SENTRY_AUTH_TOKEN	Production			Sentry Auth Token for error tracking
SENTRY_ORG	Production			Sentry Org for error tracking
SENTRY_PROJECT	Production			Sentry Project for error tracking
GH_OAUTH_CLIENT_ID	Production			Client ID for the GitHub OAuth app used for CMS auth

* To change users, clear LocalStorage to delete the API key created upon first authentication.

Upgrade Docusaurus

To upgrade docusaurus, run:

yarn upgrade @docusaurus/core@latest @docusaurus/faster@latest @docusaurus/preset-classic@latest @docusaurus/theme-classic@latest @docusaurus/theme-common@latest @docusaurus/module-type-aliases@latest @docusaurus/plugin-rsdoctor@latest @docusaurus/tsconfig@latest @docusaurus/types@latest

Upgrade tdev

After detatching a fork of teaching-dev, it will be necessary to periodically update the core framework.

To update to the lastest version of teaching-dev, run yarn updateTdev in the local repository (i.e. the detached fork). Afterwards, check the log for changes to non-tracked files and installable / upgradeable packages.

The update behavior can be customized by editing updateTdev.config.yaml. The following excerpt explains how the update behavior is configured:

tdevPath: ../teaching-dev # The path to the mainline teaching-dev repository.
expectedTdevBranch: main # The expected branch for the mainline teaching-dev repository. Change this only to update a pre-release or historic branch.
trackedElements: # The elements to be synchronized from the mainline teaching-dev repository to the local repository.
    - src: docusaurus.config.ts # Sync the mainline teaching-dev `docusaurus.config.ts` file...
      dst: docusaurus.config.ts # ...to `docusaurus.config.ts` in the custom repository.
    - src: src/ # Sync the mainline teaching-dev `src/` directory...
      dst: src # ...to `src` in the custom repository (Caution: this will override / delete custom files in the custom `src` repository!)
    # ...
watchedElements: # Log changes to these files (glob patterns) in the mainline teaching-dev repository without modifying local files.
    - .env.example
    # ...