diff options
| -rw-r--r-- | _background.qmd (renamed from _formats.qmd) | 44 | ||||
| -rw-r--r-- | _workflow.qmd | 34 | ||||
| -rw-r--r-- | report.qmd | 8 |
3 files changed, 31 insertions, 55 deletions
diff --git a/_formats.qmd b/_background.qmd index 092c989..883a528 100644 --- a/_formats.qmd +++ b/_background.qmd @@ -1,3 +1,7 @@ +This chapter will provide and analysis +of the data format Markdown +and the Markdown-based publishing system Quarto. + This project mainly involves navigating in and altering data structures. Main data structures are the document formats Markdown, HTML and PDF, and the abstract data language RDF, @@ -52,22 +56,32 @@ in core tools others offer optional support e.g. through plugins [@Heesch2025; @Sphinx2025; @JSDoc2023]. -## HTML - -*TODO* - -## PDF - -*TODO* - -## RDF - -*TODO* +## Quarto -### RDFa +Collection of interrelated POSIX scripts and Pandoc extensions +for enabling semantic annotations in Markdown-based authoring workflows. -*TODO* +* filter extension to capture annotations + * identify semantic metadata in stylistic metadata part of Pandoc YAML header + * identify semantic metadata in content part of Pandoc document structure + * append semantic metadata to Pandoc YAML document header + * strip identified metadata from stylistic metadata and content +* output format extension to generate PDF + * read semantic metadata from Pandoc YAML document header + * structure semantic metadata as RDF triples + * append RDF triples serialized as part of XMP metadata in PDF +* output format extension to generate web page + * read semantic metadata from Pandoc YAML document header + * structure semantic metadata as RDF triples + * append RDF triples serialized as RDFa -### XMP +### Interfaces -*TODO* +* Pandoc document object model (DOM) +* Resource Description Framework (RDF) + * XMP + * RDFa +* Markdown + * Semantic Markdown +* CommonMark + * Semantic CommonMark diff --git a/_workflow.qmd b/_workflow.qmd deleted file mode 100644 index 84a33d4..0000000 --- a/_workflow.qmd +++ /dev/null @@ -1,34 +0,0 @@ -Here is a brief overview of the text authoring workflow -using Quarto publishing system. - -*TODO: rewrite these loose notes...* - -## Tooling - -Collection of interrelated POSIX scripts and Pandoc extensions -for enabling semantic annotations in Markdown-based authoring workflows. - -* filter extension to capture annotations - * identify semantic metadata in stylistic metadata part of Pandoc YAML header - * identify semantic metadata in content part of Pandoc document structure - * append semantic metadata to Pandoc YAML document header - * strip identified metadata from stylistic metadata and content -* output format extension to generate PDF - * read semantic metadata from Pandoc YAML document header - * structure semantic metadata as RDF triples - * append RDF triples serialized as part of XMP metadata in PDF -* output format extension to generate web page - * read semantic metadata from Pandoc YAML document header - * structure semantic metadata as RDF triples - * append RDF triples serialized as RDFa - -## Interfaces - -* Pandoc document object model (DOM) -* Resource Description Framework (RDF) - * XMP - * RDFa -* Markdown - * Semantic Markdown -* CommonMark - * Semantic CommonMark @@ -61,13 +61,9 @@ and by extension you editors {{< include _intro.qmd >}} -# Existing data formats +# Analysis of existing framework -{{< include _formats.qmd >}} - -# Existing authoring workflow - -{{< include _workflow.qmd >}} +{{< include _background.qmd >}} # Program and its affects on workflow |