English, Nederlands
Doneer met PayPal

Handleiding

Blogartikelen

Op deze pagina

Over

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.

Handleidingpagina's in deze sectie

Dit deel van de handleiding beschrijft specifieke functies en authoring-tools voor blogartikelen. De meeste lezers willen direct naar één van deze pagina's:

Wat zijn blogartikelen in Nocterra?

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:

Artikelbronnen en detectie

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:

URL-schema's en routering

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:

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.

Indexpagina's (jaren, auteurs, categorieën, tags)

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.

Caching en renderen

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.

Veelvoorkomende use-cases

Omdat artikelen optioneel en URL-gedreven zijn, kunnen ze op meerdere manieren worden gebruikt. Enkele veelvoorkomende voorbeelden: