Vítejte v návodu pro administraci krajského webu jihomoravského sdružení Pirátské strany

• náš projekt na Githubu: https://github.com/pirati-web/jihomoravsky.pirati.cz
• adresa webu: https://jihomoravsky.pirati.cz (master branch na GitHubu)
• náhled webu: https://pirati-web.github.io/jihomoravsky.pirati.cz (gh-pages branch)
• zkratka pro náhled webu: bit.ly/piratijmk

• adresa pro administraci přes CMS: https://pirati-web.github.io/jihomoravsky.pirati.cz/admin

• články se nacházejí v adresáři _posts
• profily lidí se nachází v _people
• samostatné stránky v _landing
• obrázky se nacházejí v /assets/img/...
  • obrázky profilů v /assets/img/people/
  • obrázky ke článkům v /assets/img/posts/ atp.

Postup pro editaci v Githubu

1. Je třeba vytvořit si svůj účet v GitHubu a zažádat si o práva k zápisu
2. Přihlásit se a přejít na https://github.com/pirati-web/jihomoravsky.pirati.cz
3. Výběr branche - defaultně je zvolena gh-pages - screenshot
4. proveďte vaše změny
   • nalezení a úprava požadovaného souboru - screenshoty
   • nebo vytvoření nového souboru v příslušném adresáři - screenshot
   • nebo nahrání souboru (např. obrázku) z disku screenshoty
5. dole popište vaše změny a potvrďte Commit changes - screenshot
6. Počkejte cca 20 sekund, než GitHub zkompiluje vaše změny do statického HTML
7. Ověřte na bit.ly/piratijmk, jak se vaše změny v branchi gh-pages odrazily na podobě webu, v případě chyb je opravte
8. Pokud je upravený web v gh-pages branchi v pořádku, přepněte se do master branche a proveďte merge gh-pages do mastera - screenshoty:
   • V GitHubu klikneme na New pull request
   • Na Compare changes stránce vybereme base: master a compare: gh-pages
   • Klikneme na Create pull request
   • Klikneme na Merge pull request
   • Klikneme na Confirm merge

Struktura článků

• Snažte se využívat kopírování a úpravy existujících stránek

• článek v sekci _posts musí obsahovat hlavičku:

    ---
    layout: blog
    category: CLANKY
    title: "Titulek v uvozovkách"
    date: 2017-05-26T01:00:00.000Z # datum MUSÍ být ve formátu YYYY-MM-DDT01:00:00.000Z
    author: Markéta Gregorová # jméno, které se zobrazí pod titulkem
    authorId: marketa.gregorova # ID osoby s profilem ve formátu jmeno.prijmeni (tento řádek je nepovinný)
    image: /assets/img/posts/market-u-vodotrysku-g.jpg # odkaz na obrázek ideálně s výškou 420px
    description: >-
      Autorský zákon nejen nepomáhá, ale šikanuje i všechny ostatní. Kolektivní
      správci smí vybírat poplatky a udělovat licence i jménem autorů, které
      nezastupují. Pro každou zastupovanou skupinu může existovat jen jeden správce,
      tedy je uzákoněn monopol.
    tags: kopírovací-zákon autorský-zákon kopírovací-monopol OSA Intergram # tagy jsou oddělěny mezerou
    ---
  

Tipy pro pokročilé:

• Samostatné stránky se nacházejí v adresáři landing. Obsahují parametr permalink obsahující jejich přímou adresu
• Články lze upravovat rovněž přes administrační rozhraní (po přihlášení vašim GitHub účtem) vyvinuté Václavem Klecandou. Může to být pohodlnější přes to, že v něm nefunguje zobrazování obrázků a náhled WYSIWYG editoru je nepřesný.
• V těle článků lze kromě Markdownu (viz níže) využívat i rovnou HTML.
• Celý web je zkopírován z webu celostátního, jehož administrace stylů je dost šílená. Všechny úpravy stylu pro krajský web se nachází v souborech /_sass/jmk-custom.scss a /_sass/jmk-custom-landing.scss
• Úpravy webu lze navrhovat i bez příslušných práv vytvořením pull requestu - screenshot
• Web je možné rozjet na lokální instanci ve vašem počítači, je k tomu třeba Ruby a Jekyll (ideálně v Linuxu, dá se to ale rozjet i ve Windows 10 díky Ubuntu konzoli). Úpravy pak můžete testovat přímo u sebe před commitnutím do branche.

Kramdown syntax

• Těla *.md souborů používají specifickou verzi Markdownu zvanou Kramdown.
• Oficiální dokumentace: https://daringfireball.net/projects/markdown/syntax
• Pískoviště pro experimenty: http://markdownlivepreview.com/

Níže následuje nekompletní seznam prvků, které je možné v těle článků využít a jejich zápis v Markdownu.

Hlavní nadpis

# Hlavní nadpis

Nadpis druhé úrovně

## Nadpis druhé úrovně

Nadpis třetí úrovně

### Nadpis třetí úrovně

Odkaz na www.pirati.cz

 [Odkaz na www.pirati.cz](http://www.pirati.cz)

Odkaz na www.pirati.cz v novém okně

[Odkaz na www.pirati.cz v novém okně](http://www.pirati.cz){:target="_blank"}

Odstavec s tučným textem a kurzívou.

Další odstavec.

Odstavec s **tučným textem** a *kurzívou*.

Další odstavec.

![Obrázek s kočičkou](http://lorempixel.com/660/200/cats/)

• Položka nečíslovaného seznamu

• Druhá položka nečíslovaného seznamu

  Další odstavec druhé položky

• Třetí položka nečíslovaného seznamu

    * Položka nečíslovaného seznamu
    * Druhá položka nečíslovaného seznam  
  
      Další odstavec druhé položky
    * Třetí položka nečíslovaného seznamu
  

1. Položka nečíslovaného seznamu

2. Druhá položka nečíslovaného seznamu

   Další odstavec druhé položky

3. Třetí položka nečíslovaného seznamu

    1. Položka nečíslovaného seznamu
    2. Druhá položka nečíslovaného seznamu
   
       Další odstavec druhé položky
    3. Třetí položka nečíslovaného seznamu
   

Citace. Haxx0r ipsum dereference tunnel in printf for overflow over clock ip default afk access L0phtCrack . continue grep false mountain dew data hello world. It’s a feature ssh spoof case Trojan horse warez try catch. Stack trace eaten by a grue big-endian d00dz private strlen.

> Citace. Haxx0r ipsum dereference tunnel in printf for overflow over
clock ip default afk access L0phtCrack *.* continue grep false mountain
dew data hello world. It's a feature ssh spoof case Trojan horse warez
try catch. Stack trace eaten by a grue big-endian d00dz private strlen.

| Tabulka | druhý sloupec | třetí sloupec |
| výdaje státu (včetně důchodců 0,52) | 1,25 | nějaké číslo |
| zisky (z toho 0,4 do zahraničí) | 0,9 | jiné číslo |
| přebytek obch. bilance | 0,4 | ještě |
| kapitalizace a nákl. financování | 1,2 | další |
| HDP | 4,75 | číslo |