Dave Jarvis' Repositories

git clone https://repo.autonoma.ca/repo/keenwrite.com.git
![KeenWrite](../images/logo/title.svg)

* [screenshots](../screenshots.html)
* [tutorials](https://www.youtube.com/playlist?list=PLB-WIt1cZYLm1MMx2FBG9KWzPIoWZMKu_)
* [sources](https://repo.autonoma.ca/keenwrite.git)
* [documentation](user-manual.pdf)

# Release notes

Changes between 3.6.4 and 3.6.5.

## 3.6.5

* [dd273c77](https://repo.autonoma.ca/keenwrite.git/commit/dd273c77c0d656570c43dd8d5fb54e40b599a429) -- Updates Windows installation instructions; extracts to LocalAppData on Windows before trying to extract to other directories
* [1f83afed](https://repo.autonoma.ca/keenwrite.git/commit/1f83afed90c879ff523cf5b06cc692b0a933cf38) -- Updates build script to add user manual colours; makes Containerfile public domain
* [585e92b6](https://repo.autonoma.ca/keenwrite.git/commit/585e92b6f34616d7ccbac09f853aed1c69e703f3) -- Upgrades libraries (Jackson 2.19.4, EchoSVG 2.3, ControlsFX 11.2.3, RichTextFX 0.11.7, JavaFX Media 26-ea+21, Error Prone 2.45.0), fixes chapter inclusion logic

There is a known issue where accented characters on some keyboards with Linux systems may not appear. Until the fix is backported to Java 25, a work-around is to copy accented characters from elsewhere and paste them into the editor.

---

Changes between 3.6.3 and 3.6.4.

## 3.6.4

Java 24 and 25 shipped with JAXP default parameters that are too small;
see JDK issue [8368902](https://bugs.openjdk.org/browse/JDK-8368902). This
affected rendering of SVG files, which now applies larger values as needed.
Upgrading is highly recommended.

* [ba20863d](https://repo.autonoma.ca/keenwrite.git/commit/ba20863dfe6af2c9018f126451ac16c3d4af0927) -- Changes build script to use binary
* [c2857f6c](https://repo.autonoma.ca/keenwrite.git/commit/c2857f6c214d6b01917521c3bbade1c6bc530ff0) -- Uses SCRIPT dir variable
* [bf40fd9d](https://repo.autonoma.ca/keenwrite.git/commit/bf40fd9da1d7ccbc89e1b876fcb462365584fd9f) -- Fixes SVG issue, fixes nbsp entity issue
* [39bfcd15](https://repo.autonoma.ca/keenwrite.git/commit/39bfcd1511f00148fd101cc98b0bca48e265567d) -- Upgrades to Java 25 LTS, minor library updates
* [f065aa80](https://repo.autonoma.ca/keenwrite.git/commit/f065aa80275778d6fb37985652e1c771c0d3be2a) -- Upgrades EchoSVG library

---

Changes between 3.5.13 and 3.6.3.

## 3.6.3

### Windows build

Creating a signed Windows build requires either paying approximately $500 CAD
to a signing service, or shifting the build process to a third-party service
such as GitHub. Until there are either sufficient donations made, or a free
third-party service for builds presents itself, a native Windows executable
will not be released.

### New features

- **Bracketed span extension** -- Syntax support for enhanced formatting (`[word]{.class}`)
- **Endnotes extension** -- Native endnotes support in Markdown
- **Enhanced typography** -- Smart quotes now enabled by default
- **Dashes** -- En-dashes and em-dashes are converted to HTML entities
- **Improved math handling** -- Better rendering with `frac` function for fractions
- **Fonts** -- Add more fonts to the typesetting container
- **Captions** -- Fixes for captions to figures, tables, equations

### Documentation

- **Complete user manual** -- Comprehensive documentation with examples and screenshots
- **Extended syntax reference** -- Summary table for all supported Markdown extensions
- **Installation guide updates** -- Improved setup instructions for all platforms

### Export

- **XHTML export improvements** -- Better DTD handling and document structure

### Technical improvements
- **Java 24 support** -- Upgraded to JDK 24.0.2 (for performance and security)
- **Library updates** -- Updated JSoup, Flying Saucer, RichTextFX, and other dependencies
- **Optimizations** -- Reduced typesetting logspam
- **ConTeXt** -- Upgraded typesetter container image to version 2025.08.21 23:32
- **Startup** -- Warnings are suppressed

### Bug fixes

- **Text/Markdown export fixes** -- Resolved broken export functionality
- **Hyperlinks** -- Fixes variables within hyperlinks

### Typesetting theme improvements

- **xhtml** -- Forces image placement

## 3.6.2

- **XHTML namespace fix** -- Properly imports head element into XHTML namespace for better compatibility

## 3.6.1

- **Build system** -- Updated release script for better packaging

## 3.6.0

### New features

- **Smart quotes in preview** -- Automatic quote curling in the preview window
- **Improved XHTML export** -- Better handling of document structure and metadata
- **Enhanced CLI support** -- Command-line interface improvements for batch processing
- **Typography protection** -- TeX formatting protected from unwanted ligature conversion
- **HTML injection** -- Ability to inject HTML head and foot content

### Export enhancements

- **Automatic format detection** -- .xhtml files now export as XHTML automatically
- **Document title extraction** -- Titles properly extracted from variable definitions

### Data handling

- **CSV improvements** -- Preserves original header names when reading CSV files

### Library updates

- **Modern dependencies** -- Updated ControlsFX, RichTextFX, JavaFX Media, and other core libraries
- **Performance improvements** -- Various efficiency tweaks and code cleanup

### Bug fixes

- **Variable handling** -- Suppresses null values in variable lists