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. 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 [https://mrak.pirati.cz mraku] a asset-server
se postará o zbytek.
Do úložiště (asset-storage
) je doporučováno nahrávat následující typy souborů: .jpg
.png .svg
.pdf. 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 [https://redmine.pirati.cz/projects/to/issues/new podatelny TO] podáte žádost o vytvoření nové adresy. Do žádosti uvedete následující: 3.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) 3.2. zvolená zkratka
# Po zpracování žádosti technickým odborem naleznete obsah celé vaší složky (synchronizace jednou za 5 minut) na adrese https://a.pirati.cz/zkratka
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 jménem a odkazem.
Velmi dobře zvažujte názvy souborů, aby byly dobře zapamatovatelné a napsatelné. 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 dobrých názvů souborů: * povolebni-strategie-msk.pdf * barton-opreny-o-strom.jpg * logotyp-pirati-a-stan.svg
Syntaxe
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 * 'úprava obrázku
' * 'změna velikosti
' - provádí se přidáním 'resize/WxH
' do odkazu na obrázek, kdy W je šířka obrázku v pixelech a H výška. Při změně velikosti se nemění poměr stran. * šíř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 * pokus o šířka 400 px a výška 200 px - https://a.pirati.cz/resize/400x200/to/img/it.jpg - disproporční šířka je ignorována (výsledek je 168×200 px)
<pre>* ořezávání - provádí se přidáním crop/WxH do odkazu
- ořez na 400×200 px - https://a.pirati.cz/crop/400x200/to/img/it.jpg</pre>
Asset-server lze nastavit od jekyll-theme-pirati verze 7.7.0 a používaji ho i některé dalši weby. Můžete jen používat i pro přímé odkazování. #### 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 [https://redmine.pirati.cz/projects/to/issues/new podatelny TO] podáte žádost o vytvoření nové adresy. Do žádosti uvedete následující: 3.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) 3.2. zvolená zkratka
# Po zpracování žádosti technickým odborem naleznete obsah celé vaší složky (synchronizace jednou za 5 minut) na adrese https://a.pirati.cz/zkratka
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 jménem a odkazem.
Velmi dobře zvažujte názvy souborů, aby byly dobře zapamatovatelné a napsatelné. 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 dobrých názvů souborů: * povolebni-strategie-msk.pdf * barton-opreny-o-strom.jpg * logotyp-pirati-a-stan.svg
Syntaxe
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 * 'úprava obrázku
' * 'změna velikosti
' - provádí se přidáním 'resize/WxH
' do odkazu na obrázek, kdy W je šířka obrázku v pixelech a H výška. Při změně velikosti se nemění poměr stran. * šíř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 * pokus o šířka 400 px a výška 200 px - https://a.pirati.cz/resize/400x200/to/img/it.jpg - disproporční šířka je ignorována (výsledek je 168×200 px)
<pre>* ořezávání - provádí se přidáním crop/WxH do odkazu
- ořez na 400×200 px - https://a.pirati.cz/crop/400x200/to/img/it.jpg</pre>
Asset-server lze nastavit od jekyll-theme-pirati verze 7.7.0 a používaji ho i některé dalši weby. Můžete jen používat i pro přímé odkazování.