Návod k administraci pirátského webu

07. 11. 2017

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

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

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

![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 (nefunguje v preview) 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
| 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 |
Sdílení je aktem lásky
Kam dále?
Podpořte nás!
Navrhni úpravu