From 651fcfe553442965efbaec17891c4d205e0607a5 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 19 May 2025 14:26:59 +0200
Subject: merge sections contraints and design into markdown

---
 _markdown.qmd | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

(limited to '_markdown.qmd')

diff --git a/_markdown.qmd b/_markdown.qmd
index ff7b346..948eda8 100644
--- a/_markdown.qmd
+++ b/_markdown.qmd
@@ -1,3 +1,9 @@
+*FIXME: introduce extensions and extension sets (dialects)*
+
+*FIXME: Pick Commonmark as reference dialect*
+
+## Syntax of Markdown dialect Commonmark
+
 Markdown consists of blocks of content,
 optionally prepended a set of Metadata blocks.
 Visually, this can be described using a syntax diagram
@@ -63,3 +69,58 @@ by extending the Markdown language with additional types of annotation.
 
 Syntax diagrams for additional Markdown components are included
 as [Appendix @sec-def-dia].
+
+## Syntax of extension Semantic Markdown
+
+*FIXME: write this!*
+
+## Expectations of processors
+
+*FIXME: write this!*
+
+* hvad skal med
+* hvad skal ikke med
+* hvis PDF..., hvad så?
+
+Dette afsnit udgør "requirements"
+
+### Readability
+
+In the source format of Markdown with with annotations...
+
+* the syntax for annotation **should* be relatively human comprehensible
+  (in the same spirit as Markdown -- e.g. \*\*strong emphasis\*\*)
+* annotation syntax **must not** conflict with core Markdown
+  (i.e. must not cause disambiguations)
+* annotation syntaxt **should not** conflict with other Markdown extensions
+
+For syntactically correct and structurally supported annotations...
+
+* visual output **must** be identical to source without the annotation
+* metadata of output **must** contain the annotation
+
+For syntactically incorrect or structurally unsupported annotations...
+
+* the annotation **must not** disappear from visual output
+* visual output **should** include the annotation in source form
+
+### XMP, RDFa and RDF
+
+RDF is an abstract data model for knowledge graphs,
+usable for domain-specific annotations:
+Terminology for a domain is established by referencing a shared ontology,
+and terms are composed as sets of subject-predicate-object triples.
+RDF includes one language, Turtle, strives to be human readable,
+and languages for embedding triples into other data structures,
+notably XMP for PDF files and RDFa for HTML.
+
+RDF is an abstract data model for knowledge graphs.
+Multiple RDF languages exist,
+each covering all or subsets of the RDF model,
+including human readability optimized Turtle,
+RDFa for HTML embedding
+and XMP for PDF embedding.
+Each RDF language have different constraints,
+e.g. the XMP language for storing RDF in media files
+can express express one RDF graph in each XMP object
+[@Adobe2012, p. 9].
-- 
cgit v1.2.3

