1 V 1.3 Auteur(s): Ronald Heller Robert van de Rijt Versie: 1.3 Datum: Informatie: ICTU Programmabureau: Advies Overheid.nl Wilhelmina van Pruisenweg ...
ICTU Programmabureau: Advies Overheid.nl Wilhelmina van Pruisenweg 104, 2595 AN Den Haag http://www.overheid.nl en http://www.advies.overheid.nl Advies Overheid.nl draagt met raad en daad bij aan een online toegankelijke overheid
VERSIE HISTORIE Datum 02-03-2006
Versie 0.1
Omschrijving Start concept
24-07-2006
1.0
Eerste versie
14-11-2006
1.1
- Bij Bijlages toegevoegd: Metadata & Doctypes.pdf - para 2.7 over kopjes: aanleveraar moet de mogelijkheid hebben om af te wijken van de standaardisering van het font. - Tabellen moet worden gecodeerd in XML. Over een versnelde procedure wordt in de SLA iets opgenomen. - Namen in de lopende tekst hoeven niet gecodeerd te worden. - Aanpassing DC.creator - Aanpassing in DCTERMS.hasPart en isPartOf - Toegevoegd citeertitel in de metadata - Naamgeving van verbeterpublicaties - Aanpassing histnoot - Paragraaf besluitwijziging vervangen door paragraaf Wijzigingsbepalingen met nieuwe aanvullende tekst. - OVERHEIDop.jaargang toegevoegd aan metadata
- Paragraaf Enig-artikel aangepast. Er wordt geen gebruik gemaakt van het element <enig-artikel> - <jaargang> element verwijderd. Jaargang wordt alleen vastgelegd in de metadata niet meer in de lopende tekst. Dit sluit aan bij het Tractatenblad en de Staatscourant. - noten Advies Raad van State en kamerstukken worden gecodeerd als aparte . - Definitielijst verwijderd. Deze is ingevoegd in het document Codering
Robert van de Rijt
06-08-2007
-2-
Auteur(s) Robert van de Rijt Ronald Heller Robert van de Rijt Ronald Heller Robert van de Rijt
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
1
Inleiding
Dit document beschrijft de codeerinstructies en kwaliteitsnormen voor de XML codering van Staatsblad. Hieronder volgt een korte opsomming van de indeling. In Hoofdstuk 2 wordt kort een overzicht gegeven van de metadata van het Staatsblad. In hoofdstuk 3 worden algemene codeerinstructies behandeld voor terugkerende structuren in het Staatsblad. Deze codeerinstructies zijn niet compleet. De volgende documenten dienen tevens geraadpleegd te worden: BWB documentatie.pdf, versie: BWB05-001 - 1.1 (27 juni 2005) Doctypes & Metadata 1.3.doc Codering algemene, gedeelde structuur met OP DTD 1.0.doc De BWB documentatie, versie BWB05-001 - 1.1 (27 juni 2005) dient als referentiekader. Hierin is per element de betekenis en gebruik vastgelegd van de BWB DTD die is geïncludeerd in de OP DTD. Het document Doctypes & Metadata 1.3.doc gaat zeer gedetailleerd in op het gebruik van metadata voor OP’s. Het document Codering algemene, gedeelde structuur met OP DTD 1.0.doc. behandeld de codering van algemene structuren zoals tabellen, figuren etc. Deze zijn in een apart document opgenomen om ze niet te hoeven herhalen per publicatiesoort.
- 5 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
2
Metadata
Voor een gedetailleerd overzicht van de metadata van het Staatsblad zie het bestand Doctypes & metadata. Hieronder volgt een voorbeeld van de syntax van de metadata van stb-2006-300: <metadata> <meta name="DC.title" content="Wet van 1 juni 2006 tot wijziging van het Wetboek van Strafrecht, het Wetboek van Strafvordering en enige andere wetten in verband met nieuwe ontwikkelingen in de informatietechnologie (computercriminaliteit II)"/> <meta name="DCTERMS.alternative" content="computercriminaliteit II"/> <meta name="DC.type" scheme="OVERHEID.Informatietype" content="officiële publicatie" /> <meta name="DC.type" scheme="OVERHEIDop.Staatsblad" content="Wet" /> <meta name="DC.creator" scheme="OVERHEID.Ministerie" content="Ministerie van Justitie" /> <meta name="OVERHEID.organisationType" scheme="OVERHEID.OrganisatieType" content="Ministerie" /> <meta name="DC.identifier" scheme="OVERHEIDop.StbID" content="stb-2006-300" /> <meta name="OVERHEIDop.publicationName" content="Staatsblad"/> <meta name="OVERHEIDop.publicationIssue" content="300"/> <meta name="OVERHEIDop.jaargang" scheme="DCTERMS.W3CDTF" content="2006"/> <meta name="DCTERMS.available" scheme="DCTERMS.W3CDTF" content="2006-00-00" /> <meta name="DCTERMS.issued" scheme="DCTERMS.W3CDTF" content="2006-07-13" /> <meta name="OVERHEIDop.datumOndertekening" scheme="DCTERMS.W3CDTF" content="2006-06-01" /> <meta name="OVERHEID.category" scheme="OVERHEID.TaxonomieBeleidsagenda" content="Recht | Strafrecht"/> <meta name="OVERHEID.category" scheme="OVERHEID.TaxonomieBeleidsagenda" content="Openbare orde en veiligheid | Criminaliteit"/> <meta name="OVERHEIDop.doctype" content="officiële publicaties, versie 1.1"/>
- 6 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
3 3.1
Algemene aanwijzingen Voorblad
Het voorblad van het Staatsblad moet op identieke wijze gecodeerd worden. Hieronder staat een concreet voorbeeld afgebeeld met codering.
A) De titel van het Staatsblad wordt altijd vastgelegd in de XML. …
…
Staatsblad <subtitel>van het Koninkrijk der Nederlanden
<staatsblad>
B en C) De jaargang van het Staatsblad (B) en de editie (C) worden vastgelegd in de metadata. … <meta name="OVERHEIDop.publicationName" content="Staatsblad"/> <meta name="OVERHEIDop.jaargang" content="2005"/> <meta name="OVERHEIDop.publicationIssue" content="414"/> … <staatsblad> …
D) De titel (opschrift) van het wet-besluit wordt vastgelegd in de metadata en de lopende tekst van het document. In de lopende tekst wordt die gecodeerd als . Tegenwoordig heet dit echter het opschrift.
- 7 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
… <meta name="DC.title" content="Wet van 28 april 2005 tot vaststelling van de begrotingsstaten van het Ministerie van Buitenlandse Zaken (V) voor het jaar 2005 "/> … Wet van 28 april 2005 tot vaststelling van de begrotingsstaten van het Ministerie van Buitenlandse Zaken (V) voor het jaar 2005 <wet-besluit> …
3.2
Aanhef
De aanhef bevat de formele inleidende informatie voor wet- en regelgeving en daaraan gerelateerde documenten. De aanhef begint meestal met de openingsformule van de ondertekenaar van de wet- en regelgeving. Het element wij wordt gebruikt wanneer de regeling de koning/koningin als ondertekenaar heeft. De tekst van de openingsformule begint dan met: "Wij...". Als niet de koning/koningin ondertekent maar een minister of staatssecretaris wordt het element wie gebruikt. De overwegingen (considerans) is, inhoudelijk gezien, de belangrijkste component van de aanhef. De considerans bevat de overwegingen voor de wet- en regelgeving, inclusief verwijzingen naar relevante onderliggende wet- en regelgeving (grondslag) en een beknopte beschrijving van de gehanteerde procedure (Ministerie, Raad van State, Europese Unie). De grondslag dient apart gecodeerd te worden in de metadata met het gebruik van metadata element <meta name=”Dc.source” /> Daarnaast bevat een aanhef vaak een afkondiging. Deze bevat de vaste formule die direct volgt op de considerans maar voorafgaat aan de feitelijke regelgevende tekst. Vaak is dit een term als Besluit of Besluiten. Hieronder volgt een voorbeeld uit Stb-2005-414 met XML codering:
- 8 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
<staatsblad> Wet van 28 april 2005 tot vaststelling van de begrotingsstaten van het Ministerie van Buitenlandse Zaken (V) voor het jaar 2005 <wet-besluit> <wij>Wij Beatrix, bij de gratie Gods, Koningin der Nederlanden, Prinses van Oranje-Nassau, enz. enz. enz. Allen, die deze zullen zien of horen lezen, saluut! doen te weten:Alzo Wij in overweging genomen hebben, dat ingevolge artikel 105 van de Grondwet de begroting van de uitgaven en de ontvangsten van het Rijk bij de wet moet worden vastgesteld en dat in artikel 1 van de Comptabiliteitswet 2001 wordt bepaald welke begrotingen tot die van het Rijk behoren;Zo is het, dat Wij, de Raad van State gehoord, en met gemeen overleg der Staten-Generaal, hebben goedgevonden en verstaan, gelijk Wij goedvinden en verstaan bij deze: <wettekst>
…
3.3
Artikelen
Een artikel in de tekst moet als artikel gecodeerd worden in de XML en niet als een opsomming of ander element. Hierbij geldt de regel dat artikelen alleen worden herkend op basis van de structuur in de tekst. Als het uitsluitend op basis van de inhoud van de tekst mogelijk is artikelen te herkennen, zal de structuur niet als artikel gecodeerd worden. Een artikel kan herkend worden aan de volgende kenmerken: Een artikel kan bestaan uit een combinatie van een label (artikel), nr. (bijvoorbeeld 1, 2, 3,) en titel. Als één of twee van deze elementen in de structuur ontbreekt, zal deze nog steeds als artikel herkend en gecodeerd moeten worden. Daarbij kan een artikel worden herkend aan de gecentreerde kop.
- 9 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
Binnen artikelen kunnen zowel leden als opsommingen voorkomen. Een opsomming wordt herkend aan een stukje tekst met daarachter een dubbele punt. Na deze dubbele punt volgt op een nieuwe regel de opsomming. Als onder de artikelkop alleen sprake is van regels met alfanumerieke nummering moeten deze worden gecodeerd als leden. Hieronder volgt een voorbeeld van een artikelstructuur in stb-2005-414:
De artikelen worden als volgt gecodeerd: … <wettekst> <artikel>
1
De bij deze wet behorende begrotingsstaat van het Ministerie van Buitenlandse Zaken (V) voor het jaar 2005 wordt vastgesteld. <artikel> 2De bij deze wet behorende begrotingsstaat van het Ministerie van Buitenlandse Zaken inzake de baten-lastendienst Centrum tot Bevordering van de Import uit ontwikkelingslanden (CBI) voor het jaar 2005 wordt vastgesteld.
- 10 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
<artikel> 3De vaststelling van de in artikelen 1 en 2 bedoelde begrotingsstaten geschiedt in duizenden euro's. <artikel> 4Deze wet treedt in werking met ingang van 1 januari van het jaar waarop de vaststelling van de begroting betrekking heeft. Indien het Staatsblad waarin deze wet wordt geplaatst, wordt uitgegeven op of na deze datum van 1 januari, treedt zij in werking met ingang van de dag na de datum van uitgifte van dat Staatsblad en werkt zij terug tot en met 1 januari. …
Let op dat een toelichting op artikelen in een Nota van Toelichting anders gecodeerd dient te worden. Een Nota van Toelichting heeft af en toe een onderdeel “artikelsgewijs”. Hierin wordt per artikel een toelichting gegeven, bijvoorbeeld:
Dit zijn echter zelf geen artikelen en worden derhalve ook niet zo gecodeerd. Ze moeten gecodeerd worden als koppen binnen een divisiestructuur. De juiste manier van coderen is te zien in volgend voorbeeld:
Artikelsgewijs
….. Artikel 4Een belangrijke voorziening ten behoeve van een bewindspersoon betreft zijn beveiliging. Dit omvat de beveiliging op het ministerie, thuis, in de eventuele verblijfsvoorziening en onderweg. Daarbij maakt de beveiliging op het ministerie onderdeel uit van de bedrijfsvoering. De uitgaven ten behoeve van beveiliging thuis, in de verblijfsvoorziening en
- 11 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
onderweg gelden als bestuurskosten die ten laste van de begroting van het ministerie komen. De kosten van de beveiliging van de dienstauto worden ook hiertoe gerekend; deze kosten worden niet meegerekend in de kilometerprijs, bedoeld in artikel 7.
3.4
Enig-artikel
Sommige Staatsbladen bevatten maar één artikel en hebben dan als kop enig artikel. Dit artikel moet niet worden gecodeerd met het enig-artikel element. Dit element uit het BWB wordt niet gebruikt. In plaats daarvan wordt het gecodeerd als Enig. Een voorbeeld hiervan is stb-2006-323:
3.5
Wijzigingsbepalingen
In het Staatsblad komen naast normale nieuwe wet- en regelgeving ook zogenaamde wijzigingsbepalingen voor waarin wijzigingen op eerdere regelingen beschreven zijn. Deze tekststructuur moet als een <wijzig-artikel> gecodeerd zijn, en niet als artikel, lijst of ander element. De tekst binnen een <wijzigartikel> element is dus een tekstgedeelte waarin het wijzigen van een bepaald artikel wordt uitgeschreven. Hoofdvormen: De nummering van de wijzigingsbepalingen is beschreven in Aanwijzing voor de regelgeving nummer 234: "1. Een regeling die slechts betrekking heeft op wijziging of intrekking van een of meer bestaande regelingen, wordt ingedeeld in artikelen met Romeinse cijfers.
- 12 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
2. Indien een nieuwe regeling tevens strekt tot wijziging van bestaande regelingen, worden ook de wijzigingsbepalingen genummerd met Arabische cijfers." Zuivere wijzigingsregeling (stb-2006-349):
Dit kan gecodeerd worden als: … <wijzig-artikel> IWet werk en bijstand <wijziging> <wat>Artikel 36, eerste lid, onderdeel b, van de Wet werk en bijstand komt te luiden: <artikeltekst> b. gedurende de in onderdeel a bedoelde periode geen inkomsten uit of in verband met arbeid heeft ontvangen of ten aanzien van wie het college van oordeel is dat, gelet op de zeer geringe hoogte van de inkomsten uit of in verband met arbeid in die periode en de zeer geringe duur van deze arbeid, in redelijkheid niet gesproken kan worden van een feitelijke aanwezigheid van arbeidsmarktperspectief;. …
Voorbeeld van een nieuwe regeling met wijzigingsbepalingen (stb-2006-371):
- 13 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
Dit kan gecodeerd worden als: … <wijzig-artikel> 9 <wijziging> 1. <wat>Hoofdstuk V van de Regeling Toezicht Luchtvaart vervalt, met uitzondering van artikel 96, vierde lid. <wijziging> 2. <wat>Artikel 166, eerste lid, van de Regeling Toezicht Luchtvaart komt te luiden: <artikeltekst> 1.Overtreding van de artikelen 96, vierde lid, 123, eerste lid, 124,aanhef en onder a, 125, eerste lid, 126, 127, 128, 129, eerste tot en metvierde lid, 130, eerste en tweede lid, 131, 133, eerste en tweede lid, 136 toten met 143, is een strafbaar feit als bedoeld in artikel 62, derde lid, van deLuchtvaartwet. <wijziging> 3. <wat>Artikel 166, derde lid, van de Regeling Toezicht Luchtvaart komt teluiden: <artikeltekst> 3.Overtreding van een aanwijzing, regel of voorschrift gegevenkrachtens de artikelen 123, tweede lid, 124 aanhef en onder b, 125, tweedelid, 126, 129, vijfde lid, 130, derde lid, 132, eerste lid, 132a, 133, derde lid,139, derde lid, is, voor zover die overtreding uitdrukkelijk als strafbaar feitis aangemerkt, een strafbaar feit als bedoeld in artikel 62, derde lid, van deLuchtvaartwet.
- 14 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
…
Bijzondere vormen: Daarnaast bestaan er nog bijzondere varianten die zich niet houden aan de bovenvermelde nummeringwijze. Dat is vaak het geval bij grootschalige invoerings- en aanpassingswetten, en in die gevallen komen uiteenlopende nummeringen voor zoals - Hoofdstuk per departement, met daarbinnen Romeins genummerde artikelen ( stb-2005-343) - Hoofdstuk per departement met daarbinnen Arabisch genummerde artikelen (stb-1997-660) - Hoofdstuk per departement met doorlopende nummering over de hoofdstukken in de vorm van 1.1, 1.2 ,1.3, 2.1, 3.1, 3.2 etc. (stb-2005-525) De algemene structuur van een wijzigingsbepaling wordt gecodeerd met een <wijzig-artikel> element en <wijziging> elementen. (zie stb-2006-349 en stb-2006-371 hierboven). Wijzigingsbepalingen kunnen ook worden gecodeerd in de vorm van een <wijzig-artikel> met wijzigleden in Romeinse hoofdletters: A, B, C etc. Dit is een wijzig-artikel structuur die zowel in het Staatsblad als de Staatscourant veel voorkomt. Deze wijzig-artikelen kunnen gemakkelijk worden herkend op basis van structuur van de tekst zonder inhoudelijk de tekst aan een nader onderzoek te onderwerpen. Een voorbeeld hiervan vormt stb-2005-275:
Dit kan worden gecodeerd als:
- 15 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
… <wettekst> <wijzig-artikel> IDe Wet op de waterkering wordt als volgt gewijzigd: <wijzig-lid> A <wat>Artikel 2 wordt als volgt gewijzigd: <wijziging> 1.In het eerste lid wordt «een als bijlage I bij deze wet behorende landkaart» vervangen door: als bijlage I en bijlage IA bij deze wet behorende. <wijziging> 2.In het tweede lid wordt «bijlage kan» vervangen door: bijlagen kunnen. <wijzig-lid> B <wat>Artikel 3 wordt als volgt gewijzigd: <wijziging> 1.In het eerste lid wordt «Op een bij deze wet behorende bijlage II» vervangen door: Op de bij deze wet behorende bijlage II en bijlage IIA. <wijziging> 2.In het vierde lid wordt «bijlage» vervangen door: bijlagen. <wijziging> 3.In artikel 3 wordt na het vierde lid een lid toegevoegd, luidende: <artikeltekst> 5.Onze Minister zendt elke tien jaar aan de beide Kamers der Staten-Generaal een verslag over de doeltreffendheid en de effecten van de in bijlage II en bijlage IIA aangegeven veiligheidsnorm. <wijzig-lid> ,,,
Het is mogelijk dat een <wijziging> alleen een <wat> bevat (zie stb-2006-371 hierboven), omdat de te wijzigen tekst en de wijziging in één zin staan. Wanneer er minstens twee wijzigingen zijn kunnen deze genummerd worden met het element .
- 16 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
Binnen een <wijziging> kunnen artikelen of leden in zijn geheel worden toegevoegd of verbeterd. Deze kunnen in dat geval worden gecodeerd met het element <artikel> voor artikelen en het element <artikeltekst> in het geval van leden. Let op dat in het laatste geval het van een artikeltekst niet gecodeerd wordt als het van een wijziging! Is er alleen sprake van onderdelen van leden dan kunnen deze worden gecodeerd met een (zie stb-2006-349). Als er binnen een <wijziging>een hoofdstuk, paragraaf, of andere delen worden beschreven met daarin meerdere gewijzigde artikelen, kan het best gebruik gemaakt worden van een het element <wijzigdivisie>.
3.6
Wetsluiting
Slotformulering Binnen de BWB DTD is binnen het element sluiting (wet-sluiting, regeling-sluiting etc.) een element slotformulering opgenomen. Dit is de tekst die vooraf kan gaan aan de daadwerkelijke ondertekening en bevat teksten als: “Gegeven”, “Mij bekend” of “wordt gepubliceerd in”. Dagtekening Een wetsluiting is meestal voorzien van een plaats en datum: de dagtekening. Vaak zijn dergelijke gegevens gescheiden door een komma en eindigen ze met een punt. Het content model dat gevolgd moet worden is bij wet-besluiten en regelingen die van . Dit is echter geen mixed content model, dus zal de codering niet altijd even zuiver zijn. Let er hierbij op dat komma’s worden gecodeerd in het tekstgedeelte waar deze bij staan. In het onderhavige geval is dit bij het element en niet bij het element . Hieronder volgt een voorbeeld van een wetsluiting:
Dit wordt in XML gecodeerd als: <wetsluiting>
- 17 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
<slotformulering> Lasten en bevelen dat deze in het Staatsblad zal worden geplaatst en dat alle ministeries, autoriteiten, colleges en ambtenaren, wie zulks aangaat aan de nauwkeurige uitvoering de hand zullen houden.'s-Gravenhage,28 april 2005BeatrixDe Minister van Buitenlandse Zaken,B. R.BotDe Minister van Ontwikkelingssamenwerking,A. M. A. vanArdenne-van der HoevenUitgegeven de drieëntwintigste augustus 2005De Minister van Justitie,J. P. H.Donner
Noten Bij de afsluiting van een staatsblad worden de noten uit de lopende tekst in de marge getoond naast de ondertekening. Daarnaast wordt hier ook de noot getoond die refereert aan het bijbehorende kamerstuk. Ook een eventuele verwijzing naar het Advies van de Raad van State is hier gecodeerd in de marge. Deze laatste noten zijn herkenbaar aan het ontbreken van de nummering en worden anders gecodeerd dan de noten waarnaar wordt verwezen in de lopende tekst. Anders dan de noten uit de tekst, worden deze zogenaamde “histnoten” gecodeerd na de slotformulering. Let er op dat de eindnoten hier dus niet worden gecodeerd. Deze staan in de lopende tekst! Meer informatie over noten vind je in para 3.13 tot 3.15.
- 18 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
Bovenstaand voorbeeld van stb-2002-369 dient als volgt gecodeerd te worden: <wetsluiting> <slotformulering> Lasten en bevelen dat dit besluit met de daarbij behorende nota van toelichting in het Staatsblad zal worden geplaatst.Het advies van de Raad van State is openbaar gemaakt door terinzagelegging bij het Ministerie van Binnenlandse Zaken en Koninkrijksrelaties. Tevens zal het advies met de daarbij terinzage gelegde stukken worden opgenomen in het bijvoegsel bij de Staatscourant van 13 augustus 2002, nr. 153.'s-Gravenhage,7 juni 2002BeatrixDe Minister van Binnenlandse Zaken en Koninkrijksrelaties, K. G. deVriesUitgegegeven de zestiende juli 2002De Minister van Justitie,A. H.Korthals
- 19 / 25 -
Codering Staatsblad met OP DTD Codeerinstructies en kwaliteitsnormen
3.7
Bijlage en Nota-toelichting
De tekst die volgt na de sluiting van een wet-besluit kan gecodeerd worden gecodeerd met het element Bijlage of Nota-toelichting. De toelichting bevat een verantwoording en uitleg van het wet-besluit. Een bijlage wordt voornamelijk gebruikt voor vaststelling van een tabel, formulier, model, kaart of lijst. De bijlagen hebben een afwijkende vormgeving in de staatsbladen ten opzichte van de vormgeving van een nota van toelichting. Zie het voorbeeld van een bijlage uit stb-1996-394 hieronder.
1LEIDRAAD
…
Merk op dat de kop van de bijlage volledig is uitgeschreven met het gebruik van label, nr en titel. Bij de presentatie zullen de elementen
