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.
praha.pirati.cz
, pro odbor např. to
, mo
)
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ů:
Příklady dobrých názvů souborů:
Jako příklad použijeme obrázek uložený 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.