diff options
| author | Jonas Smedegaard <dr@jones.dk> | 2025-05-24 11:32:34 +0200 |
|---|---|---|
| committer | Jonas Smedegaard <dr@jones.dk> | 2025-05-24 11:32:34 +0200 |
| commit | c8eef6faa84aef5245da05215821ae03ad6054eb (patch) | |
| tree | db27efb585783147ddc2d6c539d624516ac83236 | |
| parent | 85e5c51dab5877362afc3203b84dc56a4e6cf2c8 (diff) | |
avoid mentioning YAML or TOML
| -rw-r--r-- | _conclusion.qmd | 15 | ||||
| -rw-r--r-- | _markdown.qmd | 2 | ||||
| -rw-r--r-- | _pandoc.qmd | 2 |
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, |
