forked from Disroot/Howto
104 lines
4.6 KiB
Markdown
104 lines
4.6 KiB
Markdown
|
<p align="center">
|
||
|
|
||
|
![](h2.png)
|
||
|
|
||
|
</p>
|
||
|
|
||
|
<h1 align="center">Disroot's Jak na to a překlady</h1>
|
||
|
|
||
|
<h2 align="center">· Zapojte se a přispějte ·</h2>
|
||
|
|
||
|
|
||
|
<br>
|
||
|
|
||
|
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ů.
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
# 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<br>
|
||
|
Systém pro kontrolu verzí pro sledování změn v howto a překladech tak jak jsou psány.<br>
|
||
|
· [**Co je git?**](https://cs.wikipedia.org/wiki/Git) <br> · [**Stažení a návod k instalaci**](https://git-scm.com/downloads) (anglicky)
|
||
|
|
||
|
- ## text editor with markdown format files support<br>
|
||
|
_Doporučené programy:_<br>
|
||
|
· **VSCodium**, Komunitou řízená, volně licencovaná binární distribuce editoru VS Code společnosti Microsoft. [[**Stažení a návod k instalaci**](https://vscodium.com/)]<br> (anglicky)
|
||
|
· **Neovim**, hyperextenzivní textový editor založený na Vimu. [[**Stažení a návod k instalaci**](https://github.com/neovim/neovim/wiki/Installing-Neovim)]<br> (anglicky)
|
||
|
· **Kate Editor**, funkcemi nabitý textový editor. [[**Stažení a návod k instalaci**](https://kate-editor.org/cs/get-it/)]
|
||
|
|
||
|
<br>
|
||
|
|
||
|
## 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**](https://git.disroot.org/user/sign_up).
|
||
|
|
||
|
<br>
|
||
|
|
||
|
## 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.
|
||
|
|
||
|
<br>
|
||
|
|
||
|
## 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<br>
|
||
|
`git init`<br>
|
||
|
|
||
|
- Doplňte vlatní údaje do následujících příkazů a vložte do terminálu:<br>
|
||
|
`git config --global user.email "uživatel@email"`<br>
|
||
|
`git config --global user.name "Uživatelskéjméno"`
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
# 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.
|
||
|
|
||
|
<br>
|
||
|
|
||
|
## 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.
|
||
|
|
||
|
<br>
|
||
|
|
||
|
## 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:
|
||
|
|
||
|
- [Jak přispívat k návodům **Disroot**](https://howto.disroot.org/cs/contribute)<br>
|
||
|
|
||
|
- [Jak postupovat při tvorbě návodů a překladů](https://howto.disroot.org/cs/contribute/procedure)
|
||
|
|
||
|
<br>
|
||
|
|
||
|
# 3. Licence
|
||
|
Dokumentace **Disroot's Howto** je licencována pod [Creative Commons Attribution-ShareAlike 4.0 mezinárodní licence](https://creativecommons.org/licenses/by-sa/4.0/deed.cs)
|