Skip to content

Repository voor het publiceren van alle (versies van) door VNG Realisatie vervaardigde Respec documentatie

Notifications You must be signed in to change notification settings

VNG-Realisatie/publicatie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Publiceren Respec documentatie (under construction)

Let op! Deze repository niet hernoemen. Dat veroorzaakt dode links.

Het is de bedoeling dat het geautomatiseerd publiceren van de statische html en pdf wordt onderzocht. Vooralsnog blijven we dit handmatig doen.

Het publiceren van Respec documentatie gebeurd niet vanuit de GitHub repository waarin deze wordt samengesteld en gegenereerd. In die repository kan nl. slechts één versie van die Respec documentatie met GitHub Pages worden aangeboden terwijl we de mogelijkheid willen hebben alle voorgaande versies ook aan te bieden. Anders zouden de links in het eerst deel van de Respec documenten ook dood lopen. Om die reden wordt bij het genereren van Respec documentatie het bestand 'snapshot.html' en het daarvan afgeleide pdf bestand gegenereerd zodat we deze bestanden kunnen kopiëren naar de 'publicatie' repository van waaruit we alle Respec documentatie publiceren.

Inrichten publicatie repository

LET OP!
De hieronder uitgewerkte structuur van de publicatie GitHub repository is slechts een voorstel.

Voor het publiceren van alle Respec documenten in de GitHub repository 'publicatie' is de volgende consistente structuur vereist:

folder- of bestandsnaam Opmerking
cim Het publicatie domein
    [project-mnemonic] De afkorting van het project. 'Open Raadsinformatie' wordt bijv. afgekort als 'ori'.
        [x.x.x] Het versienummer van het Respec document. Deze folder kan zich herhalen met steeds een ander versienummer. Komt minimaal 1x voor met als naam het huidige versienummer.
            media Folder waarin evt. illustratie bestanden zijn opgenomen (optioneel).
            index.html Gegenereerde statische html (snapshot.html) welke overeenkomt met de versie, hernoemd.
            cim-[project-mnemonic]-[x.x.x].pdf Gegenereerd pdf bestand welke overeenkomt met de versie.
        media Folder waarin evt. illustratie bestanden zijn opgenomen (optioneel).
        index.html Gegenereerde statische html (snapshot.html), welke overeenkomt met de huidige versie, hernoemd.
        cim-[project-mnemonic]-[x.x.x].pdf Gegenereerd pdf bestand welke overeenkomt met de huidige versie.

In dit overzicht vertegenwoordigd x.x.x het versienummer van het Respec document. De folder met die naam kan zich herhalen maar komt minimaal 1x voor, de huidige versie. De inhoud van die folder wordt dan eveneens geplaatst in de folder [project-mnemonic]. project-mnemonic. Hieronder zie je een voorbeeld van deze structuur:

image

Tijdens het samenstellen van de inhoud van een nieuwe versie of een geheel nieuw Respec document kun je de structuur in de 'publicatie' repository al aanpassen. Betreft het de eerste versie van een Respec document creëer dan direct in de folder 'cim' een nieuwe folder die als naam de mnemonic van het project krijgt. Daarbinnen creëer je een versiefolder met als naam het versienummer waaronder je de eerste versie publiceert. Bestaat de projectfolder al wel dan creëer je in die folder een nieuwe versiefolder met als naam het versienummer waaronder je de nieuwe versie publiceert. In beide folders creëer je voorlopig een leeg 'index.html' bestand.

Publiceren van documenten

Na generatie kan het bestand 'snapshot.html' en het pdf bestand vanuit de GitHub repository waarin ze gegenereerd zijn worden gekopieerd naar de projectfolder en naar de naar de zojuist aangemaakte versiefolder in de 'publicatie' repository. Het bestand 'index.html' verwijder je vervolgens in beide folders waarna je 'snapshot.html', eveneens in beide folder, hernoemt naar 'index.html'.

Pas vervolgens in de root van de publicatie repository de 'index.md' aan zodat je toegang hebt tot alle Respec documentatie en de http links kunt kopiëren voor gebruik in andere GitHub Pages documentatie.

About

Repository voor het publiceren van alle (versies van) door VNG Realisatie vervaardigde Respec documentatie

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published