mirror of
https://codeberg.org/Kankys/doxa.git
synced 2026-11-11 14:44:36 +01:00
126 lines
3.6 KiB
Markdown
126 lines
3.6 KiB
Markdown
# DOXA-TODO 🦅
|
|
|
|
**Locally-First Správce Úkolů** - Minimalistická terminálová aplikace pro správu úkolů s podporou kategorií, priorit a štítků.
|
|
|
|
## Funkce
|
|
|
|
- **Dvoujazyčná podpora**: Čeština a Angličtina (přepínání klávesou `l`)
|
|
- **Kategorie**: Osobní a Pracovní úkoly
|
|
- **Priority**: 3 úrovně (Nízká, Střední, Vysoká)
|
|
- **Štítky**: Podpora pro označování úkolů
|
|
- **Automatické datum**: Časové razítko vytvoření a úpravy
|
|
- **Trvalé uložení**: Úkoly se ukládají do `~/.doxa-todo/doxa_todo.json`
|
|
- **Vyhledávání a filtrace**: Vyhledávání podle textu, procházení podle štítků, filtrace podle kategorie
|
|
- **Export**: Export jednotlivých úkolů do textových souborů
|
|
- **Splněné úkoly**: Označování úkolů jako splněné/nesplněné s automatickým řazením na konec seznamu
|
|
|
|
## Instalace
|
|
|
|
### Pomocí install.sh (Doporučeno)
|
|
|
|
```bash
|
|
# Naklonujte repositář
|
|
git clone https://codeberg.org/Kankys/doxa-todo.git
|
|
cd doxa-todo
|
|
|
|
# Učiňte install.sh spustitelným a spusťte ho
|
|
chmod +x install.sh
|
|
./install.sh
|
|
```
|
|
|
|
Skript:
|
|
1. Zkontroluje instalaci Go
|
|
2. Stáhne závislosti
|
|
3. Zkompiluje aplikaci
|
|
4. Nainstaluje do `~/.local/bin`
|
|
5. Vytvoří konfigurační adresář `~/.doxa-todo`
|
|
|
|
### Ruční instalace
|
|
|
|
```bash
|
|
# Naklonujte repositář
|
|
git clone https://codeberg.org/Kankys/doxa-todo.git
|
|
cd doxa-todo
|
|
|
|
# Zkompilujte aplikaci
|
|
go build -o doxa-todo .
|
|
|
|
# Nainstalujte do svého PATH
|
|
cp doxa-todo ~/.local/bin/
|
|
chmod +x ~/.local/bin/doxa-todo
|
|
|
|
# Ujistěte se, že ~/.local/bin je ve vašem PATH
|
|
export PATH=$PATH:~/.local/bin
|
|
```
|
|
|
|
## Použití
|
|
|
|
### Klávesové zkratky
|
|
|
|
| Klávesa | Akce |
|
|
|---------|-------|
|
|
| `Enter` | Spustit aplikaci / Zobrazit vybraný úkol |
|
|
| `q` | Ukončit aplikaci / Jít zpět |
|
|
| `Esc` | Jít zpět / Vymazat vyhledávání |
|
|
| `1` | Přidat nový úkol |
|
|
| `2` | Upravit vybraný úkol |
|
|
| `3` | Exportovat vybraný úkol |
|
|
| `4` | Smazat vybraný úkol |
|
|
| `/` | Vyhledat úkoly |
|
|
| `b` | Procházet štítky |
|
|
| `c` | Filtr podle kategorie |
|
|
| `l` | Přepnout jazyk (Čeština/Angličtina) |
|
|
| `t` | Přepnout stav splnění úkolu |
|
|
| `+` | Zvýšit prioritu (při přidávání/úpravě) |
|
|
| `↑/↓` nebo `j/k` | Procházet seznamem |
|
|
| `Tab` | Přepínat mezi poli |
|
|
|
|
### Struktura úkolu
|
|
|
|
Každý úkol má:
|
|
- **Název** (povinný)
|
|
- **Popis** (nepovinný)
|
|
- **Prioritu**: Nízká (●), Střední (●), Vysoká (●) - s barevným označením
|
|
- **Kategorii**: Osobní (🏠) nebo Pracovní (💼)
|
|
- **Štítky**: Seznam oddělený čárkami
|
|
- **Vytvořeno**: Automatické časové razítko
|
|
- **Upraveno**: Automatické časové razítko při úpravách
|
|
- **Splněno**: Stav splnění (přepíná se klávesou `t`)
|
|
|
|
### Uložení
|
|
|
|
Všechny úkoly jsou uloženy v JSON formátu na:
|
|
```
|
|
~/.doxa-todo/doxa_todo.json
|
|
```
|
|
|
|
Exportované úkoly jsou uloženy v:
|
|
```
|
|
~/doxa-todo-export/
|
|
```
|
|
|
|
## Splněné úkoly
|
|
|
|
Aplikace podporuje označování úkolů jako splněné:
|
|
- **Přepnutí stavu**: Vyberte úkol a stiskněte `t` pro přepnutí mezi splněným/nesplněným
|
|
- **Vizualizace**: Splněné úkoly jsou zobrazovány přeškrtlé a šedě
|
|
- **Automatické řazení**: Splněné úkoly jsou vždy zobrazeny na konci seznamu (za nesplněnými)
|
|
- **Trvalé uložení**: Stav splnění se ukládá spolu s úkolem
|
|
|
|
## Konfigurace
|
|
|
|
Aplikace automaticky vytvoří konfigurační adresář a soubor při prvním spuštění.
|
|
|
|
## Licence
|
|
|
|
MIT License - Copyright (c) 2026 Kankys
|
|
|
|
## Autor
|
|
|
|
Kankys - [Codeberg](https://codeberg.org/Kankys)
|
|
|
|
## Příbuzné projekty
|
|
|
|
- [doxa-cli](https://codeberg.org/Kankys/doxa-cli) - Správce poznámek
|
|
- [doxa-secret](https://codeberg.org/Kankys/doxa-secret) - Nástroj pro šifrování zpráv
|