説明なし

xnecas 0e23bcd7a0 Added license 3 週間 前
organisation a5cefb1d3e Updated README 3 週間 前
snippets acf6333b48 First Commit 1 ヶ月 前
styles acf6333b48 First Commit 1 ヶ月 前
README.md 0e23bcd7a0 Added license 3 週間 前
main.tex acf6333b48 First Commit 1 ヶ月 前
uni.sty acf6333b48 First Commit 1 ヶ月 前

README.md

UNIZA Beamer – prezentačná šablóna

LaTeXová šablóna pre tvorbu prezentácií v Beameri s vlastnými rozloženiami slajdov, typografiou, farbami, pätou, logom organizácie a pomocnými príkazmi na vkladanie tabuliek, obrázkov a zdrojového kódu.

Súbor main.tex slúži ako ukážková prezentácia a zároveň ako praktický katalóg dostupných príkazov. Vlastné makrá a vzhľad sú oddelené do modulov, takže obsah prezentácie možno upravovať bez potreby meniť všetky súčasti šablóny.

Obsah

Štruktúra projektu

.
├── main.tex
├── uni.sty
├── styles/
│   ├── colors.sty
│   ├── contents.sty
│   ├── fonts.sty
│   ├── footer.sty
│   ├── lists.sty
│   ├── slides.sty
│   └── titles.sty
├── organisation/
│   ├── info.sty
│   ├── feit-uniza/
│   │   ├── info.sty
│   │   └── logo-footer.png
│   ├── kris-feit-uniza/
│   │   ├── info.sty
│   │   └── logo-footer.png
│   └── uniza/
│       ├── info.sty
│       └── logo-footer.pdf
└── snippets/
    ├── maximum.py
    ├── mean-func.py
    └── mean.py

Dôležité: cesty k modulom, logám a ukážkovým zdrojovým súborom sú relatívne ku koreňovému priečinku projektu. Pri kompilácii preto pracujte v priečinku, v ktorom sa nachádza main.tex, a zachovajte názvy a štruktúru priečinkov.

Ako prezentáciu skompilovať

Potrebné nástroje

  • LaTeX distribúcia, napríklad TeX Live alebo MiKTeX.
  • Trieda beamer a balíky používané šablónou, vrátane graphicx, booktabs, amsmath, minted, caption, calc, adjustbox a multicol.
  • Python a balík Pygments, ktorý používa minted na zvýrazňovanie syntaxe kódu.
  • Povolené spúšťanie externých príkazov v LaTeXu (shell escape), pretože minted spúšťa Pygments.

Kompilácia pomocou latexmk

V koreňovom priečinku projektu spustite:

latexmk -pdf -shell-escape main.tex

Ak latexmk nemáte, môžete použiť pdflatex:

pdflatex -shell-escape main.tex
pdflatex -shell-escape main.tex

Druhé spustenie pomáha aktualizovať odkazy, obsah a celkový počet slajdov. V online editore, napríklad Overleaf, vyberte kompatibilný LaTeX kompilátor a povoľte nastavenia potrebné pre minted, ak ich editor vyžaduje.

Výstupom je súbor main.pdf.

Ako zmeniť organizáciu, farby a logo

Výber organizačného profilu sa robí v jedinom centrálnom súbore: organisation/info.sty. Tento súbor aktuálne obsahuje:

\input{organisation/kris-feit-uniza/info.sty}

Tým sa aktivuje profil uniza. Na prepnutie na inú z pripravených organizácií zmeňte tento jeden riadok.

Príklad: prechod na FEIT UNIZA

V súbore organisation/info.sty nahraďte riadok:

\input{organisation/kris-feit-uniza/info.sty}

riadkom:

\input{organisation/feit-uniza/info.sty}

Zmena aktivuje farebný profil a logo z priečinka organisation/feit-uniza/. Obsah slajdov v main.tex meniť nemusíte.

Ktoré nastavenia profil určuje?

Každý profil má vlastný súbor info.sty, v ktorom sa definujú farby a cesta k logu v päte. Napríklad profil organisation/feit-uniza/info.sty mapuje konkrétne farby na významové premenné:

\colorlet{colorBg}{white}
\colorlet{colorText}{black}
\colorlet{colorTextHighlight}{darkOrange}
\colorlet{colorFooterFg}{white}
\colorlet{colorFooterBg}{feitOrange}
\providecommand{\orgLogoFooter}{organisation/feit-uniza/logo-footer.png}

Význam premenných:

  • colorBg – základné pozadie slajdov.
  • colorText – predvolená farba hlavného textu.
  • colorTextHighlight – zvýrazňovacia farba, využívaná napríklad štruktúrnymi prvkami a nadpismi.
  • colorFooterFg – farba textu a prvkov v päte.
  • colorFooterBg – farba pozadia päty; používa sa aj ako pozadie farebného záverečného slajdu.
  • orgLogoFooter – cesta k obrázku loga zobrazovaného v päte.

Farby možno definovať aj pomocou RGB, napríklad:

\providecolor{myBlue}{RGB}{0, 90, 160}
\colorlet{colorTextHighlight}{myBlue}
\colorlet{colorFooterBg}{myBlue}

Hodnoty RGB sú tri celé čísla od 0 do 255. Pri zmene farieb je praktické ponechať názvy významových premenných (colorBg, colorText a podobne) a meniť iba ich priradenia. Tak sa úprava automaticky prejaví v moduloch, ktoré tieto premenné používajú.

Vytvorenie vlastného profilu organizácie

  1. Vytvorte priečinok, napríklad organisation/moj-profil/.
  2. Vložte doň súbor info.sty s definíciami farieb a cesty k logu.
  3. Uložte logo v danom priečinku a v \orgLogoFooter uveďte správny názov a formát súboru.
  4. Zmeňte organisation/info.sty tak, aby načítaval nový profil, napríklad \input{organisation/moj-profil/info.sty}.
  5. Skompilujte prezentáciu a skontrolujte kontrast textu, čitateľnosť päty a správne zobrazenie loga.

Príklad minimálneho súboru vlastného profilu:

% organisation/moj-profil/info.sty
\providecolor{myBrand}{RGB}{0, 90, 160}

\colorlet{colorBg}{white}
\colorlet{colorText}{black}
\colorlet{colorTextHighlight}{myBrand}
\colorlet{colorFooterFg}{white}
\colorlet{colorFooterBg}{myBrand}

\providecommand{\orgLogoFooter}{organisation/moj-profil/logo-footer.png}

Logo musí existovať presne na uvedenej ceste. Ak používate iný súbor alebo formát, upravte hodnotu \orgLogoFooter.

Čo obsahujú jednotlivé súbory

Koreň projektu

main.tex – ukážková prezentácia

Hlavný dokument, ktorý autor prezentácie zvyčajne upravuje. Na začiatku načíta triedu Beamer, balík uni, jazykové a kódovacie nastavenia a metadáta prezentácie. Ďalej demonštruje titulné slajdy, obsah, sekcie, jednostĺpcové a dvojstĺpcové rozloženia, zoznamy, tabuľky, obrázky, matematiku a zdrojové kódy.

Pri príprave vlastnej prezentácie upravte najmä:

\author{Meno Priezvisko}
\title{Názov prezentácie}
\subtitle{Podnadpis prezentácie}

Potom nahraďte ukážkové sekcie a obsah vlastným materiálom. Súbor je vhodný aj ako referencia syntaxe vlastných makier.

uni.sty – hlavný balík šablóny

Koordinačný balík, ktorý sa načítava príkazom \usepackage{uni}. Načíta potrebné LaTeX balíky, nastaví základné vlastnosti Beameru, definuje počítadlo pre označenie kódových blokov a postupne načíta moduly zo styles/.

Ak chcete meniť iba obsah prezentácie alebo organizačnú tému, zvyčajne tento súbor upravovať nepotrebujete. Zásah doň je vhodný pri rozširovaní samotnej šablóny alebo pri pridávaní ďalších závislostí či modulov.

styles/ – vzhľad a správanie šablóny

Táto zložka rozdeľuje vzhľad a vlastné príkazy do tematických modulov. Uľahčuje údržbu: typografiu možno meniť v fonts.sty, pätičku v footer.sty a rozloženia slajdov v slides.sty.

styles/colors.sty

Načíta vybraný organizačný profil z organisation/info.sty a priradí jeho významové farby ku komponentom Beameru. Nastavuje farbu bežného textu a pozadia, štruktúrnych prvkov, päty a položiek obsahu prezentácie.

Ak chcete prepínať medzi pripravenými organizáciami, zmeňte centrálny výber profilu; tento súbor na bežnú zmenu značky meniť netreba.

styles/contents.sty

Definuje príkazy pre tabuľky, obrázky a zdrojové kódy:

  • \tab vytvorí tabuľku s popisom a menovkou.
  • \fig vloží obrázok s popisom a menovkou; ak súbor obrázka neexistuje, zobrazí náhradný rámček.
  • \code vloží kód zo samostatného súboru pomocou minted. Nehviezdičkovaná verzia pridáva označenie typu (L1), (L2) atď.; hviezdičkovaná verzia číslovanie vynecháva.

Súbor obsahuje aj rozmery a parametre kódových blokov, napríklad veľkosť písma, odsadenie čísel riadkov a typ rámčeka.

styles/fonts.sty

Nastavuje typografiu prezentácie: základnú veľkosť písma, veľkosti nadpisov a podnadpisov, meno autora, text v päte a jednotlivé úrovne zoznamov. Ak má prezentácia pôsobiť jednotne, globálne veľkosti písma meňte práve tu, nie samostatne na každom slajde.

styles/footer.sty

Zodpovedá za pätu slajdov. Načíta organizačné nastavenia, určuje rozmery päty a loga a podľa typu slajdu zobrazí logo spolu s dátumom na titulnej strane alebo logo spolu s číslom aktuálneho a celkového počtu slajdov na bežných slajdoch. Skrýva predvolené navigačné symboly Beameru.

Pri zmene loga upravte organizačný profil; rozmery a zarovnanie päty meňte v tomto súbore iba vtedy, ak chcete meniť spoločný dizajn.

styles/lists.sty

Nastavuje vzhľad odrážok pre prvú, druhú a tretiu úroveň nečíslovaných zoznamov. Číslované zoznamy naďalej vytvárate štandardným prostredím LaTeX enumerate.

styles/slides.sty

Hlavný modul na rozloženia slajdov. Definuje titulné slajdy, obsah, oddeľovacie slajdy sekcií a jednostĺpcové či dvojstĺpcové rozloženia. Obsahuje tiež rozmery, napríklad medzeru medzi stĺpcami a odstupy v titulných slajdoch.

Pri vytváraní obsahu používajte dostupné príkazy, aby jednotlivé slajdy zachovali jednotný vzhľad. Tento súbor upravujte vtedy, keď chcete meniť samotné rozloženie.

styles/titles.sty

Definuje formát titulkov bežných slajdov a označenie pokračovania viacstranových rámcov. Určuje vertikálne odsadenie, zarovnanie a použitie nastaveného písma nadpisov.

organisation/ – profily značky

organisation/info.sty

Centrálny prepínač organizácie. Načítava jeden konkrétny profil, ktorý obsahuje farby a cestu k logu. Toto je prvé miesto, ktoré treba upraviť pri zmene organizačnej témy.

organisation/feit-uniza/info.sty

Farebný profil Fakulty elektrotechniky a informačných technológií UNIZA. V aktuálnych definíciách používa oranžovú farbu päty (feitOrange, RGB 244,119,35) a tmavooranžovú zvýrazňovaciu farbu (darkOrange, RGB 228,92,18). Načítava organisation/feit-uniza/logo-footer.png.

organisation/kris-feit-uniza/info.sty

Profil KRIS FEIT UNIZA. Aktuálne používa tyrkysovú farbu krisCyan (RGB 18,102,113) pre zvýraznenie aj pozadie päty a načítava organisation/kris-feit-uniza/logo-footer.png. Tento profil je predvolene aktívny cez organisation/info.sty.

organisation/uniza/info.sty

Všeobecný profil Univerzity Žilina. Definuje modré odtiene, používa unizaBlue (RGB 0,45,113) pre pätu a darkbBlue (RGB 24,47,105) pre zvýraznenie. Načítava vektorové logo organisation/uniza/logo-footer.pdf.

Súbory logo-footer.*

Grafické súbory loga, ktoré sa umiestňujú do päty. Každý profil odkazuje na vlastné logo. Ak ho nahradíte, zachovajte cestu uvedenú v \orgLogoFooter, alebo túto definíciu aktualizujte. Dbajte na oprávnenie používať logo a na dodržiavanie pravidiel vizuálnej identity organizácie.

snippets/ – ukážkové zdrojové kódy

Obsahuje samostatné ukážky Pythonu, ktoré v main.tex vkladá makro \code. Udržiavanie kódu v osobitných súboroch zjednodušuje jeho úpravu a umožňuje zachovať zvýrazňovanie syntaxe.

  • mean.py – stručný výpočet aritmetického priemeru hodnôt [2, 4, 6, 8].
  • mean-func.py – ukážka výpočtu priemeru pomocou funkcie calculate_mean.
  • maximum.py – funkcia find_maximum, ktorá hľadá najväčšiu hodnotu v zozname.

Pri príkaze \code použite cestu k súboru relatívnu ku koreňu projektu, napríklad snippets/mean.py.

Príkazy na tvorbu slajdov

Všetky nižšie uvedené príkazy sú definované šablónou a používajú sa v main.tex po načítaní \usepackage{uni}.

Titulok a obsah

\slideTitle
\slideTitleColor
\slideTableOfContents
\slideTableOfContents[2]
  • \slideTitle vytvorí titulný slajd z údajov \title, \subtitle a \author.
  • \slideTitleColor vytvorí záverečný/titulný slajd s farebným pozadím podľa farby päty.
  • \slideTableOfContents vloží obsah; voliteľný argument je počet stĺpcov. Ak argument vynecháte, použije sa jeden stĺpec.

Oddeľovacie slajdy sekcií

\slideSection{Názov sekcie}
\slideSection*{Sekcia bez zápisu do obsahu}
\slideSectionSubtitle{Názov sekcie}{Podnadpis}

Neoznačené (nehviezdičkované) verzie zapíšu názov sekcie do štruktúry Beameru, a tým ovplyvnia automatický obsah. Hviezdička potlačí automatické zaregistrovanie sekcie. Pri \slideSectionSubtitle druhý povinný argument obsahuje podnadpis.

Jednostĺpcové slajdy

\slideOneColumn{Nadpis slajdu}
{
    Text, zoznam alebo iný obsah slajdu.
}

\slideOneColumn*{Nadpis bez registrácie sekcie}
{
    Obsah slajdu.
}

\slideOneColumnPlain
{
    Obsah bez nadpisu rámca.
}
  • \slideOneColumn{nadpis}{obsah} vytvorí štandardný slajd s nadpisom.
  • \slideOneColumn* zobrazí nadpis, ale nezaregistruje ho ako sekciu v obsahu.
  • \slideOneColumnPlain{obsah} vytvorí slajd bez štandardného nadpisu.

Dvojstĺpcové slajdy

\slideTwoColumns{Porovnanie}{0.45}
{
    Obsah ľavého stĺpca.
}
{
    Obsah pravého stĺpca.
}

\slideTwoColumnsPlain{0.45}
{
    Ľavý stĺpec bez nadpisu.
}
{
    Pravý stĺpec bez nadpisu.
}

Číselný argument určuje podiel šírky ľavého stĺpca voči šírke textovej oblasti. Napríklad 0.45 znamená 45 % šírky pre ľavý stĺpec; medzi stĺpcami sa navyše ponecháva definovaná medzera. Pravý stĺpec zaberie zvyšný priestor. Podľa potreby použite pomer ako 0.4, 0.45 alebo 0.5 a skontrolujte, či sa obsah zmestí.

Hviezdičková verzia \slideTwoColumns*{nadpis}{pomer}{ľavý obsah}{pravý obsah} potlačí automatické registrovanie sekcie.

Tabuľky, obrázky a zdrojový kód

Tabuľka

\tab{lrr}{tab:vysledky}{Porovnanie výsledkov}
{
    \toprule
    \textbf{Parameter} & \textbf{Metóda A} & \textbf{Metóda B} \\
    \midrule
    Čas [s] & 12.4 & 14.8 \\
    Presnosť [\%] & 95 & 97 \\
    \bottomrule
}

Argumenty v poradí: špecifikácia stĺpcov, menovka na odkazovanie, popis tabuľky a samotný obsah. V špecifikácii sa používajú bežné typy zarovnania LaTeXu, napríklad l (vľavo), c (na stred) a r (vpravo). Vodorovné čiary \toprule, \midrule a \bottomrule poskytuje balík booktabs.

Obrázok

\fig{0.8}{fig:architektura}{Schéma architektúry}{images/architektura.png}

Argumenty sú: šírka ako násobok \linewidth, menovka, popis a cesta k obrázku. Hodnota 0.8 znamená najviac 80 % šírky dostupného riadku. Obrázok musí existovať na zadanej ceste. Ak neexistuje, makro zobrazí rámček s textom Placeholder, čo pomáha odhaliť chýbajúci súbor bez prerušenia vkladania obrázka.

Zdrojový kód

\code{python}{code:mean}{snippets/mean.py}
\code*{python}{lst:maximum}{snippets/maximum.py}

Argumenty: jazyk pre zvýraznenie syntaxe, menovka a cesta k zdrojovému súboru. \code zobrazí kód s číslami riadkov a označením L1, L2 atď. vedľa bloku. \code* použije plnú šírku a nezvyšuje počítadlo kódových blokov. Cesty musia smerovať na existujúce súbory a kompilácia musí mať správne nastavený minted/Pygments.

Riešenie bežných problémov

  • Chyba pri minted alebo Pygments: skontrolujte, či je nainštalovaný Pygments a či kompilátor používa -shell-escape.
  • Nezobrazuje sa logo: overte hodnotu \orgLogoFooter, existenciu súboru a kompiláciu z koreňového priečinka projektu.
  • Zobrazí sa Placeholder namiesto obrázka: cesta uvedená v \fig je nesprávna alebo obrázok chýba. V dodanom ukážkovom main.tex sa používa demo-image.png, ktorý v zozname súborov tejto šablóny nie je; nahraďte ho vlastným existujúcim obrázkom alebo pridajte súbor na túto cestu.
  • Zmena farieb sa neprejaví: overte, ktorý profil načítava organisation/info.sty, a upravujte významové premenné v aktívnom profile.
  • Odkazy alebo celkový počet slajdov nie sú aktualizované: spustite kompiláciu druhýkrát alebo použite latexmk.
  • Obsah sa nezobrazuje podľa očakávania: skontrolujte, či používate nehviezdičkované príkazy pre sekcie tam, kde sa majú automaticky registrovať do obsahu.

Atribúcia a licencia

Táto šablóna je licencovaná pod medzinárodnou licenciou Creative Commons Attribution 4.0 International (CC BY 4.0).

  • Autor aktuálnej verzie a úprav: Matúš Nečas (október 2026)
  • Pôvodná práca (autor pôvodnej šablóny): Ján Šumský (august 2024) — jan.sumsky@gmail.com