Managing LaTeX lecture notes

Additions to original repo

Scripts now handle notes for lectures and exercise sessions for each course.

This repository complements this blog post.

New File structure

ROOT
├── linear-algebra
│   ├── info.yaml
│   ├── cours
│   │   ├── master.tex
│   │   ├── cm_01.tex
│   │   ├── cm_02.tex
│   │   └── ...
│   └── td
│       ├── master.tex
│       ├── td_01.tex
│       ├── td_02.tex
│       └── ...
├── other-courses
└── ...

new rofi-lectures.py`

When you run this file, it show you lectures and exercise sessions of the current course. Selecting one opens up the file in Vim, pressing Ctrl+C creates a new lecture, pressing Ctrl+T creates a new exercise session.

init-all-courses.py

Creates session directories based on config.py and creates master.tex files for each course.

Original Readme

Contents of info.yaml

title: 'Riemann Surfaces'
short: 'RSurf'
url: 'https://'

Contents of master.tex:

\documentclass[]{report}
\input{../preamble.tex}
\DeclareMathOperator{\Res}{Res}
...
\title{Riemann surfaces}
\begin{document}
    \maketitle
    \tableofcontents
    % start lecture
    \input{lec_01.tex}
    ...
    \input{lec_12.tex}
    % end lectures
\end{document}

Here % start lectures and % end lectures are important.

A lecture file contains a line

\seance{1}{vr 14 feb 2020 16:04}{Introduction}

which is the lecture number, date an title of the lecture. Date format is configurable in config.py.

config.py

This is where you configure what calendar to use for the countdown script, the root folder of the file structure, and similar stuff. You can also configure the date format used in some places (lecture selection dialog and LaTeX files).

courses.py

This file defines Course and Courses. Courses is a list of Courses in the ROOT folder. A Course is a python object that represents a course. It has a name, a path, and some info (which reads from info.yaml). You can also access its lectures.

Courses also has a current property which points to the current course. When setting this property, the script updates the ~/current_course symlink to point to the current course (configurable in config.py) Furthermore, it writes the short course code to /tmp/current_course. This way, when using polybar, you can add the following to show the current course short code in your panel.

[module/currentcourse]
type = custom/script
tail = true
exec = echo '/tmp/current_course' | entr cat /tmp/current_course

countdown.py

This script hooks into your calendar, which you can configure in the config.py file. If you're using polybar, you can use the following config:

[module/calendar]
type = custom/script
exec = TZ='Europe/Brussels' python3 -u ~/scripts/uni/countdown.py
click-left = sensible-browser 'https://calendar.google.com/calendar/' -- &
tail = true

It activates the course if the title of the course can be found in the description of the calendar event:

course = next(
    (course for course in courses
     if course.info['title'].lower() in event['summary'].lower()),
    None
)

You can easily change this by for example adding a calendar_name to each info.yaml file and checking with if course.info['calendar_name'] == event['summary'] or something like that.

To get it working, follow step 1 and 2 of the Google Calendar Python Quickstart, and place credentials.json in the scripts directory.

lectures.py

This file defines Lectures, the lectures for one course and Lecture, a single lecture file lec_xx.tex. A Lecture has a title, date, week, which get parsed from the LaTeX source code. It also has a reference to its course. When calling .edit() on a lecture, it opens up lecture in Vim.

Lectures is class that inherits from list that represents the lectures in one course. It has a method new_lecture which creates a new lecture, update_lectures_in_master, which when you call with [1, 2, 3] updates master.tex to include the first three lectures, compile_master which compiles the master.tex file.

rofi-courses.py

When you run this file, it opens rofi allows you to activate a course.

rofi-lectures-view.py

This opens up a rofi dialog to update which lectures are included in master.tex

rofi.py

Wrapper function for rofi

utils.py

Some utility functions

compile-all-masters.py

This script updates the master.tex files to include all lectures and compiles them. I use when syncing my notes to the cloud. This way I always have access to my compiles notes on my phone.