86 lines
2.2 KiB
Markdown
86 lines
2.2 KiB
Markdown
# Installation
|
|
|
|
## Voraussetzungen
|
|
|
|
Bevor Sie den SemesterapparatsManager installieren können, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:
|
|
|
|
- [x] Windows 10/11 oder höher
|
|
- [x] Internetzugang für Katalog-Abfragen
|
|
- [x] Optional: Zotero-Account für ELSA-Funktionen
|
|
|
|
## Installation
|
|
|
|
### Für Endanwender
|
|
|
|
=== "Portable Version"
|
|
|
|
1. Laden Sie die neueste Version von der Release-Seite herunter
|
|
2. Entpacken Sie die ZIP-Datei in einen Ordner Ihrer Wahl
|
|
3. Starten Sie `SemesterapparatsManager.exe`
|
|
|
|
=== "Installer"
|
|
|
|
1. Laden Sie den Installer herunter
|
|
2. Führen Sie die Setup-Datei aus
|
|
3. Folgen Sie den Anweisungen des Installationsassistenten
|
|
4. Starten Sie das Programm über das Startmenü
|
|
|
|
### Für Entwickler
|
|
|
|
!!! note "Entwicklerinstallation"
|
|
Diese Anleitung ist für Entwickler gedacht, die den Quellcode bearbeiten möchten.
|
|
|
|
#### Mit UV (empfohlen)
|
|
|
|
```bash
|
|
# Repository klonen
|
|
git clone https://github.com/IHR-REPO/SemesterapparatsManager.git
|
|
cd SemesterapparatsManager
|
|
|
|
# Virtuelle Umgebung erstellen und Abhängigkeiten installieren
|
|
uv sync
|
|
|
|
# Anwendung starten
|
|
uv run python main.py
|
|
```
|
|
|
|
#### Mit pip
|
|
|
|
```bash
|
|
# Repository klonen
|
|
git clone https://github.com/IHR-REPO/SemesterapparatsManager.git
|
|
cd SemesterapparatsManager
|
|
|
|
# Virtuelle Umgebung erstellen
|
|
python -m venv .venv
|
|
.venv\Scripts\activate
|
|
|
|
# Abhängigkeiten installieren
|
|
pip install -e ".[dev]"
|
|
|
|
# Anwendung starten
|
|
python main.py
|
|
```
|
|
|
|
## Erster Start
|
|
|
|
Beim ersten Start werden Sie aufgefordert, sich anzumelden:
|
|
|
|
{ loading=lazy }
|
|
|
|
!!! tip "Tipp"
|
|
Ihre Anmeldedaten werden sicher gespeichert. Bei Fragen zur Einrichtung wenden Sie sich an den Administrator.
|
|
|
|
## Konfiguration
|
|
|
|
Nach der Installation sollten Sie die Einstellungen überprüfen:
|
|
|
|
1. Öffnen Sie das Programm
|
|
2. Gehen Sie zu **Einstellungen** (über das Menü oder :lucide-settings:)
|
|
3. Konfigurieren Sie:
|
|
- **Datenbank-Pfad**: Speicherort der SQLite-Datenbank
|
|
- **Zotero**: API-Schlüssel für Zitat-Funktionen
|
|
- **E-Mail**: SMTP-Einstellungen für Benachrichtigungen
|
|
|
|
Weitere Informationen zur Konfiguration finden Sie unter [Hauptoberfläche](hauptoberflaeche.md).
|