Rozcestnik-studovna

Domovská stránka a nápověda pro počítače na studovnách v MZK vknihovne.mzk.cz

Jak upravovat stránky nápovědy

Stránky jsou napsané ve formátu Markdown. Zde najdete co je to Markdown a jak jej psát. Github používá také formát Markdown, stránky se dají tedy upravovat přímo v editoru Markdown na Githubu.

Stránky nápovědy se nachází ve složce private/

Po vybrání určitého souboru stačí kliknout na jeho editaci.

Editor formátu Markdown

Editor se skládá ze dvou panelů. V levém panelu můžeme upravovat text Markdown. V pravém panelu se vykreslují HTML změny.

Markdown vypadá takto:

# Zde si napíšu libovolný nadpis
Takto se píše text ve formátu Markdown

Uložení změn

Změny se ukládají ve formuláři dole pod editorem. Je nutné vyplnit název změny. Změny se uloží tlačítem Commit

Změny v textech se projeví jen zde v repozitáři na Githubu. Změny se neprojeví na webu vknihovne.mzk.cz

Změněné texty z tohoto repozitáře je potom nutné nahrát na web vknihovne.mzk.cz

Obrázky

Obrázky si Meteor načítá ze složky public/images. V Markdown souborech jsou obrázky a jejich cesta takto:

![](/images/help/jakTisknout/terminal.png)

Všiměte si, že adresa začíná složkou /images/.... Meteor totiž bere složku public/ jako document root /. S výše uvedenou cestou obrázky v aplikaci fungují, nefungují ale v Markdown editoru na Githubu.

Aby byly obrázky zobrazeny i na Githubu, musí být obsah složky public/images nahrán i ve složce images. Toto je nešikovné a i když jsem tomu věnoval dostatek času, nepodařilo se mi to vyřešit lépe.

Spuštění aplikace na lokálním PC

$ git clone https://github.com/moravianlibrary/Rozcestnik-studovna.git
$ cd Rozcestnik-studovna
$ meteor

Po zadání posledního příkazu se aplikace se spustní na adrese http://localhost:3000/

Docker

Z Githubu je na hub.docker.com nastavený webhook, který při změně provede build nového Docker image.

Pak pro nasazení nové verze stačí na serveru s rozcestníkem pouze:

$ docker-compose pull

Pro lokální vytvoření Docker image

$ docker build -t moravianlibrary/rozcestnik .
$ docker push moravianlibrary/rozcestnik

Google tag manager

GTM používá balík meteor-iron-router-gtm. Id pro GTM se může předat pomocí souboru settings.json, nebo ekvivalentně jako systémová proměnná.

Produkce

Id pro GTM se předává jako systémová proměnná v yaml souboru v open shiftu

Test

Pro testovací build s GTM id

$ meteor build ../vknihovne_build
$ cd vknihovne_build
$ ROOT_URL=http://127.0.0.1 PORT=8080 METEOR_SETTINGS='{"public": {"gtm": {"id": "GTM-MBZGH4"}}}' node main.js