Skip to content

Commit

Permalink
Tilføj indholdet fra bilag 3 af Vejledning om geografi i lovgivningen
Browse files Browse the repository at this point in the history 
Ændringer i forhold til den oprindelige tekst:
- tilføjelse af en indledende tekst med målgruppe, baggrund og
læsevejledning
- tilføjelse af noter ang. standarder som skal købes vs. kan findes
online
- opdatering af beskrivelse af INSPIRE-direktiv
- rettelse af nogle (stave)fejl
- opdatering af bestemte URL'er
  • Loading branch information
@heidivanparys
heidivanparys committed Dec 22, 2022
1 parent c613b32 commit b318470
Show file tree
Hide file tree
Showing 31 changed files with 2,519 additions and 0 deletions.
65 changes: 65 additions & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# From https://github.com/github/gitignore/blob/218a941be92679ce67d0484547e3e142b2f5f6f0/Global/Eclipse.gitignore
.metadata
bin/
tmp/
*.tmp
*.bak
*.swp
*~.nib
local.properties
.settings/
.loadpath
.recommenders

# External tool builders
.externalToolBuilders/

# Locally stored "Eclipse launch configurations"
*.launch

# PyDev specific (Python IDE for Eclipse)
*.pydevproject

# CDT-specific (C/C++ Development Tooling)
.cproject

# CDT- autotools
.autotools

# Java annotation processor (APT)
.factorypath

# PDT-specific (PHP Development Tools)
.buildpath

# sbteclipse plugin
.target

# Tern plugin
.tern-project

# TeXlipse plugin
.texlipse

# STS (Spring Tool Suite)
.springBeans

# Code Recommenders
.recommenders/

# Annotation Processing
.apt_generated/
.apt_generated_test/

# Scala IDE specific (Scala & Java development for Eclipse)
.cache-main
.scala_dependencies
.worksheet

# Uncomment this line if you wish to ignore the project description file.
# Typically, this file would be tracked if it contains build/dependency configurations:
.project


# Added, not from https://github.com/github/gitignore/blob/218a941be92679ce67d0484547e3e142b2f5f6f0/Global/Eclipse.gitignore
target/
395 changes: 395 additions & 0 deletions LICENSE.md
View file

Large diffs are not rendered by default.

27 changes: 27 additions & 0 deletions build/create_html.ps1
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Windows PowerShell script to create the HTML file.
# saxonJar is the location of the Saxon jar file
param([Parameter(Mandatory=$true)] $saxonJar)

# change to unicode
[console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding

$folder = "..\target"
if (Test-Path $folder) {
Remove-Item -Recurse $folder
Write-Host "Deleted folder " + $folder
New-Item $folder -ItemType Directory
Write-Host "Folder " + $folder + " created successfully"
}

$assetsFolder = $folder + "\assets"
Copy-Item -Path "..\docs\assets" -Destination $assetsFolder -Recurse

# retrieve today's date, for setting the revision date
$today = Get-Date -Format "yyyy-MM-dd"

Write-Host "Running asciidoctorj"
$tmp_output = "index_tmp.html"
asciidoctorj -b xhtml5 -a revdate=$today -a stylesheet! -o $tmp_output -D $folder ..\docs\index.adoc
Write-Host "Running Saxon"
java -jar $saxonJar -s:..\target\$tmp_output -xsl:prepare_html_for_styling.xsl -o:..\target\index.html
Write-Host "Finished"
82 changes: 82 additions & 0 deletions build/prepare_html_for_styling.xsl
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/1999/xhtml" xmlns:x="http://www.w3.org/1999/xhtml" exclude-result-prefixes="x">
<!--
html-version: see https://www.saxonica.com/documentation11/index.html#!xsl-elements/output og
https://www.w3.org/TR/xslt-30/
include-content-type: meta-tag med Content-Type er ikke nødvendig, da <meta charset="utf-8"/> allerede er til stede
omit-xml-declaration: hvis ikke til stede (default: no), kommer der en fejl på https://validator.w3.org,
"XML processing instructions are not supported in HTML"
-->
<xsl:output method="xhtml" html-version="5.0" include-content-type="no" omit-xml-declaration="yes" indent="no" />
<!-- Kopiér (medmindre et andet template er "matched" -->
<xsl:template match="/|@*|node()">
<xsl:copy>
<xsl:apply-templates select="@*|node()" />
</xsl:copy>
</xsl:template>
<!-- Tilføj data-theme -->
<xsl:template match="x:html">
<html xmlns="http://www.w3.org/1999/xhtml" lang="da" data-theme="light">
<xsl:apply-templates select="@*|node()" />
</html>
</xsl:template>
<!-- Kopiér CSS som det er, uden XML-escaping af f.eks. > tegn -->
<xsl:template match="x:style">
<style>
<xsl:value-of disable-output-escaping="yes" select="text()" />
</style>
</xsl:template>
<!-- Transformér header; tilføj container for layout -->
<xsl:template match="x:body">
<body>
<xsl:apply-templates select="@*" />
<xsl:apply-templates select="x:div[@id='header']" />
<div class="ds-container ds-grid-1-2">
<xsl:apply-templates select="x:div[@id='header']/x:div[@id='toc']"/>
<xsl:apply-templates select="x:div[@id='content']"/>
</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">
<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>
</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: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>
<nav class="ds-nav-vertical">
<xsl:apply-templates select="x:ul"/>
</nav>
</div>
</xsl:template>
<!-- Anvend main i stedet for div -->
<xsl:template match="x:div[@id='content']">
<main id="content" class="ds-padding">
<xsl:apply-templates select="@*|node()"/>
</main>
</xsl:template>
</xsl:stylesheet>
105 changes: 105 additions & 0 deletions docs/BegrebsOgDatamodeller.adoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
[#begrebs-datamodeller]
=== Begrebs- og datamodeller

Det er et arkitekturprincip i Digitaliseringsstyrelsens <<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
anvendelser af data. Princippet, om at gode data deles og genbruges, er
gjort mere konkret i form af fire arkitekturregler:

* Del og genbrug data.
* Anvend fælles regler for dokumentation af data.
* 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
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
relevante tema som inspiration ved udarbejdelse af nye datamodeller.

[#fda-hvidbog]
==== Hvidbog om fællesoffentlig digital arkitektur

[.bibliographicaldetails]
DIGITALISERINGSSTYRELSEN. _Den digitalt sammenhængende offentlige
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
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.0.0. 2019. Tilgængelig på: https://arkitektur.digst.dk/metoder/regler-begrebs-og-datamodellering[https://arkitektur.digst.dk/metoder/regler-begrebs-og-datamodellering,title=Fællesoffentlige regler for begrebs- og datamodellering]
--

Dokumentet 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
data er navngivet entydigt og meningsfuldt, og at begreber og data er
defineret fyldestgørende.

[NOTE]
====
I høj fokus skal være egenskaber som går igen i mange datasæt. Eksempler
er forskellige typer datoer (forslagsdato, vedtagelsesdato, osv.) og
status ifm. et objekts livscyklus.
Man skal være opmærksom på, hvordan data administreres, især hvad angår:
* historik: egenskaber som beskriver et objekts levetid i forhold til
virkningstid og registreringstid stiller store krav til det it-system,
der skal holde styr på data. Se også punkt 5 om historik.
* sammenhæng: relationer til andre modeller forudsætter, at man i
praksis kan og vil anvende de data, som de andre modeller beskriver, se
også punkt 2 om identifikatorer.
====

[#fda-modelregler-vejledning]
==== Vejledning i begrebs- og datamodellering

[.bibliographicaldetails]
FÆLLESOFFENTLIG DIGITAL ARKITEKTUR, _Vejledning i begrebs- og
datamodellering_ [igangværende arbejde]

Vejledningen uddyber reglerne beskrevet i <<fda-modelregler>> og beskriver processerne omkring
modellering.

[#19103]
==== DS/ISO 19103 Konceptuelt modelleringssprog

[.bibliographicaldetails]
DS/ISO 19103:2015, _Geografisk information - Konceptuelt
modelleringssprog_

Denne internationale standard 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).

Målet med denne standard er UML-skemaer, der beskriver geografisk
information.

Derudover beskriver denne standard begreber såsom CharacterString,
DateTime, osv.

[NOTE]
====
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”].
Det gør, at man kan bruge disse typer i sine egne geografiske
datamodeller.
====
59 changes: 59 additions & 0 deletions docs/Forord.adoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
Dette dokument 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]
--
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
best practices der er nødvendige og anvendelige i forskellige tilfælde,
og hvor og hvordan disse standarder og best practices kan tilgås.

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]
--
Version 1.0.0 af dette dokument og bilag 3 til _Vejledning om geografi i
lovgivningen_ <<vej-2020-9428>> er indholdsmæssigt identisk, på nær den
indledende tekst. Standarderne kan nemlig være relevante at anvende i
forbindelse med anvendelse af geografi i lovgivningen, særligt i forhold
til registermetoden (beskrevet i _Vejledning om geografi i
lovgivningen_).
--

.Læsevejledning
[#laesevejledning]
--
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.
. Det andet afsnit er en gennemgang af de relevante dokumenter, delt op i emnekategorier, og følger følgende struktur:
+
[#eksempel_opbygning]
====
[.title]
Emnekategori

Introducerende tekst til kategorien.

[.title]
Titel på standard eller best practice

[.bibliographicaldetails]
Dokumentets bibliografiske detajler.

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.
====

--
5 changes: 5 additions & 0 deletions docs/Fortegnelse.adoc
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
[#fortegnelse]
== Standarder og best practices på udvalgte områder med relation til geodata

Standarder og best practices på følgende områder er opført og beskrevet
i de næste afsnit.
Loading

0 comments on commit b318470

Please sign in to comment.