{"id":4281,"date":"2026-03-16T07:00:00","date_gmt":"2026-03-16T06:00:00","guid":{"rendered":"https:\/\/www.my-it-brain.de\/wordpress\/?p=4281"},"modified":"2026-02-07T22:19:28","modified_gmt":"2026-02-07T21:19:28","slug":"von-scrartcl-zu-typst","status":"publish","type":"post","link":"https:\/\/www.my-it-brain.de\/wordpress\/von-scrartcl-zu-typst\/","title":{"rendered":"Von scrartcl zu typst"},"content":{"rendered":"\n<p>In der Vergangenheit habe ich viele Dokumente, wie z.B. Hausarbeiten, Aufs\u00e4tze, Briefe, Dokumentationen und Pr\u00e4sentationen mit <a href=\"https:\/\/www.latex-project.org\/\">LaTeX<\/a> erstellt. In der Vorbereitungsphase f\u00fcr einen Vortrag haben <a href=\"https:\/\/dirk.deimeke.ruhr\/\">Dirk<\/a> und ich beschlossen, <a href=\"https:\/\/typst.app\/\">Typst<\/a> zu lernen.<\/p>\n\n\n\n<p>Wie ich <a href=\"https:\/\/www.my-it-brain.de\/wordpress\/briefe-mit-typst-statt-latex-schreiben\/\">Briefe mit Typst statt LaTeX<\/a> schreibe, habe ich bereits beschrieben. Hier schreibe ich, wie ich meine <a href=\"https:\/\/www.my-it-brain.de\/wordpress\/update-2025-01-zur-dokumentation-fuer-den-notfall\/\" data-type=\"post\" data-id=\"4008\">Notfalldokumentation<\/a> von scrartcl zu typst migriert habe.<\/p>\n\n\n\n<p>Ich habe kein Werkzeug zur automatischen Konvertierung genutzt, da ich zu faul war, ein solches erst zu finden und zu erlernen. Stattdessen habe ich Vim genutzt und die entsprechenden Umgebungen ersetzt. Das war in diesem Fall in Ordnung, kann aber bei komplexeren Dokumenten schnell in Arbeit ausarten. Allerdings werden Automaten bei zunehmend komplexen Projekten ebenfalls an ihre Grenzen kommen.<\/p>\n\n\n\n<p>Im Folgenden findet ihr einen kurzen Vergleich der Syntax-Elemente.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Die Preamble (Vorspann)<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Die Preamble ist der Teil des LaTeX-Dokuments, der vor dem eigentlichen Inhalt steht. Hier werden grundlegende Einstellungen und Pakete definiert, die w\u00e4hrend der Dokumenterstellung verwendet werden. Die Preamble beginnt immer mit dem Befehl <code>\\documentclass<\/code> und endet mit dem Befehl <code>\\begin{document}<\/code>.<\/p>\n<cite>Quelle: <a href=\"https:\/\/www.namsu.de\/LaTeX-Buch\/kap2-2.html\">https:\/\/www.namsu.de\/LaTeX-Buch\/kap2-2.html<\/a><\/cite><\/blockquote>\n\n\n\n<p>Die LaTeX-Preamble meiner Dokumentation sieht wie folgt aus:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\\documentclass&#91;a4paper,parskip=half,numbers=noenddot]{scrartcl}\n\\usepackage&#91;ngerman]{babel}\n\\usepackage&#91;T1]{fontenc}\n\\usepackage&#91;utf8x]{inputenc}\n\\usepackage{lmodern}\n\\usepackage{graphicx}\n\\usepackage{subcaption}\n\\usepackage&#91;ngerman]{varioref}\n\\usepackage{pdfpages}\n\\usepackage{hyperref}\n\n%opening\n\\title{Dokumentation des Heimnetzwerks in der Triftenstr. 10}\n\\author{J\u00f6rg Kastning}\n\n\\begin{document}<\/code><\/pre>\n\n\n\n<p>Der Vorspann meiner <code>typ<\/code>-Datei zum Vergleich:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>#set page(paper: \"a4\", numbering: \"1\")\n#set heading(numbering: \"1.1\")\n#set text(lang: \"de\")\n#set document(\n  title: &#91;Dokumentation des Heimnetzwerks in der Triftenstr. 10],\n  author: \"J\u00f6rg Kastning\"\n)<\/code><\/pre>\n\n\n\n<p>Die Syntax-Elemente werden in der <a href=\"https:\/\/typst.app\/docs\/reference\/\">Typst-Referenz<\/a> erkl\u00e4rt, z.B.:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/typst.app\/docs\/reference\/layout\/page\/\"><code>page<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/typst.app\/docs\/reference\/model\/heading\/\"><code>heading<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/typst.app\/docs\/reference\/text\/text\/\"><code>text<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/typst.app\/docs\/reference\/model\/document\/\"><code>document<\/code><\/a><\/li>\n<\/ul>\n\n\n\n<p>Die Referenz ist st\u00e4ndig in einem Browser-Tab ge\u00f6ffnet, wenn ich mit <code>typst<\/code> arbeite. Dies wird so bleiben, bis ich die am h\u00e4ufigsten verwendeten Funktionen auswendig kenne.<\/p>\n\n\n\n<p>Grunds\u00e4tzlich halte ich mich an das <a href=\"https:\/\/de.wikipedia.org\/wiki\/KISS-Prinzip\">KISS-Prinzip<\/a> und den Grundsatz: <em>Form follows function (Deutsch: die Form folgt der Funktion bzw. dem Inhalt).<\/em> Ich m\u00f6chte mich so viel wie m\u00f6glich mit dem Inhalt besch\u00e4ftigen und m\u00f6glichst wenig Zeit mit dem Satz bzw. der Formatierung zubringen.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Abbildungen und Tabellen<\/h2>\n\n\n\n<p>Zu den h\u00e4ufigsten Umgebungen z\u00e4hlen vermutlich Abbildungen und Tabellen. In der LaTeX-Version habe ich diese wie folgt gesetzt:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\\begin{tabular}{ll}\n    Vertragsnummer  &amp; 12345\\\\\n    Kundennummer  &amp; 98765432\\\\\n    Tarif &amp; zuhause100\\\\\n\\end{tabular}\n\n\\begin{figure}\n    \\centering\n    \\includegraphics&#91;scale=0.3]{bilder\/bild.jpg}\n    \\caption{Meine super Bildunterschrift}\n    \\label{fig:bild}\n\\end{figure}\n\n\\begin{figure}\n    \\begin{subfigure}&#91;c]{0.5\\textwidth}\n        \\includegraphics&#91;width=0.9\\textwidth]{bilder\/front.jpg}\n        \\subcaption{Frontansicht}\n    \\end{subfigure}\n    \\begin{subfigure}&#91;c]{0.5\\textwidth}\n        \\includegraphics&#91;width=0.9\\textwidth]{bilder\/rear.jpg}\n        \\subcaption{R\u00fcckansicht}\n    \\end{subfigure}\n    \\caption{Das sind zwei tolle Abbildungen.}\n    \\label{fig:bild2}\n\\end{figure}<\/code><\/pre>\n\n\n\n<p>F\u00fcr das LaTeX-Konstrukt <code>subfigure<\/code> habe ich keinen entsprechenden Ersatz in <code>typst<\/code> gefunden. Ich setze dies in einzelnen Abbildungen hintereinander um. Die Umgebungen sehen nun wie folgt aus:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>#figure(\n  table(\n    columns: 2,\n    stroke: (x: none),\n    &#91;Vertragsnummer], &#91;12345],\n    &#91;Kundennummer], &#91;98765432],\n    &#91;Tarif], &#91;zuhause100],\n  ),\n  caption: &#91;Vertragsinformationen],\n) &lt;referenz-name&gt;\n\n#figure(\n  image(\"bilder\/bild.jpg\", width: 30%),\n  caption: &#91;Meine super Bildunterschrift],\n) &lt;referenz_name2&gt;<\/code><\/pre>\n\n\n\n<p>Tabellen und Bilder werden beide in einer <code><a href=\"https:\/\/typst.app\/docs\/reference\/model\/figure\/\">figure<\/a><\/code>-Umgebung gesetzt. Dies macht in meinen Augen Sinn, da beide Umgebungen in der Regel mit einer \u00dcber- bzw. Unterschrift versehen werden, h\u00e4ufig zentriert gesetzt und mit einer <a href=\"https:\/\/typst.app\/docs\/reference\/model\/ref\/\">Referenz<\/a> versehen werden.<\/p>\n\n\n\n<p>Ich habe mich noch nicht ganz an die Terminologie gew\u00f6hnt. Typst bezeichnet <code>figure<\/code> und <code><a href=\"https:\/\/typst.app\/docs\/reference\/model\/table\/\">table<\/a><\/code> sowie die meisten anderen Elemente als Funktionen und nicht als Umgebungen.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Aufz\u00e4hlungen, Links und Listen<\/h2>\n\n\n\n<p>F\u00fcr nummerierte und unsortierte Listen in LaTeX siehe <a href=\"https:\/\/ctan.ebinger.cc\/tex-archive\/macros\/latex\/contrib\/koma-script\/doc\/scrguide-de.pdf\">Abschnitt 3.18. Listen<\/a> im KOMA-Script Scrguide. F\u00fcr <code>typst<\/code> siehe <code><a href=\"https:\/\/typst.app\/docs\/reference\/model\/enum\/\">enum<\/a><\/code> und <code><a href=\"https:\/\/typst.app\/docs\/reference\/model\/list\/\">list<\/a><\/code>.<\/p>\n\n\n\n<p>F\u00fcr <a href=\"https:\/\/markov.htwsaar.de\/tex-archive\/macros\/latex\/contrib\/hyperref\/doc\/hyperref-doc.html#x1-230006\">Links<\/a> steht in LaTeX das m\u00e4chtige Paket <code>hyperref<\/code> bereit. In <code>typst<\/code> gibt es das <code><a href=\"https:\/\/typst.app\/docs\/reference\/model\/link\/\">link<\/a><\/code>-Element.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Fazit<\/h2>\n\n\n\n<p>Mir erscheint die <code>typst<\/code>-Syntax etwas einfacher, daf\u00fcr weniger flexibel zu sein. Was mir besser gef\u00e4llt, mag ich noch nicht sagen, da ich noch unentschlossen bin.<\/p>\n\n\n\n<p>Das mit LaTeX erstellte PDF sieht in meinen Augen perfekt aus. Das mit typst erstellte PDF sieht ebenfalls gut aus und ist leserlich. Es reicht in meinen Augen jedoch nicht an die LaTeX-Ausgabe heran.<\/p>\n\n\n\n<p>In typst ist meine Preambel k\u00fcrzer, die Syntax etwas einfacher. Daf\u00fcr war es mir nicht so einfach m\u00f6glich, die Schriftart zu \u00e4ndern. Diese h\u00e4tte ich erst in meine typst-Bin\u00e4rdatei mit einkompilieren m\u00fcssen. Ein Vorgang, der mir entschieden zu aufwendig ist.<\/p>\n\n\n\n<p>Probiert es am besten aus und entscheidet selbst, welches Ergebnis euch besser gef\u00e4llt. Ich vermag (noch) nicht zu sagen, ob mir LaTeX oder typst insgesamt besser gefallen. Werft ggf. zuerst einen Blick in den <a href=\"https:\/\/typst.app\/docs\/guides\/for-latex-users\/\">Guide for LaTeX Users<\/a>.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>In der Vergangenheit habe ich viele Dokumente, wie z.B. Hausarbeiten, Aufs\u00e4tze, Briefe, Dokumentationen und Pr\u00e4sentationen mit LaTeX erstellt. In der Vorbereitungsphase f\u00fcr einen Vortrag haben Dirk und ich beschlossen, Typst zu lernen. Wie ich Briefe mit Typst statt LaTeX schreibe, habe ich bereits beschrieben. Hier schreibe ich, wie ich meine Notfalldokumentation von scrartcl zu typst<span class=\"continue-reading\"> <a href=\"https:\/\/www.my-it-brain.de\/wordpress\/von-scrartcl-zu-typst\/\">[Weiterlesen&#8230;]<\/a><\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_metis_text_type":"standard","_metis_text_length":5362,"_post_count":0,"footnotes":""},"categories":[90],"tags":[430,305],"class_list":["post-4281","post","type-post","status-publish","format-standard","hentry","category-latex","tag-osbn","tag-planet"],"public_identification_id":"aadce3cb846f49c6ace45b5deb97be1c","private_identification_id":"c7e23b3e2dbc4ac88b74c39d70d8ef67","_links":{"self":[{"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/posts\/4281","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/comments?post=4281"}],"version-history":[{"count":10,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/posts\/4281\/revisions"}],"predecessor-version":[{"id":4301,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/posts\/4281\/revisions\/4301"}],"wp:attachment":[{"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/media?parent=4281"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/categories?post=4281"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.my-it-brain.de\/wordpress\/wp-json\/wp\/v2\/tags?post=4281"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}