summaryrefslogtreecommitdiff
path: root/macros/generic/markdown/CHANGES.md
diff options
context:
space:
mode:
Diffstat (limited to 'macros/generic/markdown/CHANGES.md')
-rw-r--r--macros/generic/markdown/CHANGES.md334
1 files changed, 328 insertions, 6 deletions
diff --git a/macros/generic/markdown/CHANGES.md b/macros/generic/markdown/CHANGES.md
index 4e1e87e508..e0f893ab21 100644
--- a/macros/generic/markdown/CHANGES.md
+++ b/macros/generic/markdown/CHANGES.md
@@ -1,5 +1,323 @@
# Changes
+## 3.4.1 (2024-02-16)
+
+Fixes:
+
+- Rename option `contentType` to `contentLevel`. (#300, #400, ca98e039)
+- Correctly produce paragraph separators inside block-level elements.
+ (#376, #377, #403, contributed by @lostenderman)
+
+Deprecation:
+
+- Replace all instances of `\markdownInfo`, `\markdownWarning`, and
+ `\markdownError` with l3msg functions and deprecate `\markdownInfo`,
+ `\markdownWarning`, and `\markdownError`. (#383, #398, e3ca682c, 48002f84)
+- Use the `TEXMF_OUTPUT_DIRECTORY` environmental variable to set
+ `\markdownOptionOutputDir` and deprecate `\markdownOptionOutputDir`.
+ (#405, #409, [matrix.org][matrix-405])
+
+ [matrix-405]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$8oUA2Bn3ch3q9K6RU-1EgpO9uQOd_3Mky4YwT325Ib0?via=matrix.org&via=im.f3l.de
+
+Docker:
+
+- Add support for TeX Live 2024 pretest.
+ (#404, #406, e51738ba, #410, 7ef64dd9, a7cff81d, contributed by @jspitz)
+
+## 3.4.0 (2024-01-31)
+
+Development:
+
+- Separate default token renderer prototype definitions to a universal theme
+ `witiko/markdown/defaults`. (#391, #392)
+- Add format-independent options `noDefaults` and `plain`, which control the
+ loading of theme `witiko/markdown/defaults`. (#393, #394)
+- Add `contentLevel` Lua option.
+ (#300, #375, #400, contributed by @lostenderman)
+
+Fixes:
+
+- Make Pandoc syntax extensions `tex_single_backslash_math` and
+ `tex_double_backslash_math` robust against extra spaces at the beginning /
+ end of inline / display math. (#386, #399, contributed by @lostenderman)
+
+Libraries:
+
+- Update `tinyyaml` to v0.4.4. (e2a59ba)
+
+Contributed Software:
+
+- Remove private GitHub repository `contributions/istqb_latex`. (cc21fe2)
+- Add `contributions/37c3-beamer`. (f5bb26b, contributed by @TeXhackse)
+
+Default Renderer Prototypes:
+
+- Do not unnecessarily override math renderer prototypes in LaTeX/ConTeXt.
+ (#387, #396, contributed by @zousiyu1995)
+
+Unit Tests:
+
+- In pull requests, process added and modified testfiles first.
+ (feafe9b9, 9ff530da, 18deae73)
+
+Deprecation:
+
+- Replace all instances of `\markdownInfo`, `\markdownWarning`, and
+ `\markdownError` with l3msg functions and deprecate `\markdownInfo`,
+ `\markdownWarning`, and `\markdownError`. (#383, #398)
+
+Docker:
+
+- Uninstall the distribution Markdown package. (258a73d4)
+
+## 3.3.0 (2023-12-30)
+
+Development:
+
+- Add support for universal (cross-format) themes. (#276, #373)
+
+Fixes:
+
+- Prevent unwanted space tokens before `*ContextEnd` renderers. (#373)
+- Make ConTeXt command `\inputmarkdown` properly process extra options.
+ (#389, #390, contributed by @ibotty)
+
+Documentation:
+
+- Improve the discoverability of the `\markdownInput` macro.
+ (#381, #382, contributed by @solernou)
+- Encourage alternatives to the `hybrid` option in the user manual. (#382)
+
+Speed Improvements:
+
+- Optimize needless catcode switching in package code. (3eb7231)
+
+Default Renderer Prototypes:
+
+- Fix the typesetting of level four headings with attributes for LaTeX document
+ classes without the `\chapter` command such as `article` and level five
+ headings for LaTeX document classes with the `\chapter` command such as
+ `book`. (86eefc0)
+
+## 3.2.1 (2023-11-23)
+
+Fixes:
+
+- Remove the `options.cacheDir` directory if it is empty after conversion.
+ (5cfcea6)
+- Allow tables inside lists. (#368, #371, contributed by @lostenderman,
+ sponsored by ISTQB)
+- Check that shell access is unrestricted before attempting shell escape.
+ (#365, witiko/lt3luabridge#22, latex3/latex3#1339, #372)
+
+Documentation:
+
+- Add a link to a work-in-progress article for TUGboat 45:1 to `README.md`.
+ (1988a0c2, 3b85533d)
+- Fix miscellaneous issues with the technical documentation. (#366, #367)
+- In `README.md`, add a link to a GPT chatbot with background knowledge about
+ the Markdown Package for TeX. (59eb04d)
+
+Docker:
+
+- Include developer tools in the development Docker image. (#374)
+
+## 3.2.0 (2023-10-21)
+
+Development:
+
+- Add support for Pandoc `auto_identifiers` and `gfm_auto_identifiers`
+ syntax extensions.
+ (#237, #238, lostenderman/markdown#153, #315, #354,
+ contributed by @lostenderman)
+- Add support for bulk redefinition of token renderers and token renderer
+ prototypes in the `\markdownSetup` command using enumeration.
+ (#232, #361..#363, [matrix.org][matrix-361])
+
+ [matrix-361]: https://matrix.to/#/!UeAwznpYwwsinVTetR:matrix.org/$k__vWylYp_L9eyZ0lXCPy26GokZ-Y9g5v8Xs9n47twQ?via=matrix.org&via=im.f3l.de
+
+Fixes:
+
+- Make the `import` LaTeX option correctly handle recursive imports.
+ (68c7a2f5, danopolan/istqb_latex#87)
+- Support attributes on multi-line setext headings.
+ (#315, #355, #356, contributed by @lostenderman)
+- Correctly process the combination of Lua options `fancyLists` and
+ `startNumber`. (59fb97e8)
+- Properly parse emphasis at line endings in headings.
+ (#358, #360, contributed by @lostenderman)
+- Fix fancy lists that use roman numerals as markers.
+ (danopolan/istqb_latex#87, #359, #364,
+ contributed by @lostenderman, sponsored by ISTQB)
+
+Documentation:
+
+- Add a link to a preprint from TUGboat 44:3 to `README.md`.
+ (cf6b3d7b, dc57af7)
+- Measure the speed impact of test file batching.
+ (#357, b526fa65, 8c94ffc9, [matrix.org][matrix-357])
+
+ [matrix-357]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$WR3quuO1fyOl6w_KX6YFA4BACBcL-cWUWBpVfpPWDkI?via=matrix.org&via=im.f3l.de
+
+Unit Tests:
+
+- Restore CommonMark testfiles with trailing tabs and spaces.
+ (#348, #353, lostenderman/markdown#2, contributed by @lostenderman)
+- Fail faster during batch bisection. (5177ef6)
+- Speed up tests by running ConTeXt MkIV only once. (61f36e6d)
+- Use `BEGIN document` and `END document` instead of `documentBegin`
+ and `documentEnd` for consistence with other renderers. (0be6be4)
+
+Continuous Integration:
+
+- Do not rebuild existing Docker images when we rerun the
+ continuous integration for the same commit multiple times.
+ (ae390ec, 70c5f2e5)
+
+Default Renderer Prototypes:
+
+- In LaTeX, correctly capitalize fancy list labels. (0a10053f)
+- In LaTeX, properly indent fancy ordered lists when the Lua option
+ `startNumber` is enabled. (6a7649e8)
+
+## 3.1.0 (2023-09-27)
+
+Development:
+
+- Add `\markdownSetup` command to all TeX formats.
+ (#275, #349, [matrix.org][matrix-349])
+- Add an optional argument to the `markdown` LaTeX environment.
+ (#299, #351)
+- Add support for Pandoc `mark` syntax extension.
+ (jgm/lunamark#67, #303, #352, [matrix.org][matrix-352],
+ contributed by @Omikhleia)
+
+ [matrix-349]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$8JXGbDz0viyRyv6ySWQ3344BOhwd4dj5WYeawzEg_tU?via=matrix.org&via=im.f3l.de
+ [matrix-352]: https://matrix.to/#/!lWGKeMcpgwGHpfLYkf:matrix.org/$yVeWB0Yzfz6mgORv5VeG9IEl7a4xLogkAUmdNMSCxEg?via=matrix.org&via=im.f3l.de
+
+Deprecation:
+
+- Deprecate the `markdown*` LaTeX environment.
+ (#299, #351, [matrix.org][matrix-351])
+
+ [matrix-351]: https://matrix.to/#/!lWGKeMcpgwGHpfLYkf:matrix.org/$yVeWB0Yzfz6mgORv5VeG9IEl7a4xLogkAUmdNMSCxEg?via=matrix.org&via=im.f3l.de
+
+Unit Tests:
+
+- Add support for YAML metadata in testfiles.
+ (#345, #347, [matrix.org][matrix-347])
+
+ [matrix-347]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$8JXGbDz0viyRyv6ySWQ3344BOhwd4dj5WYeawzEg_tU?via=matrix.org&via=im.f3l.de
+
+Documentation:
+
+- Add a link to a preprint from CSTUG Bulletin to `README.md`.
+ (2c354f49)
+
+## 3.0.1 (2023-09-10)
+
+Fixes:
+
+- Correctly parse paragraphs with trailing spaces.
+ (danopolan/istqb_latex#77, #345, #347)
+
+## 3.0.0 (2023-08-25)
+
+Development:
+
+- Add support for TeX-like rich paragraphs.
+ (#30, #306, [matrix.org][matrix-306])
+
+ [matrix-306]: https://matrix.to/#/!lWGKeMcpgwGHpfLYkf:matrix.org/$g9ZTEyXP-V_5elJjcqRd-D9QyIfJuTw-TWlZIFoh72c?via=matrix.org&via=im.f3l.de
+
+Fixes:
+
+- Reset current heading level at the end of a markdown document.
+ (1261e6f)
+- Fix out-of-memory issues with CommonMark implementation.
+ (#308, #318, 28650b8)
+- Fix `rawAttribute` option being enabled in Lua by default.
+ (92c9ac2)
+- Make our implementation of attributes compatible with jgm/pandoc.
+ (jgm/lunamark#68, #304, #343, contributed by @Omikhleia)
+
+Documentation:
+
+- Fix the link to @xvrabcov's talk at TUG 2022 in `README.md`.
+ (166c4506)
+- Add a link to @writersglen's talk at TUG 2022 to `README.md`.
+ (f3efcb9)
+- Document setting up catcodes in Lua. (#329, #342)
+
+Unit Tests:
+
+- Batch unit tests to improve speed.
+ (#245, #316, 8bfd0b3, #317, #319..#325, #327, #328, e3b31696,
+ #331, #332, #334, 0a230fa, 90cc428, 3be0013, dbe1808, a0108814)
+- Use self-hosted GitHub runners for tests to improve speed.
+ (#326, #330, #331, a9948a86, 68b6216b, contributed by @TeXhackse,
+ [matrix.org][matrix-331])
+
+ [matrix-331]: https://matrix.to/#/!efVbynJpCMjlOTfose:matrix.org/$6qKDXlLxsaJnOl0muFX3K7Htj41B-7hL2PmSFTIm6NE?via=matrix.org&via=im.f3l.de
+
+Continuous Integration:
+
+- In draft pull requests, do not build documentation or examples
+ and do not run pkgcheck. (#337, #338, 189bb153)
+- Push temporary Docker images to GitHub Packages.
+ (#340, #341, d15ae88a, 7e42e846)
+
+## 3.0.0-alpha.2 (2023-08-01)
+
+Development:
+
+- Add support for attributes on tables. (#310, #313, 8786408)
+
+Default Renderer Prototypes:
+
+- Correctly handle multiple heading identifiers. (3ae1b0d1)
+- Add alt text to figures. (#312)
+
+Documentation:
+
+- Add a link to TUG 2023 slides and video to the README.
+ (ce6047b8, adb69e2f)
+
+Unit Tests:
+
+- Rewrite the unit testing framework from Bash to Python
+ and implement summarization. (#245, #314)
+
+## 3.0.0-alpha (2023-06-27)
+
+Development:
+
+- Comply with CommonMark 0.30 and increment `grammar_version` to `3`.
+ (contributed by @lostenderman, #29, #210, #212, #226)
+- Add a demo of using the Markdown package in OpTeX.
+ (contributed by @olsak, #215, 109c1b5, #292)
+- Add `singletonCache` Lua option. (#226)
+
+Documentation:
+
+- Add @lostenderman's thesis to `README.md`. (#226, 8a4536e)
+
+Default Renderer Prototypes:
+
+- Do not force line breaks after high-level headings in LaTeX.
+ Allow the text to follow the heading on the same line. (df8562c)
+
+Deprecation:
+
+- Remove deprecated parts of the package. (#309)
+- Remove support for LuaMetaTeX. (#226)
+
+Fixes:
+
+- Allow references in fenced divs. (#307, jgm/lunamark#69)
+- Prevent `eagerCache=false` from causing undefined behavior and make
+ it the new default. (#129)
+
## 2.23.0 (2023-04-27)
Development:
@@ -55,9 +373,12 @@ Development:
parens and brackets. (contributed by @lostenderman, #61,
#235, #236, #270)
- Add support for attributes on links, images, fenced code,
- and inline code spans. (jgm#36, jgm#43, #50, #123, #256, #280)
+ and inline code spans. (jgm/lunamark#36, jgm/lunamark#43,
+ #50, #123, #256, #280, [matrix.org][matrix-256])
- Add `import` LaTeX option. (#107, #286)
+ [matrix-256]: https://matrix.to/#/!pznomuvubVyxElflTe:matrix.org/$mDATROtxOLOGBvH5Nt3o86iysRe1LCfZB-lw4PqjKJk?via=matrix.org&via=im.f3l.de
+
Documentation:
- Unify how Pandoc syntax extensions are named and cited in
@@ -107,9 +428,10 @@ Deprecation:
Development:
- Add support for line blocks.
- (contributed by @Omikhleia and @lostenderman, jgm#41, #209, #248)
+ (contributed by @Omikhleia and @lostenderman, jgm/lunamark#41,
+ #209, #248)
- Add support for attributes on fenced code blocks.
- (contributed by @Omikhleia, jgm#36, #123, #211)
+ (contributed by @Omikhleia, jgm/lunamark#36, #123, #211)
Documentation:
@@ -126,7 +448,8 @@ Fixes:
- Fix input normalization and move it from Lua CLI and plain TeX
layers directly to the `convert()` Lua method. (#246, #253)
- Allow fenced div closing tag to break out of a blockquote.
- (contributed by @Omikhleia, jgm#60, jgm#61, #230, #259)
+ (contributed by @Omikhleia, jgm/lunamark#60, jgm/lunamark#61,
+ #230, #259)
Default Renderer Prototypes:
@@ -194,8 +517,7 @@ Development:
- Rename the `footnotes` and `inlineFootnotes` options to `notes` and
`inlineNotes`.
- Rename the `HorizontalRule` rule to `ThematicBreak` and increment
- `grammar_version` to `2`. This change is not backwards-compatible with the
- `grammar_version` of `1`.
+ `grammar_version` to `2`.
- Add `\markdownEscape` macro that inputs a TeX document in the middle of a
markdown document fragment. (1478f7b)
- Add support for raw attributes. (#173, #202)