Ihr erstes Dokument

Beginnen Sie mit dem kleinsten Dokument, das zusammengestellt wird, und fügen Sie dann einen Titel und Überschriften hinzu, bis Sie einen kleinen Bericht haben. Unterwegs lernen Sie die Grundregeln von LaTeX kennen.

Das kleinste Dokument

Jedes LaTeX-Dokument besteht aus drei Teilen. \documentclass{...} oben wählt die Art des Dokuments; alles vor \begin{document} ist die Präambel (wohin die Einstellungen gehen); und alles zwischen \begin{document} und \end{document} ist der Körper. Diese wenigen Zeilen sind ein vollständiges, funktionierendes Beispiel.

latex
\documentclass{article}
\begin{document}
This is my first document.
\end{document}

Die Klasse ist eine Vorlage, die über das Gesamtaussehen des Dokuments entscheidet – Ränder, Überschriftenformen, Funktionsweise von Kapiteln usw. article ist die Standardklasse für Aufsätze, Kurzberichte und technische Notizen und der sichere Ausgangspunkt, wenn Sie sich nicht sicher sind. Es gibt auch report, book und – für Japanisch – jlreq (siehe „TeX/LaTeX und Japanisch“, um auf Japanisch zu schreiben).

Die Grundregeln

Jeder Befehl beginnt mit einem Backslash \. Erforderliche Argumente stehen in klammern { }, optionale in klammern [ ] (z. B. \documentclass[12pt]{article}). Alles von % bis zum Ende der Zeile ist ein Kommentar und wird nicht gedruckt.

Im Hauptteil werden Zeilenumbrüche in der Quelle ignoriert und eine Leerzeile beginnt einen neuen Absatz – LaTeX entscheidet über die endgültigen Zeilenumbrüche. Beachten Sie, dass & % $ # _ { } eine besondere Bedeutung hat; Um sie wörtlich auszugeben, maskieren Sie sie als \&, \% usw.

Kompilieren Sie es zu einem PDF

Führen Sie die Datei über eine TeX-Engine aus, um ein PDF zu erhalten. In einem Editor oder auf Overleaf drücken Sie einfach „Kompilieren“; auf der Kommandozeile:

terminal
pdflatex document.tex     # → document.pdf
# or, simpler — runs the right number of passes automatically:
latexmk -pdf document.tex

Dokumente mit einem Inhaltsverzeichnis oder Querverweisen benötigen zwei Durchgänge (latexmk ermittelt die Anzahl für Sie). Die vollständige Pipeline finden Sie unter „Von der Quelle zu PDF“.

Behebung der ersten Fehler

Im ersten Dokument ist es wichtiger zu lernen, wie man Fehler liest, als sie zu vermeiden. Wenn die Kompilierung stoppt, suchen Sie im .log- oder Editor-Protokoll nach der ersten Zeile, die mit ! beginnt. TeX kann aus einem Fehler viele Folgefehler erzeugen. Beheben Sie daher den obersten Fehler und führen Sie ihn erneut aus.

  • Jeder \begin{...} benötigt seinen passenden \end{...}; Wenn einer fehlt, wird der Build möglicherweise gegen Ende abgebrochen.
  • Um %, $, _ oder & wörtlich auszugeben, schreiben Sie \%, \$, \_ und \&.
  • Ein falsch geschriebenes \section ergibt Undefined control sequence; Überprüfen Sie den Befehlsnamen und alle erforderlichen Pakete.

Fügen Sie einen Titel und Überschriften hinzu – machen Sie daraus einen Bericht

Fügen Sie \title, \author und \date in die Präambel ein und rufen Sie dann \maketitle oben im Textkörper auf, um den Titel zu drucken. Mit \section und \subsection erstellte Überschriften werden automatisch nummeriert und \tableofcontents erstellt die Inhaltsliste für Sie.

latex
\documentclass{article}
\title{My First Report}
\author{Taro Yamada}
\date{\today}
\begin{document}
\maketitle
\tableofcontents

\section{Introduction}
This is the introduction.

\section{Method}
\subsection{Setup}
Details go here.
\end{document}

Um eine Überschrift nicht zu nummerieren, fügen Sie ein Sternchen hinzu: \section*{...}. \today wird durch das Datum ersetzt, an dem Sie kompilieren.

Fügen Sie Funktionen mit Paketen hinzu

Fehlende Funktionen stammen aus Paketen – fügen Sie einfach \usepackage{...} zur Präambel hinzu. Für Bilder graphicx; für ernsthafte Mathematik, amsmath; für Ränder geometry. Eine riesige Sammlung lebt auf CTAN.

latex
\documentclass{article}
\usepackage{graphicx}   % images
\usepackage{amsmath}    % better math
\begin{document}
% your content
\end{document}