zpwiki/pages/topics/faq/README.md

86 lines
4.1 KiB
Markdown
Raw Permalink Normal View History

2020-10-02 12:24:56 +00:00
---
published: true
taxonomy:
category: [info]
tag: [zp]
author: Daniel Hladek
---
2019-11-19 17:26:17 +00:00
# Často kladené otázky
2019-11-22 11:48:13 +00:00
## Pre koho to je?
Stránka je určená pre študentov a vyučujúcich na Katedre elektroniky a multimediálnych telekomunikácií pre zdieľanie výsledkov záverečných prác.
Pomôže aj záujemcom o štúdium, zamestnávateľom a partnerom katedry na získanie prehľadu o študentskej odbornej činnosti.
2019-11-25 12:12:08 +00:00
## Ako to funguje
2019-11-25 12:26:16 +00:00
Stránka je založená na princípe WIKI - každý prihlásený použvateľ môže zapisovať na ľubovoľné miesto. Každá zmena aj jej autor sa ale zaznamenáva pomocou [systému GIT](https://git.kemt.fei.tuke.sk). Je jednoduché zistiť, kto urobil kedy akú zmenu a zmenu zvrátiť.
2019-11-22 11:48:13 +00:00
2019-12-07 11:52:14 +00:00
Stránky môžte editovať cez web rozhranie systému alebo lokálne pomocou Vášho obľúbeného textového editora a synchronizovať pomocou príkazu `git`. Jedna stránka zodpovedá jednému adresáru. Do adresáru umiestnite text stránky vo formáte Markdown do súboru `README.md` a ostatné súvisiace súbory, napr. obrázky.
2019-11-22 11:48:13 +00:00
## Čo tu nájdem?
2020-10-03 08:30:16 +00:00
Nájdete tu materiály súvisiace s vypracovaním záverečnej práce. Kažý študent tu nájde svoj záznam o projekte.
2019-11-19 17:26:17 +00:00
2019-11-22 11:48:13 +00:00
Študenti sú organizovaní do skupín podľa roku nástupu na štúdium:
2020-10-03 08:30:16 +00:00
- `/students/rok_nastupu_na_studium/meno_priezvisko`: Stránka s profilom študenta a prácami na ktorých pracoval.
2019-11-22 11:48:13 +00:00
2019-11-25 12:26:16 +00:00
2019-12-07 11:52:14 +00:00
## Ako upravím stránky cez webové rozhranie
2019-12-07 11:07:38 +00:00
2020-10-03 08:30:16 +00:00
Zobrazte si stránku kotrú chcete upraviť. ´Tuknite na odkaz "Edit this page".
Na editovanie sa potrebujete prihlásiť do GIT servra pomocou Vašich študentských prístupových údajov.
Zmeny môžete vykonávať pomocou webového editora, kotrý Vám uľahčí prácu s formátom Markdown.
V pravom hornom rohu ťuknite na ikonku s perom. Otvorí sa Vám editor v ktorom môžte upravovať.
Keď skončíte s úpravami, ťuknite na zelené tlačítko "Commit changes/Potvrď zmeny" celkom dole na stránke. Zmena na GITe sa automaticky zobrazí aj na wiki stránke.
2019-12-07 11:07:38 +00:00
2020-10-03 08:30:16 +00:00
Pre vytvorenie nového adresára stačí dopísať jeho meno pred názov nového súboru a adresár sa vytvorí automaticky.
2019-12-07 11:07:38 +00:00
2019-12-07 11:52:14 +00:00
## Ako upravím stránky pomocu môjho textového editora
2019-11-25 12:26:16 +00:00
2019-12-07 11:52:14 +00:00
Ak chcete upravovať pomocou Vášho textového editora, vytvorte si lokálnu kópiu repozirára. Použite grafický GIT klient, ktorý je súčasťou Vášho editora alebo pomocou príkazu `git clone` .
Ak kópiu už máte vytvorenú, získajte najnovšie zmeny príkazom `git pull`.
2019-11-25 12:26:16 +00:00
2019-12-07 11:52:14 +00:00
V Vašou kópiou môžte vykonávať bežné operácie so súbormi a adresármi - úpravu, premiestnenie alebo vymazanie. Nájdite alebo vytvorte vhodný adresár, a upravte súbor `README.md`, do adresára skopírujte obrázky a iné súbory. Stránka sa bude volať rovnako ako adresár.
2019-12-05 14:06:23 +00:00
2019-12-07 11:52:14 +00:00
Na konci pridajte zmenené súbory príkazom `git add` a potvrďte zmeny príkazom `/git commit`. Zmeny odošlite príkazom `git push`.
2019-11-25 12:26:16 +00:00
2019-12-05 14:06:23 +00:00
2019-11-25 12:12:08 +00:00
## Čo je to Markdown?
2019-11-22 12:35:28 +00:00
2019-11-25 12:12:08 +00:00
Markdown je jednoduchý značkovací formát obyčajného textu ktorý sa dá ľahko premeniť na HTML alebo aj iné formáty.
2019-11-22 12:35:28 +00:00
2019-11-25 12:12:08 +00:00
- [Krátky prehľad syntaxe](https://commonmark.org/help/)
- [Viac informácií o Markdown](https://www.markdownguide.org/getting-started)
2019-11-22 12:35:28 +00:00
2019-11-25 12:12:08 +00:00
Text vo formáte Markdown vytvoríte pomocou textového editora alebo pomocou webového editora, ale môžte využiť aj špecializované nástroje:
2019-11-22 12:35:28 +00:00
2019-11-25 12:12:08 +00:00
- [Dillinger](https://dillinger.io/), online Markdown Editor
- Online nástroj na [konverziu DOC](https://word2md.com/)
- [Pandoc](https://pandoc.org/) (konverzia z a do Markdown)
2019-11-22 11:48:13 +00:00
2019-11-26 06:09:46 +00:00
2019-11-25 12:12:08 +00:00
## Ako vytvorím odkaz
2019-11-19 17:26:17 +00:00
2019-11-22 12:35:28 +00:00
Meno stránky je totožné s adresárom v ktorom sa nachádza. Na stránku sa odkážete podobne ako na adresár v ktorom sa nachádza.
2020-10-03 08:30:16 +00:00
Takto odkážete na stránku Vášho kolegu:
[Môj obľúbený kolega](/students/2016/vzorny_student)
2019-11-22 12:35:28 +00:00
## Ako vložím obrázok
2020-10-03 08:30:16 +00:00
2019-11-22 12:35:28 +00:00
Uložte súbor s obrázkom do adresára s Vašou stránkou. Do textu pridajte odkaz na obrázok a pridajte výkričník:
![Text odkazu](./obrazok.jpg)
2019-11-19 17:26:17 +00:00
2020-10-03 08:30:16 +00:00
Na vloženie obrázka môžete použiť aj web rozhranie. Ťuknite na "Edit page" a potom cez Git na "New file".
2019-11-25 12:26:16 +00:00
## Čo ak som našiel preklep?
Môžte ho sám opraviť.