Nav apraksta

xnecas c4bb2af88d Updated README v3 3 nedēļas atpakaļ
organisation a5cefb1d3e Updated README 3 nedēļas atpakaļ
snippets acf6333b48 First Commit 1 mēnesi atpakaļ
styles acf6333b48 First Commit 1 mēnesi atpakaļ
README.md c4bb2af88d Updated README v3 3 nedēļas atpakaļ
main.tex acf6333b48 First Commit 1 mēnesi atpakaļ
uni.sty acf6333b48 First Commit 1 mēnesi atpakaļ

README.md

UNIZA Beamer – prezentačná šablóna

LaTeXová šablóna pre tvorbu prezentácií v prostredí Beamer 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 demo prezentácia a zároveň ako praktický katalóg dostupných príkazov.

Obsah

1. Kompilácia online cez Overleaf (odporúčaná možnosť)

Prezentáciu môžete skompilovať priamo v prehliadači bez lokálnej inštalácie LaTeXu, Pythonu alebo Pygments.

  1. Stiahnite ZIP archív Uni_Presentation_Template_with_README.zip z repozitára alebo miesta, kde je šablóna zverejnená. Archív nerozbaľujte.
  2. Prihláste sa do Overleafu a na stránke projektov zvoľte New Project → Upload Project.
  3. Nahrajte ZIP archív. Overleaf rozbalí súbory a zachová priečinky ako styles/, organisation/ a snippets/.
  4. Otvorte nastavenia projektu a skontrolujte, že ako hlavný dokument (Main document) je zvolený main.tex. Ako kompilátor zvoľte pdfLaTeX, ak už nie je vybraný automaticky.
  5. Kliknite na Recompile. Po úspešnej kompilácii si hotový súbor stiahnete cez Download PDF.

Šablóna používa balík minted na zvýrazňovanie zdrojového kódu. Overleaf ho podporuje bez toho, aby ste si na svojom počítači museli inštalovať Python alebo Pygments. Ak sa kompilácia nepodarí, najprv skontrolujte, či je ako hlavný dokument nastavený main.tex, a pozrite si prvú chybu v logu kompilácie.

Užitočné návody: nahratie ZIP projektu do Overleafu a zvýrazňovanie kódu pomocou minted.

2. Potrebné nástroje pri lokálnej kompilácii

  • 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 pomocné nástroje na zvýrazňovanie syntaxe.

3. Lokálna 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. Pri lokálnej kompilácii sa uistite, že máte správne nainštalované balíky a povolený shell escape.

Výstupom je súbor main.pdf.

Ako zmeniť organizáciu, farby a logo

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

\input{organisation/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/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}

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.

Aktuálne podporované témy:

  1. UNIZA,
  2. FEIT-UNIZA,
  3. KRIS-FEIT-UNIZA.

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.

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