summaryrefslogtreecommitdiff
path: root/macros/generic/markdown/CHANGES.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-11-02 03:04:36 +0000
committerNorbert Preining <norbert@preining.info>2024-11-02 03:04:36 +0000
commit7722e07af1602ab9d40d96c6b0a0bdd37152c419 (patch)
tree8f14fe7a5508a20a8ac40095093ed73f83a9a8e2 /macros/generic/markdown/CHANGES.md
parentfef969d9c6d08b0ca51b3d8bb3f5edc9bab7df63 (diff)
CTAN sync 202411020304
Diffstat (limited to 'macros/generic/markdown/CHANGES.md')
-rw-r--r--macros/generic/markdown/CHANGES.md97
1 files changed, 87 insertions, 10 deletions
diff --git a/macros/generic/markdown/CHANGES.md b/macros/generic/markdown/CHANGES.md
index 1b32517f09..69deeac748 100644
--- a/macros/generic/markdown/CHANGES.md
+++ b/macros/generic/markdown/CHANGES.md
@@ -1,5 +1,82 @@
# Changes
+## 3.8.0 (2024-10-31)
+
+Development:
+
+- Add support for versioned themes and add new Lua option `experimental`.
+ (#466, #512, #514, [matrix.org][matrix-514] reviewed by @TeXhackse, #521)
+
+ The option `experimental` enables experimental features that are planned to
+ be the new default in the next major release of the Markdown package.
+
+ At the moment, this just means that the version `experimental` of the theme
+ `witiko/markdown/defaults` will be loaded and warnings for hard-deprecated
+ features will become errors. However, the effects may extend to other areas
+ in the future as well.
+
+ [matrix-514]: https://matrix.to/#/!UeAwznpYwwsinVTetR:matrix.org/$TTc-m7B5NSdsLBNNyIuFWQ-u2nOZ03lJ5js88hnyFiU?via=matrix.org&via=im.f3l.de
+
+- Add first-class support for YAML documents. (#452, #473, #524)
+ - Add plain TeX macros `\yamlSetup`, `\yamlInput`, `\yamlBegin`, and `\yamlEnd`.
+ - Add LaTeX environment `yaml` and redefine command `\yamlInput` for LaTeX.
+ - Add ConTeXt commands `\setupyaml`, `\inputyaml`, `\startyaml`, and `\stopyaml`.
+
+Documentation:
+
+- Document LaTeX hooks. (#464, #507)
+
+Defaults:
+
+- Improve the compatibility of the default LaTeX packages with PDF tagging:
+ (#466, #512, #514, #521, reported and consulted by @u-fischer)
+
+ - In TeX engines other than LuaTeX, use the package soul instead of the
+ package soulutf8 in TeX Live ≥ 2023.
+
+ - In LuaLaTeX, use the package lua-ul for strike-through/mark renderer
+ prototypes instead of the package soul.
+
+ - Use the package enumitem for tight and fancy lists instead of the package
+ paralist.
+
+ This is a breaking change that is marked as experimental. To enable it,
+ either use the package option `experimental` or specify any test phase in
+ the document metadata:
+
+ 1. `\usepackage[experimental]{markdown}`
+ 2. `\DocumentMetadata{testphase=phase-III}`
+
+- Define LaTeX renderers for image identifiers.
+ (#520, suggested by @jurf, 6f3dcd0c, 478530f, [matrix.org][matrix-520])
+
+ This establishes a reliable method for authors to reference figures within Markdown:
+
+ ``` tex
+ \documentclass{article}
+ \usepackage[link_attributes, relative_references]{markdown}
+ \begin{document}
+ \begin{markdown}
+
+ ![example image](example-image "An example image"){#example-image-id}
+
+ See Figure <#example-image-id>.
+
+ \end{markdown}
+ \end{document}
+ ```
+
+- Set correct category codes for version 3 of the package minted. (39980934)
+
+Continuous Integration:
+
+- Only use self-hosted runners for the quick CI in pull requests.
+ For full CI outside pull requests, use GitHub-hosted runners.
+ (c2697428, [matrix.org][matrix-950e8269])
+
+ [matrix-950e8269]: https://matrix.to/#/!pznomuvubVyxElflTe:matrix.org/$op_onsRdhtXJsZB5d5LZrOFF75T02XvKehmikdoucx4?via=matrix.org&via=im.f3l.de
+ [matrix-520]: https://matrix.to/#/!lWGKeMcpgwGHpfLYkf:matrix.org/$mZB-_YfreLFSKU5eDzp0AIvMnsV_Bn-rpUoj9HtUVwk?via=matrix.org&via=im.f3l.de
+
## 3.7.1 (2024-09-30)
Development:
@@ -21,8 +98,8 @@ Fixes:
- Properly load LaTeX themes when `theme` or `import` is used in
`\usepackage[...]{markdown}`. (#471, #498)
-- Prevent endless loop when setting deprecated `jekyllDataString` (renderer)
- prototype. (#500)
+- Prevent endless loop when setting deprecated `jekyllDataString` renderer
+ (prototype). (#500)
- Correctly handle backslashes in `\markdownOptionOutputDir` on Windows.
(#492, #500, reported by @l0th3r)
@@ -125,7 +202,7 @@ Continuous Integration:
- Only test latest TeX Live in pull requests. (81927ca1)
-Unit Tests:
+Tests:
- Test the `outputDir` plain TeX option. (#457, #459)
@@ -303,7 +380,7 @@ Default Renderer Prototypes:
- Do not unnecessarily override math renderer prototypes in LaTeX/ConTeXt.
(#387, #396, contributed by @zousiyu1995)
-Unit Tests:
+Tests:
- In pull requests, process added and modified testfiles first.
(feafe9b9, 9ff530da, 18deae73)
@@ -407,7 +484,7 @@ Documentation:
[matrix-357]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$WR3quuO1fyOl6w_KX6YFA4BACBcL-cWUWBpVfpPWDkI?via=matrix.org&via=im.f3l.de
-Unit Tests:
+Tests:
- Restore CommonMark testfiles with trailing tabs and spaces.
(#348, #353, lostenderman/markdown#2, contributed by @lostenderman)
@@ -450,7 +527,7 @@ Deprecation:
[matrix-351]: https://matrix.to/#/!lWGKeMcpgwGHpfLYkf:matrix.org/$yVeWB0Yzfz6mgORv5VeG9IEl7a4xLogkAUmdNMSCxEg?via=matrix.org&via=im.f3l.de
-Unit Tests:
+Tests:
- Add support for YAML metadata in testfiles.
(#345, #347, [matrix.org][matrix-347])
@@ -497,7 +574,7 @@ Documentation:
(f3efcb9)
- Document setting up catcodes in Lua. (#329, #342)
-Unit Tests:
+Tests:
- Batch unit tests to improve speed.
(#245, #316, 8bfd0b3, #317, #319..#325, #327, #328, e3b31696,
@@ -531,7 +608,7 @@ Documentation:
- Add a link to TUG 2023 slides and video to the README.
(ce6047b8, adb69e2f)
-Unit Tests:
+Tests:
- Rewrite the unit testing framework from Bash to Python
and implement summarization. (#245, #314)
@@ -709,7 +786,7 @@ Default Renderer Prototypes:
- In LaTeX and ConTeXt, use just first word of infostring to determine fence
code block language. (#244)
-Unit Tests:
+Tests:
- Do not fold tabs and spaces into a single space token.
(lostenderman#107, #242)
@@ -1238,7 +1315,7 @@ Licensing:
- Bump the copyright year. (9462f17)
- Sublicense the code as LPPL v1.3c. (609aeee)
-Unit tests:
+Tests:
- Remove xtrace from `test.sh` for less verbose output. (b307ee6)
- Treat all files as text with GNU diff in `test.sh`. (ec89e6d)