README-cs.md

Saber

           

English | čeština | Deutsch | 中文 (简体中文, 中国) | 中文 (繁體, 台灣)

Saber je aplikace pro psaní poznámek uzpůsobená pro ruční psaní.

Je navržena pro nejjednodušší a nejintuitivnější možné používání, přičemž stále nabízí unikátní funkce, které opravdu využijete. Navíc je Saber dostupný napříč všemi vašimi zařízeními, velkými i malými, mezi nimiž se bez povšimnutí synchronizuje.

Je na místě poznamenat, že umí invertovat vaše poznámky, pokud jste v temném módu. To vám umožňuje psát bílým inkoustem na černém pozadí, což je daleko příjemnější pro oči v prostředí s nedostatkem světla, jako když učitel ve třídě vypne osvětlení. Obrázky a PDF jsou také invertovány, takže stále můžete bez problému používat digitální výtisky nebo učebnice.

Saber používá systém dvou hesel, aby ochránil vaše poznámky před kýmkoliv kromě vás, i kdyby měl kompletní přístup k serveru. Můžete bezpečně ukládat své poznámky na oficiální server aplikace Saber, jiný server či dokonce pro tyto účely provozovat svůj vlastní server!

Aplikace má kompletně otevřené zdrojové kódy, takže si je každý může prohlédnout a přesně vidět, co aplikace dělá a jakým způsobem jsou zpracovává vaše data. Spousta dalších aplikací pro pořizování poznámek má uzavřené zdrojové kódy a je proprietární, což znamená, že co se děje uvnitř, je pro veřejnost záhadou.

Jako někdo, kdo studuje matematiku, mohu říct, že pro mě vždy bylo utrpení zvýrazňovat víceřádkové rovnice v jiných aplikacích, kde zvýrazňovač mění barvu po přetažení již zvýrazněné části. Další problém, který jsem měl v některých aplikacích, spočíval v tom, že se zvýrazňovač vykresloval nad textem, takže se text ztrácel a špatně se četl. Zvýrazňovač aplikace Saber těmito neduhy netrpí. Využívá kompozice plátna k vykreslování zvýrazňovače způsobem, který je konzistentní s tradičním papírem, ba možná i lepší, jelikož řeší překrývání a udržuje konzistenci barev.

Saber má vše, co potřebujete k tomu, abyste dokázali organizovat své poznámky. Tvořte složky uvnitř složek uvnitř složek, jak jen chcete bez omezení na počet zanořených složek. Ačkoliv může být poznámka pohřbena hluboko uvnitř vnořené složky, pořád k ní můžete jednoduše přistoupit, jelikož jsou nejnovější poznámky vždy k dispozici na domovské obrazovce.

Objevte zcela nový způsob zaznamenávání a organizace vašich myšlenek s aplikací Saber. Ať již jste student, profesionál nebo kreativní duše, Saber je vaším důvěryhodným společníkem pro digitální psaní. Stáhněte si jej nyní a nechte volně plynout své nápady!

Klepněte pro zobrazení/skrytí snímků obrazovky

Features

Podívejte se na #1 plán vývoje aplikace Saber (anglicky).

Instalace

Klepněte pro zobrazení/skrytí instalačních instrukcí

Android

Možnosti:

1. Stažení z Play Store

2. Stažení z F-Droidu

   • Je třeba poznamenat, že sestavení dostupné na F-Droidu není optimalizované pro zařízení Onyx Boox, které vyžaduje proprietární závislosti od společnosti Onyx.

3. Stažení a instalace Saber_{verze}.apk z nejnovějšího vydání.

Linux

Možnost 1 (doporučená): Instalace pomocí flatpaku z Flathubu: flatpak --user install com.adilhanney.saber.

Možnost 2: Stažení Saber-{verze}-x86_64.AppImage z nejnovějšího vydání, nastavení práv pro spuštění chmod +x Saber-*-x86_64.AppImage a spuštění.

Možnost 3: Díky @soumyaDghosh je k dispozici neoficiální snap: sudo snap install saber.

Windows

Stažení a instalace SaberInstaller_{verze}.exe z nejnovějšího vydání.

Pokud dostáváte chybu ohledně chybějících ddl, ujistěte se, že máte instalované Visual C++ Redistributable.

iOS and macOS

Stažení aplikace Saber na App Store.

Sestavení ze zdrojového kódu

Klepněte pro zobrazení/skrytí instrukcí pro sestavení

1. Nainstalujte flutter

https://docs.flutter.dev/get-started/install

2. Naklonujte si tento projekt

git clone https://github.com/saber-notes/saber.git

3. Natáhněte si závislosti

flutter pub get

4. Nainstalujte dodatečné závislosti

Postup pro balíček super_clipboard se dá shrnout jako:

• Nainstalujte Rustu
• Nainstalujte NDK 26.1.10909125 v případě, že sestavujete pro Android

5. Sestavení pro…

Linux

sudo apt install libsecret-1-dev libjsoncpp-dev flutter build linux

Toto je dostatečné pro použití na vlastním počítači, ale pokud chcete své sestavení distribuovat, budete potřebovat použít předvídatelné prostředí: udělejte fork tohoto repozitáře a použijte místo toho GitHub Action Build for Linux.

Android

flutter build apk

Budete potřebovat vygenerovat a podepsat certifikát a vytvořit soubor android/key.properties. Více informací na https://docs.flutter.dev/deployment/android#create-an-upload-keystore

Poznámka: vydání pro F-Droid jsou sestavena výrazně odlišně

./patches/remove_proprietary_dependencies.sh
flutter build apk --dart-define=OFFLINE_FONTS_ONLY="true"

Windows

flutter build windows

Instalátor pro Windows je vytvořen pomocí Inno Setup. Pro vytvoření vlastního instalátoru spusťte výše uvedený příkaz a následně upravte a spusťte installers/desktop_inno_script.iss pomocí Inno Setup Compiler.

iOS and macOS

Pokud máte počítač s macOS, můžete sestavovat pro iOS pomocí flutter build ipa nebo sestavovat pro macOS pomocí flutter build macos.

Pokud nikoliv, udělejte fork tohoto repozitáře a použijte GitHub Action Build for macOS and iOS. Alternativně následujte anglický YouTube tutoriál How to compile a flutter application to iPhone with no mac (free | no jailbreak) pro manuální sestavení s využitím Codemagic.

Odkazy

• Nextcloud server
• Zásady ochrany osobních údajů (anglicky)
• Licence
• Vydání

Překlady

Veškeré překlady jsou založené na crowdsourcingu. Saber byl zatím přeložen do:

• angličtiny (en)
• arabštiny (ar)
• češtiny (cs)
• němčiny (de)
• španělštiny (es)
• perštiny (fa)
• francouzštiny (fr)
• hebrejštiny (he)
• maďarštiny (hu)
• italštiny (it)
• japonštiny (ja)
• portugalské brazilštiny (pt_BR)
• ruštiny (ru)
• turečtiny (tr)
• zjednodušené čínštiny (zh_Hans_CN)
• tradiční čínštiny (zh_Hant_TW)

Experimentuji s využitím Weblate pro crowdsourcované překlady. Více informací se dozvíte později.

Rozšiřování existujících překladů

Podívejte se do _missing_translations.yaml, zda nechybí nějaké překlady.

1. Pro úpravu _missing_translations.yaml použijte tento odkaz.
2. Aktualizujte soubor _missing_translations.yaml pomocí svého překladu, např. aktualizací němčiny (de)

   de:
     editor:
       newerFileFormat:
         title: Diese Notiz wurde mit einer neueren Version von Saber bearbeitet
         subtitle: Wenn du diese Notiz bearbeitest, können Daten verloren gehen. Möchtest du die Notiz trotzdem öffnen?
         openAnyway: Trotzdem öffnen
         cancel: Abbruch
   # ignorujte ostatní jazyky...

3. Vytvořte žádost o začlenění (pull request)! O zbytek se postarám

Přidání nového jazyka

1. Najděte zde svůj kód jazyka, např. hi pro hindštinu, fr pro francouzštinu, bn for bengálštinu, ar pro arabštinu atd.
2. Použijte tento odkaz pro vytvoření nového souboru v lib/i18n/community/ nazvaného strings_XX.i18n.yaml, kde XX je kód vašeho jazyka.
3. Zkopírujte obsah existujícího souboru jako (v ideálním případě anglického) lib/i18n/strings.i18n.yaml a nahraďte překlady těmi svými. Pokud neznáte překlad pro nějaký text, prostě daný řádek odstraňte.
4. Vytvořte žádost o začlenění (pull request)!

Pro více informací se taktéž podívejte na stránku Jak začít s knihovnou slang (anglicky).

Překlady popisů v obchodech s aplikacemi

Jsou 2 formáty popisů do obchodů s aplikacemi:

1. F-Droid/Play Store:

   i. Otevřete metadata/en-US/ a zkopírujte soubory full_description.txt a short_description.txt do složky metadata/XX/, kde XX je kód vašeho jazyka. Následně přeložte obsahy těchto souborů.

   ii. Záznamy o změnách jsou automaticky překládané z anglické verze. Pokud narazíte na chybu, opravte prosím záznam o změnách v metadata/XX/changelogs/<kód-verze>.txt, kde XX je kód vašeho jazyka.

2. Linuxový soubor .desktop:

   i. Otevřete flatpak/com.adilhanney.saber.desktop a přidejte řádek pro klíč Comment v následujícím formátu, kde XX je kód vašeho jazyka:

   Comment[XX]=Váš překlad

   Pokud zároveň chcete přeložit klíč Name, udělejte pro něho totéž.

3. Flathub (nepovinné):

   i. Jelikož je to výrazně techničtější, jestli chcete, můžete část s Flathubem přeskočit a já tam zkopíruji překlady ze sekcí uvedených výše.

   ii. V flatpak/com.adilhanney.saber.metainfo.xml přidejte před uzavírací značku </description> svůj překlad v následujícím formátu, kde XX je kód vašeho jazyka:

   <p xml:lang="XX">Váš překlad</p>

   iii. Ve stejném souboru můžete přeložit záznamy o změnách obdobnou změnou ve značkách <release> před jejich uzavírací značkou </description>.

Podpora aplikace Saber

Pokud máte rádi Saber, zvažte prosím jeho podporu pomocí

• Poděkování!
• Hvězdičky pro projekt na GitHubu
• Sponzorství prostřednictvím GitHub Sponsors
• Zaslání daru na PayPal
• Zakoupení více místa na oficiálním Nextcloud serveru: podívejte se na Ceník

Poznámky pro vývojáře

Zobrazit/skrýt poznámky pro vývojáře

• Když aktualizujete verzi aplikace:
  • Spusťte ./scripts/apply_version.sh <název-verze> <kód-verze> (Pro více informací spusťte ./scripts/apply_version.sh --help)
  • Aktualizujte záznamy o změnách v metadata/en-US/changelogs/ a flatpak/com.adilhanney.saber.metainfo.xml, a spusťte dart scripts/translate_changelogs.dart, jak je udáno skriptem.
• Pokud aktualizujete ikony, spusťte tyto příkazy:
  • Obecné: dart run icons_launcher:create
  • Flatpak ikony: cd assets/icon && ./resize-icon.sh
• Když aktualizujte překlady…
  • Spusťte tyto příkazy:
    • dart run slang apply --locale=XX pro případ, že potřebujete aplikovat _missing_translations.yaml
    • dart run slang
    • dart run slang analyze --full
  • Pokud přidáváte nový jazyk, aktualizujte:
    • CFBundleLocalizations v ios/Runner/Info.plist
    • CFBundleLocalizations v macos/Runner/Info.plist
    • android/app/src/main/res/xml/locales_config.xml
    • lib/data/locales.dart
    • README.md (a jeho lokalizované varianty) výše v sekci "Překlady".
    • a pro překlad záznamu změn spusťte dart scripts/translate_changelogs.dart.