Abbildungen
Bilddateien werden über die figure-Funktion eingebunden. Im einfachsten Fall schreibt man:
#figure(image("Bilddatei.jpg"))
Von Typst verstanden werden verschiedene Dateiformate (jpg, pdf, png usw.).
Relative Pfade
Achtung! Alle Pfadangaben sind RELATIV, und zwar zum Typst-Quellcode! Das bedeutet, die im Beispiel gezeigte Pfadangabe sucht die Datei logo.jpg im gleichen
Verzeichnis, in dem auch der Quellcode liegt.
Liegen Bilddateien in einem Unterverzeichnis, schreibt man beispielsweise:
Abbildungen/logo.jpg
oder wenn die Dateien ganz woanders liegen, dann eben:
../../images/
Bildgröße
Die Größe der Bilddatei wird mit dem width-Parameter bestimmt. Bequem ist eine prozentuale Angabe. Auch auto u.a. sind möglich, siehe Typst-Dokumentation.
Rahmen
Soll die Abbildung selbst in einen einfachen Rahmen eingefaßt werden, setzt man die image-Funktion geschachtelt in eine rect-Funktion:
#figure(rect(image("logo.jpg", width: 30%)))
Zur Erinnerung: In der Typst-Syntax werden Leerzeichen, Umbrüche und Einrückungen lediglich zur besseren Übersichtlichkeit genutzt. Ein genau gleiches Ergebnis erhält man, wenn man alle Anweisungen in eine Zeile schreibt:
Bildbeschriftung
Jede Abbildung verdient eine Unterschrift. Diese kann über den Parameter caption eingegeben werden (Code-Zeile 41):
#figure(image("logo.jpg", width: 30%), caption: [Beschriftung]) <marke>
Außerdem habe ich eine Verweismarke angebracht (Code-Zeile 42) und darauf verwiesen (Code-Zeile 46). Siehe auch Lektion Dokumentinterne Verweise.
Ohne weitere Angabe wird die Bilddatei dort dargestellt, wo sie im Quelltext steht (also z.B. zwischen Textblock A und B). Soll die Position des Bildes vorgegeben werden, nutzt man den
placement-Parameter mit den Möglichkeiten top (oben auf der Seite), bottom (unten auf der Seite) oder auto (automatisch oben oder unten, je
nachdem, was näher ist).
#figure(placement: top, image("logo.jpg", width: 30%), caption: [Beschriftung]) <marke>
Um die Bildunterschrift noch etwas mehr abzuheben, setze ich sie mit der Anweisung in Code-Zeile 5 kursiv:
#show figure.caption: emph
Zähler zurücksetzen
Angenommen, die Titelseite wird von einer Grafik geziert. Hier gibt man selbstverständlich keine Beschriftung an. Werden dann allerdings später im Text Abbildungen mit Beschriftung plaziert, so beginnen sie dort mit "Abbildung 2" (es fehlt also die Abbildung "Nr. 1"). Aus diesem Grund wird gleich nach der Titelgrafik der interne Abbildungszähler zurückgesetzt:
#counter(figure.where(kind: image)).update(0)