Contents

Instructions for lecturers

Most lecturers now place material for their students onto the web. To support this, we create each year a new set of directories and page templates on the departmental filer and web server, to ensure that outdated material is not left in the main student access path.

Where are the files?

Each course has its own directory on the filer with a set of web-page templates.

These can be found this year

under Unix/Linux/macOS (via automounted NFS) at
```
/anfs/www/html/teaching/2021/courseid
```

under Windows (via SMB) at

\\filer.cl.cam.ac.uk\webserver\www\html\teaching\2021\courseid

under macOS (via SMB, not recommended, better use NFS) at

smb://wilbur.cl.cam.ac.uk/webserver/www/html/teaching/2021/courseid

on “the Interwebs” at

https://www.cl.cam.ac.uk/teaching/2021/courseid/
https://www.cl.cam.ac.uk/teaching/current/courseid/

Please consult the lecturer index to find your pages.

You can access the /anfs/www/... path above on the departmental file space directly on any lab-managed Linux computer. If you lack one, please use ssh or PuTTY to log into one of the Linux timesharing servers (e.g., ely.cl.cam.ac.uk).

You can also configure your own computers for automounted NFS access to the filer:

External lecturers: The instructions on this page are mainly aimed at lecturers who have already a login on a departmental Linux server. External lecturers may find it easiest to ask a member of the department, such as the teaching officer who sponsors their course, or the student administrators to place course materials for them onto our web server. Former members of the department, or technically keen external lecturers, may also ask a teaching officer to request for them a “discretionary Unix account” from [Javascript required], ideally sometimes in early July. (Note that remote access to Computer Laboratory servers is not entirely trivial, as password-based login from outside is disabled, and new users will have to set up VPN and Kerberos authentication first. See our sys-admin ssh pages for details.)

How to update the pages?

An easy to edit, undecorated, “bare-bones” HTML file, materials-b.html, has been placed into your directory, where you can add any information that you would like to make available to your students, such as links to lecture notes and exercise sheets. The actual “Course materials” page, materials.html, is automatically generated from that file after you type "make" under Linux. (If there is no materials-b.html file, you can edit index-b.html instead, but this applies only to a few pages where there is no syllabus.)

To recreate all the *.html files from the respective *-b.html files, run the UNIX command:

  /anfs/www/tools/bin/ucampas -r

Simply typing “make” will achieve the same, thanks to the also provided Makefile.

New changes this year:

The house style used by these pages has changed from the previously used ucam2008 style to the slightly newer ucam2012 (“Project Light”) University web house style. That change should largely not affect your content, but you may want to read a summary of some more intrusive Project Light CSS changes if you encounter oddities in the way your HTML is presented, especially with the <blockquote>, <table>, <img> and <pre> elements, and how to override these. The new house style also changes the layout quite significantly when the window width falls below 768px, for the benefit of mobile phone users, and you may want to test the appearance of your pages in that mode as well (simply by resizing your browser window).
Most courses have now by default an added “Recordings” tab and a video/ subfolder, where you can drop MP4 files of your recorded lectures. See below for more information on how to auto-generate a simple video index page there.

Access rights

A principal lecturer has been assigned to each course. This person is the owner of the directory on the filer and has full access.

If a course has more than one lecturer, its course directory also gives write access to Unix group “teaching”, which comprises all the lecturers teaching any course at the department this year, plus teaching administrators (about 70 people). This makes collaboration easier in courses taught by several people, and also allows administrators to help with placing materials online or fixing typos. To preserve group write access, make sure the Linux command “umask” outputs “0002”.

If you prefer to disable group write access, you could do this with the Linux tools chgrp or chmod. However we do not recommend this: if user wwwupdate no longer has write access to auto-generated HTML files, the site navigation data on some of your pages may get out of date as we can no longer update it for you.

Access rights for web users, such as requiring Raven login and restricting access to lists of certain users or pre-defined groups, can be controlled by adding or editing a Require line in an .htaccess file in the directory that you want to restrict. (This is the same mechanism available elsewhere on the CL web space, such as your personal ~/public_html/ directory. See below for how such an .htaccess file controls access to your page for supervisors and your video recordings page by default).

Syllabus page

The first tab of the course pages (index.html) usually shows an HTML version of the syllabus. You are not supposed to edit that yourself directly: the syllabus is edited and frozen in August/September and substantial changes require teaching-committee approval.

To update your CST Part IA, Part IB or Part II syllabus:: NEW: We no longer produce any printed syllabus booklet. Therefore the undergradute syllabus is now also maintained in HTML, just like for MPhil ACS modules. Fetch the current HTML source from /anfs/www/html/teaching/2021/syllabus-html/ and then send the revised version to Dinah Pounds.
To update your CST Part III or MPhil ACS module syllabus:: Fetch the HTML source from /anfs/www/html/teaching/2021/syllabus-html/ and then send the revised version to Lise Gough.

Materials for supervisors

Lecturers in Part IA/IB/II are expected to prepare a Supervision Guide for supervisors of the course, and this is what the page “Information for supervisors” in subdirectory supervisors/ is for. Access to this page is restricted via Raven.

You can edit the file supervisors/.htaccess in order to grant access to individual supervisors that contact you, as explained in the comments in that file. Supervisors can also ask the Director of Studies or Helen Neal (whoever hired them), to add them to the Lookup/Raven group cl-supervisors, to gain that access. (Comments in the .htaccess file also explain how you can grant access to your students after the end of lectures and supervisions.)

In our archive of past Tripos exam papers, students can now also access solution notes older then two years. As a result, supervisors can no longer rely on past exam questions as exercise material and need separate exercise sheets and solution notes.

Assessment page

Part II units of assessment as well as Part III and MPhil ACS modules have an assessment-b.html page, where you need to explain in detail how you are going to assess the course. This might include information about deadlines for essays or the dates and details of exams, as well as how the final mark will be calculated from all the assessed student contributions.

If your Part II unit is also available as a Part III and MPhil ACS module, please make sure you populate the assessment-tab page on both of your course pages.

Cloned course pages

Some courses (in particular many of the new "Part II units of assessment") are now offered to both Part II as well as Masters students. In these cases, we create two separate course directories for each group of students, using different course codes.

This is because while the lectures and most of the course materials may be the same, the form of assessment (and in some cases also the syllabus) will be different.

To avoid lecturers having to maintain two copies of their syllabus and course-materials pages, we have set up the syllabus and materials pages of these "cloned" Masters courses such that they automatically copy over the text from the respective Part II parent-course pages. This is done using a magic <div class="ucampas-include-html"> element, which extracts and copies the relevant HTML and also adjusts embedded URLs to work correctly. If you want, you can add additional text above or below that magic div element, or you can alternatively also delete it and replace it with your own manually maintained copy of your text, as you prefer. See the comments in the materials-b.html files for more details.

After each edit to the materials page of the parent course, make sure you also run ucampas on the corresponding cloned page to update it with the latest text. The default Makefile provided in your parent-course directory will do that automatically.

For the “Recordings” page, a different mechanism is used to update the clone. (The video/Makefile in the cloned page calls rsync to copy hardlinks of the files, and then calls ucampas to rebuild the page with adjusted navigation links.)

Video recordings

For the COVID-19 switch to online lectures, we have added an additional “Recordings” tab at

       /auto/anfs/www/html/teaching/2021/courseid/video/
= https://www.cl.cam.ac.uk/teaching/2021/courseid/video/

Record your lectures as *.mp4 files and copy them into the above video/ folder. You can then auto-generate an index page on Ely with

$ ssh -K ely.cl.cam.ac.uk
$ cd /anfs/www/html/teaching/2021/courseid/video/
$ make

The “make” command will run the “Makefile” in that folder. This will

extract one of the first frames of each *.mp4 file and save it as a *.jpg file (to be used as a preview image by the player)
call a script “/anfs/www/tools/bin/videopage *.mp4” that automatically builds an index.html file containing <video> player elements for all your *.mp4 videos in that folder, along with some metadata (duration of your video).

This way, you get a make-generated video index page, without having to edit any HTML yourself. Each time you add another video file, simply call “make” again to update that index page. (If you instead want to edit your video index page manually, you may want to empty or change the Makefile such that it cannot accidentally overwrite your DIY index page if called.)

If you do not intend to use the “Recordings” tab, you can remove it by

deleting from uconfig.txt the line video,
running "make"
deleting from Makefile the line $(MAKE) -C video
deleting the video/ subdirectory

By default, there is a file video/.htaccess with the line

Require group students-all cl-supervisors all-cl-users undergrad-directors-of-studies

This restricts access to the recordings tab to members of the department and others involved in teaching our courses. Please adjust this file for your access-control preferences, e.g. either

delete video/.htaccess to make your recordings openly available on the Internet,
replace it with the line Require valid-user to grant access to anyone with a Raven login,
add lines of the form Require user abc123 def467 to grant access to individual additional students using their CRSId.

If you run “make” on your own computer, make sure it has the “ffmpeg” tool (used to extract the preview *.jpg image) and the “Image::ExifTool” Perl library (used to extract video metadata) installed:

Ubuntu Linux: sudo apt-get install ffmpeg libimage-exiftool-perl
macOS with Homebrew: brew install ffmpeg exiftool

If you want to prefix your video index page with a few introductory remarks, then put these into a file intro.html in the video/ folder, which the videopage script will then include automatically.

Video file naming conventions

Your video files will appear on the auto-generated index page in alphabetical sorting order, so make sure each filename starts with a 2-digit number or yyyy-mm-dd date.

The videopage script understands several different file naming schemes, for example:

If you just want to have a sequence of videos, each with a part number and a title, use names such as
```
01-Introduction_and_prerequisites.mp4
02-Unix_history_and_free_software.mp4
03-Terminals.mp4
03.1-ASCII_and_Unicode.mp4
03.2-ESC_sequences.mp4
04-Documentation.mp4
[...]
```
(If you don't get the above sorting order displayed with ls -l, you can set the environment variable LC_COLLATE=C to switch to a simpler sorting order.)
The videopage script will automatically convert filenames of that format into a nicer <h2> heading for each video, by removing any leading zero digits (needed to maintain sorting order) in the part number, removing the .mp4 extension, and converting any underscore in the title text into a space. So the above will be displayed as
1 Introduction and prerequisites
2 Unix history and free software
3 Terminals
3.1 ASCII and Unicode
3.2 ESC sequences
4 Documentation
[...]
.
(You can also always use a dot in the part number, to separate a lecture number from the number of the video within that lecture, e.g. 01.1-Introduction_and_prerequisites.mp4.)
Example: Unix Tools
NEW: Some students find it helpful to be told which recording they should watch on which day. If you add in a file sections.txt lines of the form recordings|heading, then the videopage script will automatically insert the given heading before the stated number of recordings. If you append the unit symbol min to recordings, the script will interpret that as a number of minutes rather than as a number of recordings, and will automatically split up the recordings into groups of (on average) that many minutes.
Example: DSP/video/sections.txt for the DSP/video/ page at /anfs/www/html/teaching/2021/DSP/video/.
If you want to group your videos by lecture date, prefix each video filename with the yyyy-mm-dd date of the lecture, optionally followed by more digits (e.g. an integer, or the hh:mm start time of the recording) for sorting, such as
```
2020-04-24.mp4
2020-04-27_1.mp4
2020-04-27_2.mp4
2020-04-29.mp4
2020-05-01.mp4
[...]
```
Example: Digital Signal Processing
(In this date-based format, there is currently not yet any provision for title text, as it was originally meant for automatically named recordings made in lecture theatres by just pressing a button.)

Video recording tips

There is no reason to make each video 50 minutes long. Better break up your lecture into topic sections of 5–20 minutes each, and record each of these as a separate file. This makes it easier for students to take a break, or do some exercises, at the appropriate time.
Make sure the first couple of seconds of your video indicate what the video is about, e.g. shows a slide that states or visualizes the topic of the section. The index page will show the a frame taken after the first second of each video as a pre-view picture, so if it indicates the section, that helps your students to pick the right video. (You may want to define keyboard hotkeys to start and stop the recording, such that the start of your videos does not show you interacting with the GUI of your screen recording software.)
You can use any video recording software that you like, as long as it produces reasonably sized MP4 (H.264) files compatible with most web browsers. Make sure you use variable bitrate (VBR) encoding. For example, OBS Studio set up via the “auto-configuration wizard” (Tools>Auto-configuration wizard) in “Optimize just for recording” works well. (The alternative, constant bitrate (CBR) encoding, commonly used for real-time streaming, produces many megabits per second even for a completely static image, leading to huge files. 100 MB per hour is a reasonable typical VBR filesize, while 10 GB per hour is not!)
See Markus Kuhn's page on OBS Studio settings for suggested settings if you are using OBS Studio for recording.
There is also a departmental Google Docs document with more video-recording hints that we collected for Easter term 2020.

More information

Getting started with HTML – if you have never edited a web page
HTML 4 specification
Ucampas documentation – explains how to add additional pages or use advanced features (auto-generated tables of content, etc.).
Creating the course web pages – instructions for pagemaster
Updating course syllabi and metadata – instructions for administrators