diff options
| author | Jonas Smedegaard <dr@jones.dk> | 2025-03-27 08:10:12 +0100 |
|---|---|---|
| committer | Jonas Smedegaard <dr@jones.dk> | 2025-03-27 08:10:36 +0100 |
| commit | 3babb9c082bb636da3e48c781bab27c4c8af083d (patch) | |
| tree | b784c3991b2a92093decf8a02f96ef0ead6909b1 | |
| parent | 054f1c0b2ad0277536e9927023966a8e6aaf8824 (diff) | |
small improvements to intro and headers
| -rw-r--r-- | _background.qmd | 2 | ||||
| -rw-r--r-- | _constraints.qmd | 4 | ||||
| -rw-r--r-- | _design.qmd | 2 | ||||
| -rw-r--r-- | _intro.qmd | 16 |
4 files changed, 18 insertions, 6 deletions
diff --git a/_background.qmd b/_background.qmd index d7b4b91..fe2f35f 100644 --- a/_background.qmd +++ b/_background.qmd @@ -92,7 +92,7 @@ in core tools others offer optional support e.g. through plugins [@Heesch2025; @Sphinx2025; @JSDoc2023]. -## Quarto +## Pandoc and Quarto Pandoc is a document converter built around the markdown markup language, able to parse from and serialise to many Markdown dialects diff --git a/_constraints.qmd b/_constraints.qmd index 568e529..be415d7 100644 --- a/_constraints.qmd +++ b/_constraints.qmd @@ -17,3 +17,7 @@ For syntactically incorrect or structurally unsupported annotations... * the annotation **must not** disappear from visual output * visual output **should** include the annotation in source form + +## Plan + +*TODO* diff --git a/_design.qmd b/_design.qmd index 2ff9a7a..0c96016 100644 --- a/_design.qmd +++ b/_design.qmd @@ -1,5 +1,7 @@ *TODO* +## Readability + ## XMP, RDFa and RDF RDF is an abstract data model for knowledge graphs, @@ -16,10 +16,10 @@ You can add authors, supervisors and publication date as a YAML structure at the top of the text. And you can produce a web page or a PDF document from your text, sensibly styled and laid out according to academic conventions. -You cannot, however, annotate a string according to content domain. +You cannot, however, annotate a string +contextually related an arbitrary content domain +(only navigationally for hypertext and quotationally for citations). -Quarto supports hypertext and citation annotations, -but not arbitrary domain-specific annotations. You can spell out in prose that one set of numbers is in meter and another in nautical miles, or that one citation is supportive and another a rebuttal, @@ -33,8 +33,14 @@ and as intuitive and unobtrusive writing aid. ## Problem formulation -The aim of this project is to extend Pandoc and Quarto -to support domain-specific annotations. +Quarto supports hypertext and citation annotations, +and document-wide metadata. +The aim of this project is to extend +Pandoc processing and Quarto authoring workflow +to support writing arbitrary domain-specific annotations +which are converted to metadata, +if possible preserving reference to location of the string. + This aim has been framed with the following problem statement: **How can Pandoc |