Skip to content

Commit

Permalink
Added translated docs to czech
Browse files Browse the repository at this point in the history
  • Loading branch information
zen0bit committed Mar 13, 2023
1 parent 13706c4 commit 7f92392
Show file tree
Hide file tree
Showing 17 changed files with 1,334 additions and 7 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
| Updated 07.02.2023 | Languages: EN, [FR](/docs/lang/fr/README.md) |
| Updated 07.02.2023 | Languages: EN, [FR](/docs/lang/fr/README.md), [CZ](/docs/lang/cs/README.md) |

<img src="images/simplex-chat-logo.svg" alt="SimpleX logo" width="100%">

Expand Down
2 changes: 2 additions & 0 deletions docs/ANDROID.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
| Updated 26.02.2023 | Languages: EN, [CZ](/docs/lang/cs/ANDROID.md) |

# Accessing files in Android app

SimpleX uses databases and stores its preferences inside private data directory in Android. The directory contains:
Expand Down
2 changes: 1 addition & 1 deletion docs/CLI.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
| Updated 31.01.2023 | Languages: EN, [FR](/docs/lang/fr/CLI.md) |
| Updated 26.02.2023 | Languages: EN, [FR](/docs/lang/fr/CLI.md), [CZ](/docs/lang/cs/CLI.md) |

# SimpleX Chat terminal (console) app for Linux/MacOS/Windows

Expand Down
2 changes: 1 addition & 1 deletion docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
| Updated 31.01.2023 | Languages: EN, [FR](/docs/lang/fr/CONTRIBUTING.md) |
| Updated 26.02.2023 | Languages: EN, [FR](/docs/lang/fr/CONTRIBUTING.md), [CZ](/docs/lang/cs/CONTRIBUTING.md) |

# Contributing guide

Expand Down
2 changes: 1 addition & 1 deletion docs/SERVER.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
| Updated 31.01.2023 | Languages: EN, [FR](/docs/lang/fr/SERVER.md) |
| Updated 26.02.2023 | Languages: EN, [FR](/docs/lang/fr/SERVER.md), [CZ](/docs/lang/cs/SERVER.md) |

# Hosting your own SMP Server

Expand Down
3 changes: 1 addition & 2 deletions docs/SIMPLEX.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
| Updated 07.02.2023 | Languages: EN, [FR](/docs/lang/fr/SIMPLEX.md) |

| Updated 26.02.2023 | Languages: EN, [FR](/docs/lang/fr/SIMPLEX.md), [CZ](/docs/lang/cs/SIMPLEX.md) |
# SimpleX platform - motivation and comparison

## Problems
Expand Down
2 changes: 1 addition & 1 deletion docs/SQL.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
| Updated 31.01.2023 | Languages: EN, [FR](/docs/lang/fr/SQL.md) |
| Updated 26.02.2023 | Languages: EN, [FR](/docs/lang/fr/SQL.md), [CZ](/docs/lang/cs/SQL.md) |

# Accessing messages in the database

Expand Down
2 changes: 2 additions & 0 deletions docs/TRANSLATIONS.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
| Updated 26.02.2023 | Languages: EN, [CZ](/docs/lang/cs/TRANSLATIONS.md) |

# Contributing translations to SimpleX Chat

Huge thanks for your interest in translating SimpleX Chat - it helps a lot to make it accessible to a wider range of users, and we really appreciate your help.
Expand Down
41 changes: 41 additions & 0 deletions docs/lang/cs/ANDROID.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
| Aktualizováno 26.02.2023 | Jazyky: CZ, [EN](/docs/ANDROID.md) |

# Přístup k souborům v aplikaci Android

SimpleX používá databáze a ukládá své předvolby do soukromého datového adresáře v systému Android. Adresář obsahuje:
- Databáze
- odeslané a přijaté soubory
- dočasné soubory, které budou smazány, když nebudou potřeba
- uživatelské předvolby.


Pokud chcete zobrazit, co je uloženo v datovém adresáři SimpleX, musíte mít:
- Unixový operační systém (nebo [MinGW](https://www.mingw-w64.org/downloads/) na Windows).
- Nástroj ADB (Android Debug Bridge) nainstalovaný v počítači ([stáhněte si jej zde](https://developer.android.com/studio/releases/platform-tools) a nainstalujte).
- zařízení připojené přes USB nebo Wi-Fi k počítači.

## Postup:
- Otevřete SimpleX, přejděte na `Databáze passphrase & export`, povolte `Zálohování dat aplikace`. Tím se zprovozní další kroky
- _Volitelné_: pokud chcete zobrazit obsah databáze, změňte přístupovou frázi databáze z náhodné na svou. Chcete-li to provést, zastavte chat na obrazovce `Database passphrase & export`, otevřete `Database passphrase`, zadejte novou passphrase a potvrďte ji, poté ji aktualizujte. Nezapomeňte ji, jinak přijdete o všechna svá data v případě, že bude passphrase později znovu požadována.
- otevřete emulátor terminálu (Windows CMD/Powershell nebude fungovat) a změňte adresář na ten, který chcete použít pro uložení zálohy:

```bash
cd /tmp # jen příklad
```
Poté spusťte následující příkaz:
```bash
adb -d backup -f chat.ab -noapk chat.simplex.app &&
tail -n +5 chat.ab > chat.dat &&
printf "\x1f\x8b\x08\x00\x00\x00\x00\x00" | cat - chat.dat > chat.gz &&
tar -xvzf chat.gz
```

Nyní odemkněte zařízení a potvrďte operaci zálohování bez použití hesla pro šifrování, jinak příkazy nebudou fungovat.

Poté by mělo být zálohování ukončeno. Pokud se zobrazí chybové hlášení `tar: Error is not recoverable: exiting now`, ale předtím jste vypsali názvy některých souborů, nebojte se, je to v pořádku.

Nyní budou zálohované soubory uvnitř `./apps/chat.simplex.app/`.

Upozorňujeme, že pokud používáte moderní verzi SimpleX, budou databáze zašifrované a jejich obsah nebudete moci zobrazit bez použití aplikace `sqlcipher` a bez znalosti dešifrovací fráze (musíte ji nejprve změnit na svou z náhodně vygenerovaných v aplikaci).

Další informace o tom, jak dešifrovat databáze a provádět dotazy do nich, najdete v příručce [SQL.md](./SQL.md).
252 changes: 252 additions & 0 deletions docs/lang/cs/CLI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,252 @@
| Aktualizováno 26.02.2023 | Jazyky: CZ, [EN](/docs/CLI.md), [FR](/docs/lang/fr/CLI.md) |

# SimpleX Chat terminálová (konzolová) aplikace pro Linux/MacOS/Windows

## Obsah

- Funkce chatu v terminálu](#terminal-chat-features)
- Instalace](#🚀-installation)
- [Stáhnout klienta chatu](#download-chat-client)
- [Linux a MacOS](#linux-and-macos)
- [Windows](#windows)
- [Sestavit ze zdrojového kódu](#build-from-source)
- [Použití Dockeru](#using-docker)
- [Použití zásobníku Haskell](#using-haskell-stack)
- [Použití](#usage)
- [Spuštění klienta chatu](#running-the-chat-client)
- [Přístup k serverům pro zasílání zpráv přes Tor](#access-messaging-servers-via-tor-beta)
- [Jak používat chat SimpleX](#how-to-use-simplex-chat)
- [Skupiny](#groups)
- [Posílání souborů](#sending-files)
- [Kontaktní adresy uživatelů](#user-contact-addresses)
- [Přístup k historii chatu](#access-chat-history)

## Funkce chatu v terminálu

- Chat 1:1 s více lidmi v jednom okně terminálu.
- Skupinové zasílání zpráv.
- Posílání souborů kontaktům a skupinám.
- Kontaktní adresy uživatelů - navázání spojení prostřednictvím odkazů na více kontaktů.
- Zprávy uchovávané v místní databázi SQLite.
- Automaticky vyplňované jméno příjemce - po navázání spojení stačí napsat zprávu a odpovědět odesílateli.
- K dispozici ukázkové servery SMP, které jsou v aplikaci předkonfigurovány - nebo si můžete [nasadit vlastní server](https://github.com/simplex-chat/simplexmq#using-smp-server-and-smp-agent).
- Žádná globální identita ani žádná jména nejsou pro server(y) viditelná, což zajišťuje plné soukromí vašich kontaktů a konverzací.
- Dvě vrstvy šifrování E2E (double-ratchet pro duplexní spojení s použitím dohody klíčů X3DH s efemérními klíči Curve448 a NaCl crypto_box pro fronty SMP s použitím klíčů Curve25519) a předávání klíčů příjemců mimo pásmo (viz [Jak používat chat SimpleX](#how-to-use-simplex-chat)).
- Ověřování integrity zpráv (pomocí zahrnutí digestů předchozích zpráv).
- Ověřování každého příkazu/zprávy servery SMP pomocí automaticky generovaných klíčů Ed448.
- Transportní šifrování TLS 1.3.
- Dodatečné šifrování zpráv od serveru SMP k příjemci za účelem snížení korelace provozu.

Veřejné klíče zapojené do výměny klíčů se nepoužívají jako identita, jsou náhodně generovány pro každý kontakt.

Technické podrobnosti viz [Použité šifrovací primitivy](https://github.com/simplex-chat/simplexmq/blob/master/protocol/overview-tjr.md#encryption-primitives-used).

<a name="🚀-installation"></a>

## 🚀 Instalace

### Stáhněte si klienta chatu

#### Linux a MacOS

Chcete-li **nainstalovat** nebo **aktualizovat** `simplex-chat`, měli byste spustit instalační skript. K tomu použijte následující příkaz cURL nebo Wget:

```sh
curl -o- https://raw.githubusercontent.com/simplex-chat/simplex-chat/stable/install.sh | bash
```

```sh
wget -qO- https://raw.githubusercontent.com/simplex-chat/simplex-chat/stable/install.sh | bash
```

Jakmile se chatovací klient stáhne, můžete jej spustit pomocí příkazu `simplex-chat` v terminálu.

Případně můžete binární soubor chatu pro váš systém stáhnout ručně z [latest stable release](https://github.com/simplex-chat/simplex-chat/releases) a spustit jej podle následujícího návodu.

```sh
chmod +x <binary>
mv <binary> ~/.local/bin/simplex-chat
```

(nebo v jakémkoli jiném preferovaném umístění v `PATH`).

V systému MacOS musíte také [povolit spuštění nástroje Gatekeeper](https://support.apple.com/en-us/HT202491).

#### Windows

```sh
move <binary> %APPDATA%/local/bin/simplex-chat.exe
```

### Sestavení ze zdrojových kódů

> **Upozornění:** pro sestavení aplikace použijte zdrojový kód ze [stabilní větve](https://github.com/simplex-chat/simplex-chat/tree/stable).
#### Použití nástroje Docker

V systému Linux můžete spustitelný soubor chatu sestavit pomocí [docker build with custom output](https://docs.docker.com/engine/reference/commandline/build/#custom-build-outputs):

```shell
git clone [email protected]:simplex-chat/simplex-chat.git
cd simplex-chat
git checkout stable
DOCKER_BUILDKIT=1 docker build --output ~/.local/bin .
```

> **Upozornění:** Pokud narazíte na chybu `` verze `GLIBC_2.28' nenalezena ``, obnovte jej pomocí základního obrazu `haskell:8.10.7-stretch` (změňte jej ve svém lokálním [Dockerfile](Dockerfile)).
#### V libovolném operačním systému

1. Nainstalujte [Haskell GHCup](https://www.haskell.org/ghcup/), GHC 8.10.7 a cabal:

```shell
curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
```

2. Sestavte projekt:

```shell
git clone [email protected]:simplex-chat/simplex-chat.git
cd simplex-chat
git checkout stable
# v Linuxu
apt-get update && apt-get install -y build-essential libgmp3-dev zlib1g-dev
cp scripts/cabal.project.local.linux cabal.project.local
# nebo na MacOS:
# brew install [email protected]
# cp scripts/cabal.project.local.mac cabal.project.local
# možná budete muset změnit cabal.project.local tak, aby ukazoval na skutečné umístění openssl
cabal update
cabal install
```

## Použití

### Spuštění klienta chatu

Chcete-li spustit klienta chatu, spusťte z terminálu příkaz `simplex-chat`.

Ve výchozím nastavení je datový adresář aplikace vytvořen v domovském adresáři (`~/.simplex` nebo `%APPDATA%/simplex` ve Windows) a jsou v něm inicializovány dva databázové soubory SQLite `simplex_v1_chat.db` a `simplex_v1_agent.db`.

Chcete-li zadat jiný prefix cesty k souborům databáze, použijte volbu příkazového řádku `-d`:

```shell
$ simplex-chat -d alice
```

Spuštění výše uvedeného příkladu vytvoří databázové soubory `alice_v1_chat.db` a `alice_v1_agent.db` v aktuálním adresáři.

Na serveru Linode jsou umístěny tři výchozí servery SMP - jsou [předkonfigurovány v aplikaci](https://github.com/simplex-chat/simplex-chat/blob/stable/src/Simplex/Chat/Options.hs#L42).

Pokud jste nasadili vlastní SMP server(y), můžete klienta nakonfigurovat pomocí volby `-s`:

```shell
$ simplex-chat -s smp://[email protected]
```

Řetězec zakódovaný v Base64url před adresou serveru je offline otisk certifikátu serveru, který je ověřován klientem během TLS handshake.

S lidmi můžete stále hovořit pomocí výchozího nebo jakéhokoli jiného serveru - ovlivňuje to pouze umístění fronty zpráv při navazování spojení (a fronta odpovědí může být na jiném serveru, jak nastaví klient druhé strany).

Spusťte `simplex-chat -h` a zobrazte všechny dostupné možnosti.

### Přístup k serverům pro zasílání zpráv přes Tor

Nainstalujte Tor a spusťte jej jako proxy server SOCKS5 na portu 9050, např. na Macu můžete:

```
brew install tor
brew services start tor
```

Pro přístup k serverům přes Tor použijte volbu `-x`:

```
simplex-chat -x
```

Můžete také použít volbu `--socks-proxy=ipv4:port` nebo `--socks-proxy=:port` pro konfiguraci hostitele a portu vašeho SOCKS5 proxy serveru, např. pokud jej provozujete na jiném hostiteli nebo portu.

### Jak používat SimpleX chat

Po spuštění chatu budete vyzváni k zadání svého "zobrazovacího jména" a volitelného "celého jména" pro vytvoření místního profilu chatu. Vaše zobrazované jméno je přezdívka, pod kterou se na vás mohou obracet vaše kontakty - není jedinečné a neslouží jako globální identita. Pokud si některé vaše kontakty zvolily stejné zobrazovací jméno, přidá chatovací klient k jejich místnímu zobrazovacímu jménu číselnou příponu.

Následující schéma ukazuje, jak se připojit ke kontaktu a poslat mu zprávu:

<div align="center">
<img align="center" src="../images/how-to-use-simplex.svg">
</div>

Po nastavení místního profilu zadejte `/c` (pro `/connect`) pro vytvoření nového spojení a vygenerování pozvánky. Tuto pozvánku odešlete svému kontaktu prostřednictvím jakéhokoli jiného kanálu.

Můžete vytvořit více pozvánek zadáním `/connect` vícekrát a odesláním těchto pozvánek příslušným kontaktům, se kterými se chcete spojit.

Pozvánku lze použít pouze jednou, a i kdyby byla zachycena, útočník by ji nemohl použít k odeslání zpráv prostřednictvím této fronty, jakmile váš kontakt potvrdí, že spojení bylo navázáno. Vysvětlení [formátu pozvánky](https://github.com/simplex-chat/simplexmq/blob/master/protocol/agent-protocol.md#connection-request) naleznete v protokolu agenta.

Kontakt, který obdržel pozvánku, by měl zadat `/c <pozvánka>`, aby spojení přijal. Tím se spojení naváže a obě strany jsou o tom informovány.

Poté by měly použít příkazy `@<jméno> <zpráva>` k odesílání zpráv. Můžete také prostě začít psát zprávu a odeslat ji kontaktu, který byl poslední.

Seznam dostupných příkazů zobrazíte pomocí `/help` v chatu.

### Skupiny

Skupinu vytvoříte příkazem `/g <group>` a kontakty do ní přidáte příkazem `/a <group> <name>`. Do skupiny pak můžete posílat zprávy zadáním `#<skupina> <zpráva>`. Pro další příkazy použijte `/help groups`.

![simplex-chat](../images/groups.gif)

> **Upozornění**: skupiny nejsou uloženy na žádném serveru, jsou vedeny jako seznam členů v databázi aplikace, kterým budou zprávy zasílány.
### Odesílání souborů

Soubor můžete odeslat kontaktu pomocí `/f @<contact> <soubor_cesta>` - příjemce jej bude muset před odesláním přijmout. Pro další příkazy použijte `/help files`.

![simplex-chat](../images/files.gif)

Soubory můžete posílat skupině pomocí `/f #<skupina> <soubor_cesta>`.

### Kontaktní adresy uživatelů

Jako alternativu k jednorázovým pozvánkovým odkazům můžete vytvořit dlouhodobou adresu pomocí `/ad` (pro `/adresa`). Vytvořenou adresu pak můžete sdílet libovolným kanálem a používat ji ostatními uživateli jako odkaz na žádost o kontakt pomocí `/c <uživatelská_kontaktní_adresa>`.

Příchozí žádosti můžete přijmout nebo odmítnout pomocí příkazů `/ac <jméno>` a `/rc <jméno>`.

Uživatelská adresa je "dlouhodobá" v tom smyslu, že se jedná o odkaz pro vícenásobné použití - lze ji používat, dokud ji uživatel nesmaže, v takovém případě by všechna navázaná spojení zůstala stále aktivní (na rozdíl od toho, jak to funguje u e-mailu, kdy změna adresy vede k tomu, že vám lidé nemohou posílat zprávy).

Pro ostatní příkazy použijte `/help address`.

![simplex-chat](../images/user-addresses.gif)

### Přístup k historii chatu

SimpleX chat ukládá všechny vaše kontakty a konverzace do místní databáze SQLite, takže jsou soukromé a přenosné, vlastněné a kontrolované uživatelem.

Historii chatu můžete zobrazit a prohledávat dotazem do databáze. Spusťte níže uvedený skript pro vytvoření zobrazení zpráv ve vaší databázi.

```sh
curl -o- https://raw.githubusercontent.com/simplex-chat/simplex-chat/stable/scripts/message_views.sql | sqlite3 ~/.simplex/simplex_v1_chat.db
```

Otevřete SQLite Command Line Shell:

```sh
sqlite3 ~/.simplex/simplex_v1_chat.db
```

Příklady viz [Message queries](./SQL.md).

> **Upozornění:** Omezení cizích klíčů SQLite jsou ve výchozím nastavení vypnuta a musí být **[povolena pro každé připojení k databázi zvlášť](https://sqlite.org/foreignkeys.html#fk_enable)**. Toho lze dosáhnout spuštěním příkazu `PRAGMA foreign_keys = ON;` na otevřeném databázovém připojení. Spouštěním dotazů měnících data bez předchozího povolení cizích klíčů můžete riskovat, že se databáze dostane do nekonzistentního stavu.
**Pohodlné dotazy**

Získat všechny zprávy z dnešního dne (`chat_dt` je v UTC):

```sql
select * from all_messages_plain where date(chat_dt) > date('now', '-1 day') order by chat_dt;
```

Získejte ranní noční zprávy:

```sql
select * from all_messages_plain where chat_dt > datetime('now', '-15 hours') order by chat_dt;
```
21 changes: 21 additions & 0 deletions docs/lang/cs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
| Aktualizováno 26.02.2023 | Jazyky: CZ, [EN](/docs/CONTRIBUTING.md), [FR](/docs/lang/fr/CONTRIBUTING.md) |

# Průvodce přispíváním

## Kompilace s povoleným šifrováním SQLCipher

Do kořenového adresáře projektu přidejte `cabal.project.local` s umístěním hlaviček a knihoven OpenSSL a příznakem nastavujícím režim šifrování:

```
cp scripts/cabal.project.local.mac cabal.project.local
# nebo
# cp scripts/cabal.project.local.linux cabal.project.local
```

## OpenSSL na MacOS

Systém MacOS je standardně dodáván s LibreSSL, pro kompilaci SimpleX ze zdrojových kódů je nutné nainstalovat OpenSSL.

OpenSSL lze nainstalovat pomocí `brew install [email protected]`.

Aby vše fungovalo správně, musíte do své cesty PATH přidat `/opt/homebrew/opt/[email protected]/bin`.
Loading

0 comments on commit 7f92392

Please sign in to comment.