Nasazení vzhledu v Primo

Tato stránka je určena pracovníkům členských knihoven konsorcia CARDS, kteří mají v aplikaci Alma roli správce discovery. Technické znalosti nejsou potřeba: téma se nahrává jako hotový balíček.

Rozsah tohoto návodu: Balíček ke stažení obsahuje logo knihovny, její hlavní barvu a patičku (footer) povinné publicity. Patička se nasadí spolu s balíčkem. Pokud má vaše univerzita vlastní patičky, její balíček žádnou neobsahuje a o povinnou publicitu se staráte sami. Některé balíčky navíc obsahují favicon. Kompletní téma s typografií a jednotným vzhledem jednotlivých obrazovek se teprve navrhuje. Pokud vám cokoliv v obsahu balíčku nevyhovuje nebo nefunguje, ozvěte se prosím na Servisní centrum PNG.

Co je Next Discovery Experience

Next Discovery Experience (NDE) je nové vyhledávací rozhraní Primo VE od dodavatele Ex Libris Clarivate. Nahrazuje starší rozhraní Primo VE a je postavené na technologii Angular.

Jeho vzhled řídí sada systémových proměnných, které je možné přepsat vlastním CSS. Přesně to balíček dělá: nemění chování rozhraní, pouze jeho vzhled. Garantem designu je konsorcium CARDS, které připravuje témata pro všechny členské knihovny.

Co balíček obsahuje

Co se změní	Popis
Logo knihovny	Nahradí výchozí logo dodavatele v záhlaví stránky.
Hlavní barva	Projeví se na barevně zvýrazněných prvcích: tlačítkách, aktivních polích, odkazech
Barva textu na barevné ploše	Bílá, aby text zůstal čitelný.
Patička povinné publicity	Doplní na konec úvodní stránky logolinku EU a ministerstva, v české i anglické verzi.
Favicon	Ikona na záložce prohlížeče. Zatím jen v některých balíčcích.

Vše ostatní, tedy písmo, rozvržení i barvy ploch, zůstává ve výchozím nastavení dodavatele. Je to záměr: první fáze má být rychlá, bezpečná a nemá zasahovat do chování rozhraní.

Postup v šesti krocích

1. Vyberte knihovnu a téma

Výběr témat prozatím najdete na stránce dokumentace Primo na webu Design Systemu, zatím v alfa verzi. Vyhledejte svou knihovnu. U každého záznamu je vidět logo, hlavní barva a kód Primo view, který budete potřebovat později.

Dokumentace je zatím v alfa verzi a dostupná jen ze sítě NTK nebo přes VPN. Nemáte-li k ní přístup, napište si o balíček do Redmine servisního centra a pošleme vám jej. Veřejnou verzi dokumentace očekáváme do konce roku 2026.

2. Stáhněte balíček

Tlačítkem Download stáhnete ZIP s názvem ve tvaru primo-nde-<téma>-v<verze>.zip. Nerozbalujte jej, do Alma se nahrává celý archiv.

Stáhněte vždy balíček sestavený pro to view, na které nahráváte. Balíčky nejsou zaměnitelné: cesty k obrázkům jsou v nich zapsané už při sestavení a přejmenování složky v archivu je nespraví.

3. Zjistěte, co už na view běží

Nahrání balíčku přepíše celou složku vašeho view. Každý soubor, který view zobrazuje a který není v nahrávaném archivu, se smaže, bez varování a bez přehledu změn.

Pokud si nejste jisti, co vaše view zobrazuje, napište do Redmine servisního centra a nechte si to ověřit. Nahrávejte až potom.

4. Nahrajte balíček pro Primo do aplikace Alma

Přihlaste se do aplikace Alma s oprávněním správce discovery.
Otevřete Discovery → Display Configuration → Manage Customization Package.
Vyberte kód view své knihovny, například 420CARDS_NTK:NTK nebo 420CARDS_VUT:VUT.
Nahrajte archiv ZIP a klikněte na Publish. Bez publikování je balíček sice uložený, ale navenek se neprojeví.

Nastavení najdete v administračním rozhraní Alma Back Office, pod ikonou ozubeného kola vpravo nahoře.

5. Ověřte výsledek

Otevřete veřejnou adresu svého view, například https://discovery.techlib.cz/nde/home?vid=420CARDS_NTK:NTK, a načtěte stránku znovu bez mezipaměti: Ctrl+Shift+R, na Macu ⌘⇧R. V záhlaví má být logo knihovny a na zvýrazněných prvcích hlavní barva.

6. Když se nic nezměnilo

Typickým příznakem je, že v záhlaví zůstalo výchozí logo dodavatele. Projděte postupně:

Klikli jste na Publish, nebo jste balíček jen nahráli?
Souhlasí kód view znak po znaku? Rozlišují se velká a malá písmena: správně je 420CARDS_NTK:NTK, nikoli 420cards_ntk:ntk.
Načetli jste stránku znovu bez mezipaměti?
Zkuste balíček nahrát a publikovat znovu. Pole Currently active v aplikaci Alma ukazuje, který balíček je právě v provozu.

Pokud nepomůže nic z toho, založte požadavek v Redmine servisního centra a uveďte kód view a čas nasazení.

Nastavení v Alma a balíček spolu souvisí

Obě vrstvy působí naráz. V aplikaci Alma se nastavuje obecné téma, tedy hrubá barevnost rozhraní; balíček nad ním doladí detaily – logo, přesný odstín hlavní barvy a patičku. Nesedí-li barva, projděte obě vrstvy: nejdřív nastavení view v aplikaci Alma, potom balíček. Nevíte-li si rady, napište do Redmine servisního centra.

Patička povinné publicity

Součástí každého balíčku je patička s logolinkou Evropské unie a Ministerstva školství, mládeže a tělovýchovy. Nasadí se sama a není na ní co nastavovat. Zobrazuje se na úvodní stránce view, ne ve výsledcích vyhledávání.

Je to plnění povinnosti vyplývající z financování projektu, ne dekorace. Pravidla, co se s ní smí a nesmí dělat, jak ověříte, že se zobrazuje, a co dělat, když se logolinka nenačte, najdete na stránce Povinná publicita v katalogu.

Hranice podpory

Dodavatel Clarivate nepodporuje vlastní kód v rozhraní NDE. Řešení potíží s tématem je tedy na nás, ne na dodavateli.

Nepoužívejte nástroj Primo Studio. Je určený pro starší rozhraní Primo VE a s NDE nefunguje. Náhled se sice vykreslí, ale nahraný balíček se nikdy nepoužije. Dodavatel to ve své dokumentaci potvrzuje.

Co se připravuje

Následující věci hotové nejsou. Uvádíme je, aby bylo zřejmé, co čekat, nikoli jako závazek termínu.

Kompletní téma – typografie, barvy ploch a jednotný vzhled jednotlivých obrazovek. Ve fázi návrhu. Metoda implementace a aktualizací ještě také není jasná.
Klíčové komponenty – vyhledávací pole, výsledky vyhledávání, dostupnost dokumentu, přihlášení a čtenářské konto. Návrhy vznikají.
Favicon – ikona na záložce prohlížeče. Zatím není v každém balíčku.
Otevírací doba – doplněk zobrazující otevírací dobu na úvodní stránce s jednoduchou změnou. Máme funkční prototyp, zprovoznění se plánuje.
Automatizovaná kontrola vzhledu před vydáním – automatická kontrola proti živému rozhraní při každém vydání, aby aktualizace od dodavatele nerozbila téma nepozorovaně.

Aktuální stav nasazení jednotlivých knihoven najdete na stránce Phase 1 rollout pod NTK VPN.

Máte dotaz nebo potřebujete nové téma

Založte požadavek v Redmine servisního centra.