Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- to:navody:asset-server [12.01.2020 14:47]
jitka.novotna
+++ to:navody:asset-server [05.03.2024 17:37] (aktuální)
tomas.hozman1 fix jmen slozek
@@ Řádek 1: / Řádek 1: @@
-Asset-server je to správné místo pro vkládání obrázku. Postará se o jejich resize, ořezání a hlavně jim zařídí hezkou a trvalou adresu s dobrou dostupností.
+====== Asset server =======
-Obrázky nahrajete do složky na mraku a asset-server se postará o zbytek.
+===== Úvod =====
-Na assets-storage je doporučováno nahrávat následující typy souborů
+//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.
-*.jpg *.png *.svg *.pdf
-před nahráním jiných souborů nebo při větší velikosti (>100MB) se poraďte s TO.
-Na mraku je následující struktura
+===== Jak to funguje? =====
-Assets - kam může psát celé TO
-v ní je několik posdskupin př:
+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.
-mo - kam navíc může psát celé MOjihomoravsky - kam piše MO jihomoravského kraje
-praha - kam piše PKS praha
-Pokud chcete přidat dalšiho člověka či skupinu tak se ozvěte v TO. Určitě nezdílejte přes odkaz to by mohlo vést k vážnému bezpečnostnímu riziku.
+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.
-Cokoliv se nahraje na do složky se překopíruje na server. Nejde to smazat můžete to jedině 'přepsat' souborem se stejným jménem a odkazem.
+==== Struktura ====
-Velmi dobře zvažujte názvy souborů. To co je v názku se objeví v url vyhněte se proto mezerám, háčkům velkým písmenům, dlouhým číslům nebo názvům.
+  - 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
+  * 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 |
-Příklady umístněných obrázku:
+Jak je vidět v posledním příkladu, disproporční šířka je ignorována a výsledek má rozměry 168x200 px.
-media storage TO (primy pristup):
+Pokud si přejeme obrázek na požadovanou velikost oříznout, je možné slovo ''resize'' v adrese nahradit slovem ''crop''.
-https://a.pirati.cz/to/img/
-nejaky obrazek bez resizingu:
+| Ořez na šířku 300 px | https://a.pirati.cz/crop/300x-/to/img/it.jpg   |
-https://a.pirati.cz/to/img/it.jpg
+| Ořez na 400x200 px   | https://a.pirati.cz/crop/400x200/to/img/it.jpg |
-ten samy obrazek resizeovany na sirku 200:
+//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í.
-https://a.pirati.cz/resize/200x-/to/img/it.jpg
-ten samy obrazek resizeovany na vysku 200:
+<hidden onHidden="Zobrazit štítek" onVisible="Skrýt  štítek">
-https://a.pirati.cz/resize/-x200/to/img/it.jpg
+---- 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
+----
-ten samy obrazek resizeovany na vysku 200 a pokusem resizovat na sirku 400 :
+</hidden>
-https://a.pirati.cz/resize/400x200/to/img/it.jpg
+Na tento návod odkazují [[?do=backlink|tyto stránky]].
-ano, ta disproporcni sirka je ignorovana
-a ořezávání
-https://a.pirati.cz/crop/400x200/to/img/it.jpg