diff options
| author | Jonas Smedegaard <dr@jones.dk> | 2025-05-24 14:26:51 +0200 |
|---|---|---|
| committer | Jonas Smedegaard <dr@jones.dk> | 2025-05-24 14:26:51 +0200 |
| commit | 7f610808af0a83264d9e2dd52620b01bea4d0091 (patch) | |
| tree | 26bc05ea5ae624f2f214f5ffec1cbc7666792da9 | |
| parent | 85447f31197306a540af3b761700ae16ff75a110 (diff) | |
rename filter semantic-markdown -> sem-md; consistently capitalize spec Semantic Markdown
| -rw-r--r-- | Makefile | 4 | ||||
| -rw-r--r-- | _conclusion.qmd | 2 | ||||
| l--------- | _extensions/ruc-play/sem-md | 1 | ||||
| -rw-r--r-- | _intro.qmd | 2 | ||||
| -rw-r--r-- | _markdown.qmd | 2 | ||||
| -rw-r--r-- | example/example.qmd | 2 | ||||
| -rw-r--r-- | report.qmd | 4 | ||||
| -rw-r--r-- | sem-md/_extension.yaml (renamed from _extensions/ruc-play/semantic-markdown/_extension.yaml) | 4 | ||||
| -rw-r--r-- | sem-md/sem-md.lua (renamed from _extensions/ruc-play/semantic-markdown/semantic-markdown.lua) | 6 |
9 files changed, 14 insertions, 13 deletions
@@ -4,9 +4,9 @@ PDF_DOCUMENTS = _site/report.pdf include _make/*.mk -DOCUMENT_APPENDIX_REGEX = Pandoc filter semantic-markdown +DOCUMENT_APPENDIX_REGEX = Pandoc filter sem-md -FILTER = _extensions/ruc-play/semantic-markdown/semantic-markdown.lua +FILTER = _extensions/ruc-play/sem-md/sem-md.lua DIFFTESTS = $(patsubst %.md,%,$(wildcard test/*.md)) diff --git a/_conclusion.qmd b/_conclusion.qmd index 688b343..446a421 100644 --- a/_conclusion.qmd +++ b/_conclusion.qmd @@ -34,7 +34,7 @@ and streamlining of automated document layout. ### Implementation as import extension This project has been implementet as a cleanup filter -for a misparsing of semantic Markdown as regular Markdown +for a misparsing of Semantic Markdown as regular Markdown (see @sec-misparsing). This approach was chosen based in an assumption on fitting better with existing uses of Pandoc, diff --git a/_extensions/ruc-play/sem-md b/_extensions/ruc-play/sem-md new file mode 120000 index 0000000..65c97a3 --- /dev/null +++ b/_extensions/ruc-play/sem-md @@ -0,0 +1 @@ +/home/jonas/Projects/PLAY/md/sem-md
\ No newline at end of file @@ -36,7 +36,7 @@ or "this uses the derogatory meaning of the term". A few years ago, a call was made on a blog to extend Markdown to cover semantic text annotations [@Francart2020]. -This led to a draft specification called "Semantic Markdown" +This led to the draft specification Semantic Markdown [@Smedegaard2022]; no actual implementation was made at the time, however. diff --git a/_markdown.qmd b/_markdown.qmd index f137b17..a82f49f 100644 --- a/_markdown.qmd +++ b/_markdown.qmd @@ -23,7 +23,7 @@ the renderers for `README.md` files at Github and Gitlab -- and because its syntax is thoroughly documented, separately from implementations of parsers of that dialect. -The second analysis covers the Markdown extension semantic-markdown, +The second analysis covers the Markdown extension Semantic Markdown, chosen because it covers semantic text annotation and is the only Markdown extension description that covers it, as far as the author of this paper is aware. diff --git a/example/example.qmd b/example/example.qmd index 57e03b5..7fb3421 100644 --- a/example/example.qmd +++ b/example/example.qmd @@ -4,7 +4,7 @@ format: html: minimal: true filters: - - semantic-markdown + - sem-md --- My name is @@ -114,9 +114,9 @@ are editorial comments not intended for inclusion in the final version.* \appendix -# Pandoc filter `semantic-markdown` {.appendix} +# Pandoc filter `sem-md` {.appendix} -```{.lua include="_extensions/ruc-play/semantic-markdown/semantic-markdown.lua" code-line-numbers="true"} +```{.lua include="sem-md/sem-md.lua" code-line-numbers="true"} ``` # Markdown syntax as PEG {.appendix #sec-def-peg} diff --git a/_extensions/ruc-play/semantic-markdown/_extension.yaml b/sem-md/_extension.yaml index 76b9a7a..22bfe98 100644 --- a/_extensions/ruc-play/semantic-markdown/_extension.yaml +++ b/sem-md/_extension.yaml @@ -1,6 +1,6 @@ -name: semantic-markdown +name: sem-md author: Jonas Smedegaard version: 0.0.1 contributes: filters: - - semantic-markdown.lua + - sem-md.lua diff --git a/_extensions/ruc-play/semantic-markdown/semantic-markdown.lua b/sem-md/sem-md.lua index abdb078..4c7ad01 100644 --- a/_extensions/ruc-play/semantic-markdown/semantic-markdown.lua +++ b/sem-md/sem-md.lua @@ -1,4 +1,4 @@ ---- semantic-markdown - Pandoc filter to process semantic hints +--- sem-md - Pandoc filter to process semantic annotations in Markdown --- --- SPDX-FileCopyrightText: 2025 Jonas Smedegaard <dr@jones.dk> --- SPDX-License-Identifier: GPL-3.0-or-later @@ -31,7 +31,7 @@ --- ``` --- --- This filter should transform the above text, with the command ---- `pandoc -L semantic-markdown.lua -t commonmark --wrap=preserve`, +--- `pandoc -L sem-md.lua -t commonmark --wrap=preserve`, --- into the below markdown text with semantic annotations as metadata: --- --- ```markdown @@ -62,7 +62,7 @@ --- ``` --- --- This filter should also transform the above text, with the command ---- `pandoc -L semantic-markdown.lua -t html --wrap=preserve`, +--- `pandoc -L sem-md.lua -t html --wrap=preserve`, --- into the below HTML text with embedded RDFa Lite 1.1 anotations, --- modulo wrapping of long lines: --- |
