Toto je starší verze dokumentu!
Asset server
Úvod
asset-server slouží k publikování dříve uložených obrázků na webu. Vhodným formátováním odkazu dokáže obrázek upravit na požadovanou velikost, případně oříznout, opravené obrázky zůstavají v cache 10 minut. Díky asset-serveru navíc získáte přímý odkaz na daný obrázek.
Jak to funguje?
Jednoduše! Obrázky nahrajete do složky na mraku a asset-server se postará o zbytek.
Do úložiště (asset-storage) je doporučováno nahrávat obrázky (nejlépe ve formátech JPEG, PNG, SVG), ale také dokumenty (například PDF či ODT, ODS, DOCX, XLSX). Před nahráním jiných souborů nebo při souborech větší velikosti (>100 MB) se poraďte s TO.
Struktura
- Na mraku si vytvoříte složku pro asset-storage. Vzhledem k možnosti nastavení oprávnění je vhodné takto vytvořit podsložku ve skupinové složce.
- Pro projekt si zvolíte vlastní zkratku (pro web např.
praha.pirati.cz
, pro odbor např.to
,mo
) - Do podatelny TO podáte žádost o vytvoření nové adresy. Do žádosti uvedete následující:
- Popis složky na mraku (přesná specifikace - název group folder nebo uživatelské jméno v případě soukromé složky a název složky)
- Zvolenou zkratku
- Po zpracování žádosti technickým odborem naleznete obsah celé vaší složky na adrese
a.pirati.cz/zkratka
. Synchronizace probíhá jednou za 5 minut.
Cokoliv se nahraje do složky se překopíruje na server. Tyto soubory nelze smazat, ale můžete je přepsat souborem se stejným názvem.
Velmi dobře zvažujte názvy souborů, aby byly dobře zapamatovatelné a zapsatelné. Název obrázku bude součástí URL, vyhněte se proto mezerám, háčkům velkým písmenům, dlouhým číslům nebo názvům.
Příklady špatných názvů souborů:
Povolební strategie MSK.pdfIMG_1234.Bartoň.jpgLOGOTYP.SVG
Příklady dobrých názvů souborů:
- povolebni-strategie-msk.pdf
- barton-opreny-o-strom.jpg
- logotyp-pirati-a-stan.svg
Syntax
Jako příklad použijeme obrázek uložený v media storage TO.
Odkaz do složky na asset-serveru | https://a.pirati.cz/to/img/ |
Odkaz přímo na obrázek (plná velikost) | https://a.pirati.cz/to/img/it.jpg |
Pro úpravu velkosti obrázku přidáme do adresy resize/WxH
, kde W
je požadovaná šířka a H
požadovaná výška obrázku v pixelech. Při změně velikosti se nemění poměr stran. Například:
Šířka 200 px | https://a.pirati.cz/resize/200x-/to/img/it.jpg |
Výška 200 px | https://a.pirati.cz/resize/-x200/to/img/it.jpg |
Šířka 400 px a výška 200 px | https://a.pirati.cz/resize/400x200/to/img/it.jpg |
Jak je vidět v posledním příkladu, disproporční šířka je ignorována a výsledek má rozměry 168×200 px.
Pokud si přejeme obrázek na požadovanou velikost oříznout, je možné slovo resize
v adrese nahradit slovem crop
.
Ořez na šířku 300 px | https://a.pirati.cz/crop/300x-/to/img/it.jpg |
Ořez na 400×200 px | https://a.pirati.cz/crop/400x200/to/img/it.jpg |
Asset-server lze nastavit od jekyll-theme-pirati
verze 7.7.0
a používaji ho i některé dalši weby. Můžete jej používat i pro přímé odkazování.
Na tento návod odkazují tyto stránky.