Added new tests for shortcodes (especially keyworded arguments)

tests/25-shortcode-firstuse/Readme.md

@@ -0,0 +1,12 @@
+This test demonstrates how to force the "first / next use" in shortcodes.
+
+The `first_use` argument accepts "boolean" strings:
+
+- `true`
+- `false`
+- `yes`
+- `no`
+- `y`
+- `n`
+
+It is also case-insensitive: `true`, `TRUE`, and `tRuE` are identical.

tests/25-shortcode-firstuse/expected.md

@@ -0,0 +1,14 @@
+# List Of Acronyms {#acronyms_HEADER_LOA .loa}
+
+[RL]{#acronyms_RL}
+:   Reinforcement Learning
+
+# Introduction {#intro}
+
+This paragraph mentions [Reinforcement Learning (RL)](#acronyms_RL) for the first time.
+
+And now, in this paragraph, [RL](#acronyms_RL) is in short form.
+
+Here, we force the first use again: [Reinforcement Learning (RL)](#acronyms_RL).
+
+And here in "next use" (also case-insensitive): [RL](#acronyms_RL).

tests/25-shortcode-firstuse/input.qmd

@@ -0,0 +1,16 @@
+---
+acronyms:
+  keys:
+    - shortname: RL
+      longname: Reinforcement Learning
+---
+
+# Introduction {#intro}
+
+This paragraph mentions {{< acr RL >}} for the first time.
+
+And now, in this paragraph, {{< acr RL >}} is in short form.
+
+Here, we force the first use again: {{< acr RL first_use=true >}}.
+
+And here in "next use" (also case-insensitive): {{< acr RL first_use=FaLSe >}}.

tests/26-shortcode-insertlinks/Readme.md

@@ -0,0 +1,12 @@
+This test demonstrates how to force insertion of links in shortcodes.
+
+The `insert_links` argument accepts "boolean" strings:
+
+- `true`
+- `false`
+- `yes`
+- `no`
+- `y`
+- `n`
+
+It is also case-insensitive: `true`, `TRUE`, and `tRuE` are identical.

tests/26-shortcode-insertlinks/expected.md

@@ -0,0 +1,10 @@
+# List Of Acronyms {#acronyms_HEADER_LOA .loa}
+
+[RL]{#acronyms_RL}
+:   Reinforcement Learning
+
+# Introduction {#intro}
+
+This paragraph has a link: [Reinforcement Learning (RL)](#acronyms_RL).
+
+But this one will not: RL.

tests/26-shortcode-insertlinks/input.qmd

@@ -0,0 +1,12 @@
+---
+acronyms:
+  keys:
+    - shortname: RL
+      longname: Reinforcement Learning
+---
+
+# Introduction {#intro}
+
+This paragraph has a link: {{< acr RL insert_links=true >}}.
+
+But this one will not: {{< acr RL insert_links=false >}}.

tests/27-shortcode-nonexisting/Readme.md

@@ -0,0 +1,2 @@
+This test demonstrates how to choose the behaviour when an acronym is not found
+with shortcodes.

tests/27-shortcode-nonexisting/expected.md

@@ -0,0 +1,7 @@
+# List Of Acronyms {#acronyms_HEADER_LOA .loa}
+
+# Introduction {#intro}
+
+The non-existing acronym will be replaced by "??": ??.
+
+Here, with its key: RL.

tests/27-shortcode-nonexisting/expected.stderr

@@ -0,0 +1,2 @@
+(W) [acronyms] Acronym key RL not recognized
+(W) [acronyms] Acronym key RL not recognized

tests/27-shortcode-nonexisting/input.qmd

@@ -0,0 +1,9 @@
+---
+acronyms: {}
+---
+
+# Introduction {#intro}
+
+The non-existing acronym will be replaced by "??": {{< acr RL non_existing=?? >}}.
+
+Here, with its key: {{< acr RL non_existing=key >}}.

tests/run_tests.ts

@@ -346,6 +346,9 @@ const testDirs = [
     '22-shortcode-simple',
     '23-shortcode-specific-style',
     '24-shortcode-listofacronyms',
+    '25-shortcode-firstuse',
+    '26-shortcode-insertlinks',
+    '27-shortcode-nonexisting',
 ];