This organization contains open interactive course modules created by employees from Delft University of Technology that are being hosted on GitHub and GitHub Pages. These open interactive course modules are created using JupyterBook 1 (based on Sphinx), TeachBooks and/or Jupyterbook 2 (based on MyST). All open interactive course modules are shown on: https://oit.tudelft.nl/. Furthermore, this homepage lists TU Delft open interactive learning material (both open interactive course modules and open interactive textbooks) hosted on various other places, among others:

• other GitHub personal/organizations with corresponding GitHub pages
• EWI pages (prime.pages.ewi.tudelft.nl)
• published TU Delft OPEN Interactive textbooks (interactivetextbooks.tudelft.nl)
• ...

if you'd like to have open interactive learning material mentioned or added here, request member access to the organisation at one of the owners:

• Dennis van den Ouden-van der Horst
• Tom van Woudenberg
• Reid Sczerba

The owners have a shared responsibility of adding people to the organisation, maintaining the homepage https://oit.tudelft.nl/ and they can be approached for technical questions. This list of owners will grow soon! If you'd like to be an owner, reach out to one of the existing owners!

You can get started on your own account with the template provided by TeachBooks, converted to be used at TU Delft (https://github.com/TUDelft-books/TUDelft-template) and transfer your repository to this organisation as soon as you're a member. After transferring, it is online at https://oit.tudelft.nl/<book_repository>!

For transferring open interactive course modules you already have somewhere elso on GitHub we propose:

• If the old repository is not shared with others yet:
  • Ask one of the owners to transfer the repository to this organization
• If the old repository is already shared:
  • Ask one of the oweners to Use the GitHub Importer to add it to this organization. If your repository is not public, you have to add credentials or create an empty repo and push your local repository to this new one.
  • In the old repoistory:
    • Adding a note: 'Moved to <link to new repository in GitHub organization 'Open interactive course modules from Delft University of Technology'>' to README.md
    • Adding a note: 'Moved to <link to new repository in GitHub organization 'Open interactive course modules from Delft University of Technology'>' to the description of the repository on GitHub
    • Adding a banner to the book with a link to your new online book, see code below
    • Archive the old repository
  • In the new repository in the organization 'Open interactive course modules from Delft University of Technology':
    • reactivate GitHub pages from actions by setting the source for GitHub pages to GitHub Actions under Settings - Pages - Build and deployment - Source - GitHub Actions
    • If your new repository is private: create a new Personal Access Token (classic) with at least the scopes repo, read:org and gist as described in the github documentation, and add this token with the name GH_PAT as a Repository secret or Organization secret (Settings - Secrets and variables > Actions > Repository secrets or Organization secrets.)
    • Copy repository variables for deploy-book workflow from old repository
    • Run the deploy-book-orkflow from Actions - All workflows - call-deploy-book - Run workflow - Run workflow
    • Set the repository website as your GitHub Pages website under Code- About - Settings icon - Website - Use your GitHub Pages Website
    • Copy other GitHub-specific repository settings from the old repository.
    • Adapt the baseurl and repository_url in _config.yml:
      • baseurl : "https://oit.tudelft.nl/<new repository name>"
      • repository_url : "https://github.com/TUDelft-books/<new repository name>"

sphinx:
  config:
    ...
    html_theme_options:
      ...
      announcement : "This book has been moved to: <a href='https://oit.tudelft.nl/<new repository in the GitHub organization 'Open interactive course modules from Delft University of Technology'> style='color:white'>https://oit.tudelft.nl/<new repository> </a>."
      ...