De vorm woont in je theme
Alles wat een site zijn vorm geeft, staat in theme/. De engine rendert; het theme bepaalt hoe dat eruitziet. Er zit geen paginabouwer tussen jou en de markup, geen blokkenbibliotheek waar je binnen moet blijven, geen build-stap om te voeden. Stylesheets, scripts en fonts zijn bestanden in theme/static/ — jij linkt ze, de server serveert ze; wat de site zelf bewaart, de beelden en documenten, staat in assets/.
Hoe een pagina zijn template vindt
Er is geen routeringsbestand dat pagina's opsomt. Een pagina vindt zijn template via een korte ladder:
| Trede | Template |
|---|---|
| Genoemd | een template die op de entiteit zelf genoemd wordt — voor de pagina die een eigen nodig heeft |
| Type | een template genoemd naar het type: elk Event via event.php |
| Vloer | de template waar elke pagina op kan landen |
Een nieuw geclaimde pagina rendert zodra hij bestaat. Het meeste werk zit in de middelste trede: één template per soort ding.
Gewoon PHP, gewoon CSS
Een loam-theme is PHP-templates over data, met een kleine set helpers. Geen eigen templatetaal, en geen andere geaccepteerd — geen Liquid, geen Twig. Paginablokken zijn sections, kleine fragmenten zijn snippets, interfacewoorden staan per taal in strings. Heb je elders themes gebouwd, dan nemen de concepten mee; alleen de bestandstypes veranderen.
Standaarden die je kunt overnemen
Elke pagina die de engine zelf serveert — de 404, de offline pagina, de installatiegids, de uitleg op /admin — maakt plaats voor een theme-bestand met dezelfde naam. Doe niets en de versie van de engine wordt geserveerd; zet een bestand met de juiste naam in het theme en dan die van jou. Een overzicht van het theme laat precies zien waar je site afwijkt.
Wat een plugin zou toevoegen, is van jou
Er zijn geen plugins: wat er een zou brengen, staat in je theme, in je eigen bestanden, op je eigen tempo. En een pagina kan meenemen wat hij nodig heeft om te renderen — kleuren, een focuspunt, een gekozen template — naast zijn Schema.org-content, weggehaald uit de machineweergave zodat de claim waar blijft.
Templates zijn ook wijzigingen
Een nieuwe template is een concept zoals elke andere wijziging: bekeken op de echte site, geweigerd als hij niet parseert, gecontroleerd voordat hij live gaat. Een ontwerper kan een pagina herzien terwijl de live site onaangeroerd blijft tot iemand publiceert.