Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pirati-web/stredocesky.pirati.cz


https://github.com/pirati-web/stredocesky.pirati.cz

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README 

        
# Pirátský web Stredočeského kraje - stredocesky.pirati.cz



* pokud je to možné, je lepší použít Markdown (.md) formát než html

* pokud kód nemůžete otestovat na lokále (stažení celého repa, build a spuštění v jekyllu), dělejte jen drobné změny, kterým rozumíte

* obecně k pirátským šablonám: https://github.com/pirati-web/jekyll-theme-pirati/blob/master/USAGE.md

* další repository pro inspiraci: https://github.com/pirati-web

* další informace a návody k pirátským jekyllům: https://wiki.pirati.cz/to/navody/jekyll-weby a https://github.com/pirati-web/zlinsky.pirati.cz/blob/master/readme.md

* web je dostupný i přes hostname stc.pirati.cz včetně všech URL, např. stc.pirati.cz/volby



# Co má nebo musí mít článek



* jméno článku rozumné délky

* autora

* datum (pokud nemá být aktuální)

* titulní fotografii (zobrazuje se v seznamu článků a také v samotném článku nahoře - bez dalšího popisu)

* tagy

* první část textu vhodnou pro automaticky generovaný perex

* text co nejméně formátovaný, bez obtékání obrázků



Článek také může obsahovat:



* více obrázků

* citace v samostatném odstavci s uvozovkama + uvozením autora (před nebo poté)

* dlouhé URL odkazy v seznamu dalších zdrojů je třeba opatřit jednoznačným jménem/popisem (např. iDnes: K Jirkovi se vrátit nechci, říká Andrea Pomeje)



Obrázky pro články by měly být zmenšené do 800px, s jpeg kvalitou 95% a velikostí souboru do 300KB.



# Co má nebo musí mít osobní profilová stránka



* jméno a příjmení, tituly

* u piráta uživatelské uid

* kontakt (minimálně pirátský e-mail), případně linky na osobní weby atd.

* fotka (hlava) - ořezává se do čtverce a nechává se v co nejvyšším rozlišení

* historie vč. data a místa narození, profese a záliby



# Markdown formát



```

# Nadpis

## Menší nadpis

*kurzíva* **tučné písmo** ~~škrtance~~ `kód`

* seznam nečíslovaný

1. seznam číslovaný

[odkaz](http://www.pirati.cz)

obrazek: {% asset 'posts/clanek-jmeno_souboru.jpg' alt='Popis obrázku' %}

```



Jak správně citovat:



```

> „Tohle říkám."

říká Petr Novák.

```



Více viz https://en.wikipedia.org/wiki/Markdown nebo https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet



# Jednoduchá editace souborů přímo na githubu



Pro editaci stačí mít github účet, nejsou potřeba žádná speciální práva. Postup je následující:



Pro jednoduché editace je možné použít odkazy "Navrhni úpravu" vpravo dole na každé stránce webu. Odkaz vás přesměruje na přímo na editaci na githugu.

Nebo po rozkliknutí konkrétního souboru na githubu lze kliknout na ikonu tužky v pravém horním rohu (po najetí myší se objeví hláška: "Edit the file in your fork of this project").



1. Změňte potřebné části souboru (nahoře na liště mód "Edit file"),

2. zkontrolujte správnost provedených změn kliknutím na "Preview changes" na horní liště (červeně jsou označeny odebrané části textu, zeleně naopak ty přidané),

3. sjeďte na konec stránky k tabulce "Propose file change" a vyplňte pole "Add an optional extended description..." - stručně a jasně shrňte své změny,

4. klikněte na zelené tlačítko "Propose file change",

5. objeví se nová stránka, kde ještě jednou uvidíte provedené změny a pokud je vše v pořádku, klikněte na horní zelené tlačítko "Create pull request" a pak ještě jednou na další stránce,

6. počkejte, až vaše změny potvdí administrátor stránek (přijde vám do e-mailu zpráva, když se tak stane),

7. a máte HOTOVO!



# Pro linuxáky



Vystačíte si s jakýmkoliv editorem a "git" klientem (balík by se měl jmenovat stejně). Pár tipů pro command line git klienta viz níže - i tak byste ale měli vědět, co v každém kroku děláte!



Více viz https://help.github.com/



## Start



```

mkdir ~/git

cd ~/git

git clone https://github.com/pirati-web/stredocesky.pirati.cz

git config user.name "vas_github_user"

git config --global credential.helper cache

git config --global credential.helper 'cache --timeout=3600'

```



## Zápis změn do lokálního repository a přenos na server



```

git status

git add -A

git commit -a

git push

```



## Aktualizace lokálního repository



To udělejte vždy, než něco začnete měnit.



```

git fetch

```



## Upgrade témátka



1. zjistit [poslední release](https://github.com/pirati-web/jekyll-theme-pirati/releases) a projít changelog

2. nahradit verzi v Gemfile (jekyll-theme-pirati)

3. nahradit verzi v _config.yml (vendor/bundle/ruby/2.5.0/gems/jekyll-theme-pirati-...)

4. spustit *bundle install*

5. otestovat lokální build



## CODE HOWTO - vložení upoutávky článku

```

{% assign article = site.posts | where: "url", "/url-k-clanku/" | first %}

{% include articles/vertical-article.html article=article %}

```



## CODE HOWTO - vložení medailonku člověka

```

{% assign person = site.people | where: "uid", "uid daného člověka" | first %}

{% include people/profile-badge.html item=person imgSize='small' imgStyle='round' %}

```



## CODE HOWTO - redirect



Na stránce máme aktivní modul jekyll-redirect-from. Do hlavičky md stránky je tak možné např. přidat:



```

redirect_from:

  - /zdrojovaURL

```