Anfibrief der FSI Tübingen

Makefile

Dieses Repo besitzt ein Makefile über das ihr die Briefe noch einfacher per Konsole erzeugen könnt. Mit make help erhält man eine Übersicht der Targets (Befehle).

In der Regel sollte jedoch make fürs erste reichen (mit make info kann man prüfen, ob das Jahr und Semester stimmt). Make sollte dann automatisch die Briefe für das kommende Semester generieren und im Ordner pdf ablegen.

Voraussetzungen

Ihr benötigt ein Linux-System oder einen Mac. Sorry.
Inkscape und PDFTK müssen installiert sein. Ubuntu/Debian: sudo apt install inkscape pdftk
Auf Arch/Manjaro müssen zudem java-commons-lang und bcprov installiert sein: sudo pacman -S inkscape pdftk java-commons-lang bcprov
Zum benutzen der Makefile müssen auf allen Distributionen die Pakete make und latexmk installiert sein

TexLive-Pakete (Stand: Februar 2023)

Archlinux und Derivate

texlive-bin (automatisch als Abhängigkeit der Unteren)
texlive-core (automatisch als Abhängigkeit der Unteren)
texlive-fontsextra
texlive-latexextra

Ubuntu, Debian und Derivate

tex-common (automatisch als Abhängigkeit der Unteren)
texlive-base (automatisch als Abhängigkeit der Unteren)
texlive-binaries (automatisch als Abhängigkeit der Unteren)
texlive-latex-base (automatisch als Abhängigkeit der Unteren)
texlive-latex-recommended
texlive-lang-german
texlive-fonts-extra

HowTo Briefe updaten

Jedes Semester müssen die Briefe aktualisiert werden. Dafür müssen die folgenden Dinge erledigt werden:

Informationen sammeln:
- Mathe Vorkurs bei Rüdiger Zeller (Wann, Anmeldeschluss)
- Informatik Vorkurs für BioInfos bei Philipp Thiel (Wann, Anmeldeschluss)
Termine updaten
- Hierzu müsst ihr die Datei termine.tex öffnen und entsprechend editieren. Termine der Fachschaft Psychologie werden mit \ifkogwiss .. \fi umschlossen.
- Es gibt desweiteren noch das Flag \ifmaster ... \fi, mit dem man Termine nur für alle Masterstudiengänge gültig machen kann.
Daten in src/config.tex updaten
Stundenpläne ggf. updaten, (siehe Modulhandbuch / Alma)
Probeexemplare an die Mailingliste schicken
Wenn kein Einspruch kommt, Briefe an Frau Hallmayer schicken
Briefe releasen
- Dazu einfach auf den master-Branch von https://github.com/fsi-tue/anfibrief pushen, die PDFs werden dann automatisch generiert und veröffentlicht (Index).
- Das Ergebnis bitte kurz prüfen.

HowTo WS 2022/2023

Die POs haben sich geändet, die meisten meisten Änderungen sind im Anfibrief von SoSe 2022 schon drinn.

Wo ist was?

Die Briefe der einzelnen Studiengänge setzen sich zusammen aus:

media/anfibrief.lco, diese Datei definiert den Briefkopf und das Seitenlayout sowie die Fußzeile.
src/config.tex, hier werden grundsätzliche Infos die in jedem Brief vorkommen gesetzt, z.B. Info- und Mathe-Profs sowie der Preis des Semestertickets, Anmeldeschluss für Vorkurse
src/brief_main.tex, hier wird das Hauptdokument definert und die einzelnen Abschnitte werden eingebunden.
src/brief_init.tex, hier werden die if-Statements für die einzelnen Briefe definiert und auf false gesetzt. Diese Datei nicht verändern! (Es sei denn, ihr legt einen neuen Studiengang an.)
briefe/brief_<studiengang>.tex, hier werden im Prinzip nur Variablen gesetzt, die die Platzhalter in der Datei brief_main.tex ersetzen.
stundenplaene/stpl_<studiengang>.tex, hier wird die Sektion "Das erwartet dich im Studium" definiert, wichtig ist hier vor allem die Tabelle mit dem Stundenplan.

Überschrift	Datei
"Dein Terminkalender für die ersten Tage"	`src/termine.tex`
"Das erwartet dich im Studium"	`stundenplaene/stpl_<studiengang>.tex`
"Die Anfangszeiten und Orte"	`src/misc.tex`
"Die Informatik-Vorlesung"	`src/misc.tex`
"Mailinglisten"	`src/mailinglisten.tex`
"Verkehr in Tübingen"	`src/tuebingen.tex`
"Wohnen in Tübingen"	`src/tuebingen.tex`
Stadtplan	`media/stadtplan.svg`

Wichtig: Der Stadtplan wird automatisiert in eine PDF umgewandelt und an die Briefe gehängt. Den Stadtplan nur mit Inkscape bearbeiten, Illustrator o.ä. sorgen für seltsame Fehler im Makefile.

If-Else-Trickserei

An vielen Stellen, vor allem bei den Terminen, können unterschiedliche Texte notwendig sein, da z.B. Anfangszeiten unterschiedlich sind oder der Text auf Englisch verfasst werden muss. Wir haben dazu für Winter- und Sommersemester sowie jeden Studiengang eine if-Konstruktion eingebaut, mit der sich die Dokumente entsprechend verzweigen lassen:

Boolean	Befehl
Sommersemester?	`\ifsommersemester`
Wintersemester?	`\ifwintersemester`
Bachelor?	`\ifbachelor`
Master?	`\ifmaster`
Info?	`\ifinfo`
Bioinfo?	`\ifbinfo`
Medieninfo?	`\ifmedien`
Kogni?	`\ifkogwiss`
Lehramt?	`\iflehramt`
Medizininfo?	`\ifmedinfo`
Machine Learning?	`\ifml`

Benutzung wie folgt:

\ifsommersemester
    \ifbachelor
        \ifbinfo
            Dieser Text erscheint nur im Bachelor Bioinformatik-Brief und wenn der Brief fürs Sommersemester kompiliert wird.
         \fi
    \fi
\fi

Ganz wichtig: Alle ifs immer mit \fi schließen, sonst fliegt euch das Dokument um die Ohren.

Private Subversion history

FSI members can also obtain the private history from Subversion by issuing the following 3 commands inside of this repository (git-svn must be installed):

git svn init --stdlayout --prefix=svn/ https://projects.fsi.uni-tuebingen.de/svn/anfibrief
# The following requires an FSI SVN account and will take quite a few minutes:
git svn fetch
# Last revision:
# r262 = b355af9fa399ff559e379a4f1ffb8d37d6ee2069 (refs/remotes/svn/trunk)
git replace --graft 04ba800db821516ff044d0e7d72ca32c82196d91 b355af9fa399ff559e379a4f1ffb8d37d6ee2069

Git can then be used exactly like before but git-log, git-blame, etc. will be aware of the full history.

fsi-tue / anfibrief