Každý článek je textový soubor v adresáři _posts. Struktura tohoto adresáře může být libovolná, my jsme zvolili rozdělení podle let a měsíců. Článek má dvě hlavní části: samotný text ve formátu Markdown a metadata, tedy informace o článku (autor, rubrika a podobně).
Informace o článku jsou uložené především v záhlaví každého souboru, například takhle:
---
title: „Člověk dokáže i trapno využít ve svůj prospěch.“
perex: Rozhovor s Michaelou Vymazalovou a Jendou Nádvorníkem o improvizačním divadle.
cover-photo: http://i.imgur.com/eYUFoYtl.jpg
author: Martina Vašková
category: rozhovory
tags: kultura divadlo
---
Tímto záhlavím začíná každý článek. Jeho formát je jednoduchý: nejprve tři pomlčky (přesněji řečeno spojovníky) jako oddělovač, pak několik řádků ve tvaru magické-klíčové-slovo: nějaká hodnota, a nakonec zase tři spojovníky jako oddělovač.
Titulek se nastavuje klíčovým slovem title. Skrývá se tady jen jeden čert: Pokud titulek obsahuje dvojtečku, je nutné celý text titulku uzavřít do rovných uvozovek ("), aby dvojtečka nezmátla mašinu.
A vlastně ještě jeden čert tu je: Pokud je článek v rubrice názory a komentáře, nedávejte do titulku jméno autora, vloží se tam automaticky.
Nastavuje se klíčovým slovem cover-photo, hodnotou je URL fotky. K nahrávání fotek podrobněji samostatný dokument. Nezapomeňte na to, že titulní fotka nesmí být v plném rozlišení, jinak by se nám na titulce webu sešly desítky megabajtů dat!
Nastavuje se klíčovým slovem author. Hodnota musí být něco ze seznamu autorů, jinak by se nenačetla profilovka autora a jeho e-mail.
Jelikož samotným titulkem bychom článek většinou nezvládli dostatečně popsat, používáme ještě perex, tedy krátký popis obsahu článku. Dříve jsme jako perex brali první odstavec textu, ale ten bývá hodně dlouhý a ne vždy dostatečně dobře shrnuje obsah. Proto jsme zavedli klíčové slovo perex, kterým lze nastavit perex článku samostatně. Důležité je, aby titulek společně s perexem byl rozumně krátký a vešel se do náhledu článku na titulce a jinde:
Nastavuje se klíčovým slovem category. Možné hodnoty jsou rozhovory, názory a komentáře, zpravodajství, ankety a seriály. Podle rubriky se momentálně pod každým článkem sází seznam dalších článků.
Nastavují se klíčovým slovem tags, hodnotou je seznam témat oddělených mezerou. Jelikož mezera slouží jako oddělovač, témata s mezerou je potřeba sázet složitěji:
tags:
- Červená zahrada
- architektura a urbanismus
Pokud je článek součástí seriálu, mezi ostatní články ze seriálu ho zařadíte klíčovým slovem serial. Možné hodnoty jsou stromy, depozitar, jazyk, krajiny a historie, viz seznam seriálů ve zdrojovém kódu webu.
Kromě záhlaví článku jsou metadata uložená ještě v názvu souboru. Ten vypadá třeba takhle:
2016-6-15-rozhovor-impro.md
Koncovka je vždycky md, netřeba řešit. Řetězec rozhovor-impro je ve výsledku vidět v adrese článku na webu, například tenhle článek má ve výsledku tohle URL:
http://ohlasy.info/clanky/2016/06/rozhovor-impro.html
URL je to důležitá věc, takže je dobré vybírat něco stručného a výstižného. Smíte použít pouze písmena anglické abecedy (bez diakritiky) a spojovníky. Pokud si nevíte rady, podívejte se na předchozí články.
A konečně zbývající částí názvu souboru je datum vydání ve tvaru RRRR-M-D.
Pro formátování článků používáme jazyk Markdown. Jediné, co stojí za další zmínku, je vkládání obrázků. To vypadá takhle:
{% photo src="http://i.imgur.com/qMjTQHm.jpg"
caption="Nadační dům s modlitebnou a učebnou zřízený Nathanem Löw-Beerem roku 1883"
author="Muzeum regionu Boskovicka" %}
Do uvozovek za src patří URL obrázku, caption je popisek obrázku a atribut author určuje autora nebo držitele autorských práv. Do atributu alt se vkládá textový popisek obrázku, který potřebují například hlasové čtečky pro nevidomé. Pokud alt chybí, použije se hodnota caption.
Zvláštním případem jsou „profilové“ fotky s kruhovým ořezem, které se objevují například v anketách. Ty se vkládají takhle:
<img src="http://i.imgur.com/Ajp97PF.jpg"
alt="Pavel Vlach"
class="profile-picture">
Fotka může být libovolně veliká, ale musí být čtvercová. Ořez na kruh už si web zařídí sám.
Pokud si nejste jisti, jak co zařídit, podívejte se na předchozí články v podobném stylu, máme jich mraky.
Pokud je nutné aktualizovat seznam nejčtenějších článků ručně, mrkněte na soubor _data/nejctenejsi.yml, formát by měl být jasný.
Když chcete vložit nový článek, otevřete si adresář _posts, rozklikněte aktuální rok a měsíc, a pak klikněte na tlačítko Create new file (vytvořit nový soubor). Vložte kompletní zdrojový kód článku včetně záhlaví, v políčku nahoře (Name your file…) doplňte název souboru, na záložce Preview si můžete aspoň rámcově zkontrolovat formátování a nakonec dole (ve vstupním poli s textem Create new file) vypište stručný popis změn a klepněte na Commit new file. Za moment by nový článek měl naskočit na webu.