Overview
Help us spread the word ðĶ.
There were improvements to role/directive parsing in #181, this resulted in many new packages that can be used independently in other contexts such as the theme or jupyterlab-myst.
The API and links were migrated to myst-tools.org domain for API requests, our new domain!
There were improvements for compatibility for admonitions that now parse callouts in Quarto, GitHub, and MyST.
You can now embed notebook cells directly into your document, see the documentation.
There were improvements to the docs -- thank you to @kolibril13 and @Carreau who made their first commits.
MyST can now read LaTeX, and parsing was improved wit features to support other types of images (PDF, EPS).
New Features
- ðĪ Support embedded cross references and output images/text in file exports by @fwkoch in #154
- ð Embed notebook cells in a page by @fwkoch in #143
- âĪïļ Improve admonitions to support GitHub and Quarto by @rowanc1 in #229
New Packages
We have introduced new extensions for cards, grids and tabs.
myst-ext-card: Card directivesmyst-ext-grid: Grid directivesmyst-ext-tabs: Tab directives
Commits:
We have pulled out the roles and directives into their own packages. See #181.
markdown-it-mystmarkdown-it plugin to handle tokenizing roles and directives.myst-directivescore directives for MySTmyst-rolescore roles for MySTmyst-parserconverts markdown-it token stream to mdastmyst-to-htmlconvert MyST to HTML
Commits:
Documentation Improvements
- ð Document JATS exports by @rowanc1 in #109
- ð Improve the quickstart tutorials by @rowanc1 in #152
- ð Fix readme example, mystjs undefined use MyST directly. by @Carreau in #159
- ð Improve logging of LaTeX error messages by @rowanc1 in #165
- ð Issue templates for
.githubby @rowanc1 in #171 - ð Improve onboarding documentation by @rowanc1 in #214
- ð Improve quickstart with warnings by @rowanc1 in #218
- ð ð Document tab behavior by @rowanc1 in #132
- ð Overhaul Docs and many details by @rowanc1 in #146
- ð ð Document notebook cell labels and separate site/project configs by @fwkoch in #177
- ð ð Update domain to myst-tools for all links. by @rowanc1 in #182
- ð Small tweaks in the quickstart guide by @kolibril13 in #215
New LaTeX Parsing and Features
See the blog post by Curvenote.
The entire LaTeX rendering process can run in a few hundred milliseconds from start to finish rather than around 3-10
seconds for small documents using common LaTeX renderers. The paper I was testing on during this blog post is
âĄïļ 16 times faster âĄïļ - which is significant, and there is lots of room for improvement in MyST as well!
- âĄïļ Introduce a latex parser/converter by @rowanc1 in #110
- âĄïļ Improve latex parsing by @rowanc1 in #117
- ð Use unix path for images in latex by @fwkoch in #125
- ð Render include node children during tex/docx export by @fwkoch in #163
- ð Support for PDF images by @rowanc1 in #173
- ð Update image conversion transform to handle EPS images by @fwkoch in #228
Usability improvements
- ð Publish source file and exports by @fwkoch in #112
- ð Define exports as a single string by @rowanc1 in #148
- ðĪ Implicitly initialize project to resolve single file export cross references by @fwkoch in #167
- ðĨ Reload project on toc change, new bib files by @fwkoch in #175
- ð Reload project on all created/deleted files during watch by @fwkoch in #186
- ðĪ Get text output working in exports by @fwkoch in #176
- ðŽ Add comment to default html-to-mdast handlers by @fwkoch in #205
- ð Add mystToHtml as a simple wrapper function by @rowanc1 in #234
- ðĪš Do not parse nested colon fence as directive option by @fwkoch in #227
- âŧïļ Allow whitespace around role name inside brackets by @fwkoch in #233
Refactoring
- ð Move References/Footnotes/Citations types to myst-common by @fwkoch in #108
- ð Move template enums from myst-templates to myst-common by @fwkoch in #111
- ð Improve myst-frontmatter by @rowanc1 in #119
- ð Update notebook handling to use new nbtx by @fwkoch in #133
Bug Fixes
- ð Path replacement on windows for logging by @rowanc1 in #116
- ð LaTeX: Capture framed environment by @rowanc1 in #123
- ð Shell output capture for windows by @rowanc1 in #124
- ð Target propagations after lifting
mystDirectives by @rowanc1 in #136 - ð Catch and mute spurious warnings by @rowanc1 in #145
- ð Change reloadConfigs --> reload by @rowanc1 in #147
- ð Show yaml errors for jtex and allow
myst: v1by @rowanc1 in #151 - ð Validate subtitle & short_title on project/site by @rowanc1 in #174
- ð Fix packaging for downstream theme components by @rowanc1 in #178
- ð Delete children rather than set to undefined by @rowanc1 in #232
- ð Fix/whitespace option by @fwkoch in #226
New Contributors
- @Carreau made their first contribution in #159
- @kolibril13 made their first contribution in #215
Full Changelog: https://github.com/executablebooks/mystjs/commits/myst-cli@0.1.15