aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-03-18 09:40:24 +0100
committerJonas Smedegaard <dr@jones.dk>2025-03-18 09:40:24 +0100
commit57dcb94ba9728def667799d3e81f59235259b33d (patch)
tree78b34f75b0c76c421de4967227aeb3dd91ccfbb7
parentfa348679c737a06dd9c74caaab78a035abc89d16 (diff)
rename file markdown -> formats, and expand content
-rw-r--r--_formats.qmd (renamed from _markdown.qmd)31
-rw-r--r--report.qmd2
2 files changed, 30 insertions, 3 deletions
diff --git a/_markdown.qmd b/_formats.qmd
index 56d4c76..dc88a61 100644
--- a/_markdown.qmd
+++ b/_formats.qmd
@@ -1,3 +1,10 @@
+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,
+serialised as RDFa (embedded in HTML) and PDF (embedded in PDF).
+
+## Markdown
+
Markdown is a text markup language
with an emphasis on being easy for humans to read
[@Gruber2004].
@@ -26,7 +33,7 @@ Similarly the format LaTeX is also plaintext,
but its markdown arguably distracts the reading process
[@Mailund2019chap2, p. 9].
-## Alternatives
+### Alternatives
Other human-readable document source formats exists.
@@ -34,7 +41,7 @@ FIXME reStructuredText.
FIXME Org-mode.
FIXME AsciiDoc.
-## Integration
+### Integration
Markdown is in widespread use.
@@ -46,3 +53,23 @@ in core tools
[@Microsoft2023; @Oracle2025; @RustTeam2024];
others offer optional support e.g. through plugins
[@Heesch2025; @Sphinx2025; @JSDoc2023].
+
+## HTML
+
+*TODO*
+
+## PDF
+
+*TODO*
+
+## RDF
+
+*TODO*
+
+### RDFa
+
+*TODO*
+
+### XMP
+
+*TODO*
diff --git a/report.qmd b/report.qmd
index fae00ef..1284007 100644
--- a/report.qmd
+++ b/report.qmd
@@ -63,7 +63,7 @@ TODO
## Data formats
-{{< include _markdown.qmd >}}
+{{< include _formats.qmd >}}
## Authoring workflow