diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/markdown/CHANGES.md')
-rw-r--r-- | Master/texmf-dist/doc/generic/markdown/CHANGES.md | 334 |
1 files changed, 328 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/generic/markdown/CHANGES.md b/Master/texmf-dist/doc/generic/markdown/CHANGES.md index 4e1e87e5088..e0f893ab21d 100644 --- a/Master/texmf-dist/doc/generic/markdown/CHANGES.md +++ b/Master/texmf-dist/doc/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) |