Paratext.IcuFreeLdml

Paratext.IcuFreeLdml

ICU-free implementation of ILdmlAdapter for reading and writing LDML writing system definitions.

Use this package when you depend on ParatextData but cannot or do not want to ship ICU (for example Android, or other lightweight deployments).

Usage

using Paratext.Data;
using Paratext.IcuFreeLdml;

ScrTextCollection.LdmlAdapter = new IcuFreeLdmlAdapter();

The adapter provides read/write parity with SIL.WritingSystems.LdmlDataMapper for Paratext-supported LDML fields: identity, exemplar characters, delimiters, layout, collations (simple + ICU rules storage), and fonts.

Limitations

• Collation runtime still requires ICU where Paratext uses ICU collators; this library only parses and persists collation data.
• sil:reordered collations are preserved on round-trip but not loaded into the writing system model.
• sil:needsCompiling collations keep SimpleRules and any existing <cr> rules for round-trip, but rules are not validated or compiled on read (unlike ICU LdmlDataMapper which may compile on read).
• \p{...} property classes in exemplar sets are expanded on read (ICU-free); write emits explicit character lists.
• Unknown LDML elements are preserved when writing with an existing LDML file as the round-trip base (xmlTextReader parameter).

Building the NuGet package

Version is defined in Paratext.IcuFreeLdml.csproj. Release builds produce .nupkg and .snupkg files in bin/Release.

./createIcuFreeLdmlNugetPackage.sh Release

Optional version override:

./createIcuFreeLdmlNugetPackage.sh Release 9.6.0.2-beta

On Windows:

createIcuFreeLdmlNugetPackage.bat Release