Skip to content

Developers Guide

Jump to bottom
CHAOSdonut edited this page Oct 12, 2022 · 9 revisions

In deze Developers guide zal er een beschrijving gegeven worden van de functionaliteiten die specifiek zijn aan het Logius profiel. Voor de algemene development guide voor de rest van ReSpec raden we aan om de officiële ReSpec development guide te gebruiken: https://github.com/w3c/respec/wiki/Developers-Guide

Config files

ReSpec gebruikt een config file, binnen de Logius build word deze file gesplitst in 2 delen: document configs en organisatie configs. Deze files worden geladen in de index.html file met:
<script src="CONFIG_FILE_SRC" class="remove"></script>
Daarna worden alle config files in één respecConfig object gezet:
<script>const respecConfig = { ...organisationConfig, ...config }</script> Nieuwe files kunnen variabelen in oudere files overschrijven. Variabelen die aan de meest rechtse kant tussen de { } staan overschrijven eerdere variabelen.

Organisatie config

Deze config opties zijn variabelen die voor alle documenten binnen een organisatie gelijk zijn. Dit zijn bijvoorbeeld de organisatienaam of statuscodes. Het is handig om deze file centraal te hosten en dan in te laden. Hierdoor hoeft de file niet constant gekopieerd te worden en kunnen eventuele zeldzamen aanpassingen (zoals een naamsverandering) globaal toegepast worden.

Document config

Deze config opties zijn alleen relevant voor het document waarin ze gebruikt worden, denk bijvoorbeeld aan de status van het document.

Vertalingen

Om een document in verschillende talen te kunnen gebruiken worden er in de organisatie config verschillende vertalingen opgenomen:

labelText: {
    nl: {
      def: `Definitieve versie`,
      wv: `Werkversie`,
    },
    en: {
      def: `Definitive version`,
      wv: `Working version`,
    },

getIntlData() uit utils.js pakt dan de <html lang=""> tag uit de index file om te bepalen welke vertaling hij moet gebruiken.

Config warner

ReSpec geeft de mogelijkheid om errors en warnings aan gebruikers te geven. Omdat missende config opties het renderen van sommige onderdelen blokkeert, is het belangrijk dat een gebruiker weet als er een belangenrijke config mist. Deze plugin heeft 2 arrays: requiredConfigs en recommendedConfigs. Missende requiredConfigs geven een error, missende recommendedConfigs geven een warning. Beide linken in de "how to fix" automatisch naar de juiste config optie in de github wiki.

Een config is required als hij een onderdeel of het hele document breekt. Een config is recommended als het alleen impact heeft op zichzelf.

Test html build

Het is goed om de node packages up-to-date te houden. Maar omdat die packages van 3e partijen zijn is het handig om wel te controleren of het document nog wel naar behoren werkt na een update. Het test-html-build script maakt een snapshot en vergelijkt de html met een stabiele snapshot. Als er dus onverwachte veranderingen zijn kunnen die makkelijk ontdekt worden.

Guides

Document configuration options

Global configuration options

Document URLs
Clone this wiki locally