chore: prepare for 0.14.0 version (#600)

Author: mfontanini

CHANGELOG.md

@@ -1,3 +1,38 @@
+# v0.14.0 - 2025-05-17
+
+## New features
+
+* Add support for [exporting presentations as HTML files](https://mfontanini.github.io/presenterm/features/exports.html#html) ([#566](https://github.com/mfontanini/presenterm/issues/566)) ([#595](https://github.com/mfontanini/presenterm/issues/595)) ([#575](https://github.com/mfontanini/presenterm/issues/575)) ([#599](https://github.com/mfontanini/presenterm/issues/599)) - thanks @JustSimplyKyle.
+* Snippet execution output now contains configurable padding and built-in themes default to the same padding as snippets (2 spaces horizontally, one line vertically) ([#592](https://github.com/mfontanini/presenterm/issues/592)) ([#593](https://github.com/mfontanini/presenterm/issues/593)).
+* Add highlighting and execution support for Jsonnet ([#585](https://github.com/mfontanini/presenterm/issues/585)) - thanks @imobachgs.
+* Allow [configuring snippets](https://mfontanini.github.io/presenterm/configuration/settings.html#sequential-snippet-execution) to be executed sequentially during exports ([#584](https://github.com/mfontanini/presenterm/issues/584)).
+
+## Fixes
+
+* Skip slides with pauses correctly ([#598](https://github.com/mfontanini/presenterm/issues/598)).
+* Avoid printing text if there's no vertical space for it, which otherwise looks bad particularly when using font size > 1 ([#594](https://github.com/mfontanini/presenterm/issues/594)).
+* Execute snippets only once during export ([#583](https://github.com/mfontanini/presenterm/issues/583)).
+* Don't add an extra pause after lists if there's nothing left ([#580](https://github.com/mfontanini/presenterm/issues/580)).
+* Allow interleaved spans and variables in footer ([#577](https://github.com/mfontanini/presenterm/issues/577)).
+* Truly center `+exec_replace` snippet output ([#572](https://github.com/mfontanini/presenterm/issues/572)).
+
+## Docs
+
+* Added link to public presentation using presenterm ([#589](https://github.com/mfontanini/presenterm/issues/589)) - thanks @pwnwriter.
+* Rename parameter name to the correct one in docs ([#570](https://github.com/mfontanini/presenterm/issues/570)) - thanks @DzuWe.
+* Fix typo in highlighting.md ([#586](https://github.com/mfontanini/presenterm/issues/586)) - thanks @0atman.
+
+## Chore
+
+* Bump dependencies ([#596](https://github.com/mfontanini/presenterm/issues/596)).
+
+## ❤️ Sponsors
+
+Thanks to the following users who supported _presenterm_ via a [github sponsorship](https://github.com/sponsors/mfontanini) in this release:
+
+* [@0atman](https://github.com/0atman)
+* [@orhun](https://github.com/orhun)
+
 # v0.13.0 - 2025-04-25
 
 ## Breaking changes

Cargo.lock

@@ -4,7 +4,7 @@ authors = ["Matias Fontanini"]
 description = "A terminal slideshow presentation tool"
 repository = "https://github.com/mfontanini/presenterm"
 license = "BSD-2-Clause"
-version = "0.13.0"
+version = "0.14.0"
 edition = "2021"
 
 [dependencies]

Cargo.toml

@@ -44,7 +44,7 @@ Visit the [documentation][docs-introduction] to get started.
 * [Introduction slide][docs-intro-slide] that displays the presentation title and your name.
 * [Slide titles][docs-slide-titles].
 * [Snippet execution][docs-code-execute] for various programming languages.
-* [Export presentations to PDF][docs-pdf-export].
+* [Export presentations to PDF and HTML][docs-exports].
 * [Slide transitions][docs-slide-transitions].
 * [Pause][docs-pauses] portions of your slides.
 * [Custom key bindings][docs-key-bindings].
@@ -82,7 +82,7 @@ Gave a talk using _presenterm_? We would love to feature it here! Open a PR or i
 [docs-layout]: https://mfontanini.github.io/presenterm/features/layout.html
 [docs-mermaid]: https://mfontanini.github.io/presenterm/features/code/mermaid.html
 [docs-latex]: https://mfontanini.github.io/presenterm/features/code/latex.html
-[docs-pdf-export]: https://mfontanini.github.io/presenterm/features/pdf-export.html
+[docs-exports]: https://mfontanini.github.io/presenterm/features/exports.html
 [docs-key-bindings]: https://mfontanini.github.io/presenterm/configuration/settings.html#key-bindings
 [docs-hot-reload]: https://mfontanini.github.io/presenterm/features/introduction.html#hot-reload
 [docs-speaker-notes]: https://mfontanini.github.io/presenterm/features/speaker-notes.html

README.md

@@ -15,10 +15,13 @@ title = "presenterm documentation"
 git-repository-url = "https://github.com/mfontanini/presenterm"
 default-theme = "navy"
 
-# Redirects for broken links after 02/02/2025 restructuring.
 [output.html.redirect]
+# Redirects for broken links after 02/02/2025 restructuring.
 "/guides/basics.html" = "../features/introduction.html"
 "/guides/installation.html" = "../install.html"
 "/guides/code-highlight.html" = "../features/code/highlighting.html"
 "/guides/mermaid.html" = "../features/code/mermaid.html"
 
+# Redirects for HTML export changes on 05/17/2025.
+"/features/pdf-export.html" = "exports.html"
+

docs/book.toml

@@ -15,7 +15,7 @@
         - [LaTeX and typst](./features/code/latex.md)
     - [Themes](./features/themes/introduction.md)
         - [Definition](./features/themes/definition.md)
-    - [PDF export](./features/pdf-export.md)
+    - [Exports](./features/exports.md)
     - [Slide transitions](./features/slide-transitions.md)
     - [Speaker notes](./features/speaker-notes.md)
 - [Configuration](./configuration/introduction.md)

docs/src/SUMMARY.md

@@ -279,11 +279,13 @@ speaker_notes:
 
 # Presentation exports
 
-The configurations that affect PDF exports.
+The configurations that affect PDF and HTML exports.
 
-## PDF export size
+## Export size
 
-The size of exported PDFs can be configured via the `export.dimensions` key:
+By default, the size of each page in the generated PDF and HTML files will depend on the size of your terminal. 
+
+If you would like to instead configure the dimensions by hand, set the `export.dimensions` key:
 
 ```yaml
 export:
@@ -292,8 +294,6 @@ export:
     rows: 30
 ```
 
-See [the PDF export page](../features/pdf-export.md) for more information.
-
 ## Pause behavior
 
 By default pauses will be ignored in generated PDF files. If instead you'd like every pause to generate a new page in 
@@ -303,3 +303,13 @@ the export, set the `export.pauses` attribute:
 export:
   pauses: new_slide
 ```
+
+## Sequential snippet execution
+
+When generating exports, snippets are executed in parallel to make the process faster. If your snippets require being 
+executed sequentially, you can use the `export.snippets` parameter:
+
+```yaml
+export:
+  snippets: sequential
+```

docs/src/configuration/settings.md

@@ -1,4 +1,8 @@
-# Exporting presentations in PDF format
+# Exporting presentations
+
+Presentations can be exported to PDF and HTML, to allow easily sharing the slide deck at the end of a presentation.
+
+## PDF
 
 Presentations can be converted into PDF by using [weasyprint](https://pypi.org/project/weasyprint/). Follow their 
 [installation instructions](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html) since it may require you 
@@ -22,14 +26,20 @@ want the output file to be written to.
 > If you're using a separate virtual env to install _weasyprint_ just make sure you activate it before running 
 > _presenterm_ with the `--export-pdf` parameter.
 
-## PDF page size
+## HTML
+
+Similarly, using the `--export-html` parameter allows generating a single self contained HTML file that contains all 
+images and styles embedded in it. As opposed to PDF exports, this requires no extra dependencies:
+
+```bash
+presenterm --export-html examples/demo.md
+```
 
-By default, the size of each page in the generated PDF will depend on the size of your terminal. 
+The output file will be placed in `examples/demo.html` but this behavior can be configured via the `--output` flag just 
+like for PDF exports.
 
-If you would like to instead configure the dimensions by hand, set the `export.dimensions` key in the configuration file 
-as described in the [settings page](../configuration/settings.md#pdf-export-size).
+# Configurable behavior
 
-## Pause behavior
+See the [settings page](../configuration/settings.md#presentation-exports) to see all the configurable behavior around 
+presentation exports.
 
-See the [settings page](../configuration/settings.md#pause-behavior) to learn how to configure the behavior of pauses in 
-generated PDFs.