Asset server

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.

Jednoduše! Obrázky nahrajete do složky na mraku a asset-server se postará o zbytek.

Do úložiště (ve složce Assets) 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.

1. Na mraku si vytvoříte složku pro Assets. Vzhledem k možnosti nastavení oprávnění je vhodné takto vytvořit podsložku ve skupinové složce.
2. Pro projekt si zvolíte vlastní zkratku (pro web např. praha.pirati.cz, pro odbor např. to, mo)
3. Do podatelny TO podáte žádost o vytvoření nové adresy. Do žádosti uvedete následující:
   1. 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)
   2. Zvolenou zkratku
4. 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.pdf
• IMG_1234.Bartoň.jpg
• LOGOTYP.SVG

Příklady dobrých názvů souborů:

• povolebni-strategie-msk.pdf
• barton-opreny-o-strom.jpg
• logotyp-pirati-a-stan.svg

Jako příklad použijeme obrázek uložený TO.

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:

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.

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.