\section{\ldeen{Kurztutorial}{Short Tutorial}} \ldeen{Dieses Tutorial begleitet Nora. Nora hält im kommenden Semester erstmals die Vorlesung "`Betriebssysteme"'. Die erste Unterrichtseinheit soll über Speicher gehen. Nora will sofort Speichervirtualisierung behandeln. Die ist vielleicht etwas optimistisch, aber das soll uns hier nicht aufhalten. Der Studiengang, in dem der Kurs stattfindet, ist zwar deutschsprachig, aber Nora weiß, dass viele Gaststudenten teilnehmen werden, die besser Englisch als Deutsch beherrschen. Daher will sie Folien jeweils in beiden Sprachen vorbereiten. Außerdem hat sie versprochen, ein kurzes Skript bereitzustellen. Für die Lehrveranstaltung selbst möchte sie außerdem eine Vortragendenfassung mit der aktuellen und der nächsten Folie sowie eigenen Anmerkungen verwenden. Mehrere Dokumentinstanzen für zunächst eine einzige Stunde Lehre: Nora ahnt bereits, dass getrennte Quelldateien keine besonders gute Idee wären.}{This tutorial follows Nora. Next semester, Nora will be teaching the lecture "`Operating Systems"' for the first time. The first lesson will cover storage. Nora wants to dive right into storage virtualization. That might be a bit optimistic, but let's not let that stop us here. Although the degree program in which the course is offered is German-language, Nora knows that many visiting students will be attending who are more comfortable with English than with German. That’s why she wants the slides to be in both languages. She has also promised to provide a short set of lecture notes. For the lecture itself she also wants a presenter's version showing the current and next slide together with her own remarks. Several document instances for what is initially just a single hour of instruction: Nora already suspects that having separate source files wouldn’t be a particularly good idea.} \ldeen*{Das Tutorial beschreibt nicht jede Möglichkeit von \osglecture. Es zeigt vielmehr die Dinge, die Nora für ihren ersten kleinen Kurs tatsächlich benötigt.\footnote{% Wer lieber sofort in die Details gehen will, kann auch direkt im Abschnitt~@1 weiterlesen. }% Am Ende entstehen aus einem einzelnen Quelldokument einer Lehreinheit Folien, eine Vortragendenfassung und ein Skript, jeweils in zwei Sprachen.}{The tutorial does not describe every option in the bundle. Instead, it shows the things Nora actually needs for her first small course.\footnote{% If you'd rather get right into the details, you can continue reading directly in section~@1. } At the end, one course unit will produce slides, a presenter's version, and lecture notes, each in two languages.}{\ref{sec:concepts}} \paragraph{\ldeen{Noras Problem}{Nora's Problem}.} \ldeen{Nora beginnt so, wie man vermutlich intuitiv ohne \osglecture\ beginnen würde. Sie legt \File{slides-de.tex} an, füllt es mit Inhalt, kopiert die Datei nach \File{slides-en.tex} und beginnt mit der Übersetzung. Für das Skript fügt sie später noch \File{script-de.tex} hinzu. Das funktioniert. Allerdings fällt kurze Zeit später ein, dass sie bei der Beschreibung des Unterschieds zwischen \emph{Paging} und \emph{Segmentierung} etwas Wichtiges vergessen hat. Jedoch klingelt bei der Bearbeitung ihr Telefon, und nach dem Anruf muss Nora überlegen, in welche der Dateien sie die Korrektur übernommen hat.}{Nora starts off the way one would probably intuitively begin without \osglecture. She creates \File{slides-de.tex}, copies the file to \File{slides-en.tex}, and begins the translation. For the script, she later adds \File{script-de.tex}. That works. However, shortly afterward, she realizes that she forgot something important in the description of the difference between \emph{paging} and \emph{segmentation}. But while she’s editing, her phone rings, and after the call, Nora has to figure out which of the files she made the correction in. } \begin{figure}[htbp] \centering \begin{minipage}[t]{.27\linewidth} \begin{tcolorbox}[colback=red!3,colframe=red!55!black] \centering\File{slides-de.tex}\par\smallskip \scriptsize\ldeen{64 Einträge}{64 entries} \end{tcolorbox} \end{minipage}\hfill \begin{minipage}[t]{.27\linewidth} \begin{tcolorbox}[colback=red!3,colframe=red!55!black] \centering\File{slides-en.tex}\par\smallskip \scriptsize\ldeen{64 Einträge}{64 entries} \end{tcolorbox} \end{minipage}\hfill \begin{minipage}[t]{.27\linewidth} \begin{tcolorbox}[colback=red!3,colframe=red!55!black] \centering\File{script-de.tex}\par\smallskip \scriptsize\ldeen{63 Einträge?}{63 entries?} \end{tcolorbox} \end{minipage} \caption{\ldeen{Kopien sind bequem anzulegen und unbequem zu pflegen.}{Copies are easy to create and awkward to maintain.}} \end{figure} \ldeen{Nora entscheidet deshalb, \osglecture\ zu nutzen und nur noch eine fachliche Quelle zu pflegen. Die Sprachen sollen darin nahe beieinanderstehen; Folien und Skript sollen ebenfalls aus dieser Quelle entstehen. Genau dies wird im Folgenden eingerichtet.}{Nora therefore decides to use \osglecture\ and to maintain only one subject-specific source. The languages should be closely aligned within it; slides and lecture notes should also be derived from this source. This is exactly what will be set up below.} \paragraph{\ldeen{Ein Zuhause für den Kurs}{A Home for the Course}.} \ldeen{Zunächst braucht der Kurs ein Verzeichnis. Nora könnte alle Dateien dort ablegen. Sie entscheidet sich aber gleich für zwei Unterverzeichnisse: eines für gemeinsame Angaben und eines für die erste Lehreinheit. Dass die Einheit die Nummer \code{010} statt \code{001} erhält, erscheint ihr zunächst unnötig großzügig. Später kann sie dafür eine neue Einheit \code{005-Overview} dazwischenschieben, ohne alles umzubenennen. In das Verzeichnis für die erste Lehreinheit kommt die Quelldatei. Nora legt erst mal eine leere Datei mit dem Namen \File{main.tex} an, da dies bei \osglecture\ der Standardname für die \LaTeX-Hauptdatei einer Lehreinheit ist. }{First, the course needs a directory. Nora could put every file directly into it. Instead, she immediately chooses two subdirectories: one for shared settings and one for the first course unit. Giving the unit the number \code{010} rather than \code{001} initially seems unnecessarily generous. Later, however, she can insert a new unit named \code{005-Overview} before it without renaming everything.} \begin{verbatim} mkdir -p Noras-os/Include Noras-os/010-Memory cd Noras-os touch 010-Memory/main.tex \end{verbatim} \ldeen{Noch ist das Ergebnis nicht besonders eindrucksvoll}{The result is not particularly impressive yet}: \begin{manualdirtree} \dtdir{Noras-os}{\ldeen{Projektwurzel}{project root}}{ \dtdir{Include}{\ldeen{gemeinsame Angaben}{shared settings}}{} \dtdir{010-Memory}{\ldeen{erste Lehreinheit}{first course unit}}{ \dtfile{main.tex}{} } } \end{manualdirtree} \ldeen{Immerhin ist nun klar, was zum gesamten Kurs und was nur zur Einheit "`Virtueller Speicher"' gehört.}{At least it is now clear what belongs to the whole course and what belongs only to the "`Virtual Memory"' unit.} \paragraph{\ldeen{Nora bestellt Ergebnisse}{Nora Orders Some Outputs}} \ldeen{Nora hat nun Verzeichnisse, aber noch kein Weg, das aus ihrer einen Quelle die gewünschten Dokumente erzeugt. Diese Aufgabe übernimmt \OLLM, der \emph{OSG LaTeX Lecture Maker}. \OLLM\ ist das Buildwerkzeug des Bundles: Es wählt Dokumenttyp und Sprache, startet den passenden \LaTeX-Lauf und verwaltet die entstandenen Dateien. Nora wird \OLLM\ deshalb nicht den Inhalt ihrer Vorlesung erklären, wohl aber, welche Ergebnisse sie erwartet.}{Nora now has directories, but no way to turn her single source into the documents she wants. This is the job of \OLLM, the \emph{OSG LaTeX Lecture Maker}. \OLLM\ is the bundle's build tool: it selects the document type and language, starts the appropriate \LaTeX\ run, and manages the resulting files. Nora will therefore not tell \OLLM\ the subject matter of her lecture, but she will tell it which outputs she expects.} \ldeen{Eine konkrete Wahl aus Lehreinheit, Target und Sprache heißt im Folgenden \emph{Instanziierung}. Diesen Begriff kennt Nora schon aus der Objektorientierten Programmierung. Aber anders als dort ist das Ergebnis einer Instanziierung kein Objekt sondern eine \emph{Dokumentinstanz}. Die Kombination "`Unterrichtseinheit \code{memory}, Target \code{slides}, Sprache \code{en}"' erzeugt beispielsweise die englische Folieninstanz dieser Einheit. Damit ist präzise benannt, was \OLLM\ später bauen soll.}{A specific selection of a teaching unit, target, and language is referred to below as \emph{instantiation}. Nora is already familiar with this term from object-oriented programming. But unlike in that context, the result of an instantiation is not an object but a \emph{document instance}. For example, the combination "`Lesson \code{memory}, Target \code{slides}, Language \code{en}"' generates the English slide instance of this lesson. This precisely specifies what \OLLM\ is to generate later.} \ldeen{Nora möchte \OLLM\ am liebsten sofort mit \code{ollm slides} starten. Das Werkzeug kann jedoch noch nicht wissen, welche Sprachen der Kurs anbietet oder ob Nora z.\,B.\ überhaupt ein Skript haben möchte. Diese Angaben kommen in ein Manifest namens \File{ollmconfig.toml} in der Projektwurzel. Man kann es als Bestellzettel lesen: Nora bestellt zwei Sprachfassungen der Folien und zwei des Skripts.}{Nora would prefer to start \OLLM\ immediately by typing \code{ollm slides}. However, the tool cannot yet know which languages the course offers or whether Nora wants lecture notes at all. This information goes into a manifest named \File{ollmconfig.toml} in the project root. It can be read as an order form: Nora orders two language versions of the slides and two of the lecture notes.} \begin{verbatim} schema = 2 bundle_preset = "OSG lecture/1" [project] id = "os-in-60" [targets.defaults] languages = ["de", "en"] default_language = "de" presentation_profile = "ltx-talk" longform_profile = "book" document_metadata = "enabled" [targets.slides] [targets.screen] [targets.script] \end{verbatim} \ldeen{Nora ist versucht, hier auch Titel, Autorin und Übersetzungen einzutragen. TOML kann schließlich Text speichern. Sie lässt es dennoch bleiben: Das Manifest beschreibt die zu erzeugenden Dokumentinstanzen, nicht den Inhalt des Dokuments. Titel und Sprachabbildung sind \LaTeX-Angelegenheiten und folgen im nächsten Schritt.}{Nora is tempted to add the title, author, and translations here as well. After all, TOML can store text. She resists the temptation: the manifest describes the build matrix, not the document's content. The title and language mapping are \LaTeX\ concerns and follow in the next step.} \ldeen{Bevor sie weiterschreibt, prüft Nora den Bestellzettel}{Before continuing, Nora checks the order form}: \begin{verbatim} ollm check \end{verbatim} \ldeen{Bei ihrem ersten Versuch hatte sie \option{language} statt \option{languages} geschrieben. \OLLM\ weist den unbekannten Schlüssel zurück. Das ist Nora lieber als stillschweigend Kursmaterial in der falschen Sprache zu erhalten. Nachdem sie den Tippfehler korrigiert hat, ist das Manifest gültig. Auch falls ihre Buildumgebung selbst Probleme bereitet, schließlich erwartet \osglecture\ eine relativ moderne \LaTeX-Installation, kann \OLLM\ helfen: \code{ollm doctor} liefert die passendere Diagnose.}{ On her first attempt, she had written \option{language} instead of \option{languages}. \OLLM\ rejects the unknown key. Nora prefers that to a course that’s silently in German. After she corrects the typo, the manifest is valid. Even if her build environment itself is causing problems, \code{ollm doctor} provides a more accurate diagnosis. } \paragraph{\ldeen{Was für alle Lehreinheiten gilt}{What Applies to Every Unit}.} \ldeen{Nora möchte ihren Namen und den Kurstitel nicht in jeder späteren Einheit wiederholen. Sie legt deshalb \File{Include/projectconfig.tex} an. Im Manifest hat sie für Präsentationen bereits \cls{ltx-talk} und für das Skript die Standardklasse \cls{book} gewählt. Beide Profile arbeiten mit der neuen PDF-Verwaltung von \LaTeX; damit kann Nora ihre Dokumente als Tagged PDF bereitstellen. Das passende Präsentationsthema kann sie unabhängig davon auswählen. Die Wahl der Klassen ist eine Projektentscheidung; die einzelnen Fachtexte in den Lehreinheiten müssen von diesen Klassennamen nichts wissen. Außerdem lernt Nora, dass Dokumente, die nicht zu den Präsentationen oder Handouts gehören, in \osglecture\ "`Langformen"' genannt werden. Ihr Skript ist eine solche Langform. }{Nora does not want to repeat her name and the course title in every future unit. She therefore creates \File{Include/projectconfig.tex}. In the manifest she has already selected \cls{ltx-talk} for presentations and the standard \cls{book} class for the lecture notes. Both profiles use \LaTeX's new PDF management, allowing Nora to provide her documents as Tagged PDF. She can select a suitable presentation theme independently. The choice of classes is a project-level decision; the individual subject-specific texts within the teaching units do not need to be aware of these class names. In addition, Nora learns that documents that are not part of the presentations or handouts are called "`long forms"' in \osglecture. Her lecture notes are one such long form.} \ldeen*{Sie schreibt in @1}{She writes into @1}{\File{/Include/projectconfig.tex}} \begin{verbatim} \title{\ldeen{Betriebssysteme}{Operating Systems}} \author{Nora Example} \LectureProjectSetup{ languages={ map={de=ngerman,en=british}, load babel } } \end{verbatim} \ldeen{Die Profilwahl steht im Manifest und nicht in \File{projectconfig.tex}, weil die Basisklasse und ihr Bedarf an \cs{DocumentMetadata} feststehen müssen, bevor die Klasse überhaupt startet. Für die frühe PDF-Konfiguration legt Nora deshalb zusätzlich \File{Include/documentmetadata.tex} an}{The profile selection belongs in the manifest rather than \File{projectconfig.tex}, because the base class and its need for \cs{DocumentMetadata} must be known before the class starts. Nora therefore also creates \File{Include/documentmetadata.tex} for the early PDF configuration}: \begin{verbatim} \DocumentMetadata{ lang = \OsgLectureRequestedLanguage, tagging = on } \end{verbatim} \ldeen{\OLLM\ bindet diese Datei bei allen drei Targets vor \cs{documentclass} ein. Die sichtbaren Dokumentangaben bleiben dagegen in \File{projectconfig.tex}.}{\OLLM\ includes this file before \cs{documentclass} for all three targets. Visible document metadata remains in \File{projectconfig.tex}.} \ldeen{Die verbleibende Sprachkonfiguration enthält zwei verschiedene Arten von Namen. \OLLM\ arbeitet mit den kurzen, portablen Kennungen \code{de} und \code{en}, wie sie in der Norm ISO 639-1 definiert sind. Das verbreitete Sprachpaket \pkg{babel} benötigt dagegen die konkreteren Namen \code{ngerman} und \code{british}. Der Schlüssel \option{languages} reicht dieses Mapping an \pkg{langselect} weiter und lädt \pkg{babel}. Welche Sprachen das Projekt überhaupt anbietet, steht bereits im Manifest -- \osglecture\ reicht die Liste von dort an \pkg{langselect}.}{The remaining language configuration contains two different kinds of names. \OLLM\ uses the short, portable identifiers \code{de} and \code{en}. The popular language package \pkg{babel}, by contrast, needs the more specific names \code{ngerman} and \code{british}. The \option{languages} key passes this mapping on to \pkg{langselect} and loads \pkg{babel}. Which languages the project offers at all is already in the manifest -- \osglecture\ hands that list from there to \pkg{langselect}.} \paragraph{\ldeen{Endlich etwas Fachliches}{At Last, Some Subject Matter}.} \ldeen{Nun schreibt Nora \File{010-Memory/main.tex}. Sie beginnt bewusst mit wenig Inhalt. Ein kleines, erfolgreich gebautes Dokument ist eine angenehmere Ausgangsbasis als zwanzig Seiten, bei denen eine schließende Klammer fehlt.}{Now Nora writes \File{010-Memory/main.tex}. She deliberately starts with little content. A small document that builds successfully is a more pleasant starting point than twenty pages with a missing closing brace.} \begin{verbatim} \documentclass{osglecture} \begin{document} \lecture[Memory]{\ldeen{Virtueller Speicher}{Virtual Memory}}{lec:memory} \begin{frame} \frametitle{\ldeen{Warum virtueller Speicher?}{Why virtual memory?}} \ldeen{Jeder Prozess sieht einen eigenen Adressraum.} {Each process sees a private address space.} \Note{\ldeen{Hier an die Analogie mit Zimmernummern erinnern.} {Recall the analogy with room numbers here.}} \end{frame} \begin{frame} \frametitle{\ldeen{Seitentabellen}{Page tables}} \ldeen{Eine Seitentabelle ordnet virtuelle Seiten physischen Seitenrahmen zu.} {A page table maps virtual pages to physical page frames.} \end{frame} \end{document} \end{verbatim} \ldeen{Der Befehl \cs{lecture} dient Nora dazu, eine Unterrichtseinheit zu beginnen. Das erste Pflichtargument ist der Titel, das optionale Argument seine Kurzform.}{The \cs{lecture} command begins a course unit. Its first mandatory argument is the title, and the optional argument is the short title.} \ldeen{Das zweite Pflichtargument von \cs{lecture}, hier \code{lec:memory}, ist das Label der Unterrichtseinheit Dieses etabliert die Identität der Einheit. Nora darf den sichtbaren Titel später verbessern und sogar das Verzeichnis umbenennen. Die Identität sollte sie aber dabei nicht beiläufig ändern; Querverweise und Buildzustand verwenden diesen Wert, um die richtige Lehreinheit zu finden.}{The second mandatory argument of \cs{lecture}, here \code{lec:memory}, is the label of the unit. It constitutes the unit's stable identity. Nora may improve the visible title later and may even rename the directory. She should not casually change the identity while doing so; cross-references and build state use this very value.} \ldeen{Die \env{frame}-Umgebung kennt Nora schon aus ihrer früheren Arbeit mit \cls{beamer}. Sie hat dort zwar häufig den Titel in ein Umgebungsargument geschrieben, aber das darf sie bei \osglecture\ nicht; dafür gibt es den Befehl \cs{frametitle}.}{Nora already knows the \env{frame} environment from her earlier work with \cls{beamer}. She often put the title in an environment argument there, but \osglecture\ does not permit that; the \cs{frametitle} command must be used instead.} \ldeen{Den Befehl \cs{ldeen} kennt Nora noch nicht. Sie findet auch bei einer kurzen Suche mit \code{grep} in ihrem \LaTeX-Verzeichnis kein Paket, das ihn definiert. Dennoch ist Nora intuitiv klar, was er macht: Er stellt die beiden Sprachvarianten, die Nora bestellt hat, nebeneinander dar.}{Nora has not seen the \cs{ldeen} command before. Even a quick \code{grep} search of her \LaTeX\ directory finds no package defining it. Nevertheless, its purpose is intuitively clear to her: it places the two requested language variants side by side.} \ldeen{\cs{Note} enthält dagegen eine Anmerkung für Nora selbst. Sie gehört in den Frame, auf den sie sich bezieht. Auf den gewöhnlichen Folien und im Skript erscheint sie nicht; die Vortragendenfassung sammelt sie später auf ihrer Presenter-Seite.}{\cs{Note}, by contrast, contains a remark for Nora herself. It belongs inside the frame to which it refers. It does not appear on the ordinary slides or in the lecture notes; the presenter's version later collects it on its presenter page.} \paragraph{\ldeen{Der erste Build}{The First Build}.} \ldeen{Nora wechselt in die Lehreinheit und versucht aus alter Gewohnheit zuerst \File{lualatex main.tex}. Das ist zwar ein verständlicher Versuch, umgeht aber den Bestellzettel: Target und Sprache fehlen. Für einen Serienkurs ist \OLLM\ der richtige Eingang. Nora baut also zunächst genau das Ergebnis, das sie gerade sehen möchte}{Nora changes into the course unit and, out of habit, first tries \File{lualatex main.tex}. This is an understandable attempt, but it bypasses the order form: the target and language are missing. For a course series, \OLLM\ is the right entry point. Nora therefore first builds exactly the output she wants to see}: \begin{verbatim} cd 010-Memory ollm build slides --language=de \end{verbatim} \ldeen{Das Ergebnis ist eine deutsche Folie. Sie liegt nicht neben \File{main.tex}; \OLLM\ hält erzeugte Dateien unter \path{.osglecture/build} von den Quellen getrennt. Nora sucht kurz im falschen Verzeichnis, findet die Trennung dann aber überzeugend: Ein beschädigter Buildordner kann entfernt werden, ohne dass dabei Lehrmaterial verschwindet.}{ The result is a German slide. It is not placed next to \File{main.tex}; \OLLM\ keeps generated files below \path{.osglecture/build}, separate from the sources. Nora briefly looks in the wrong directory, but then finds the separation convincing: a damaged build directory can be removed without losing teaching material.} \ldeen{Die englische Folie ist jetzt fast enttäuschend einfach}{The English slide is now almost disappointingly easy}: \begin{verbatim} ollm build slides --language=en \end{verbatim} \ldeen{Nur die gewählte Formulierung ändert sich. Struktur und Formel bleiben dieselben. Genau das wollte Nora erreichen.}{Only the selected wording changes. The structure and formula remain the same. That is precisely what Nora wanted to achieve.} \paragraph{\ldeen{Eine Fassung für Nora}{A Version for Nora}.} \ldeen{Für die Lehrveranstaltung baut Nora außerdem das Target \code{screen}}{For the lecture Nora also builds the \code{screen} target}: \begin{verbatim} ollm build screen --language=de \end{verbatim} \ldeen{Diese Dokumentinstanz verwendet dieselben Folien, macht jede Seite aber doppelt so breit. Links liegt die Folie für den Projektor; rechts sieht Nora die aktuelle und die nächste Folie sowie ihre mit \cs{Note} notierte Erinnerung. Bei einem erweiterten Desktop kann sie die beiden Hälften auf Projektor und eigenen Bildschirm verteilen. Die Vortragendenfassung bleibt damit Teil derselben Quelle, ohne selbst eine Fassung für die Studierenden zu sein.}{This document instance uses the same slides but makes every page twice as wide. The slide for the projector is on the left; on the right Nora sees the current and next slide together with the reminder recorded using \cs{Note}. With an extended desktop she can distribute the two halves between the projector and her own screen. The presenter's version thus remains part of the same source without itself becoming a version for the students.} \ldeen{Auch diese Instanz wird mit eingeschaltetem Tagging gebaut. Die zusätzliche Presenter-Seite ist jedoch eine Bedienhilfe für Nora und gehört nicht zur Lesereihenfolge der eigentlichen Folie.}{This instance is also built with tagging enabled. The additional presenter page is an aid for Nora, however, and is not part of the reading order of the slide itself.} \begin{minipage}{\linewidth} \captionsetup{type=figure} \centering \begin{subcaptiongroup} \begin{minipage}[t]{.48\linewidth} \fbox{\includegraphics[page=1,width=\linewidth]{tutorial-output-slides.pdf}} \caption{\ldeen{Die Folienfassung zeigt jeweils eine Folie.}{The slide version shows one slide at a time.}} \end{minipage}\hfill \begin{minipage}[t]{.48\linewidth} \fbox{\includegraphics[page=1,width=\linewidth, trim=18mm 176mm 18mm 18mm,clip]{tutorial-output-script.pdf}} \caption{\ldeen{Im Skript werden die Inhalte nacheinander gesetzt.}{In the lecture notes, the contents are typeset consecutively.}} \end{minipage} \begin{minipage}[t]{.96\linewidth} \fbox{\includegraphics[page=1,width=\linewidth]{tutorial-output-screen.pdf}} \caption{\ldeen{Die Vortragendenfassung ergänzt rechts Vorschau und Anmerkung.}{The presenter's version adds the preview and remark on the right.}} \end{minipage} \end{subcaptiongroup} \caption{\label{fig:tutorial-document-instances}\ldeen{Drei Dokumentinstanzen aus derselben Quelle.}{Three document instances from the same source.}} \end{minipage} \ldeen{Abbildung~\ref{fig:tutorial-document-instances} macht den Unterschied der drei Targets sichtbar. Die Anmerkung gehört ausschließlich in Noras Vortragendenfassung; das Skript übernimmt dagegen beide Frames als fortlaufenden Text.}{Figure~\ref{fig:tutorial-document-instances} shows the difference between the three targets. The remark belongs exclusively in Nora's presenter version, while the lecture notes typeset both frames as continuous text.} \paragraph{\ldeen{Von Stichpunkten zu einem Satz}{From Bullet Points to a Sentence}} \ldeen{Nora ergänzt zwei weitere Aussagen. Eine gewöhnliche \code{itemize}-Liste wäre auf der Folie passend. Im Skript möchte sie jedoch keinen Absatz, der nur aus drei Stichpunkten besteht. Sie könnte dafür zwei Fassungen schreiben, aber das würde ihr ursprüngliches Problem in kleinerem Maßstab wiederholen. Stattdessen verwendet sie die \pkg{presitemize}-Umgebung}{Nora adds two more statements. An ordinary \code{itemize} list would suit the slide. In the lecture notes, however, she does not want a paragraph consisting only of three bullet points. She could write two versions, but that would repeat her original problem on a smaller scale. Instead, she uses \pkg{presitemize}}: \begin{verbatim} \begin{frame} \frametitle{\ldeen{Warum virtueller Speicher?}{Why virtual memory?}} \begin{presitemize} \item \ldeen{Jeder Prozess sieht einen eigenen Adressraum} {Each process sees a private address space} \anditem \ldeen{die Hardware übersetzt virtuelle Adressen} {the hardware translates virtual addresses} \thereforeitem \ldeen{Prozesse \finite{sind} voneinander isoliert} {processes \finite{are} isolated} \end{presitemize} \end{frame} \end{verbatim} \ldeen{Auf der Folie bleiben dies drei Einträge. In der Langform werden daraus verbundene Aussagen. Das markierte finite Verb hilft dabei, im deutschen Nebensatz aus "`Prozesse sind voneinander isoliert"' die Formulierung "`weshalb Prozesse voneinander isoliert sind"' zu bilden. Nora findet die Markierung etwas ungewohnt, aber immer noch angenehmer als einen zweiten Absatz, der später vergessen werden kann. Und sie ist froh, dass English in dieser Beziehung ein bisschen regelmäßiger ist und die Verben nicht so herumschubst. }{On the slide these remain three entries. In the long form they become connected statements. The marked finite verb helps turn "`Prozesse sind voneinander isoliert"' into the German subordinate clause "`weshalb Prozesse voneinander isoliert sind"'. Nora finds the marking slightly unfamiliar, but still preferable to a second paragraph that might later be forgotten. And she's glad that English is a little more regular in that regard and doesn't mess with the verb forms so much. } \paragraph{\ldeen{Etwas mehr Platz im Skript}{A Little More Room in the Notes}.} \ldeen{Für die Folie genügt Nora die knappe Begründung. Im Skript möchte sie zusätzlich erklären, wo die Abbildung gespeichert wird. Diesmal unterscheidet sich nicht bloß die Formulierung, sondern der gewünschte Inhalt. Nora ergänzt deshalb nach dem Frame einen sogenannten \emph{Modusabschnitt}}{The concise explanation is enough for Nora's slide. In the lecture notes she also wants to explain where the mapping is stored. This time it is not merely the wording that differs, but the desired content. Nora therefore adds a so-called \emph{mode section} after the frame}: \begin{verbatim} \lecturemode{ \ldeen*{Eine Seitentabelle speichert die Abbildung @1.} {A page table stores the mapping $v\mapsto @1.}{$v\mapsto p$} } \end{verbatim} \ldeen{Sie hätte auch \code{