Přehled značek

Viz také další fakultně specifické značky.

E-mailová adresa

fi-email
Tato komponenta umožňuje vložit na stránku e-mail ve tvaru, který se do čitelné podoby předělá pouze pomocí JavaScriptu. Tímto způsobem se zabrání většině spambotům e-mailovou adresu ze stránky přečíst a posílat na ni nevyžádanou poštu.

Adresy se zadávají v atributech to, cc a bcc. Každá adresa může mít tvar

• user@example.com
• 'Jmeno Prijmeni' <user@example.com> (znaky < a > zapište jako &lt; resp. &gt;)

V každém atributu může být více adres oddělených čárkou. Tělo elementu se pak zobrazí jako text odkazu. Pro prázdné tělo se použije obsah atributu to.

Povinné atributy

to="ADRESY"

Adresy příjemců.

Nepovinné atributy

cc="ADRESY"

Kopie e-mailu.

bcc="ADRESY"

Skryté kopie.

subject="TEXT"

Předvyplněný předmět zprávy. Uživatel může tento předmět změnit, nelze na něj proto spoléhat.

icon

Zobrazit ikonu obálky před adresou.

Příklady

<fi-email to="john.doe@example.com"/>

<fi-email icon to="john.doe@example.com"/>

<fi-email to="'John Doe' &lt;john.doe@example.com&gt;"/>

<fi-email to="'John Doe' &lt;john.doe@example.com&gt;">John Doe</fi-email>

<fi-email to="john.doe@example.com,jane.doe@example.com"/>

<fi-email to="john.doe@example.com" cc="jane.doe@example.com"/>

Osoba na fakultě

fi-person
Vloží jméno osoby z ISu včetně titulů. Jméno nebo tituly se při změně automaticky aktualizují, není třeba kontakt přepisovat. Jméno může odkazovat do neautentizovaného ISu, na osobní stránku na webu MU nebo na soukromou stránku osoby odkazovanou pomocí URL.

Povinné atributy

právě jeden z:

uco="UCO"

UČO osoby.

login="LOGIN"

Fakultní login osoby.

Nepovinné atributy

titles="no"

Jméno osoby zobrazit bez titulů.

href="(@IS|@MUNI|URL)"

Jméno osoby bude klikací.

• @IS vygeneruje odkaz do neautentizované sekce ISu.
• @MUNI vygeneruje odkaz do stránek MU.
• Jinak se použije odkaz zadaný jako URL.

db="(fi|is)"

Databáze pro zdroj dat.

• fi je databáze Fakultní administrativy.
  Toto je výchozí hodnota pro login. Podporuje vstup uco i login. Po zrušení záznamu nebude odkaz fungovat. Záznam se ruší typicky několik let po skončení studia nebo pracovního poměru.
• is je databáze IS MU.
  Toto je výchozí hodnota pro uco. Nelze použít s login.

Příklady

<fi-person uco="396157"/>

<fi-person login="xlacko1"/>

<fi-person uco="396157" titles="no"/>

<fi-person uco="396157" href="@IS"/>

<fi-person uco="396157" href="@MUNI"/>

<fi-person uco="396157" href="https://fi.muni.cz/~xlacko1"/>

Aktuality a akce

fi-news
Vloží do stránky aktuality a akce z požadovaných zdrojů (vývěsky ISu nebo kategorie Magazínu M).

Povinné atributy

page="SOURCE"

Zdroje aktualit, viz níže.

count="(L,M,S,XS|N)"

Nejvyšší počet aktuálních zpráv, které se mají zobrazit. Lze zadat zvlášť pro čtyři velikosti obrazovky, nebo jednotně.

Nepovinné atributy

layout="(article|calendar|timeline|simple)"

Rozložení a tvar:

• simple: jednoduchý textový výpis, zobrazí akce i aktuality
• article: (výchozí hodnota) zobrazí pouze aktuality (zprávy bez vyplněného data konání)
• calendar: zobrazí pouze akce (zprávy s datem konání) v kalendářové podobě
• timeline: zobrazí akce ve formě časové osy

Viz i příklady.

type="(news|events|all)"

Vynutí zobrazování konkrétního typu:

• news: aktuality (zprávy bez data)
• events: akce (zprávy s datem konání)
• all: všechny zprávy bez ohledu na omezení v hodnotě layout.

Pozor, některé kombinace layout a type nemusí dávat smysl a v nejhorším případě můžou způsobit chybu zobrazení stránky.

Přenos aktualit

Aktuality se k nám synchronizují jednou za hodinu (jak z ISu, tak z Magazínu M). U zpráv na vývěsce je pro jejich přenos k nám ještě nutné, abyste byli správcem dané sekce vývěsky a při jejich editaci povolili zobrazování na webu FI (dostupné po rozbalení více možností). Pokud správcem nejste nebo tam tyto možnosti nevidíte, ale myslíte, že byste měli, obraťte se na istech@fi.muni.cz.

Řazení aktualit

Parametr layout určuje také pořadí zobrazovaných zpráv. U všech typů kromě article se zprávy řadí chronologicky (starší zprávy před novějšími), u article obráceně (novější zprávy před staršími).

Přesněji, chronologické řazení je dáno primárně datem konání (není-li definováno, použije se datum 2999) vzestupně. V případě shody data konání se sekundárně řadí dle data zveřejnění zprávy, také vzestupně.

Přehled vlastností rozložení

(¹) Tyto lze změnit atributem type.

Zdroje aktualit

Do atributu page zadejte zkratku zdroje zpráv z tabulky níže. Můžete zadat i více zdrojů, ty oddělte čárkou (bez mezer).

Příklady

výchozí rozložení (stejné jako layout="article")

<fi-news page="mu-sci,mu-stud" count="4"/>

rozložení calendar

<fi-news page="title" count="4" layout="calendar"/>

rozložení timeline

<fi-news page="bcmgr" count="2" layout="timeline"/>

rozložení simple

<fi-news page="mu-sci" count="2" layout="simple"/>

Komise pro státní závěrečné zkoušky

fi-programme-committees
Tato komponenta umožňuje vypsat předsedy a členy komisí pro státní závěrečné zkoušky.

Příklady

<fi-programme-committees/>

Bližší ukázky použití můžete vidět na stránce Komise pro státní závěrečné zkoušky bakalářských a magisterských studijních programů (pro studia započatá od akademického roku 2019/2020).

Ocenění

fi-awards
Tato komponenta umožňuje vypsat závěrečné práce, které získaly ocenění děkana FI.

Povinné atributy

type="TYP"

Typ závěrečných prací, které mají být zobrazeny. TYP může být bc-mgr pro bakalářské a magisterské práce nebo phd pro disertační práce.

Nepovinné atributy

year="ROK"

Rok, ve kterém byly uděleny dané ocenění. Pokud rok není uveden, budou vypsány všechny uděleny ocenění daného typu seřazeny podle roku.

Příklady

<fi-awards year="2019" type="bc-mgr"/>

<fi-awards year="2019" type="phd"/>

<fi-awards type="phd"/>

Bližší ukázky použití můžete vidět na stránkách Vynikající disertační práce nebo Ceny děkana studentům.

Galerie

fi-gallery, fi-photo, fi-image
Galerii obaluje značka fi-gallery. Každý potomek je pak fi-image – libovolný obrázek (jako img) nebo fi-photo – fotka z galerie. Po kliknutí na obrázek v galerii se spustí prezentace, ve které se dá pohybovat klikáním na šipky po pravé nebo levé straně obrázku, případně také šipkami na klávesnici. Obrázek z galerie popisují dva řetězce, ALBUM a ID. Tato čísla lze vyčíst z URL obrázku, např. v URL

https://www.fi.muni.cz/app/gallery/04200022/018

poslední část URL 04200022/018 znamená, že číslo alba je 04200022 a ID obrázku je 018.

Nepovinné atributy pro fi-gallery

album="ALBUM"

Výchozí číslo alba pro fotky v galerii.
Potomci fi-photo pak nemusí toto číslo specifikovat.

size="VELIKOST"

Responzivní velikost galerie, výchozí je default.

max-items="POČET"

Maximální počet obrázků, které se mají zobrazit v náhledu.
Pokud je obrázků více, vygeneruje se po posledním zpráva informující o počtu ukrytých obrázků. Tato zpráva respektujte počet obrázků (1 obrázek, 2 obrázky atd.) a jazyk.

Atributy pro fi-photo

album="ALBUM"

Číslo alba, ze kterého fotka pochází. Není povinné pokud rodičovský element fi-gallery tento atribut má.

photo="ID"

Povinné ID fotografie z galerie.

Atributy pro fi-image

Lze použít stejné atributy jako pro HTML značku img.

Jaké to jsou? Viz například MDN web docs.

title="TEXT"

Nadpis obrázku, který se zobrazí v prezentaci. Pokud není zadán, použije se obsah povinného atributu alt.

caption="TEXT"

Delší popis obrázku.

thumbnail="URL"

Obrázek, který se má použít v náhledu.
Ideální rozměry jsou 270 x 150 pixelů, pokud použijete obrázek z aplikace Soubory, pak se náhled vygeneruje automaticky.

Příklady

<fi-gallery album="01300163">
    <fi-photo photo="007"></fi-photo>
    <fi-photo photo="010"></fi-photo>
    <fi-photo album="divadlo" photo="0022"></fi-photo>
    <fi-image src="/files/unix/news-generic-1.jpg" alt="FI"></fi-image>
</fi-gallery>

První a druhý obrázek jsou z alba 01300163 (nastaveno značkou fi-gallery), třetí obrázek je z alba divadlo, čtvrtý není z galerie, ale jde o vlastní obrázek uložený v aplikaci Soubory fakultní Wiki.

<fi-gallery fi-gallery album="01300260" max-items="4">
    <fi-photo photo="001"></fi-photo>
    <fi-photo photo="002"></fi-photo>
    <fi-photo photo="003"></fi-photo>
    <fi-photo photo="004"></fi-photo>
    <fi-photo photo="005"></fi-photo>
    <fi-photo photo="006"></fi-photo>
    <fi-photo photo="007"></fi-photo>
    <fi-photo photo="008"></fi-photo>
    <fi-photo photo="009"></fi-photo>
    <fi-photo photo="010"></fi-photo>
    <fi-photo photo="011"></fi-photo>
    <fi-photo photo="012"></fi-photo>
</fi-gallery>

Náhled obsahuje pouze 4 obrázky díky atributu max-items a objeví se text, který informuje, kolik obrázků není zobrazeno. V galerii se ovšem objeví všech 12 obrázků.

Celá galerie obsahuje dalších 8 obrázků

Automaticky škálovatelný obrázek

Značka fi-picture umožňuje vygenerovat různé velikostní varianty obrázku. Tento obrázek musí být uložen v aplikaci Soubory, varianty obrázků z jiných zdrojů generovat nelze.

Velikosti obrázků se vybírají podle pravidel v nastavení rules. Prohlížeč pak podle šířky stránky vybere jednu z variant obrázku.

Povinné atributy

src="URL"

Cesta k obrázku stejně jako pro značku img. Pokud cesta nevede na obrázek v aplikaci Soubory, velikostní varianty se nevygenerují.

alt="TEXT"

Popis obrázku stejně jako pro značku img.

Nepovinné atributy

rules="(TEXT|RULE1 RULE2 …)"

Buď název přednastavení nebo seznam pravidel (níže).

width="INTEGER"

height="INTEGER"

Šířka a výška obrázku stejně jako pro img. Tyto se použijí pro výchozí obrázek, pokud prohlížeč nevybere žádný velikostní variant.

Pravidla

Nejjednodušší možnost pro pravidla je použití přednastavení. Jako hodnotu rule uveďte jedno z:

news

Velikostní varianty pro zprávy, tedy 4, 2 nebo 1 sloupec podle šířky stránky. Základní obrázek by měl mít šířku alespoň 610 px.

timeline-box-img

Velikostní varianty pro časovou osu s obrázkem. Základní obrázek by měl mít šířku alespoň 370 px.

Vlastní nastavení velikostí lze zadat jako seznam pravidel oddělených mezerou. Každé pravidlo je dvojice čísel ve tvaru PAGE:IMAGE, kde PAGE je minimální šířka stránky v px a IMAGE je pak šířka obrázku v px, který se má použít. Pokud obrázek nemá nastaven atribut width, pak musí být poslední pravidlo tvaru 0:IMAGE nebo zkráceně pouze jedno číslo, IMAGE. To se použije se jako výchozí velikost.

Prohlížeč bude pravidla interpretovat postupně. Pro první pravidlo PAGE:IMAGE, pro které má aktuální zobrazení stránky šířku alespoň PAGE, vybere prohlížeč obrázek šířky IMAGE.

Příklady

<fi-picture src="/files/webmaster/news-generic-1.jpg" alt="FI" rules="news"></fi-picture>

Obrázek vhodný pro zobrazení pro zprávy.

<fi-picture src="/files/webmaster/news-generic-1.jpg" alt="FI" rules="1024:300 600:600 150"></fi-picture>

Ukázka explicitních pravidel. Vybere se první vyhovující pravidlo:

• Pro stránku šířky alespoň 1024 px se použije obrázek šířky 300 px.
• Pro stránku šířky alespoň 600 px se použije obrázek šířky 600 px.
• Jinak se vybere obrázek šířky 150 px.

Pokud budete zmenšovat a zvětšovat okno prohlížeče, měli byste vidět změny.