aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-03-20 11:58:32 +0100
committerJonas Smedegaard <dr@jones.dk>2025-03-20 11:58:32 +0100
commita7660fdb3f5987626433170e5c9a9624f0f463a6 (patch)
treefd34294febaf803d68ce802cee54c44a139a8570
parent479d9c23d3cb983dfa541e6db2a96e4ae41c0388 (diff)
refine intro
-rw-r--r--_intro.qmd34
1 files changed, 26 insertions, 8 deletions
diff --git a/_intro.qmd b/_intro.qmd
index 3b62d7a..d0546e2 100644
--- a/_intro.qmd
+++ b/_intro.qmd
@@ -60,6 +60,32 @@ is freedom of choice regarding authoring tools
## Problem formulation
+The aim of this project is to extend Pandoc and Quarto
+to support inclusion of generic annotations
+as integral part of its Markdown-based authoring process.
+This aim has been framed with the following problem statement:
+
+*FIXME: narrow down question to the scope of Pandoc and Quarto*
+
+**How can Unix-style tools for writing technical prose
+be extended to support ontological annotations?**
+
+To aid in achieving that goal,
+the problem statement has been divided into the following subquestions:
+
+* What are the core qualities of Markdown,
+ and how can the Markdown syntax be extended
+ while maintaining those qualities?
+* How do Pandoc and Quarto process Markdown input to HTML or PDF output,
+ and how can this workflow be derived
+ to cover a new flavor of Markdown?
+* Which approach to altering the workflow of Pandoc and Quarto
+ is more likely efficient and long-term sustainable?
+
+## Motivation
+
+*FIXME: rewrite to be project motivations (not author motivations)*
+
The author of this project prefers
a console-based WYSIWYM authoring environment,
and for political reasons an environment
@@ -73,14 +99,6 @@ which is automatically processed by the tool Pandoc
into any of a range of output formats
including LaTeX with further postprocessing into PDF.
-The aim of this project is to extend Pandoc and Quarto
-to support inclusion of generic annotations
-as integral part of the authoring process.
-This aim has been framed with the following problem statement:
-
-**How can Unix-style tools for wiritng technical prose
-be extended to support ontological annotations?**
-
## Implementation idea and brief plan
Implement plugins for the Pandoc document converter