/latex/vorlagen — Vorlagen der LaTeX-Texte

Hinweis: Rahmen: 00-rahmen.md. Code: packages/plugins/src/latex/client/ (Vorlagenschirm.tsx, textanfragen.ts), Regeln in latex/shared/vorlage.ts, Server in latex/server/vorlagen.ts.

Wofür

Eine Vorlage ist der Anfang eines neuen Textes (LX18, N425 F1 und F7): eine Präambel, ein Gerüst für den Inhalt und die Satzmaschine. Wer auf /latex einen Text aus ihr anlegt, bekommt eine Hauptdatei aus Präambel, \begin{document}, Gerüst und \end{document} — kopiert, nicht verwiesen: Wer die Vorlage später ändert oder löscht, ändert keinen bestehenden Text. Die Vorlagen sind ein Grundstock für alle Konten wie die Snippets; eigene Vorlagen je Konto gibt es nicht. Zum Start stehen drei da (Wanderung 285): „Übungsblatt und Abgabe“, „Hausarbeit“ und „Folien mit Beamer“.

Weg und Rahmen

Was man sieht

Links die Liste, rechts (am Telefon darüber) das Blatt der gewählten Vorlage. Die Liste hat ein Suchfeld „Titel oder Satz suchen…“; jede Zeile trägt den Titel, rechts die Satzmaschine in Fira Code und darunter den Satz, wofür die Vorlage taugt. Die gewählte Zeile trägt einen Grund, ihre Kennung steht in der Adresse.

Das Blatt nennt den Titel und zeigt unter „So beginnt ein neuer Text“ die Hauptdatei als Quelle, so wie ein neuer Text sie bekommt. Bis der Übersetzungsdienst (LX14) setzen kann, steht dort die Quelle, keine gesetzte Seite.

• Ohne die Fähigkeit steht über der Quelle nur „Satz · Satzmaschine“.
• Mit der Fähigkeit steht dort das Formular: Titel, Satzmaschine, „Wofür sie taugt“, die Präambel und das Gerüst in Fira Code, ein Hinweis, dass Denotato \begin{document} und \end{document} selbst anfügt, und die Knöpfe „Speichern“ und „Löschen“. Die Quelle darunter folgt jeder Eingabe. In der Kopfzeile steht „Neue Vorlage“.
• Formularkopf (LX-261020-formular-nachziehen): Unter dem Hinweis folgt mit der Fähigkeit die Liste der Felder. Je Zeile zwei Pfeile zum Ordnen, die Beschriftung, der Befehl hinter einem festen Rückstrich (nur Buchstaben, etwa matrikel) und woher der Vorschlag kommt — Name aus dem Profil, Matrikelnummer, Gruppe aus dem letzten Text, Blatt, Modul, Frist oder von Hand —, dazu ein Knopf zum Entfernen. „Feld anfügen“ hängt eine leere Zeile an und sperrt mit Grund, wenn die Höchstzahl erreicht ist. Ohne Felder sagt ein Satz, dass ein Text aus der Vorlage keinen Formularkopf hat.

Ohne Vorlagen steht dort „Noch keine Vorlagen.“, ohne Wahl der Satz „Wähle eine Vorlage, um zu sehen, womit ein neuer Text aus ihr beginnt.“ Fällt die Abfrage aus, bleibt der letzte Stand stehen, und eine Marke sagt, dass Denotato nicht antwortet.

Was man tun kann

• Suchen nach Titel und Satz, im Browser.
• Ansehen, womit ein Text aus einer Vorlage beginnt.
• Anlegen, ändern, löschen — nur mit latex.befehle. Titel (höchstens 80 Zeichen), Satz (200) und Präambel sind nötig; Präambel und Gerüst höchstens 20 000 Zeichen. \begin{document} und \end{document} dürfen in keinem der beiden stehen, weil der Editor die Hauptdatei sonst an der falschen Stelle teilte. Löschen ist endgültig; Texte aus der Vorlage behalten ihren Inhalt, ihre Präambelzeile nennt dann keine Vorlage mehr.
• Felder pflegen — anlegen, umbenennen, ordnen, entfernen; gespeichert mit der Vorlage. Ein leerer oder doppelter Befehl, eine leere Beschriftung oder zu viele Felder sperren „Speichern“, der Grund steht unter dem Formular (formFieldsError). Bestehende Texte behalten ihren Kopf, wie sie ihre Präambel behalten.

Woher die Daten kommen

• personal.latex_vorlagen (Wanderung 285), ohne Besitzer und ohne Zeilensicherheit wie der Grundstock der Snippets; latex_texte.vorlage_id hält fest, aus welcher Vorlage ein Text kam (ON DELETE SET NULL).
• Endpunkte (alle POST, verschlüsselt): APIPaths.LATEX_VORLAGEN, LATEX_VORLAGEN_SPEICHERN, LATEX_VORLAGEN_LOESCHEN; die beiden letzten prüfen latex.befehle noch einmal.
• MCP: nur latex_vorlagen zum Lesen und vorlage an latex_text_anlegen. Die Pflege hat kein Werkzeug (N295).
• Der Schirm hält den Stand unter latex.vorlagen (useStand).

Was fehlt

1. Die gesetzte Vorschau der Vorlage kommt mit dem Übersetzungsdienst (LX14).
2. Eigene Vorlagen je Konto gibt es nicht; wer eine eigene Präambel will, ändert sie im Text.
3. Keine Reihenfolge der Vorlagen zur Wahl. Neue Vorlagen kommen hinten an; ordnen lässt sich nur in der Datenbank. Die Felder des Formularkopfs dagegen ordnet das Blatt.
4. Kein Text als Vorlage. Aus einem bestehenden Text eine Vorlage zu machen, geht nur durch Abschreiben.
5. Keine Prüfung durch den Satz. Ob eine Präambel übersetzt, zeigt sich erst im Text, und auch dort erst mit LX14.
6. Kein Verlauf. Eine geänderte Vorlage lässt sich nicht auf einen früheren Stand zurücksetzen.
7. Keine Zahl der Texte je Vorlage. Die Liste sagt nicht, wie viele Texte aus einer Vorlage entstanden sind.
8. Kein Bild, keine Datei in der Vorlage. Eine Vorlage trägt nur die Hauptdatei; ein Logo oder eine .bib fügt man im Text hinzu.