2.2 KiB
Svatbonet - 2. část MI-NUR
Zprovoznění aplikace
Pro spuštění aplikace je potřeba mít nainstalovaný nodeJS. Po naklonování repozitáře stačí spustit příkaz npm install, následně npm run build, čímž dojde k přeložení SCSS a JS do jednoho souboru (pomocí webpacku). Následně příkazem node src/app.js dojde ke spuštění aplikace na adrese http://localhost:8080.
Od této chvíle není potřeba nic řešit, stačí jen plnit šablony.
Šablony
Šablony se nachází v adresáři src/views. V podadresáři backend jsou šablony pro zobrazení v rámci backendu aplikace. V editor jsou zase šablony pro použití v editoru webu.
Jméno šablony se zobrazuje na základě URL. Přístup na url http://localhost:8080/budget zobrazuje šablonu src/views/backend/budget.ejs. V případě přístupu na URL, které vede na neexistující šablonu aplikace vypíše cestu k souboru.
Styly a skripty
V adresáři dist existují dva soubory - custom.css a custom.js. Tyto slouží k psaní samostatného CSS resp. javascriptu. To proto, aby nebylo potřeba po každé změně kompilovat assets (spouštět npm run build). Tyto dva soubory se vkládají do hlaviček layoutů jak v backendu, tak i v editoru.
Potřebné skripty a styly (jQuery, Bootstrap atp.) jsou načtené ve vygenerovaném dist/bundle.js.
Bootstrap 4.1
Aplikaci jsem přehodil na Bootstrap 4.1. Dokumentace k němu je zde: https://getbootstrap.com/docs/4.1/getting-started/introduction/
Backend
Aplikace vyžaduje spuštění, aby bylo možné použít šablonovací systém. Tím je ejs (https://ejs.co/#docs). Mimo jiné podporuje layouty (před doplněk) a cykly. Tím pádem drobná změna ve společné části je otázkou změny na jednom místě. Stejně tak nemusíme dvacetkrát pod sebe kopírovat obsah, stačí ho jen hodit do cyklu.
V budoucnu bude backend řešit triviální pamatování obsahu, to zatím řešeno není.
Shrnutí
Pro úpravu šablony stačí editovat soubor, jehož jméno se shoduje s částí URL adresy, doplnit patřičné styly do dist/custom.css a skripty do dist/custom.js. Tím by potřebné kroky měly být hotové.