# Zitieren

Da alle gescannten Dokumente später auf **Illias** hochgeladen werden, bietet der SemesterapparatsManager eine automatische Zitierfunktion.

---

## Zitierstil

!!! abstract "Verwendeter Stil"
    Es wird der Zitierstil der **Deutschen Gesellschaft für Psychologie (DGPs)** verwendet.

---

## Oberfläche

![Zitieroberfläche](../images/generate_quote_emtpy.png){ loading=lazy }

### Zitat erstellen

1. Wählen Sie einen Eintrag in der ELSA-Tabelle aus
2. Klicken Sie auf **Eintrag zitieren**
3. Der Dialog öffnet sich und sucht automatisch im Katalog

!!! tip "Seitenzahlen"
    Die angegebene Seitenzahl aus der Tabelle wird automatisch übernommen. Bei mehreren Abschnitten muss die Seitenzahl ggf. angepasst werden.

---

## Zitierdialog

![Zitierdialog mit Ergebnis](../images/quote_search_result.png){ loading=lazy }

Nach dem Öffnen werden automatisch relevante Daten aus dem Katalog abgefragt und in die Felder eingetragen.

### Aktionen

| Knopf | Funktion |
|-------|----------|
| :lucide-search: **Suchen** | Sucht im Katalog nach dem Identifikator |
| :lucide-quote: **Zitat erstellen** | Verbindet mit Zotero und erstellt das Zitat |
| :lucide-check: **Ok** | Schließt den Dialog |
| :lucide-trash: **Discard** | Entfernt alle Eingaben |
| :lucide-x: **Abbrechen** | Schließt den Dialog |
| :lucide-rotate-ccw: **Wiederholen** | Zurück zur Eingabe für erneute Suche |

---

## Zitat-Erstellung

```mermaid
sequenceDiagram
    participant U as Benutzer
    participant S as SemesterapparatsManager
    participant Z as Zotero

    U->>S: Klick "Zitat erstellen"
    S->>Z: Werk anlegen
    Z-->>S: Werk-ID
    S->>Z: Zitat abrufen
    Z-->>S: Formatiertes Zitat
    S->>U: Zitat anzeigen
```

### Ablauf

1. Klicken Sie auf **Zitat erstellen**
2. Eine Verbindung zu Zotero wird hergestellt
3. Das Werk wird in Ihrer Zotero-Bibliothek angelegt
4. Das formatierte Zitat wird zurückgegeben

---

## Generierte Zitate

![Generierte Zitate](../images/quote_generated.png){ loading=lazy }

Nach erfolgreicher Erstellung wechselt der Dialog automatisch zur Zitat-Ansicht.

### Verwendung

Die generierten Zitate können:

- :lucide-copy: In die Zwischenablage kopiert werden
- :lucide-file-text: Als Dateiname für das gescannte Dokument verwendet werden
- :lucide-upload: Zusammen mit dem Dokument auf Illias hochgeladen werden

---

## Voraussetzungen

!!! warning "Zotero-Konfiguration erforderlich"
    Für die Zitierfunktion muss Zotero konfiguriert sein:
    
    1. Erstellen Sie einen API-Key in Ihrem Zotero-Account
    2. Tragen Sie den Key in den [Einstellungen](../allgemein/hauptoberflaeche.md#zotero) ein
