Merge pull request #2024 from TerkaSlan/master

[Git/sk]Translation for Git to Slovak
This commit is contained in:
Spurlow 2015-11-27 11:42:35 +07:00
commit 4a465720e0
4 changed files with 1167 additions and 0 deletions

208
sk-sk/LearnGit-sk.txt Normal file
View File

@ -0,0 +1,208 @@
$ git init
# Zobraz a Nastav Základné Konfiguračné Premenné (Globálne)
$ git config --global user.email "MôjEmail@Zoho.com"
$ git config --global user.name "Moje Meno
# Rýchlo zobraz všetky dostupné príkazy
$ git help
# Zobraz všetky dostupné príkazy
$ git help -a
# Zobraz konkrétnu pomoc - použivateľský manuál
# git help <príkaz_tu>
$ git help add
$ git help commit
$ git help init
# alebo git <príkaz_tu> --help
$ git add --help
$ git commit --help
$ git init --help
# Zobrazí vetvu, nesledované súbory, zmeny a ostatné rozdiely
$ git status
# Zistí iné vychytávky o git statuse
$ git help status
# pridá súbor z tvojho pracovného adresára
$ git add HelloWorld.java
# pridá súbor z iného adresára
$ git add /cesta/k/súboru/HelloWorld.c
# Môžeš použiť regulárne výrazy!
$ git add ./*.java
# zobraz existujúce vetvy a vzdialené repozitáre
$ git branch -a
# vytvor novú vetvu
$ git branch myNewBranch
# vymaž vetvu
$ git branch -d myBranch
# premenuj vetvu
# git branch -m <starémeno> <novémeno>
$ git branch -m mojaStaraVetva mojaNovaVetva
# zmeň opis vetvy
$ git branch myBranchName --edit-description
# Zobrazí tagy
$ git tag
# Vytvorí tag so správou
# -m špecifikuje správu, ktorá bude s tagom uložená.
# Ak nešpeficikuješ správu pri tagu so správou,
# Git spustí tvoj editor, aby si ju napísal.
$ git tag -a v2.0 -m 'moja verzia 2.0'
# Ukáž informácie o tagu
# Zobrazí zadané informácie, dátum tagnutia commitu
# a správu pred zobrazením informácií o commite.
$ git show v2.0
# Zverejní (pushne) jediný tag do vzdialeného repozitára
$ git push origin v2.0
# Zverejní viacero tagov do vzdialeného repozitára
$ git push origin --tags
# Aktualizuj strom, aby odpovedal (predvolene)
# hlavnej vetve repozitáru (master branch)
$ git checkout
# Aktualizuj strom, aby odpovedal konrkétnej vetve
$ git checkout menoVetvy
# Vytvor novú vetvu & prepni sa na ňu
# ekvivalentný príkaz: "git branch <meno>; git checkout <meno>"
$ git checkout -b nováVetva
# Naklonuj learnxinyminutes-docs
$ git clone https://github.com/adambard/learnxinyminutes-docs.git
# povrchné klonovanie - rýchlejšie, uloží iba najnovšiu snímku
$ git clone --depth 1 https://github.com/adambard/learnxinyminutes-docs.git
# naklonuj iba konkrétnu vetvu
$ git clone -b master-cn https://github.com/adambard/learnxinyminutes-docs.git --single-branch
# commitni so správou
$ git commit -m "Pridal som multiplyNumbers() funkciu do HelloWorld.c"
# automaticky pridaj zmenené a vymazané súbory do staging indexu, potom ich commitni.
$ git commit -a -m "Zmenil som foo.php a vymazal bar.php"
# zmeň posledný commit (toto nahradí predchádzajúci commit novým)
$ git commit --amend -m "Správna správa"
# Ukáž rozdiel medzi pracovným repozitárom a indexom.
$ git diff
# Ukáž rozdiely medzi indexom a najnovším commitom.
$ git diff --cached
# Ukáž rozdiely medzi pracovným adresárom a najnovším commitom.
$ git diff HEAD
# Nastav, aby sa vo výsledkoch vyhľadávania zobrazovalo číslo riadku
$ git config --global grep.lineNumber true
# Urob výsledky vyhľadávania čitateľnejšie, vrátane zoskupovania
$ git config --global alias.g "grep --break --heading --line-number"
# Vďaka Travisovi Jefferymu za túto sekciu
# Hľadaj "názovPremennej" vo všetkých java súboroch
$ git grep 'názovPremennej' -- '*.java'
# Hľadaj riadok, ktorý obsahuje "názovPoľa" a "add" alebo "remove"
$ git grep -e 'arrayListName' --and \( -e add -e remove \)
# Zobraz všetky commity
$ git log
# Zobraz iba správy a referencie commitov
$ git log --oneline
# Zobraz zlúčené (merged) commity
$ git log --merges
# Zobraz všetky commity vo forme ASCII grafu
$ git log --graph
# Zlúč vybranú vetvu do aktuálnej.
$ git merge názovVetvy
# Vždy vytvor zlučovací commit
$ git merge --no-ff názovVetvy
# Premenuj súbor
$ git mv HelloWorld.c HelloNewWorld.c
# Presuň súbor
$ git mv HelloWorld.c ./nová/cesta/HelloWorld.c
# "Nasilu" premenuj, alebo presuň
# "existujúciSúbor" už v adresári existuje, bude prepísaný
$ git mv -f môjSúbor existujúciSúbor
# Aktualizuje tvoj lokálny repozitár zlúčením nových zmien
# zo vzdialených "origin" a "master" vetiev.
# git pull <alias-vzdialeného-repo> <vetva>
$ git pull origin master
# Predvolene, git pull aktualizuje tvoju aktuálnu vetvu
# zlúčením nových zmien zo vzdialenej vetvy
$ git pull
# Zlúč zmeny zo vzdialenej vetvy a presuň vetvu do nového základného commitu (rebase)
# vetva commitne na tvoj lokálny repozitár, ekvivalentný príkaz: "git pull <alias-vzdialeného-repo> <vrstva>, git rebase <branch>"
$ git pull origin master --rebase
# Zverejni a zlúč zmeny z lokálneho repozitára do
# vzdialených vetiev s názvom "origin" a "master".
# git push <vzdialené> <vetvy>
$ git push origin master
# Predvolene git zverejní a zlúči zmeny z
# aktuálnej vetvy do vzdialenej vetvy s ňou spojenej
$ git push
# Na spojenie lokálnej vetvy so vzdialenou pridaj -u:
$ git push -u origin master
# Kedykoľvek budeš chcieť zverejniť z rovnakej lokálnej vetvy, použi príkaz:
$ git push
# Aplikuj commity z experimentálnej vetvy na master
# git rebase <základnáVetva> <ináVetva>
$ git rebase master experimentBranch
# Resetni index (vrstvu medzi pracovným stromom a Git repozitárom), aby odpovedal najnovšiemu commitu (adresár ostane nezmenený)
$ git reset
# Resetni index, aby odpovedal najnovšiemu commitu (adresár sa prepíše)
$ git reset --hard
# Presunie vrchol aktuálnuej vetvy do konkrétneho commitu (adresár ostane nezmenený)
# všetky zmeny sú zachované v adresári.
$ git reset 31f2bb1
# Vezmi späť konkrétny commit
$ git revert <commit>
# odstráň HelloWorld.c
$ git rm HelloWorld.c
# Odstráň súbor z vnoreného adresára
$ git rm /pather/to/the/file/HelloWorld.c

523
sk-sk/git.html.markdown Normal file
View File

@ -0,0 +1,523 @@
---
category: tool
tool: git
contributors:
- ["Jake Prather", "http://github.com/JakeHP"]
- ["Leo Rudberg" , "http://github.com/LOZORD"]
- ["Betsy Lorton" , "http://github.com/schbetsy"]
- ["Bruno Volcov", "http://github.com/volcov"]
- ["Andrew Taylor", "http://github.com/andrewjt71"]
translators:
- ["Terka Slanináková", "http://github.com/TerkaSlan"]
lang: sk-sk
filename: LearnGit-sk.txt
---
Git je distribuovaný systém riadenia revízií a správy zdrojového kódu.
Funguje robením "snímkov" tvojho projektu, s ktorými ďalej pracuje na revíziach a správe zdrojových kódov.
## Koncept Revízií
### Čo je riadenie revízií?
Riadenie revízií je systém, ktorý postupom času zaznamenáva zmeny súboru (súborov).
### Centralizované Revízie VS Distribuované revízie
* Centralizované riadenie revízií sa zameriava na synchronizáciu, sledovanie a zálohovanie súborov.
* Distribuované riadenie revízií sa zameriava na zdieľanie zmien. Kaťdá zmena má jedinečný identifikátor (id).
* Distribuované systémy nemajú definovanú štruktúru. S gitom môžeš mať centralizovaný systém v subversion (SVN) štýle.
[Ďalšie informácie](http://git-scm.com/book/en/Getting-Started-About-Version-Control)
### Prečo Používať Git?
* Môžeš pracovať offline.
* Spolupráca s ostatnými je jednoduchá!
* Vetvenie je jednoduché!
* Zlučovanie je jednoduché!
* Git je rýchly.
* Git je flexibilný.
## Architektúra Gitu
### Repozitár
Skupina súborov, adresárov, minulých záznamov, commitov (konkrétnych revízií) a odkazy na aktuálu vetvu (HEADs). Predstav si ho ako údajovú štruktúru, kde ti každý "prvok" zdrojového kódu poskytne (okrem iného) prístup k minulým revíziam.
Git repozitár sa skladá z .git adresára a pracovného stromu
### .git Adresár (časť repozitára)
.git adresár obsahuje všetky konfigurácie, logy, vetvy, odkaz na aktuálnu vetvu (HEAD) a ostatné.
[Detailný zoznam.](http://gitready.com/advanced/2009/03/23/whats-inside-your-git-directory.html)
### Pracovný Strom (Working Tree - časť repozitára)
Toto sú adresáre a súbory v tvojom repozitári. Tiež sa tomu hovorí pracovný adresár.
### Index (časť .git adresára)
Index je také odpočívadlo Gitu. Je to v podstate vrstva, ktorá oddeľuje pracovný strom od Git repozitára. Toto dáva vývojárom viac možností nad tým, čo do repozitára naozaj pošlú.
### Commit
Commit je "snímka" zmien, či manipulácií s tvojím Pracovným Stromom. Ak si napríklad pridal 5 súborov a odstránil 2 ďalšie, tieto zmeny budú zachytené v commite. Ten môže (ale nemusí) byť zverejnený (pushed) do iných repozitárov.
### Vetva (Branch)
Vetva je ukazateľ na posledný vykonaný commit. Po ďalších commitnutiach sa ukazateľ bude automaticky posúvať na ten najnovší.
### Tag
Tag je označenie špecifického bodu v minulosti. Typicky sa používa na značenie vydaných verzií (v1.0, atď).
### HEAD a head (časť .git adresára)
HEAD je ukazateľ na aktuálnu vetvu. Repozitár má len 1 *aktívny* HEAD.
head je ukazateľ, ktorý môže ukazovať na akýkoľvek commit. Repozitár môže mať niekoľko headov.
### Štádia Gitu
* Modified - Súbor bol zmenený, no nebol ešte commitnutý do Git Databázy.
* Staged - Zmenený súbor, ktorý pôjde do najbližšieho commit snímku.
* Committed - Súbory boli commitnuté do Git Databázy.
### Koncepčné zdroje
* [Git Pre Informatikov](http://eagain.net/articles/git-for-computer-scientists/)
* [Git Pre Designerov](http://hoth.entp.com/output/git_for_designers.html)
## Príkazy
### init
Vytvorí prázdny Git repozitár. Jeho nastavenia, uložené informácie a mnoho iného sú uložené v adresári (zložke) s názvom ".git".
```bash
$ git init
```
### config
Konfiguruj nastavenia. Či už pre repozitár, samotný systém, alebo globálne konfigurácie (súbor pre globálny config je `~/.gitconfig`).
```bash
# Zobraz a Nastav Základné Konfiguračné Premenné (Globálne)
$ git config --global user.email "MôjEmail@Zoho.com"
$ git config --global user.name "Moje Meno "
```
[Prečítaj si viac o git configu.](http://git-scm.com/docs/git-config)
### pomoc
Máš tiež prístup k extrémne detailnej dokumentácií pre každý príkaz (po anglicky). Hodí sa, ak potrebuješ pripomenúť semantiku.
```bash
# Rýchlo zobraz všetky dostupné príkazy
$ git help
# Zobraz všetky dostupné príkazy
$ git help -a
# Zobraz konkrétnu pomoc - použivateľský manuál
# git help <príkaz_tu>
$ git help add
$ git help commit
$ git help init
# alebo git <príkaz_tu> --help
$ git add --help
$ git commit --help
$ git init --help
```
### ignoruj súbory
Zámerne prestaneš sledovať súbor(y) a zložky. Typicky sa používa pre súkromné a dočasné súbory, ktoré by boli inak zdieľané v repozitári.
```bash
$ echo "temp/" >> .gitignore
$ echo "private_key" >> .gitignore
```
### status
Na zobrazenie rozdielov medzi indexovými súbormi (tvoj pracovný repozitár) a aktuálnym HEAD commitom.
```bash
# Zobrazí vetvu, nesledované súbory, zmeny a ostatné rozdiely
$ git status
# Zistí iné vychytávky o git statuse
$ git help status
```
### add
Pripraví súbory na commit pridaním do tzv. staging indexu. Ak ich nepridáš pomocou `git add` do staging indexu, nebudú zahrnuté v commitoch!
```bash
# pridá súbor z tvojho pracovného adresára
$ git add HelloWorld.java
# pridá súbor z iného adresára
$ git add /cesta/k/súboru/HelloWorld.c
# Môžeš použiť regulárne výrazy!
$ git add ./*.java
```
Tento príkaz len pridáva súbory do staging indexu, necommituje ich do repozitára.
### branch
Spravuj svoje vetvy. Môžeš ich pomocou tohto príkazu zobraziť, meniť, vytvoriť, či zmazať.
```bash
# zobraz existujúce vetvy a vzdialené repozitáre
$ git branch -a
# vytvor novú vetvu
$ git branch myNewBranch
# vymaž vetvu
$ git branch -d myBranch
# premenuj vetvu
# git branch -m <starémeno> <novémeno>
$ git branch -m mojaStaraVetva mojaNovaVetva
# zmeň opis vetvy
$ git branch myBranchName --edit-description
```
### tag
Spravuj svoje tagy
```bash
# Zobraz tagy
$ git tag
# Vytvor tag so správou
# -m špecifikuje správu, ktorá bude s tagom uložená.
# Ak nešpeficikuješ správu pri tagu so správou,
# Git spustí tvoj editor, aby si ju napísal.
$ git tag -a v2.0 -m 'moja verzia 2.0'
# Ukáž informácie o tagu
# Zobrazí zadané informácie, dátum tagnutia commitu
# a správu pred zobrazením informácií o commite.
$ git show v2.0
# Zverejní (pushne) jediný tag do vzdialeného repozitára
$ git push origin v2.0
# Zverejní viacero tagov do vzdialeného repozitára
$ git push origin --tags
```
### checkout
Aktualizuje všetky súbory v pracovnom strome, aby odpovedali verzií v indexe, alebo v inom strome.
```bash
# Aktualizuj strom, aby odpovedal (predvolene)
# hlavnej vetve repozitáru (master branch)
$ git checkout
# Aktualizuj strom, aby odpovedal konrkétnej vetve
$ git checkout menoVetvy
# Vytvor novú vetvu & prepni sa na ňu
# ekvivalentný príkaz: "git branch <meno>; git checkout <meno>"
$ git checkout -b nováVetva
```
### clone
"Naklonuje", alebo vytvorí kópiu existujúceho repozitára do nového adresára. Tiež pridá špeciálne ďiaľkovo-monitorujúce vetvy (remote-tracking branches), ktoré ti umožnia zverejňovať do vzdialených vetiev.
```bash
# Naklonuj learnxinyminutes-docs
$ git clone https://github.com/adambard/learnxinyminutes-docs.git
# povrchné klonovanie - rýchlejšie, uloží iba najnovšiu snímku
$ git clone --depth 1 https://github.com/adambard/learnxinyminutes-docs.git
# naklonuj iba konkrétnu vetvu
$ git clone -b master-cn https://github.com/adambard/learnxinyminutes-docs.git --single-branch
```
### commit
Uloží aktuálny obsah indexu v novom "commite". Ten obsahuje vytvorené zmeny a s nimi súvisiace správy vytvorené použivateľom.
```bash
# commitni so správou
$ git commit -m "Pridal som multiplyNumbers() funkciu do HelloWorld.c"
# automaticky pridaj zmenené a vymazané súbory do staging indexu, potom ich commitni.
$ git commit -a -m "Zmenil som foo.php a vymazal bar.php"
# zmeň posledný commit (toto nahradí predchádzajúci commit novým)
$ git commit --amend -m "Správna správa"
```
### diff
Ukáže rozdiel medzi súborom v pracovnom repozitári, indexe a commitoch.
```bash
# Ukáž rozdiel medzi pracovným repozitárom a indexom.
$ git diff
# Ukáž rozdiely medzi indexom a najnovším commitom.
$ git diff --cached
# Ukáž rozdiely medzi pracovným adresárom a najnovším commitom.
$ git diff HEAD
```
### grep
Umožní ti rýchlo prehľadávať repozitár.
Možná konfigurácia:
```bash
# Nastav, aby sa vo výsledkoch vyhľadávania zobrazovalo číslo riadku
$ git config --global grep.lineNumber true
# Urob výsledky vyhľadávania čitateľnejšie, vrátane zoskupovania
$ git config --global alias.g "grep --break --heading --line-number"
```
```bash
# Vďaka Travisovi Jefferymu za túto sekciu
# Hľadaj "názovPremennej" vo všetkých java súboroch
$ git grep 'názovPremennej' -- '*.java'
# Hľadaj riadok, ktorý obsahuje "názovPoľa" a "add" alebo "remove"
$ git grep -e 'arrayListName' --and \( -e add -e remove \)
```
Google je tvoj kamarát; pre viac príkladov skoč na
[Git Grep Ninja](http://travisjeffery.com/b/2012/02/search-a-git-repo-like-a-ninja)
### log
Zobral commity do repozitára.
```bash
# Zobraz všetky commity
$ git log
# Zobraz iba správy a referencie commitov
$ git log --oneline
# Zobraz zlúčené (merged) commity
$ git log --merges
# Zobraz všetky commity vo forme ASCII grafu
$ git log --graph
```
### merge
"Zlúč" zmeny externých commitov do aktuálnej vetvy.
```bash
# Zlúč vybranú vetvu do aktuálnej.
$ git merge názovVetvy
# Vždy vytvor zlučovací commit
$ git merge --no-ff názovVetvy
```
### mv
Premenuj, alebo presuň súbor
```bash
# Premenuj súbor
$ git mv HelloWorld.c HelloNewWorld.c
# Presuň súbor
$ git mv HelloWorld.c ./nová/cesta/HelloWorld.c
# "Nasilu" premenuj, alebo presuň
# "existujúciSúbor" už v adresári existuje, bude prepísaný
$ git mv -f môjSúbor existujúciSúbor
```
### pull
Uloží obsah repozitára a zlúči ho s inou vetvou.
```bash
# Aktualizuje tvoj lokálny repozitár zlúčením nových zmien
# zo vzdialených "origin" a "master" vetiev.
# git pull <alias-vzdialeného-repo> <vetva>
$ git pull origin master
# Predvolene, git pull aktualizuje tvoju aktuálnu vetvu
# zlúčením nových zmien zo vzdialenej vetvy
$ git pull
# Zlúč zmeny zo vzdialenej vetvy a presuň vetvu do nového základného commitu (rebase)
# vetva commitne na tvoj lokálny repozitár, ekvivalentný príkaz: "git pull <alias-vzdialeného-repo> <vrstva>, git rebase <branch>"
$ git pull origin master --rebase
```
### push
Zverejní a zlúči zmeny z lokálnej do vzdialenej vetvy.
```bash
# Zverejni a zlúč zmeny z lokálneho repozitára do
# vzdialených vetiev s názvom "origin" a "master".
# git push <vzdialené> <vetvy>
$ git push origin master
# Predvolene git zverejní a zlúči zmeny z
# aktuálnej vetvy do vzdialenej vetvy s ňou spojenej
$ git push
# Na spojenie lokálnej vetvy so vzdialenou pridaj -u:
$ git push -u origin master
# Kedykoľvek budeš chcieť zverejniť z rovnakej lokálnej vetvy, použi príkaz:
$ git push
```
### stash
Umožní ti opustiť chaotický stav pracovného adresára a uloží ho na zásobník nedokončených zmien, ku ktorým sa môžeš kedykoľvek vrátiť.
Povedzme, že si urobil nejaké zmeny vo svojom git repozitári, ale teraz potrebuješ pullnúť zo vzdialenej repo. Keďže máš necommitnuté zmeny, príkaz `git pull` nebude fungovať. Namiesto toho môžeš použiť `git stash` a uložiť svoje nedokončené zmeny na zásobník!
```bash
$ git stash
Saved working directory and index state \
"WIP on master: 049d078 added the index file"
HEAD is now at 049d078 added the index file
(To restore them type "git stash apply")
```
Teraz môžeš uložiť vzdialenú vetvu!
```bash
$ git pull
```
Over, či je všetko v poriadku
```bash
$ git status
# On branch master
nothing to commit, working directory clean
```
Môžeš si pozrieť, čo za chaos je na zásobníku cez `git stash list`.
Nedokončené zmeny sú uložené ako Last-In-First-Out (Prvý dnu, posledný von) štruktúra, navrchu sa objavia najnovšie zmeny.
```bash
$ git stash list
stash@{0}: WIP on master: 049d078 added the index file
stash@{1}: WIP on master: c264051 Revert "added file_size"
stash@{2}: WIP on master: 21d80a5 added number to log
```
Keď so zmenami budeš chcieť pracovať, odstráň ich zo stacku.
```bash
$ git stash pop
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
#
# modified: index.html
# modified: lib/simplegit.rb
#
```
`git stash apply` urobí presne to isté
Hotovo, môžeš pokračovať v práci!
[Čítaj viac.](http://git-scm.com/book/en/v1/Git-Tools-Stashing)
### rebase (pozor)
Zober všetky zmeny commitnuté do vetvy a aplikuj ich na inú vetvu.
*Tento príkaz nerob na verejných repozitároch*.
```bash
# Aplikuj commity z experimentálnej vetvy na master
# git rebase <základnáVetva> <ináVetva>
$ git rebase master experimentBranch
```
[Čítaj viac.](http://git-scm.com/book/en/Git-Branching-Rebasing)
### reset (pozor)
Resetni HEAD (ukazateľ na aktuálnu vetvu) do konrkétneho stavu. To ti umožní vziať späť zlúčenia, zverejnenia, commity, pridania atď. Je to užitočný, no nebezpečný príkaz, pokiaľ nevieš, čo robíš.
```bash
# Resetni index (vrstvu medzi pracovným stromom a Git repozitárom), aby odpovedal najnovšiemu commitu (adresár ostane nezmenený)
$ git reset
# Resetni index, aby odpovedal najnovšiemu commitu (adresár sa prepíše)
$ git reset --hard
# Presunie vrchol aktuálnuej vetvy do konkrétneho commitu (adresár ostane nezmenený)
# všetky zmeny sú zachované v adresári.
$ git reset 31f2bb1
# Presunie vrchol aktuálnuej vetvy naopak do konkrétneho commitu
# a zosúladí ju s pracovným adresárom (vymaže nekomitnuté zmeny).
$ git reset --hard 31f2bb1
```
### revert
Vezme naspäť ("od-urobí") commit. Nezamieňaj s resetom, ktorý obnoví stav
projektu do predchádzajúceho bodu v čase. Revert pridá nový commit, inverzný tomu, ktorý chceš vymazať, tým ho od-urobí.
```bash
# Vezmi späť konkrétny commit
$ git revert <commit>
```
### rm
Opak od git add, rm odstráni súbory z aktuálneho pracovného stromu.
```bash
# odstráň HelloWorld.c
$ git rm HelloWorld.c
# Odstráň súbor z vnoreného adresára
$ git rm /pather/to/the/file/HelloWorld.c
```
## Ďalšie informácie
* [tryGit - Zábavný interaktívny spôsob, ako sa naučiť Git.](http://try.github.io/levels/1/challenges/1)
* [Udemy Git Tutoriál: Kompletný návod](https://blog.udemy.com/git-tutorial-a-comprehensive-guide/)
* [Git Immersion - Návod, ktorý Ťa prevedie základmi Gitu](http://gitimmersion.com/)
* [git-scm - Video Tutoriály](http://git-scm.com/videos)
* [git-scm - Dokumentácia](http://git-scm.com/docs)
* [Atlassian Git - Tutoriály & Postupy](https://www.atlassian.com/git/)
* [SalesForce Cheat Sheet](https://na1.salesforce.com/help/doc/en/salesforce_git_developer_cheatsheet.pdf)
* [GitGuys](http://www.gitguys.com/)
* [Git - jednoducho](http://rogerdudler.github.io/git-guide/index.html)
* [Pro Git](http://www.git-scm.com/book/en/v2)
* [Úvod do Gitu a GitHubu pre začiatočníkov (Tutoriál)](http://product.hubspot.com/blog/git-and-github-tutorial-for-beginners)

View File

@ -0,0 +1,227 @@
---
language: latex
contributors:
- ["Chaitanya Krishna Ande", "http://icymist.github.io"]
- ["Colton Kohnke", "http://github.com/voltnor"]
- ["Sricharan Chiruvolu", "http://sricharan.xyz"]
translators:
- ["Terka Slanináková", "http://github.com/TerkaSlan"]
filename: learn-latex-sk.tex
---
```tex
% Všetky komentáre začínajú s %
% Viac-riadkové komentáre sa nedajú urobiť
% LaTeX NIE JE WYSIWY ("What You See Is What You Get") software ako MS Word, alebo OpenOffice Writer
% Každý LaTeX príkaz začína s opačným lomítkom (\)
% LaTeX dokumenty začínajú s definíciou typu kompilovaného dokumentu
% Ostatné typy sú napríklad kniha (book), správa (report), prezentácia (presentation), atď.
% Možnosti dokumentu sa píšu do [] zátvoriek. V tomto prípade tam upresňujeme veľkosť (12pt) fontu.
\documentclass[12pt]{article}
% Ďalej definujeme balíčky, ktoré dokuemnt používa.
% Ak chceš zahrnúť grafiku, farebný text, či zdrojový kód iného jazyka, musíš rozšíriť možnosti LaTeXu dodatočnými balíčkami.
% Zahŕňam float a caption. Na podporu slovenčiny treba zahrnúť aj utf8 balíček.
\usepackage{caption}
\usepackage{float}
\usepackage[utf8]{inputenc}
% Tu môžme definovať ostatné vlastnosti dokumentu!
% Autori tohto dokumentu, "\\*" znamená "choď na nový riadok"
\author{Chaitanya Krishna Ande, Colton Kohnke \& Sricharan Chiruvolu, \\*Preklad: Terka Slanináková}
% Vygeneruje dnešný dátum
\date{\today}
\title{Nauč sa LaTeX za Y Minút!}
% Teraz môžme začať pracovať na samotnom dokumente.
% Všetko do tohto riadku sa nazýva "Preambula" ("The Preamble")
\begin{document}
% ak zadáme položky author, date a title, LaTeX vytvorí titulnú stranu.
\maketitle
% Väčšina odborných článkov má abstrakt, na jeho vytvorenie môžeš použiť preddefinované príkazy.
% Ten by sa mal zobraziť v logickom poradí, teda po hlavičke,
% no pred hlavnými sekciami tela..
% Tento príkaz je tiež dostupný v triedach article a report.
% Tzv. makro "abstract" je fixnou súčasťou LaTeXu, ak chceme použiť abstract
% a napísať ho po slovensky, musíme ho redefinovať nasledujúcim príkazom
\renewcommand\abstractname{Abstrakt}
\begin{abstract}
LaTeX dokumentácia v LaTeXe! Aké netradičné riešenie cudzieho nápadu!
\end{abstract}
% Príkazy pre sekciu sú intuitívne
% Všetky nadpisy sekcií sú pridané automaticky do obsahu.
\section{Úvod}
Čaute, volám sa Colton a spoločne sa pustíme do skúmania LaTeXu (toho druhého)!
\section{Ďalšia sekcia}
Toto je text ďalšej sekcie. Myslím, že potrebuje podsekciu.
\subsection{Toto je podsekcia} % Podsekcie sú tiež intuitívne.
Zdá sa mi, že treba ďalšiu.
\subsubsection{Pytagoras}
To je ono!
\label{subsec:pytagoras}
% Použitím '*' môžeme potlačiť zabudované číslovanie LaTeXu.
% Toto funguje aj na iné príkazy.
\section*{Toto je nečíslovaná sekcia}
Všetky číslované byť nemusia!
\section{Nejaké poznámočky}
Zarovnávať veci tam, kde ich chceš mať, je všeobecne ľahké. Ak
potrebuješ \\ nový \\ riadok \\ pridaj \textbackslash\textbackslash do
zdrojového kódu. \\
\section{Zoznamy}
Zoznamy sú jednou z najjednoduchších vecí vôbec! Treba mi zajtra nakúpiť, urobím si zoznam.
\begin{enumerate} % "enumerate" spustí číslovanie prvkov.
% \item povie LaTeXu, ako že treba pripočítať 1
\item Vlašský šalát.
\item 5 rožkov.
\item 3 Horalky.
% číslovanie môžeme pozmeniť použitím []
\item[koľko?] Stredne veľkých guličkoviek.
Ja už nie som položka zoznamu, no stále som časť "enumerate".
\end{enumerate} % Všetky prostredia končia s "end".
\section{Matika}
Jedným z primárnych použití LaTeXu je písanie akademických, či technických prác. Zvyčajne za použitia matematiky a vedy. Podpora špeciálnych symbolov preto nemôže chýbať!\\
Matematika má veľa symbolov, omnoho viac, než by klávesnica mohla reprezentovať;
Množinové a relačné symboly, šípky, operátory a Grécke písmená sú len malou ukážkou.\\
Množiny a relácie hrajú hlavnú rolu v mnohých matematických článkoch.
Takto napíšeš, že niečo platí pre všetky x patriace do X, $\forall$ x $\in$ X. \\
% Všimni si, že som pridal $ pred a po symboloch. Je to
% preto, lebo pri písaní sme v textovom móde,
% no matematické symboly existujú len v matematickom.
% Vstúpime doňho z textového práve '$' znamienkami.
% Platí to aj opačne. Premenná môže byť zobrazená v matematickom móde takisto.
% Do matematického módu sa dá dostať aj s \[\]
\[a^2 + b^2 = c^2 \]
Moje obľúbené Grécke písmeno je $\xi$. Tiež sa mi pozdávajú $\beta$, $\gamma$ a $\sigma$.
Ešte som neprišiel na Grécke písmeno, ktoré by LaTeX nepoznal!
Operátory sú dôležitou súčasťou matematických dokumentov:
goniometrické funkcie ($\sin$, $\cos$, $\tan$),
logaritmy and exponenciálne výrazy ($\log$, $\exp$),
limity ($\lim$), atď.
majú pred-definované LaTeXové príkazy.
Napíšme si rovnicu, nech vidíme, ako to funguje: \\
$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$
Zlomky(Čitateľ-menovateľ) sa píšu v týchto formách:
% 10 / 7
$^{10}/_{7}$
% Relatívne komplexné zlomky sa píšu ako
% \frac{čitateľ}{menovateľ}
$\frac{n!}{k!(n - k)!}$ \\
Rovnice tiež môžeme zadať v "rovnicovom prostredí".
% Takto funguje rovnicové prostredie
\begin{equation} % vstúpi do matematického módu
c^2 = a^2 + b^2.
\label{eq:pythagoras} % na odkazovanie
\end{equation} % všetky \begin príkazy musia mať konečný príkaz.
Teraz môžeme odkázať na novovytvorenú rovnicu!
Rovn.~\ref{eq:pythagoras} je tiež známa ako Pytagorova Veta, ktorá je tiež predmetom Sekc.~\ref{subsec:pytagoras}. Odkazovať môžme na veľa vecí, napr na: čísla, rovnice, či sekcie.
Sumácie a Integrály sa píšu príkazmi sum a int:
% Niektoré prekladače LaTeXu sa môžu sťažovať na prázdne riadky (ak tam sú)
% v rovnicovom prostredí.
\begin{equation}
\sum_{i=0}^{5} f_{i}
\end{equation}
\begin{equation}
\int_{0}^{\infty} \mathrm{e}^{-x} \mathrm{d}x
\end{equation}
\section{Obrázky}
Vloženie obrázku môže byť zložitejšie. Ja si vždy možnosti vloženia pozerám pre každý obrázok.
\renewcommand\figurename{Obrázok}
\begin{figure}[H] % H značí možnosť zarovnania.
\centering % nacentruje obrázok na stránku
% Vloží obrázok na 80% šírky stránky.
%\includegraphics[width=0.8\linewidth]{right-triangle.png}
% Zakomentované kvôli kompilácií, použi svoju predstavivosť :).
\caption{Pravouhlý trojuholník so stranami $a$, $b$, $c$}
\label{fig:right-triangle}
\end{figure}
% Opäť, fixné makro "table" nahradíme slovenskou tabuľkou. Pokiaľ preferuješ table, nasledujúci riadok nepridávaj
\renewcommand\tablename{Tabuľka}
\subsection{Tabuľky}
Tabuľky sa vkládajú podobne ako obrázky.
\begin{table}[H]
\caption{Nadpis tabuľky.}
% zátvorky: {} hovoria ako sa vykreslí každý riadok.
% Toto si nikdy nepamätám a vždy to musím hľadať. Všetko. Každý. Jeden. Raz!
\begin{tabular}{c|cc}
Číslo & Priezvisko & Krstné meno \\ % Stĺpce sú rozdelené $
\hline % horizontálna čiara
1 & Ladislav & Meliško \\
2 & Eva & Máziková
\end{tabular}
\end{table}
% \section{Hyperlinks} % Už čoskoro :)
\section{Prikáž LaTeXu nekompilovať (napr. Zdrojový Kód)}
Povedzme, že chceme do dokumentu vložiť zdrojový kód, budeme musieť LaTeXu povedať, nech sa ho nesnaží skompilovať, ale nech s ním pracuje ako s textom.
Toto sa robí vo verbatim prostredí.
% Tiež sú na to špeciálne balíčky, (napr. minty, lstlisting, atď.)
% ale verbatim je to najzákladnejšie, čo môžeš použiť.
\begin{verbatim}
print("Hello World!")
a%b; pozri! Vo verbatime môžme použiť % znamienka.
random = 4; #priradené randomným hodom kockou
\end{verbatim}
\section{Kompilácia}
Už by bolo načase túto nádheru skompilovať a zhliadnuť jej úžasnú úžasnosť v podobe LaTeX pdfka, čo povieš?
(áno, tento dokument sa musí kompilovať). \\
Cesta k finálnemu dokumentu pomocou LaTeXu pozostáva z nasledujúcich krokov:
\begin{enumerate}
\item Napíš dokument v čistom texte (v "zdrojáku").
\item Skompiluj zdroják na získanie pdfka.
Kompilácia by mala vyzerať nasledovne (v Linuxe): \\
\begin{verbatim}
$pdflatex learn-latex.tex learn-latex.pdf
\end{verbatim}
\end{enumerate}
Mnoho LaTeX editorov kombinuje Krok 1 a Krok 2 v jednom prostredí. Krok 1 teda uvidíš, krok 2 už nie.
Ten sa deje za oponou. Kompilácia v 2. kroku sa postará o produkciu dokumentu v tebou zadanom formáte.
\section{Koniec}
To je zatiaľ všetko!
% koniec dokumentu
\end{document}
```
## Viac o LaTeXe (anglicky)
* Úžasná LaTeX wikikniha: [https://en.wikibooks.org/wiki/LaTeX](https://en.wikibooks.org/wiki/LaTeX)
* Naozajstný tutoriál: [http://www.latex-tutorial.com/](http://www.latex-tutorial.com/)

209
sk-sk/learn-latex-sk.tex Normal file
View File

@ -0,0 +1,209 @@
% Všetky komentáre začínajú s %
% Viac-riadkové komentáre sa nedajú urobiť
% LaTeX NIE JE WYSIWY ("What You See Is What You Get") software ako MS Word, alebo OpenOffice Writer
% Každý LaTeX príkaz začína s opačným lomítkom (\)
% LaTeX dokumenty začínajú s definíciou typu kompilovaného dokumentu
% Ostatné typy sú napríklad kniha (book), správa (report), prezentácia (presentation), atď.
% Možnosti dokumentu sa píšu do [] zátvoriek. V tomto prípade tam upresňujeme veľkosť (12pt) fontu.
\documentclass[12pt]{article}
% Ďalej definujeme balíčky, ktoré dokuemnt používa.
% Ak chceš zahrnúť grafiku, farebný text, či zdrojový kód iného jazyka, musíš rozšíriť možnosti LaTeXu dodatočnými balíčkami.
% Zahŕňam float a caption. Na podporu slovenčiny treba zahrnúť aj utf8 balíček.
\usepackage{caption}
\usepackage{float}
\usepackage[utf8]{inputenc}
% Tu môžme definovať ostatné vlastnosti dokumentu!
% Autori tohto dokumentu, "\\*" znamená "choď na nový riadok"
\author{Chaitanya Krishna Ande, Colton Kohnke \& Sricharan Chiruvolu, \\*Preklad: Terka Slanináková}
% Vygeneruje dnešný dátum
\date{\today}
\title{Nauč sa LaTeX za Y Minút!}
% Teraz môžme začať pracovať na samotnom dokumente.
% Všetko do tohto riadku sa nazýva "Preambula" ("The Preamble")
\begin{document}
% ak zadáme položky author, date a title, LaTeX vytvorí titulnú stranu.
\maketitle
% Väčšina odborných článkov má abstrakt, na jeho vytvorenie môžeš použiť preddefinované príkazy.
% Ten by sa mal zobraziť v logickom poradí, teda po hlavičke,
% no pred hlavnými sekciami tela..
% Tento príkaz je tiež dostupný v triedach article a report.
% Tzv. makro "abstract" je fixnou súčasťou LaTeXu, ak chceme použiť abstract
% a napísať ho po slovensky, musíme ho redefinovať nasledujúcim príkazom
\renewcommand\abstractname{Abstrakt}
\begin{abstract}
LaTeX dokumentácia v LaTeXe! Aké netradičné riešenie cudzieho nápadu!
\end{abstract}
% Príkazy pre sekciu sú intuitívne
% Všetky nadpisy sekcií sú pridané automaticky do obsahu.
\section{Úvod}
Čaute, volám sa Colton a spoločne sa pustíme do skúmania LaTeXu (toho druhého)!
\section{Ďalšia sekcia}
Toto je text ďalšej sekcie. Myslím, že potrebuje podsekciu.
\subsection{Toto je podsekcia} % Podsekcie sú tiež intuitívne.
Zdá sa mi, že treba ďalšiu.
\subsubsection{Pytagoras}
To je ono!
\label{subsec:pytagoras}
% Použitím '*' môžeme potlačiť zabudované číslovanie LaTeXu.
% Toto funguje aj na iné príkazy.
\section*{Toto je nečíslovaná sekcia}
Všetky číslované byť nemusia!
\section{Nejaké poznámočky}
Zarovnávať veci tam, kde ich chceš mať, je všeobecne ľahké. Ak
potrebuješ \\ nový \\ riadok \\ pridaj \textbackslash\textbackslash do
zdrojového kódu. \\
\section{Zoznamy}
Zoznamy sú jednou z najjednoduchších vecí vôbec! Treba mi zajtra nakúpiť, urobím si zoznam.
\begin{enumerate} % "enumerate" spustí číslovanie prvkov.
% \item povie LaTeXu, ako že treba pripočítať 1
\item Vlašský šalát.
\item 5 rožkov.
\item 3 Horalky.
% číslovanie môžeme pozmeniť použitím []
\item[koľko?] Stredne veľkých guličkoviek.
Ja už nie som položka zoznamu, no stále som časť "enumerate".
\end{enumerate} % Všetky prostredia končia s "end".
\section{Matika}
Jedným z primárnych použití LaTeXu je písanie akademických, či technických prác. Zvyčajne za použitia matematiky a vedy. Podpora špeciálnych symbolov preto nemôže chýbať!\\
Matematika má veľa symbolov, omnoho viac, než by klávesnica mohla reprezentovať;
Množinové a relačné symboly, šípky, operátory a Grécke písmená sú len malou ukážkou.\\
Množiny a relácie hrajú hlavnú rolu v mnohých matematických článkoch.
Takto napíšeš, že niečo platí pre všetky x patriace do X, $\forall$ x $\in$ X. \\
% Všimni si, že som pridal $ pred a po symboloch. Je to
% preto, lebo pri písaní sme v textovom móde,
% no matematické symboly existujú len v matematickom.
% Vstúpime doňho z textového práve '$' znamienkami.
% Platí to aj opačne. Premenná môže byť zobrazená v matematickom móde takisto.
% Do matematického módu sa dá dostať aj s \[\]
\[a^2 + b^2 = c^2 \]
Moje obľúbené Grécke písmeno je $\xi$. Tiež sa mi pozdávajú $\beta$, $\gamma$ a $\sigma$.
Ešte som neprišiel na Grécke písmeno, ktoré by LaTeX nepoznal!
Operátory sú dôležitou súčasťou matematických dokumentov:
goniometrické funkcie ($\sin$, $\cos$, $\tan$),
logaritmy and exponenciálne výrazy ($\log$, $\exp$),
limity ($\lim$), atď.
majú pred-definované LaTeXové príkazy.
Napíšme si rovnicu, nech vidíme, ako to funguje: \\
$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$
Zlomky(Čitateľ-menovateľ) sa píšu v týchto formách:
% 10 / 7
$^{10}/_{7}$
% Relatívne komplexné zlomky sa píšu ako
% \frac{čitateľ}{menovateľ}
$\frac{n!}{k!(n - k)!}$ \\
Rovnice tiež môžeme zadať v "rovnicovom prostredí".
% Takto funguje rovnicové prostredie
\begin{equation} % vstúpi do matematického módu
c^2 = a^2 + b^2.
\label{eq:pythagoras} % na odkazovanie
\end{equation} % všetky \begin príkazy musia mať konečný príkaz.
Teraz môžeme odkázať na novovytvorenú rovnicu!
Rovn.~\ref{eq:pythagoras} je tiež známa ako Pytagorova Veta, ktorá je tiež predmetom Sekc.~\ref{subsec:pytagoras}. Odkazovať môžme na veľa vecí, napr na: čísla, rovnice, či sekcie.
Sumácie a Integrály sa píšu príkazmi sum a int:
% Niektoré prekladače LaTeXu sa môžu sťažovať na prázdne riadky (ak tam sú)
% v rovnicovom prostredí.
\begin{equation}
\sum_{i=0}^{5} f_{i}
\end{equation}
\begin{equation}
\int_{0}^{\infty} \mathrm{e}^{-x} \mathrm{d}x
\end{equation}
\section{Obrázky}
Vloženie obrázku môže byť zložitejšie. Ja si vždy možnosti vloženia pozerám pre každý obrázok.
\renewcommand\figurename{Obrázok}
\begin{figure}[H] % H značí možnosť zarovnania.
\centering % nacentruje obrázok na stránku
% Vloží obrázok na 80% šírky stránky.
%\includegraphics[width=0.8\linewidth]{right-triangle.png}
% Zakomentované kvôli kompilácií, použi svoju predstavivosť :).
\caption{Pravouhlý trojuholník so stranami $a$, $b$, $c$}
\label{fig:right-triangle}
\end{figure}
% Opäť, fixné makro "table" nahradíme slovenskou tabuľkou. Pokiaľ preferuješ table, nasledujúci riadok nepridávaj
\renewcommand\tablename{Tabuľka}
\subsection{Tabuľky}
Tabuľky sa vkládajú podobne ako obrázky.
\begin{table}[H]
\caption{Nadpis tabuľky.}
% zátvorky: {} hovoria ako sa vykreslí každý riadok.
% Toto si nikdy nepamätám a vždy to musím hľadať. Všetko. Každý. Jeden. Raz!
\begin{tabular}{c|cc}
Číslo & Priezvisko & Krstné meno \\ % Stĺpce sú rozdelené $
\hline % horizontálna čiara
1 & Ladislav & Meliško \\
2 & Eva & Máziková
\end{tabular}
\end{table}
% \section{Hyperlinks} % Už čoskoro :)
\section{Prikáž LaTeXu nekompilovať (napr. Zdrojový Kód)}
Povedzme, že chceme do dokumentu vložiť zdrojový kód, budeme musieť LaTeXu povedať, nech sa ho nesnaží skompilovať, ale nech s ním pracuje ako s textom.
Toto sa robí vo verbatim prostredí.
% Tiež sú na to špeciálne balíčky, (napr. minty, lstlisting, atď.)
% ale verbatim je to najzákladnejšie, čo môžeš použiť.
\begin{verbatim}
print("Hello World!")
a%b; pozri! Vo verbatime môžme použiť % znamienka.
random = 4; #priradené randomným hodom kockou
\end{verbatim}
\section{Kompilácia}
Už by bolo načase túto nádheru skompilovať a zhliadnuť jej úžasnú úžasnosť v podobe LaTeX pdfka, čo povieš?
(áno, tento dokument sa musí kompilovať). \\
Cesta k finálnemu dokumentu pomocou LaTeXu pozostáva z nasledujúcich krokov:
\begin{enumerate}
\item Napíš dokument v čistom texte (v "zdrojáku").
\item Skompiluj zdroják na získanie pdfka.
Kompilácia by mala vyzerať nasledovne (v Linuxe): \\
\begin{verbatim}
$pdflatex learn-latex.tex learn-latex.pdf
\end{verbatim}
\end{enumerate}
Mnoho LaTeX editorov kombinuje Krok 1 a Krok 2 v jednom prostredí. Krok 1 teda uvidíš, krok 2 už nie.
Ten sa deje za oponou. Kompilácia v 2. kroku sa postará o produkciu dokumentu v tebou zadanom formáte.
\section{Koniec}
To je zatiaľ všetko!
% koniec dokumentu
\end{document}