aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-05-24 11:32:34 +0200
committerJonas Smedegaard <dr@jones.dk>2025-05-24 11:32:34 +0200
commitc8eef6faa84aef5245da05215821ae03ad6054eb (patch)
treedb27efb585783147ddc2d6c539d624516ac83236
parent85e5c51dab5877362afc3203b84dc56a4e6cf2c8 (diff)
avoid mentioning YAML or TOML
-rw-r--r--_conclusion.qmd15
-rw-r--r--_markdown.qmd2
-rw-r--r--_pandoc.qmd2
3 files changed, 11 insertions, 8 deletions
diff --git a/_conclusion.qmd b/_conclusion.qmd
index 62a3d5e..859f8e1 100644
--- a/_conclusion.qmd
+++ b/_conclusion.qmd
@@ -76,7 +76,7 @@ illustrated in @fig-phases.
Phase 2 will extend the Pandoc filter
to support extraction of annotations,
-storing them as document-wide metadata in the Markdown YAML section.
+storing them as an initial document-wide metadata section.
Phase 3 will extend the Pandoc filter further
to support translating annotations
@@ -94,11 +94,14 @@ Both XMP and RDFa are concrete formulations (serializations)
of Resource Description Framework (RDF),
an abstract language for expressing semantics.
-Both phases 2 and 3 will involve a more intimate parsing of annotations,
-to resolve their RDF statements
-in the form of so-called subject-predicate-object triplets,
-in order to rephrase (serialize) them
-to better fit embedding in YAML, HTML and PDF, respectively.
+Both phases 2 and 3 will involve a more intimate parsing of annotations.
+Each annotation statement needs to be parsed into abstract RDF
+and then serialised into concrete forms more suitable
+for either of
+Markdown (document-wide),
+HTML (text-specific)
+and PDF (document-wide and/or text-specific),
+respectively.
These extensions to the Pandoc-based workflow have uses in themselves,
and also enables further explorations into more complex workflows.
diff --git a/_markdown.qmd b/_markdown.qmd
index 4c2adc0..ac75d96 100644
--- a/_markdown.qmd
+++ b/_markdown.qmd
@@ -38,7 +38,7 @@ to metadata embedding formats of both PDF and HTML
## Syntax of Markdown dialect Commonmark
Markdown consists of blocks of content,
-optionally prepended a set of YAML-formatted Metadata blocks.
+optionally prepended a set of Metadata blocks.
Visually, this can be described using a syntax diagram
where the possible order of elements are laid out
diff --git a/_pandoc.qmd b/_pandoc.qmd
index 6f3653c..cef54a3 100644
--- a/_pandoc.qmd
+++ b/_pandoc.qmd
@@ -8,7 +8,7 @@ of the Markdown processor Pandoc.
Many dialects of Markdown have evolved,
some tightening the language for parsing efficiency and disambiguation,
some extending to cover additional structures
-and some including support for a YAML or TOML metadata header section.
+and some including support for a metadata header section.
Pandoc is a tool that can convert texts in Markdown dialects
into many document formats including HTML and (via LaTeX) PDF,