mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-24 10:01:38 +00:00
Merge pull request #2024 from TerkaSlan/master
[Git/sk]Translation for Git to Slovak
This commit is contained in:
commit
4a465720e0
208
sk-sk/LearnGit-sk.txt
Normal file
208
sk-sk/LearnGit-sk.txt
Normal 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
523
sk-sk/git.html.markdown
Normal 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)
|
227
sk-sk/latex.html.markdown.tex
Normal file
227
sk-sk/latex.html.markdown.tex
Normal 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
209
sk-sk/learn-latex-sk.tex
Normal 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}
|
Loading…
Reference in New Issue
Block a user