# Seiten auswählen Wie Sie die Seiten benennen, auf die eine Aktion wirken soll: die Felder pages, page_order und groups sowie die Bereichssyntax, die sie teilen. Viele Aktionen wirken nur auf einen Teil der Seiten eines Dokuments. Diesen Teil beschreiben Sie mit einer kompakten Bereichssyntax: durch Kommas getrennte Seitenzahlen und Bereiche, beginnend bei 1, zum Beispiel `1..3,5`. Dieselben Zahlen und Bereiche tauchen in jeder Aktion auf, werden aber in einer von zwei Bedeutungen gelesen: als **Menge** oder als **geordnete Liste**. Diese Seite ist die einzige Referenz für beides; jede Aktion mit einem Feld für Seiten verweist hierher. ## Zwei Arten der Auswahl - Ein Feld vom Typ **Menge** (`pages`) beantwortet, *welche* Seiten. Reihenfolge und Duplikate werden ignoriert, und die ausgewählten Seiten werden immer in der Reihenfolge des Dokuments verarbeitet. - Ein **geordnetes** Feld (`page_order` sowie jede Gruppe in `groups`) beantwortet, *in welcher Reihenfolge*. Reihenfolge und Wiederholungen zählen: Die Seiten kommen genau so heraus, wie sie geschrieben sind. Die Syntax, mit der ein Bereich ausgedrückt wird, ist in beiden Fällen identisch. Der Unterschied liegt allein darin, wie das Ergebnis ausgelegt wird. ## Auswahl als Menge: das Feld `pages` Ein Feld `pages` ist eine durch Kommas getrennte Liste von Seitenzahlen und Bereichen, beginnend bei 1: - Eine einzelne Seite, zum Beispiel `5`. - Ein Bereich, zum Beispiel `2..6` (die Seiten 2 bis 6). - Ein offener Bereich: `8..` reicht von Seite 8 bis zur letzten Seite, und `..5` von der ersten Seite bis Seite 5. - Ein negativer Index zählt vom Ende her: `-1` ist die letzte Seite, `-2` die vorletzte. Bereiche nehmen sie ebenfalls entgegen, sodass `-3..-1` die letzten drei Seiten bezeichnet. Ein Feld `pages` wird als **Menge** behandelt: Reihenfolge und Duplikate werden ignoriert, und die Seiten werden immer in der Reihenfolge des Dokuments verarbeitet. Bleibt es leer, wird jede Seite ausgewählt. | Muster | Wählt aus | | ------------- | --------------------------------------- | | *(weglassen)* | Jede Seite | | `1` | Nur die erste Seite | | `2..6` | Die Seiten 2 bis 6 | | `1..3,5` | Die Seiten 1, 2, 3 und 5 | | `8..` | Seite 8 bis zur letzten Seite | | `..5` | Von der ersten Seite bis Seite 5 | | `..-2` | Von der ersten bis zur vorletzten Seite | | `-1` | Die letzte Seite | | `-3..-1` | Die letzten drei Seiten | Da eine Menge ohne Reihenfolge auskommt, wählen `5,1,2..3` und `1,2,3,5` genau dieselben Seiten aus, und beide werden in der Reihenfolge des Dokuments angewendet. Manche Aktionen fügen eine eigene Regel hinzu: [Seiten entfernen](/docs/api/remove-pages-from-pdf) muss zum Beispiel mindestens eine Seite übrig lassen, sodass eine Auswahl, die jede Seite entfernen würde, abgelehnt wird. ## Geordnete Auswahl: `page_order` und `groups` Manche Eingaben sind eine **geordnete** Liste statt einer Menge. Sie verwenden dieselben Zahlen und Bereiche wie oben, aber hier zählen Reihenfolge und Duplikate: Die Seiten kommen genau so heraus, wie sie aufgeführt sind, eine zweimal genannte Seite wird zweimal ausgegeben, und jede ausgelassene Seite wird verworfen. Ein Bereich darf auch rückwärts laufen: `10..5` geht von Seite 10 hinunter bis Seite 5. - [`page_order`](/docs/api/reorder-pages-of-pdf) (verwendet vom Neuanordnen) ist eine einzelne geordnete Liste. `3,1,2` stellt Seite 3 an den Anfang, dann 1, dann 2. Da ausgelassene Seiten verworfen und Wiederholungen beibehalten werden, dient das Neuanordnen zugleich als kombiniertes Extrahieren, Duplizieren und Neuanordnen. - [`groups`](/docs/api/split-pdf-into-page-groups) (verwendet vom Aufteilen in Seitengruppen) besteht aus mehreren geordneten Listen, getrennt durch `;`. Jede Gruppe wird zu einem Ausgabe-PDF, und innerhalb einer Gruppe gelten die geordneten Regeln. `2..8,29;1` erzeugt zwei Dokumente: das erste mit den Seiten 2 bis 8 und dann 29, das zweite mit Seite 1. ## Welches Feld jede Aktion verwendet | Feld | Semantik | Aktionen | | --- | --- | --- | | `pages` | Menge | [Textwasserzeichen hinzufügen](/docs/api/add-text-watermark-to-pdf), [Bildwasserzeichen hinzufügen](/docs/api/add-image-watermark-to-pdf), [Seiten extrahieren](/docs/api/extract-pages-from-pdf), [Seiten entfernen](/docs/api/remove-pages-from-pdf), [Seiten drehen](/docs/api/rotate-pages-in-pdf) | | `page_order` | Geordnet | [Seiten neu anordnen](/docs/api/reorder-pages-of-pdf) | | `groups` | Geordnet, je Gruppe | [In Seitengruppen aufteilen](/docs/api/split-pdf-into-page-groups) | <Tip> Greifen Sie zu einem Feld vom Typ Menge, wenn das Ergebnis unabhängig von der Reihenfolge ist, in der Sie es schreiben: ein Wasserzeichen auf den Seiten 2, 4 und 6 aufbringen. Greifen Sie zu einem geordneten Feld, wenn die Reihenfolge das Ergebnis *ist*: Seiten neu anordnen oder wiederholen. </Tip> ## Regeln, die überall gelten - Die Seitennummerierung ist **1-basiert**. Es gibt keine Seite `0`. - Negative Indizes und offene Bereiche funktionieren sowohl in Feldern vom Typ Menge als auch in geordneten Feldern. - Eine Auswahl, die eine Seite jenseits des Dokuments benennt, etwa `12` in einer Datei mit zehn Seiten, wird mit einem `400` abgelehnt. Siehe [Fehler](/docs/api/errors).