new-doxa-monorepo

doxa-cli/README_CZ.md

@@ -0,0 +1,93 @@
+DOXA-CLI
+
+DOXA-CLI je nástroj pro správu vašich poznámek z příkazové řádky. Umožňuje přidávat, zobrazovat, upravovat, mazat, exportovat poznámky a také je filtrovat a vyhledávat. Aplikace je napsána v Go a nabízí moderní terminálové uživatelské rozhraní (TUI).
+
+<p align="center">
+  <img src="https://img.shields.io/badge/go-1.22+-00ADD8?style=flat-square&logo=go&logoColor=white" alt="Go 1.22+">
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT license">
+  <img src="https://img.shields.io/badge/tested-Linux-brightgreen?style=flat-square" alt="Tested on Linux">
+</p> 
+<p align="center"> 
+   <img src="https://img.shields.io/badge/freebsd-AB2B28?style=for-the-badge&logo=freebsd&logoColor=white" alt="freeBSD">
+</p>    
+
+## Předpoklady
+
+Před instalací DOXA-CLI se ujistěte, že máte na svém systému nainstalovaný **Go**. Doporučená verze je 1.20 nebo vyšší.
+Stáhnout Go můžete z oficiálního webu: [https://go.dev/doc/install](https://go.dev/doc/install)
+
+![dashboard](screen/dashboard.png)
+
+## Instalace
+
+Pro instalaci DOXA-CLI na váš systém postupujte podle následujících kroků:
+
+1.  **Naklonujte repozitář**:
+    Získejte nejnovější verzi kódu z Gitea:
+    ```bash
+    git clone https://codeberg.org/Kankys/doxa-cli.git
+    cd doxa-cli # Přejděte do adresáře projektu
+    ```
+
+2.  **Spusťte instalační skript**:
+    ```bash
+    chmod +x install.sh
+    ./install.sh
+    ```
+    Instalační skript provede následující:
+    *   Zkontroluje, zda máte nainstalované Go.
+    *   Stáhne všechny potřebné Go moduly a závislosti projektu.
+    *   Zkompiluje aplikaci pro váš operační systém.
+    *   Nainstaluje spustitelný soubor `doxa-cli` do adresáře `$HOME/.local/bin/`.
+    *   Vytvoří konfigurační adresář `~/.doxa-cli` a soubor `doxa_notes.json`, pokud neexistují.
+
+3.  **Přidání do PATH (pokud je nutné)**:
+    Po úspěšné instalaci byste měli být schopni spustit `doxa-cli` z jakéhokoli místa v terminálu. Pokud příkaz `doxa-cli` není rozpoznán, je pravděpodobné, že adresář `$HOME/.local/bin` není ve vaší systémové proměnné `PATH`.
+
+    Můžete to opravit přidáním následujícího řádku do vašeho shell profilu (např. `~/.bashrc` pro Bash, `~/.zshrc` pro Zsh, nebo `~/.profile` pro jiné systémy):
+    ```bash
+    export PATH=$PATH:$HOME/.local/bin
+    ```
+    Po úpravě souboru profilu **restartujte terminál** nebo načtěte profil (např. `source ~/.bashrc`).
+
+## Úklid po instalaci
+
+Jakmile je instalace úspěšně dokončena, zdrojové soubory v adresáři projektu již nejsou potřeba. Celou složku s klonovaným repozitářem můžete smazat:
+
+```bash
+rm -rf doxa-cli
+```
+
+## Použití
+
+Po úspěšné instalaci můžete aplikaci spustit z jakéhokoliv adresáře zadáním:
+```bash
+doxa-cli
+```
+Pro detailní ovládání v TUI rozhraní se řiďte nápovědou zobrazovanou přímo v aplikaci.
+
+## Záloha
+
+Pro zálohu vašich poznámek je nutné si uložit soubor `doxa_notes.json` z konfiguračního adresáře `~/.doxa-cli` kamkoliv do vašeho záložního adresáře.
+
+**Poznámka**: Soubor `doxa_notes.json` obsahuje všechny vaše poznámky a je důležité si jej pravidelně uložit.
+
+
+
+## Odinstalace
+
+Pro odinstalaci DOXA-CLI postupujte takto:
+
+1.  **Odstraňte spustitelný soubor**:
+    Odstraňte binárku aplikace z vašeho PATH:
+    ```bash
+    rm ~/.local/bin/doxa-cli
+    ```
+    *(Pokud jste binárku nainstalovali do jiného adresáře, použijte jeho cestu.)*
+
+2.  **Odstraňte konfigurační adresář (volitelné)**:
+    Pokud chcete odstranit i veškerá data a konfiguraci aplikace, odstraňte konfigurační adresář:
+    ```bash
+    rm -rf ~/.doxa-cli
+    ```
+    **UPOZORNĚNÍ**: Tento krok smaže VŠECHNY vaše poznámky. Pokud si chcete data ponechat, tento krok vynechejte.