Dokumentation

Alles was du über die Verwendung von GitSy wissen musst

Installation

GitSy ist für Android-Geräte mit Android 7.0 oder neuer verfügbar. Du kannst es aus dem Google Play Store installieren oder die APK direkt herunterladen.

Systemanforderungen

  • Android 7.0+ (API-Level 24)
  • 64MB freier Speicherplatz
  • Internetverbindung für Synchronisation
  • Zugang zu einem Git-Repository (GitHub, GitLab, etc.)

Erforderliche Berechtigungen

  • Internet: Für Git-Synchronisation
  • Speicher: Für lokale Notizspeicherung
  • Netzwerkstatus: Zur Erkennung der Konnektivität

Ersteinrichtung

Nach der Installation von GitSy musst du es mit deinem Git-Repository verbinden. Dies ist ein einmaliger Prozess, der die Synchronisation auf allen deinen Geräten ermöglicht.

Schritt 1: Repository erstellen

Erstelle zunächst ein neues Repository bei deinem bevorzugten Git-Hosting-Service:

  • GitHub: Gehe zu github.com und erstelle ein neues Repository
  • GitLab: Besuche gitlab.com und erstelle ein neues Projekt
  • Selbst gehostet: Verwende deinen eigenen Git-Server

💡 Tipp

Mache dein Repository privat, um deine Notizen sicher zu halten. GitSy funktioniert sowohl mit öffentlichen als auch privaten Repositories.

Schritt 2: GitSy konfigurieren

Öffne GitSy und folge diesen Schritten:

  1. Tippe auf "Repository hinzufügen" im Willkommensbildschirm
  2. Gib deine Repository-URL ein
  3. Stelle deine Authentifizierungsdaten bereit
  4. Wähle einen lokalen Ordnernamen
  5. Tippe auf "Verbinden", um die Verbindung herzustellen

Erste Notiz erstellen

Sobald dein Repository verbunden ist, kannst du sofort mit der Erstellung von Notizen beginnen. GitSy verwendet eine einfache Benutzeroberfläche, die sich auf deinen Inhalt konzentriert.

Grundlagen der Notizerstellung

  1. Tippe auf die "+"-Schaltfläche, um eine neue Notiz zu erstellen
  2. Gib einen Titel für deine Notiz ein
  3. Beginne mit der Eingabe deines Inhalts
  4. GitSy speichert deine Änderungen automatisch
  5. Die Synchronisation erfolgt automatisch im Hintergrund

⚠️ Wichtig

Deine erste Synchronisation kann einige Momente dauern, da GitSy die anfängliche Repository-Struktur einrichtet.

Repository-Einrichtung

GitSy unterstützt verschiedene Git-Hosting-Services und Konfigurationen. Hier erfährst du, wie du Repositories für verschiedene Anbieter einrichtest.

GitHub

Repository-URL-Format:

https://github.com/benutzername/repository-name.git

GitLab

Repository-URL-Format:

https://gitlab.com/benutzername/repository-name.git

Selbst gehostetes Git

Repository-URL-Format:

https://dein-git-server.com/benutzername/repository-name.git

Authentifizierung

Sichere Authentifizierung ist für den Zugriff auf dein Git-Repository unerlässlich. GitSy unterstützt mehrere Authentifizierungsmethoden.

Personal Access Token (Empfohlen)

Die sicherste Methode ist die Verwendung eines Personal Access Tokens:

  1. Gehe zu den Einstellungen deines Git-Anbieters
  2. Generiere einen neuen Personal Access Token
  3. Gewähre Repository-Lese-/Schreibberechtigungen
  4. Kopiere den Token und füge ihn in GitSy ein

Benutzername/Passwort

Du kannst auch deinen regulären Benutzernamen und dein Passwort verwenden, aber diese Methode ist weniger sicher und funktioniert möglicherweise nicht bei allen Anbietern.

🔒 Sicherheitstipp

Verwende immer Personal Access Tokens anstelle von Passwörtern. Sie sind sicherer und können bei Bedarf einfach widerrufen werden.

Synchronisationseinstellungen

GitSy bietet flexible Synchronisationsoptionen, um ein Gleichgewicht zwischen Echtzeit-Updates und Akkulaufzeit zu schaffen.

Synchronisationsmodi

  • Automatisch: Synchronisiert bei jeder Änderung
  • Manuell: Synchronisiert nur, wenn du die Sync-Schaltfläche tippst
  • Geplant: Synchronisiert in regelmäßigen Abständen

Synchronisationshäufigkeit

Bei der Verwendung der geplanten Synchronisation kannst du wählen aus:

  • Alle 5 Minuten
  • Alle 15 Minuten
  • Jede Stunde
  • Alle 6 Stunden
  • Täglich

Notizverwaltung

GitSy bietet leistungsstarke Tools zur Organisation und Verwaltung deiner Notizen, während die Benutzeroberfläche sauber und einfach bleibt.

Notizorganisation

  • Ordner: Organisiere Notizen in Ordnern und Unterordnern
  • Tags: Füge Tags zu Notizen für einfache Kategorisierung hinzu
  • Favoriten: Markiere wichtige Notizen als Favoriten
  • Kürzlich: Schneller Zugriff auf kürzlich geänderte Notizen

Notizaktionen

  • Notizen erstellen, bearbeiten und löschen
  • Notizen für Vorlagen duplizieren
  • Notizen als Text oder Markdown teilen
  • Notizen in andere Apps exportieren

Markdown-Unterstützung

GitSy unterstützt vollständig Markdown-Formatierung, wodurch es einfach ist, reichhaltige, formatierte Notizen zu erstellen, die auf jedem Gerät großartig aussehen.

Unterstützte Markdown-Funktionen

Überschriften

# H1
## H2
### H3

Textformatierung

**Fetter Text**
*Kursiver Text*
~~Durchgestrichener Text~~

Listen

- Ungeordnete Liste
1. Geordnete Liste
- [ ] Aufgabenliste

Links und Bilder

[Link-Text](URL)
![Alt-Text](bild-url)

Konfliktlösung

Wenn dieselbe Notiz gleichzeitig auf mehreren Geräten bearbeitet wird, verwendet GitSy Gits Konfliktlösungssystem, um Konflikte elegant zu behandeln.

Wie Konflikte entstehen

Konflikte treten auf, wenn:

  • Dieselbe Notiz auf mehreren Geräten bearbeitet wird
  • Änderungen offline vorgenommen werden
  • Netzwerkprobleme eine ordnungsgemäße Synchronisation verhindern

Konfliktlösungsprozess

  1. GitSy erkennt den Konflikt während der Synchronisation
  2. Dir werden beide Versionen der Notiz präsentiert
  3. Wähle, welche Version behalten oder manuell zusammengeführt werden soll
  4. Die gelöste Notiz wird gespeichert und synchronisiert

💡 Best Practice

Um Konflikte zu minimieren, versuche die Bearbeitung einer Notiz abzuschließen, bevor du zu einem anderen Gerät wechselst.

Backup & Wiederherstellung

Deine Notizen werden automatisch in deinem Git-Repository gesichert, aber GitSy bietet auch zusätzliche Backup-Optionen für extra Sicherheit.

Automatisches Git-Backup

Jedes Mal, wenn du synchronisierst, werden deine Notizen in deinem Git-Repository gesichert. Das bedeutet, du hast:

  • Vollständige Versionsgeschichte aller Änderungen
  • Mehrere Kopien auf allen verbundenen Geräten
  • Wiederherstellung von jedem Zeitpunkt

Manueller Export

Du kannst deine Notizen auch manuell exportieren:

  • Alle Notizen als ZIP-Datei exportieren
  • Einzelne Notizen als Markdown-Dateien exportieren
  • Notizen per E-Mail oder andere Apps teilen

Fehlerbehebung

Häufige Probleme und ihre Lösungen, um das Beste aus GitSy herauszuholen.

Synchronisationsprobleme

Problem: Notizen synchronisieren nicht

Lösungen:

  • Überprüfe deine Internetverbindung
  • Verifiziere Repository-Anmeldedaten
  • Versuche manuelle Synchronisation
  • Starte die App neu

Problem: Authentifizierung fehlgeschlagen

Lösungen:

  • Überprüfe, ob dein Token abgelaufen ist
  • Verifiziere Token-Berechtigungen
  • Versuche Anmeldedaten erneut einzugeben
  • Überprüfe Repository-URL-Format

Problem: App stürzt ab oder friert ein

Lösungen:

  • Aktualisiere auf die neueste Version
  • Lösche App-Cache
  • Starte dein Gerät neu
  • Überprüfe verfügbaren Speicherplatz

Brauchst du mehr Hilfe?

Wenn du immer noch Probleme hast, besuche bitte unsere Kontaktseite, um dich mit unserem Support-Team in Verbindung zu setzen.