====== 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 [[https://mrak.pirati.cz/apps/files/files/440387?dir=/Assets|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.

==== Struktura ====

  - 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.
  - 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í:
    - 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ů:

  * <del>Povolební strategie MSK.pdf</del>
  * <del>IMG_1234.Bartoň.jpg</del>
  * <del>LOGOTYP.SVG</del>

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ý 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 168x200 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 400x200 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í. 

<hidden onHidden="Zobrazit štítek" onVisible="Skrýt  štítek">
---- dataentry navod ----
složka_page : to:start
osoba_page  : lide:jitka.novotna # člověk nebo funkce zodpovědný za údržbu návodu
adresáts    : člen, ověřený příznivce, správce webu, člen, oblastní předsednictvo # vymezení osob, jimž je návod určen
tags        : obrázky, mrak, weby # seznam kategorií (tagů), kterých se návod týká
stav_wiki   : <color green>aktuální</color> # informace o kvalitě návodu green-aktuální, orange-nedostatky, red-k nepotřebě
aktualizace : 14.02.2020 # datum poslední aktualizace textu návodu
----

</hidden>
Na tento návod odkazují [[?do=backlink|tyto stránky]].