Folium

Der Anfang

Ein Projekt ist ein GitHub-Repository. Auf der Startseite legen Sie eines an oder wählen ein vorhandenes; Folium klont es, setzt das Dokument und schreibt Ihre Arbeit in Abständen zurück. Nichts liegt nur bei uns: Der Ort, an dem Ihre Arbeit lebt, ist Ihr Repository.

Ein Projekt kann mehrere Dokumente tragen — die Dissertation und daneben die wöchentlichen Folien. Sie teilen sich Vorlage, Schriften, Abbildungen und Literatur.

Typst in zehn Minuten

Typst ist eine Auszeichnungssprache für gesetzte Dokumente — wie LaTeX, aber lesbarer und viel schneller. Sie schreiben Text, und ein paar Zeichen sagen, was er ist. Mehr als das Folgende brauchen die meisten Kapitel nie.

Text auszeichnen

Ein Rückstrich schützt ein Sonderzeichen: \* setzt einen Stern, statt fett zu schalten.

Befehle beginnen mit #

Alles, was mehr tut als auszeichnen, ist ein Aufruf mit #. Die häufigsten:

#image("figures/aufbau.png", width: 80%)

#figure(
  image("figures/messung.svg", width: 70%),
  caption: [Gemessene Abweichung über der Zeit],
) <fig:messung>

#cite(<knoll2019>)   // Literaturverweis
@fig:messung          // Verweis auf die Abbildung oben

Das Zeichen <name> hinter einer Abbildung ist ihre Marke; @name verweist darauf und setzt die richtige Nummer ein. Dasselbe gilt für Kapitel und Tabellen.

Mathematik

Im Text: $a^2 + b^2 = c^2$

Abgesetzt, mit Nummer:
$ integral_0^1 x^2 dif x = 1/3 $ <gl:integral>

Innerhalb der Dollarzeichen gilt Typsts Mathematiksatz: Leerzeichen trennen Symbole, ^ hebt hoch, _ stellt tief. Abgesetzt wird eine Formel, wenn Leerzeichen zwischen Dollarzeichen und Formel stehen.

Tabellen

#figure(
  table(
    columns: 3,
    [Verfahren], [Zeit], [Fehler],
    [Basislinie], [12.4 ms], [3.1 %],
    [Unseres],    [ 8.7 ms], [1.4 %],
  ),
  caption: [Vergleich der Verfahren],
)

columns: 3 sagt, dass je drei Zellen eine Zeile bilden. Die erste Reihe ist die Kopfzeile, wenn die Vorlage es so vorsieht.

Dokumente aus mehreren Dateien

#include "chapters/01_einleitung.typ"
#import "template/thesis.typ": *

#include fügt eine Datei an dieser Stelle ein — so entstehen Kapitel. #import holt Definitionen aus einer Vorlage. Eine eingebundene Datei ist kein eigenes Dokument; sie hat keine eigene Seite.

Mehr Sprache, als hier steht, brauchen Sie selten. Wenn doch: typst.app/docs ist die vollständige Referenz.

In der Seite schreiben

Klicken Sie in die gesetzte Seite und tippen Sie. Der Cursor sitzt dort, wo Sie hingeklickt haben, und das Dokument wird neu gesetzt, während Sie schreiben — in Millisekunden, im Browser selbst.

Manches in einer Seite ist berechnet und lässt sich nicht beschreiben: Seitenzahlen, Nummern von Abbildungen, das Inhaltsverzeichnis. Solche Stellen nehmen keinen Cursor an — sie ändern sich, indem man ihre Quelle ändert.

Wer lieber im Quelltext arbeitet: Editor zeigen in der Kopfzeile blendet ihn ein. Beide Seiten zeigen dasselbe Dokument, und der Cursor wandert mit.

Ein Klick zeigt das Detail, ein Doppelklick nimmt das Ganze. In einer Tabelle wählt der Klick die Zelle, der Doppelklick die ganze Tabelle; in einer Formel den Ausdruck, den man gerade meint, beziehungsweise die Formel als Ganzes. Bei einem Bild genügt der Klick — es hat keine Einzelteile.

Anmerkungen

Text auswählen, auf Anmerken klicken — die Anmerkung erscheint als Karte am Seitenrand, auf Höhe der Stelle, auf die sie sich bezieht.

Eine Anmerkung kann eine Änderung tragen. Dann zeigt die Karte den alten Text durchgestrichen und den neuen darunter, mit den Knöpfen Übernehmen und Ablehnen. Der Text ändert sich erst beim Übernehmen — bis dahin bleibt die Seite, wie sie ist.

Auf dem Telefon zeigt Folium nur die Seiten. Antippen einer markierten Stelle holt den Verlauf als Blatt von unten — mit Antworten und, wenn Sie den Bearbeiten-Link haben, den Entscheidungsknöpfen.

Claude als Mitarbeiter

Claude bekommt eine eigene Rolle. Es darf lesen, kommentieren und antworten — und Textänderungen vorschlagen. Wirksam werden sie erst, wenn ein Mensch sie in der Karte annimmt. Einen anderen Weg, den Text zu ändern, gibt es nicht.

Eingerichtet wird das auf der Startseite unter Claude verbinden: dort stehen die Werte für claude.ai, für Claude Science und das fertige Kommando für Claude Code, jeweils zum Kopieren. Ein Zugang genügt für alle Ihre Projekte.

Zwei Dinge darf Claude ohne Rückfrage, weil sie den Text nicht ändern: das PDF ins Projekt schreiben (es ist das Abbild des Textes, kein Eingriff), und Notizen anlegen.

Was Folium über Ihr Dokument weiß

Damit Claude nicht in jeder Sitzung dasselbe erklärt bekommen muss, gibt es zwei Orte im Projekt:

Beide liegen im Repository und werden mitcommittet. Die Notizen stehen im Explorer unter Notizen für Claude.

Dateien und Dokumente

Der Explorer links verwaltet das Projekt: Ordner sind anklickbare Zeilen — ein Klick wählt sie als Ziel und klappt sie auf oder zu. Was Sie anlegen oder hochladen, landet im gewählten Ordner.

Trägt das Projekt mehrere Dokumente, erscheint über dem Dateibaum eine Leiste. Ein Klick wechselt, was gesetzt wird. Als Dokument gilt eine .typ-Datei, die niemand einbindet und die ihre Seite selbst einrichtet — ein Kapitel also nicht, ein Foliensatz schon.

Teilen und Herunterladen

Teilen gibt zwei Links aus: einen zum Bearbeiten und einen zum Ansehen und Kommentieren. Wer den Ansehen-Link hat, kann lesen, anmerken und antworten — aber nichts ändern und keine Vorschläge annehmen.

Herunterladen bietet das gesetzte PDF, das ganze Projekt als ZIP-Archiv und den Weg zurück: Von GitHub holen, wenn jemand anderswo am Repository gearbeitet hat. Ein ZIP-Archiv einspielen geht ebenfalls dort — der übliche Weg aus Overleaf heraus.

GitHub

Folium committet Ihre Arbeit in Abständen und schiebt sie in Ihr Repository. Als Autor steht dort, wer angemeldet ist — die Historie zeigt also, wer was geschrieben hat.

Wer nebenher lokal arbeitet, pusht wie gewohnt und lässt Folium den Stand holen (Herunterladen → Von GitHub holen). Sind beide Seiten weitergelaufen, führt Folium nichts zusammen, sondern sagt es: Ein stiller Merge in einem Dokument richtet mehr Schaden an als ein Hinweis.

Ein Projekt, an dem eine halbe Stunde niemand arbeitet, wird schlafen gelegt und beim nächsten Öffnen des Links wieder geweckt. Ihre Arbeit ist zu dem Zeitpunkt längst committet.