Merge branch 'nyt_design' into 'main'

Opdatér til nyt navn for styrelsen og til nyt design
SDFIdk · Sep 20, 2024 · a6c6fe1 · a6c6fe1
2 parents 347bdb0 + 5d01b99
commit a6c6fe1
Show file tree

Hide file tree

Showing 42 changed files with 2,217 additions and 310 deletions.
diff --git a/build/prepare_html_for_styling.xsl b/build/prepare_html_for_styling.xsl
@@ -31,54 +31,70 @@
         <body>
             <xsl:apply-templates select="@*" />
             <xsl:apply-templates select="x:div[@id='header']" />
-            <div class="ds-container ds-grid-1-2">
+            <div class="ds-container">
                 <xsl:apply-templates select="x:div[@id='header']/x:div[@id='toc']"/>
                 <xsl:apply-templates select="x:div[@id='content']"/>
             </div>
+            <div class="ds-padding">
+                <nav>
+                    <a id="link_to_toc" href="#toc" role="button">Til indholdsfortegnelsen</a>
+                </nav>
+            </div>
         </body>
     </xsl:template>
     <!-- Tilføj header element med logo, navn og hjemmeside (som står i "email") -->
     <xsl:template match="x:div[@id='header']">
-        <header id="header" data-theme="dark" class="ds-padding">
+        <header id="header" class="ds-header">
             <div class="ds-container">
-                <a class="ds-logo ds-logo-pull-left">
-                    <xsl:attribute name="href" select="x:div/x:span[@id='email']/x:a/text()" />
-                    <xsl:value-of select="x:div[@class='details']/x:span[@id='author']/text()" />
-                </a>
+                <ds-logo-title title="Anbefalede standarder for geodata">
+                    <xsl:attribute name="title" select="x:h1/text()" />
+                    <xsl:attribute name="byline" select="x:div[@class='details']/x:span[@id='author']/text()" />
+                </ds-logo-title>
+                <xsl:copy select="x:h1">
+                    <xsl:apply-templates select="@*|node()"/>
+                </xsl:copy>
+                <p class="manchet">
+                    <xsl:value-of select="../../x:head/x:meta[@name='description']/@content" />
+                </p>
+                <xsl:apply-templates select="x:div[@class='details']"/>
             </div>
-            <xsl:copy select="x:h1">
-                <xsl:attribute name="class" select="'ds-container'" />
-                <xsl:apply-templates select="@*|node()"/>
-            </xsl:copy>
-            <xsl:apply-templates select="x:div[@class='details']"/>
         </header>
     </xsl:template>
     <!-- Kopiér ikke author og email, er allerede kopieret ind i headeren -->
     <xsl:template match="x:div[@class='details']">
-        <div class="details ds-container">
-            <xsl:copy-of select="x:span[@id='revnumber']"/>
-            <xsl:text> </xsl:text>
-            <xsl:copy-of select="x:span[@id='revdate']"/>
-        </div>
+        <xsl:copy-of select="x:span[@id='revnumber']"/>
+        <xsl:text> </xsl:text>
+        <xsl:copy-of select="x:span[@id='revdate']"/>
     </xsl:template>
     <!-- Tilføj nav element -->
     <xsl:template match="x:div[@id='toc']">
-        <div id="toc" class="toc">
-            <xsl:copy select="x:div[@id='toctitle']">
-                <xsl:attribute name="class" select="'ds-padding'" />
-                <xsl:apply-templates select="@*|node()"/>
-            </xsl:copy>
+        <div id="toc" class="toc ds-padding">
             <nav class="ds-nav-vertical">
+                <h2>
+                    <xsl:value-of select="x:div[@id='toctitle']/text()" />
+                </h2>
                 <xsl:apply-templates select="x:ul"/>
             </nav>
         </div>
     </xsl:template>
-    <!-- Anvend main i stedet for div -->
+    <!-- Anvend main -->
     <xsl:template match="x:div[@id='content']">
-        <main class="ds-padding">
+        <main>
             <xsl:apply-templates select="@*|node()"/>
         </main>
     </xsl:template>
+    <!-- Anvend aside -->
+    <xsl:template match="x:div[@class='paragraph bibliographicaldetails']">
+        <aside class="bibliographicaldetails">
+            <xsl:apply-templates select="@*[local-name()!='class']|node()"/>
+        </aside>
+    </xsl:template>
+    <!-- Anvend cite -->
+    <xsl:template match="x:span[@class='cite']">
+        <cite>
+            <xsl:apply-templates select="@*|node()"/>
+        </cite>
+    </xsl:template>
     <!-- Links der ikke peger på et sted i samme side skal åbnes i et nyt faneblad -->
     <xsl:template match="x:a" name="addTargetBlank">
         <xsl:element name="x:a">
@@ -91,4 +107,12 @@
             </xsl:if>
         </xsl:element>
     </xsl:template>
+    <!-- Se https://alfa.siteimprove.com/rules/sia-r79 -->
+    <xsl:template match="x:pre">
+        <pre>
+            <code>
+                <xsl:apply-templates select="@*|node()"/>
+            </code>
+        </pre>
+    </xsl:template>
 </xsl:stylesheet>
diff --git a/docs/ArkiveringAfGeodata.adoc b/docs/ArkiveringAfGeodata.adoc
@@ -9,7 +9,7 @@ Bestemte datasæt indeholdende geodata bør bevares for eftertiden.
 [.bibliographicaldetails]
 KULTURMINISTERIET. _Bekendtgørelse om arkiveringsversioner_. 12 februar 2020. BEK nr 128. Tilgængelig på: https://www.retsinformation.dk/eli/lta/2020/128[https://www.retsinformation.dk/eli/lta/2020/128,title=Bekendtgørelse om arkiveringsversioner]
 
-Statslige myndigheder skal anmelde nye it-systemer til Rigsarkivet, inden de tages i brug. Rigsarkivet vurderer ud fra anmeldelsen, om der skal afleveres en kopi af data til arkivet, og hvornår der i givet fald skal arkiveres første gang. Af de it-systemer som Rigsarkivet har bestemt til bevaring, skal den statslige myndighed producere arkiveringsversioner. En arkiveringsversion er en kopi af data fra myndighedens it-system, suppleret med dokumentation om systemet samt filer, der beskriver hvordan data hænger sammen. Arkiveringsversionen skal udarbejdes i bestemte formater, for at den kan bevares over tid <<rigs19>>. Rigsarkivet fastsætter formaterne i _Bekendtgørelse om arkiveringsversioner_. Bekendtgørelsen uddybes og eksemplificeres i _Vejledning til bekendtgørelse om arkiveringsversioner_ <<rigs22>>.
+Statslige myndigheder skal anmelde nye it-systemer til Rigsarkivet, inden de tages i brug. Rigsarkivet vurderer ud fra anmeldelsen, om der skal afleveres en kopi af data til arkivet, og hvornår der i givet fald skal arkiveres første gang. Af de it-systemer som Rigsarkivet har bestemt til bevaring, skal den statslige myndighed producere arkiveringsversioner. En arkiveringsversion er en kopi af data fra myndighedens it-system, suppleret med dokumentation om systemet samt filer, der beskriver hvordan data hænger sammen. Arkiveringsversionen skal udarbejdes i bestemte formater, for at den kan bevares over tid <<rigs19>>. Rigsarkivet fastsætter formaterne i [.cite]#Bekendtgørelse om arkiveringsversioner#. Bekendtgørelsen uddybes og eksemplificeres i [.cite]#Vejledning til bekendtgørelse om arkiveringsversioner# <<rigs22>>.
 
 [NOTE]
 ====

diff --git a/docs/BegrebsOgDatamodeller.adoc b/docs/BegrebsOgDatamodeller.adoc
@@ -1,7 +1,7 @@
 [#begrebs-datamodeller]
 === Begrebs- og datamodeller
 
-Det er et arkitekturprincip i Digitaliseringsstyrelsens <<fda-hvidbog>>, 
+Det er et arkitekturprincip i Digitaliseringsstyrelsens [.cite]#<<fda-hvidbog>>#, 
 at gode data deles og genbruges. Det
 vil sige, at begreber og data skal beskrives ensartet, så de kan
 genbruges, og der sikres tilstrækkelig kvalitet i data til de væsentlige
@@ -13,12 +13,12 @@ gjort mere konkret i form af fire arkitekturregler:
 * Giv data den kvalitet som efterspørges (se punkt om metadata).
 * Udstil oplysninger om datakilder, begreber og datamodeller.
 
-Hvis et datasæt er omfattet af INSPIRE-direktivet, skal datasættet gøres
+Hvis et datasæt er omfattet af [.cite]#<<inspire,INSPIRE-direktivet>>#, skal datasættet gøres
 tilgængeligt for omverden i overensstemmelse med INSPIRE-reglerne, og
 det indebærer, at datasættet (også) skal udstilles på en måde, så det
 følger INSPIREs dataspecifikationer - som bl.a. indeholder datamodeller
 for det relevante tema. Uanset om et datasæt er omfattet af
-INSPIRE-direktivet eller ej, så bør man bruge INSPIREs datamodel for det
+[.cite]#INSPIRE-direktivet# eller ej, så bør man bruge INSPIREs datamodel for det
 relevante tema som inspiration ved udarbejdelse af nye datamodeller.
 
 [#fda-hvidbog]
@@ -30,18 +30,16 @@ sektor. Hvidbog om fællesoffentlig digital arkitektur_. Version 1.0.
 juni 2017. Tilgængelig på:
 https://arkitektur.digst.dk/node/1175[https://arkitektur.digst.dk/node/1175,title=Den digitalt sammenhængende offentlige sektor. Hvidbog om fællesoffentlig digital arkitektur]
 
-Dokumentet beskriver arkitekturprincipper og –regler, som understøtter
+[.cite]#https://arkitektur.digst.dk/node/1175[Den digitalt sammenhængende offentlige sektor. Hvidbog om fællesoffentlig digital arkitektur]# beskriver arkitekturprincipper og –regler, som understøtter
 en sammenhængende digitalisering af den offentlige sektor.
 
 [#fda-modelregler]
 ==== Fællesoffentlige regler for begrebs- og datamodellering
 
 [.bibliographicaldetails]
---
 DIGITALISERINGSSTYRELSEN. _Fællesoffentlige regler for begrebs- og datamodellering_. Version 2.1.1. 2 august 2021. [Set 5 oktober 2023]. Tilgængelig på: https://arkitektur.digst.dk/node/1091[https://arkitektur.digst.dk/node/1091,title=Fællesoffentlige regler for begrebs- og datamodellering]
---
 
-Dokumentet sætter regler for begrebsmodeller og datamodeller, så data
+[.cite]#https://arkitektur.digst.dk/node/1091[Fællesoffentlige regler for begrebs- og datamodellering]# sætter regler for begrebsmodeller og datamodeller, så data
 forstås korrekt og passer sammen, når de anvendes på tværs af
 myndighedernes forskellige processer og it-systemer. Modelreglerne skal
 bl.a. sikre, at der anvendes samme modelleringssprog, at begreber og
@@ -72,11 +70,11 @@ også xref:Identifikatorer.adoc#identifikatorer[Identifikatorer].
 [.bibliographicaldetails]
 DS/ISO 704:2022, _Begrebsarbejde – Principper og metoder_
 
-Standarden beskriver hvordan objekter, begreber, definitioner og betegnelser relaterer sig til hinanden. Den opstiller også principper for hvordan termer dannes og hvordan definitioner udarbejdes.
+[.cite]#DS/ISO 704# beskriver hvordan objekter, begreber, definitioner og betegnelser relaterer sig til hinanden. Den opstiller også principper for hvordan termer dannes og hvordan definitioner udarbejdes.
 
 [NOTE]
 ====
-Guide to terminology <<suon01>> er en praktisk introduktion til principper og metoder for praktisk terminologiarbejde. Bogen giver praktiske eksempler på, hvordan man udarbejder definitioner.
+[.cite]#Guide to terminology# <<suon01>> er en praktisk introduktion til principper og metoder for praktisk terminologiarbejde. Bogen giver praktiske eksempler på, hvordan man udarbejder definitioner.
 ====
 
 [#19103]
@@ -86,7 +84,7 @@ Guide to terminology <<suon01>> er en praktisk introduktion til principper og me
 DS/ISO 19103:2015, _Geografisk information - Konceptuelt
 modelleringssprog_
 
-Denne internationale standard angiver regler og retningslinjer for
+[.cite]#DS/ISO 19103# angiver regler og retningslinjer for
 brugen af et konceptuelt modelleringssprog inden for rammerne af
 geografisk information. Det valgte konceptuelle modelleringssprog er UML
 (Unified Modelling Language).
@@ -103,7 +101,7 @@ Standarden anvendes i INSPIRE og som basis alle modeller der indgår i
 standarder fra ISO 19100-serien.
 
 ISO/TC 211 vedligeholder og opbevarer alle UML-modeller som indgår i de
-forskellige ISO/TC 211 standarder i det https://github.com/ISO-TC211/HMMG[“Harmonized Model Repository”].
+forskellige ISO/TC 211 standarder i det [.cite]#https://github.com/ISO-TC211/HMMG[Harmonized Model Repository]#.
 Det gør, at man kan bruge disse typer i sine egne geografiske
 datamodeller.
 ====
diff --git a/docs/Forord.adoc b/docs/Forord.adoc
@@ -1,12 +1,18 @@
-Dette dokument indeholder en detaljeret gennemgang af relevante 
+:sectnums!:
+
+[#forord]
+== Forord
+
+[.cite]#{doctitle}# indeholder en detaljeret gennemgang af relevante 
 standarder og best practices til brug for indsamling, behandling og 
 distribution af geodata, herunder i forbindelse med opbygning af 
 digitale forvaltningsløsninger. Dette understøtter interoperabilitet 
 mellem data og systemer, så data kan anvendes og genbruges på tværs.
 
-.Målgruppe
+
 [#maalgruppe]
---
+=== Målgruppe
+
 Dette dokument er primært målrettet udviklere og arkitekter med ansvar 
 for data og systemer i en forretning, som bygger på stedbestemmelse. 
 Denne målgruppe har brug for praktisk viden om, hvilke standarder og 
@@ -17,19 +23,18 @@ Dette dokument er også målrettet dem der har det overordnede ansvar
 for en forretning, som bygger på stedbestemmelse. Denne målgruppe har 
 brug for at have et overblik over standarder til brug i f.eks. 
 kravspecikationer mv.
---
 
-.Baggrund
+
 [#baggrund]
---
-{author} og Digitaliseringsstyrelsen udgav i 2020 _Vejledning om geografi i lovgivningen_ <<vej-2020-9428>>. Vejledningen indeholdt https://www.retsinformation.dk/eli/retsinfo/2020/9428#id4633c61a-4caf-4890-b270-3e0b5e80f6b9[bilaget _Anbefalede standarder ved etablering af geodata_]. Standarderne kan nemlig være relevante at anvende i forbindelse med anvendelse af geografi i lovgivningen, særligt i forhold til den metode til stedbestemmelse i lovgivningen hvor der henvises til et register.
+=== Baggrund
+
+{author} (dengang Styrelsen for Dataforsyning og Effektivisering) og Digitaliseringsstyrelsen udgav i 2020 [.cite]#Vejledning om geografi i lovgivningen# <<vej-2020-9428>>. Vejledningen indeholdt https://www.retsinformation.dk/eli/retsinfo/2020/9428#id4633c61a-4caf-4890-b270-3e0b5e80f6b9[bilaget _Anbefalede standarder ved etablering af geodata_]. Standarderne kan nemlig være relevante at anvende i forbindelse med anvendelse af geografi i lovgivningen, særligt i forhold til den metode til stedbestemmelse i lovgivningen hvor der henvises til et register.
 
-Siden hen har {author} udgivet _Anbefalede standarder for geodata_ som en selvstændig publikation. Det gør indeholdet lettere tilgængeligt, læsevenligt og mindre kompliceret at opdatere. Og det kan bedre anvendes i anden kontekst end retsgeografi. _Vejledning om geografi i lovgivningen_ udkom i en ny version i 2023 <<vej-2023-9780>> og henviser nu til _Anbefalede standarder for geodata_.
---
+Siden hen har {author} udgivet _Anbefalede standarder for geodata_ som en selvstændig publikation. Det gør indeholdet lettere tilgængeligt, læsevenligt og mindre kompliceret at opdatere. Og det kan bedre anvendes i anden kontekst end retsgeografi. [.cite]#Vejledning om geografi i lovgivningen# udkom i en ny version i 2023 <<vej-2023-9780>> og henviser nu til [.cite]#Anbefalede standarder for geodata#.
 
-.Læsevejledning
 [#laesevejledning]
---
+=== Læsevejledning
+
 Dette dokument er opbygget på følgende måde:
 
 . Det første afsnit beskriver de lovgivningsmæssige rammer for indholdet og de to centrale standardiseringsorganisationer i geodatadomænet, som de behandlede dokumenter primært kommer fra.
@@ -53,4 +58,4 @@ Beskrivelse af standard/best practice.
 NOTE: Supplerende bemærkninger, f.eks. hvor man kan finde XML-skemaer til standarden, eller hvordan dokumentet relaterer sig til andre dokumenter.
 ====
 
---
+:sectnums: