Sinds: Nocterra 0.99.1
Nocterra is een CMS dat voornamelijk pagina's serveert. Blogartikelen zijn een optionele mogelijkheid die je kunt inschakelen om gedateerde content te publiceren, automatisch indexen te genereren (bijvoorbeeld per jaar of categorie) en functies te gebruiken zoals per-artikel definities en automatische inhoudsopgaves.
Dit deel van de handleiding beschrijft specifieke functies en authoring-tools voor blogartikelen. De meeste lezers willen direct naar één van deze pagina's:
Een blogartikel in Nocterra is een file-based content item met metadata (auteur, publicatiedatum, categorie, tags, titel, omschrijving en optionele feature-instellingen) en één of meer taal-specifieke bodies. In tegenstelling tot systemen die "blog-first" zijn, behandelt Nocterra artikelen als één content type naast pagina's, zodat je artikelen kunt gebruiken in een traditionele blog-layout, of als een gestructureerde catalogus van content binnen diepere sitepaden.
In een typische setup:
Artikelen worden ontdekt door één of meer geconfigureerde bronmappen te scannen. Detectie is recursief: artikelen kunnen direct in de geconfigureerde map worden geplaatst, of in een geneste submapstructuur (bijvoorbeeld groeperen op auteur, onderwerp, jaar of project).
Geavanceerde configuraties kunnen:
$blog arrays configureren (meerdere onafhankelijke artikelcollecties op één site),Nocterra gaat niet uit van een vaste URL-layout voor artikelen. Waar een artikel in de site verschijnt, wordt bepaald door je geconfigureerde URL-schema. Eén blogconfiguratie kan meerdere patronen ondersteunen, en een site kan meerdere aparte blogconfiguraties ondersteunen met verschillende basispaden en schema's.
In de praktijk wordt een artikel-URL-layout doorgaans opgebouwd uit:
base en taalroutering (taal-specifieke basispaden),urlScheme patronen die canonieke en alternatieve URL's definiëren,urlMap koppelingen om nette doorverwijzingen van legacy paden naar canonieke paden te bieden.Een veelvoorkomend patroon is om een canoniek URL-schema te definiëren (het primaire patroon dat voor gegenereerde links wordt gebruikt) en één of meer alternatieve URL-schema's (legacy patronen die geldig blijven en worden geredirect/mapped naar de canonieke URL).
Routeringsprioriteit is belangrijk: pagina's hebben prioriteit boven blogindexen en artikelen, en indexen hebben prioriteit boven artikelen. Dit betekent dat je bewust een pagina kunt maken die een blogpad "overlaagt" (bijvoorbeeld om een beschrijvende landing page toe te voegen), maar het betekent ook dat je per ongeluk een index verkeerd kunt configureren zodat die overlapt met een artikel-URL (of een index laat overlappen met een bestaande pagina), waardoor het artikel op dat pad onbereikbaar wordt. Houd bij het ontwerpen van URL's, index-URL's en artikel-URL-schema's gescheiden, of schakel bewust een index uit die zou botsen.
Nocterra kan indexpagina's bieden voor jaren, auteurs, categorieën en tags, maar alleen voor de indextypen die je in site.php inschakelt. Als een indextype niet is geconfigureerd, is het niet beschikbaar.
Elk indextype kan, wanneer geconfigureerd, twee navigatieniveaus blootleggen:
Daarom kan een configuratie meerdere URL's per indextype bevatten: één om de top-level index in te schakelen, en één om de per-item listing in te schakelen. Deze URL's maken deel uit van het routeringsontwerp van je site en moeten zo gekozen worden dat ze geen botsingen veroorzaken met pagina's en artikel-URL's.
Nocterra gebruikt meerdere caches om contentgeneratie efficiënt te houden:
Artikelen worden gerenderd door metadata, taal-specifieke bodies en geconfigureerde functies te combineren (zoals placeholder expansion en optionele per-artikel functies). Algemene storage- en cachingconcepten worden beschreven in de handleidingsectie Storage engine.
Omdat artikelen optioneel en URL-gedreven zijn, kunnen ze op meerdere manieren worden gebruikt. Enkele veelvoorkomende voorbeelden:
/blog/<datum>/<titel>), met ingeschakelde jaar/categorie/tag-indexen./projecten/software/<titel>), waarbij categorie- en tag-indexen browsable "type"- en "topic"-lijsten worden en functies zoals automatische inhoudsopgaves helpen om langere catalogusitems te structureren./ggz/behandelingen/<titel>), waarbij auteurs overeenkomen met behandelaars, categorieën overeenkomen met behandelingsvormen (bijvoorbeeld CGT, EMDR, groepsprogramma's) en tags overeenkomen met symptomen/onderwerpen (bijvoorbeeld angst, slaap, trauma), zodat bezoekers kunnen browsen per behandelaar, per type of per hulpvraag, terwijl optionele functies zoals automatische TOC's langere behandelpagina's overzichtelijk en onderhoudbaar houden.