# `pdf_split` — PDF aufteilen

**Zweck:** Teilt ein PDF in Einzelseiten oder benannte Seitenbereiche auf. Die Ergebnis-Pfade landen als Array im Kontext — ideal als Eingabe für `loop_foreach`.

**Parameter**

| Name | Pflicht? | Default | Beschreibung |
|---|---|---|---|
| `file` | ja | — | Quell-PDF. |
| `output_dir` | ja | — | Zielverzeichnis für die Teil-PDFs (wird bei Bedarf angelegt). Dateiname: `<Quellname>_<Bereichsname>.pdf`. |
| `range` | nein (mehrfach) | — | Benannter Bereich mit Attributen `name` und `pages`. Seitenangabe: einzelne Seiten, Bereiche und offene Enden kombinierbar, z. B. `1`, `2-5`, `6-`, `1,3-5,8-`. **Ohne** `range`-Einträge wird jede Seite einzeln gespeichert (Bereichsnamen `page_1`, `page_2`, …). |
| `files_var` | nein | `<task_id>_parts` | Name der Kontext-Variable für das Ergebnis-Array. |

**Eingangswerte:** PDF-Pfad-Variable, z. B. `{{antrag_pdf}}`; `{{temp_dir}}` als Zielverzeichnis.

**Ausgangswerte:**
- `<files_var>` — Array aller Teil-Pfade (in Bereichsreihenfolge)
- `<files_var>_named` — Zuordnung Bereichsname → Pfad
- `<files_var>_count` — Anzahl erzeugter Teile
- `<task_id>_part_<name>` — Einzelpfad je Bereich (z. B. `{{split_bereich_part_deckblatt}}`)

Hinweis: `latest_pdf_path` wird von diesem Task **nicht** verändert.

```xml
<task type="pdf_split" id="split_bereich">
  <config>
    <file>{{antrag_pdf}}</file>
    <output_dir>{{temp_dir}}</output_dir>
    <range name="deckblatt" pages="1" />
    <range name="inhalt"    pages="2-5" />
    <range name="anhang"    pages="6-" />
    <files_var>teile_pdfs</files_var>
  </config>
</task>
```