/i2ml

https://slds-lmu.github.io/i2ml/

Primary LanguageMakefileMIT LicenseMIT

README

How to create a new website repository?

  1. Create a new repository with the name website_xyz and select slds-lmu/website_template as template repository
  2. There should already be a gh-pages branch. If not, create it.
  3. Go to Settings -> Pages and select the gh-pages branch as built branch.
  4. Change all website_template entries in the config.toml file to your repository name website_xyz (this should happen in two places, line 1 the baseURL and line 43 the footer url).
  5. The built of the website should already be available at http://slds-lmu.github.io/website_xyz/
  6. [Optional] Add your website link to the description of the repository to make it accessible more easily.
  7. Edit the team page. Remove people not affiliated with the lecture and add add relevant people.
  8. Edit your files as described below.

Edit the content of the website

  • Directories and filenames have to be lowercase
  • Chapters are ordered after filenames
  • if no video is given or no pdf file is present: delete yaml param completely
  • to include pdfs, use pdfjs:
    • For Files: {{< pdfjs file="slides-regression-losses.pdf" >}}. The pdf has to be in the same directory as the md file.
    • As URL: {{< pdfjs file="https://github.com/slds-lmu/lecture_i2ml/blob/master/slides-pdf/slides-regression-losses.pdf" >}}. If a URL is used, a download button is created instead a preview of the slides.
  • if you add a markdown or html link to a file that is in the same directory
    • you should use the shortcode {{< fileurl file="cheatsheet_notation.pdf" >}}
    • if you link to ../file.pdf it will break in the index pages
  • to include lecture video: {{< video id = "Syrzezpj2FY" >}}
    • the video_id is the last part of the youtube url, e.g. for https://www.youtube.com/watch?v=BmSvhDCdJro it is BmSvhDCdJro.
    • You can also embed videos from other platforms by changing video_base_url in config.toml
    • Or use a custom shortcode.
    • To directly change aspects in the video embedding you can also use the explicit HTML-iframe tag e.g. <iframe width="560" height="315" src="https://www.youtube.com/embed/8CSGRjM8E0g?si=5Ms3XDe8zZba26Vb" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay = "0"; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
    • To ensure that the views are counted properly explicitly set the autoplay = "0"-HTML attribute either directly in the HTML-iframe tag or in the video.html in the layouts of the website theme
  • mathjax enabled if mathjax: true in yaml-frontmatter
  • if mathjax should be supported in index page, add it to respective _index.md or enable it in config.toml
  • make quizzes using https://github.com/bonartm/hugo-quiz
    • put quizdown: true in yaml-frontmatter
    • quizzes support mathjax without the mathjax: true
  • in _index.md you can specify show_in_index: (content|summary|none)

Deploying the website

The deploy is done automatically via GitHub Actions. Nothing needs to be done to publish a new version of the website. Each build is triggered when a commit is done to the main branch.

License

MIT LICENSE