From fa348679c737a06dd9c74caaab78a035abc89d16 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Tue, 18 Mar 2025 09:29:37 +0100 Subject: rename chapter Analysis... -> Technologies --- _design.qmd | 29 ----------------------------- _workflow.qmd | 34 ++++++++++++++++++++++++++++++++++ report.qmd | 8 ++++---- 3 files changed, 38 insertions(+), 33 deletions(-) delete mode 100644 _design.qmd create mode 100644 _workflow.qmd diff --git a/_design.qmd b/_design.qmd deleted file mode 100644 index 6153f05..0000000 --- a/_design.qmd +++ /dev/null @@ -1,29 +0,0 @@ -*TODO: rewrite these loose notes...* - -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 diff --git a/_workflow.qmd b/_workflow.qmd new file mode 100644 index 0000000..84a33d4 --- /dev/null +++ b/_workflow.qmd @@ -0,0 +1,34 @@ +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 diff --git a/report.qmd b/report.qmd index a686670..fae00ef 100644 --- a/report.qmd +++ b/report.qmd @@ -59,15 +59,15 @@ TODO {{< include _intro.qmd >}} -# Analysis and Design +# Technologies -## Markdown +## Data formats {{< include _markdown.qmd >}} -## Design +## Authoring workflow -{{< include _design.qmd >}} +{{< include _workflow.qmd >}} # Description of the Program -- cgit v1.2.3