Folio Writer

Zeitschriftengenaue Einreichungen
mit lebendigen Abbildungen

In der letzten Woche vor der Einreichung passieren meist zwei Dinge: Das Manuskript wird in die Vorlage der Zeitschrift gezwängt, und die Abbildungen werden in dem Zustand eingefroren, in dem sie an diesem Tag gerade waren. Diese Anleitung kombiniert zwei Arbeitsabläufe in Folio Writer, damit keins von beidem passiert – das exakte Layout der Zeitschrift aus einer Quarto-Erweiterung, mit Abbildungen, die bei jedem Kompilieren aus Ihren Daten neu entstehen, bis zu dem Moment, in dem Sie hochladen.

Schritt 1 · Die Erweiterung der Zeitschrift hinzufügen

Die Zeitschriftenerweiterungen von Quarto sind von den Verlagen gepflegte Vorlagen – AGU, Elsevier, Copernicus und eine wachsende Liste. Installieren Sie eine ins Projekt, im Terminal:

cd /path/to/YourProject      # the folder with folio.json
quarto add quarto-journals/agu

Dadurch entsteht ein Ordner _extensions/ im Projekt – die Vorlage reist und synchronisiert also mit dem Manuskript. Ein Mitautor, der das Projekt öffnet, hat das Zeitschriftenformat ebenfalls, ohne etwas einzurichten.

Schritt 2 · Eine Zeile wählt die Zeitschrift

Fügen Sie im Metadaten-Dokument (oder unter Kompilieren ▸ Format-Metadaten) hinzu:

quarto-to: agu-pdf

Kompilieren Sie mit Renderer = Quarto, Format = PDF. Folio Writer rendert mit --to agu-pdf, reicht Ihre strukturierten Autoren, Affiliationen und ORCIDs unverändert an die Zeitschriftenvorlage durch – und entfernt die allgemeinen Layout-Schlüssel (geometry, fontsize, documentclass …), die mit der Zeitschriftenklasse in Konflikt geraten würden. Ihre alltäglichen Kompiliereinstellungen verunreinigen die Einreichung nicht.

Schritt 3 · Die eigenen Metadaten der Zeitschrift

Jede Erweiterung bringt ein paar eigene Schlüssel mit – sehen Sie in ihrer template.qmd auf GitHub nach. Für AGU:

citation:
  container-title: "JGR: Solid Earth"
plain-language-summary: |
  One paragraph for non-specialists.
key-points:
  - Up to three statements, ≤140 characters each.

Diese stehen wie alles andere im Metadaten-Dokument – einfaches YAML, im Projekt, unter Versionskontrolle.

Schritt 4 · Abbildungen, die in der Vorlage lebendig bleiben

Weil das Rendern für die Zeitschrift ein Quarto-Rendern ist, laufen Ihre ausführbaren Zellen darin mit: Jedes Kompilieren liest die Daten neu ein, passt das Modell neu an, zeichnet die Abbildung neu – im Gleitumgebungs-Layout, Beschriftungsstil und in der Nummerierung der Zeitschrift selbst. Zwei Optionen sorgen fürs Einpassen:

```{python}
#| label: fig-eos
#| fig-cap: "Compression curve with third-order Birch–Murnaghan fit."
#| fig-width: 5.6        # match the journal's text width
#| echo: false           # journals want figures, not code
...
```

Verweisen Sie im Text mit @fig:eos darauf wie auf jede andere Abbildung – Folio Writer übersetzt das beim Kompilieren in Quartos native Syntax, sodass dasselbe Manuskript weiterhin über pandoc/LaTeX gerendert werden kann, wenn Sie einen schlichten Build brauchen.

Eine ausführbare Zelle, die Daten aus Research liest, mit der angepassten Abbildung in der Vorschau
Die lebendige Hälfte der Kombination: Daten aus Research gelesen, beim Kompilieren angepasst und gezeichnet – die Zeitschriftenerweiterung liefert das Layout drumherum.
Die Dividende bei der Überarbeitung für die Gutachter: Wenn Gutachter 2 Sie bittet, die Analyse mit anderen Annahmen erneut laufen zu lassen, ändern Sie den Code oder die Daten – und jede Abbildung ist beim nächsten Kompilieren aktuell, im exakten Layout der Zeitschrift. Kein erneutes Exportieren, kein „Ist Abb. 3 die neue Version?“. (Passt gut zum Rundweg mit den Gutachtern.)

Schritt 5 · Beide Ergebnisse ausliefern

  1. Format = PDF – das zeitschriftengenaue PDF für die Begutachtung und für Ihre Mitautoren.
  2. Format = LaTeX – die .tex-Datei, die die meisten Einreichungssysteme tatsächlich wollen, erzeugt von derselben Erweiterung aus derselben Quelle. Die Abbildungen sind so enthalten, wie sie erzeugt wurden.

Warum diese Kombination zählt

Jede Hälfte für sich spart einen Nachmittag. Zusammen verändern sie, was eine Einreichung ist: ein Ordner mit einfachen Dateien – Text, Daten, Analysecode und die Zeitschriftenvorlage –, der deterministisch genau das Ergebnis erzeugt, das Sie hochgeladen haben. Erneut ausführbar für einen Mitautor heute, für einen Studenten in fünf Jahren, für Sie während der Überarbeitung. Das ist keine Bequemlichkeit; das ist Reproduzierbarkeit als Nebeneffekt Ihrer Art zu schreiben.

Folio Writer kostenlos laden → · Weitere Anleitungen