Howto/README_CS.md

4.6 KiB

Disroot's Jak na to a překlady

· Zapojte se a přispějte ·


Tento repozitář obsahuje soubory projektu Disroot's Howto a informace k vytváření, úpravám a překladům těchto souborů.

Cílem Disroot's Howto Project je především vytváření, údržba a zpřístupňování uživatelských příruček, návodů a konfigurací různých služeb a softwaru, které platforma Disroot poskytuje. Také poskytnout nástroje, návody a postupy pro každého, kdo chce přispět vytvořením, úpravou a překladem těchto návodů.


1. Předpoklady

  • a. Požadovaný software
  • b. Účet Gitea
  • c. Požádejte o přístup k našemu úložišti
  • d. Nastavte své uživatelské jméno a e-mail.

Pro získání kopie projektu na svém lokálním počítači a zahájení práce je třeba postupovat podle následujících pokynů.

a. Požadovaný software:

Nejprve musíte mít nainstalovaný následující software.

  • git

Systém pro kontrolu verzí pro sledování změn v howto a překladech tak jak jsou psány.
· Co je git?
· Stažení a návod k instalaci (anglicky)

  • text editor with markdown format files support

Doporučené programy:
· VSCodium, Komunitou řízená, volně licencovaná binární distribuce editoru VS Code společnosti Microsoft. [Stažení a návod k instalaci]
(anglicky) · Neovim, hyperextenzivní textový editor založený na Vimu. [Stažení a návod k instalaci]
(anglicky) · Kate Editor, funkcemi nabitý textový editor. [Stažení a návod k instalaci]


b. A účet Gitea

To abyste mohli odesílat změny, které provedete v howtos, ať už je překládáte, upravujete, nebo píšete, potřebujete mít účet v instanci Gitea.

Pro registraci účtu v instanci, kde je náš repozitář, přejděte sem.


c. Požádejte o přístup do našeho úložiště

Chcete-li mít možnost odevzdávat změny do úložiště git Disroot, musíte požádat o přístup. To provedete prostřednictvím naší stránky projektu git.


d. Nastavte své uživatelské jméno a e-mailovou adresu

To je nezbytné, abyste mohli odesílat svou práci ze svého počítače do vzdáleného úložiště. Nastavte uživatelské jméno a e-mail pro git

  • otevřete terminál a spusťte git
    git init

  • Doplňte vlatní údaje do následujících příkazů a vložte do terminálu:
    git config --global user.email "uživatel@email"
    git config --global user.name "Uživatelskéjméno"


2. Vytvoření / překlad návodu k použití

Proces vytváření nebo překládání howto není složitý a vyžaduje jen trochu cviku, abyste se ho naučili.

Postup je poměrně jednoduchý:

  1. Získejte kopii souborů, na kterých budete pracovat;
  2. pracujete na souborech lokálně ve svém počítači,
  3. po dokončení je odešlete.

První věcí, kterou je třeba udělat, je klonování úložiště, to znamená vytvoření místní kopie vzdálených souborů. Všechna práce bude probíhat na této kopii.


a. Klonování úložiště

Repozitář git je složka projektu obsahující soubory, které byly nebo mají být přeloženy, a podrobnou historii sledování těchto změn.

Pro klonování repozitáře otevřete terminál v adresáři, do kterého chcete repozitář naklonovat. Poté použijete příkaz git clone, což je instrukce pro klonování úložiště zadáním jeho adresy. V našem případě to bude:

git clone https://git.disroot.org/Disroot/howto

Jakmile bude úložiště zkopírováno na váš pevný disk, zobrazí se adresář howto obsahující všechny soubory projektu. Později jej můžete přesunout na libovolné místo ve svém počítači.


b. Vytvoření / překlad návodu

Jakmile jste zkopírovali úložiště na svůj počítač, můžete začít vytvářet, upravovat a/nebo překládat podle kroků popsaných v těchto návodech:


3. Licence

Dokumentace Disroot's Howto je licencována pod Creative Commons Attribution-ShareAlike 4.0 mezinárodní licence