asciidoctor-ldl 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 719e75b23cf670612dd2d6248301fdb0e9cf5f4ed4de0a5a8cd4f4f09c05d07d
-  data.tar.gz: 4796262bbe18bf6029bff035d8552fdb4436e3990bd6bb571dcf7974bef27293
+  metadata.gz: 20802d92a457bdb984de019c20d9d44f26a325c0c511704c2d574e5f201fa4c3
+  data.tar.gz: 2572f3ff4960d43f228854f35005877f5cd28e6f6f57c621746b8fa3750f905d
 SHA512:
-  metadata.gz: 7a2d2626dc179498d8e3bc634eaef11f9398456f112bed6839ed227ed96266becb34dff4d55581f6c2835541c036f7302526019ee4ab1af6c4c96865fddd8082
-  data.tar.gz: e1725021eed0b25fa9a8605399f935a63e7f3164902f0fc354b19cbab6774c91a14039fb23b2380ef9370605c75534c263138df204fa9994e88c1a1cc71f2698
+  metadata.gz: 0cb60bae5692c098502337f8cc4aaec5c69ada73b6df5b9d5a614a32b3a0a4653e39b60e78ca03101f68bf45778c0a322aa4eb9299fa1726d943b43c34a8a5c8
+  data.tar.gz: a4b1228d7ce234a33fd7b18b48a54739791de5d2089736d70d5b84e184b8ccd355f7e9b34195824d1e177fdc4a353e49d6cc24254721df6a4b6a1c5ec2162020

data/CHANGELOG.md

@@ -6,6 +6,21 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-07-23
+
+### Added
+
+- `font-family` / `ldl-font-family` attribute controlling the font used for
+  diagram text, and a cross-platform default
+  (`DejaVu Sans, Bitstream Vera Sans, Liberation Sans, Arial, sans-serif`).
+
+### Fixed
+
+- Gate/comparator glyphs `−` (U+2212) and `≥` (U+2265) no longer disappear in
+  asciidoctor-pdf. The renderer's generic `sans-serif` was mapped by prawn-svg
+  to the built-in Helvetica, which lacks those glyphs; the new default names
+  real fonts first (register one — e.g. DejaVu Sans — in your PDF theme).
+
 ## [0.1.1] - 2026-07-23
 
 ### Added
@@ -31,6 +46,7 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - Content-addressed caching with a digest sidecar so unchanged diagrams are not
   re-rendered.
 
-[Unreleased]: https://github.com/OpenPowerShift/asciidoctor-ldl/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/OpenPowerShift/asciidoctor-ldl/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/OpenPowerShift/asciidoctor-ldl/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/OpenPowerShift/asciidoctor-ldl/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/OpenPowerShift/asciidoctor-ldl/releases/tag/v0.1.0

data/README.adoc

@@ -181,6 +181,13 @@ header or on the command line (`-a ldl-format=png`).
 | `true`
 | Draw `.Name`/`.Description` labels.
 
+| font-family
+| ldl-font-family
+| _(see below)_
+| Font family for diagram text. Defaults to a cross-platform stack
+  (`DejaVu Sans, Bitstream Vera Sans, Liberation Sans, Arial, sans-serif`). Set
+  to `sans-serif` (or `none`) to keep the renderer's plain generic family.
+
 | target
 | —
 | _(hash)_
@@ -261,6 +268,29 @@ For `asciidoctor-pdf`, prefer `svg`: it keeps PDFs small and crisp. If you must
 raster for PDF, `png` with `scale=2` or higher gives good print quality at the
 cost of size.
 
+=== Fonts (asciidoctor-pdf)
+
+Gate and comparator symbols use `−` (U+2212) and `≥` (U+2265). In
+`asciidoctor-pdf`, `prawn-svg` maps the generic `sans-serif` family to the
+built-in Helvetica, which lacks those glyphs — so by default this extension
+names real fonts first (see `font-family` above). For them to take effect in a
+PDF, *register a matching font in your theme* and it will be used automatically:
+
+[source,yaml]
+----
+# in your -theme.yml (font files under a directory on :pdf-fontsdir:)
+font:
+  catalog:
+    merge: true
+    DejaVu Sans:
+      normal: DejaVuSans.ttf
+      bold: DejaVuSans-Bold.ttf
+      italic: DejaVuSans-Oblique.ttf
+      bold_italic: DejaVuSans-BoldOblique.ttf
+----
+
+HTML and PNG output already resolve the glyphs without any setup.
+
 == Styling with roles
 
 Every generated image is tagged with roles so it can be targeted from CSS or an

data/lib/asciidoctor/ldl/extension.rb

@@ -35,6 +35,7 @@ module Asciidoctor
           theme: attr(attrs, doc, 'theme', 'ldl-theme', 'light'),
           show_ids: attr(attrs, doc, 'show-ids', 'ldl-show-ids', nil),
           show_labels: attr(attrs, doc, 'show-labels', 'ldl-show-labels', nil),
+          font_family: attr(attrs, doc, 'font-family', 'ldl-font-family', nil),
           node: doc.attr('ldl-node', 'node'),
           package_dir: doc.attr('ldl-package-dir') || doc.attr('ldl-node-modules'),
           out_dir: image_output_dir(doc),

data/lib/asciidoctor/ldl/js/ldl_render.mjs

@@ -64,6 +64,7 @@ function parseArgs(argv) {
     showLabels: true,
     out: null,
     packageDir: null,
+    fontFamily: null,
   };
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -78,6 +79,7 @@ function parseArgs(argv) {
       case '--no-show-labels': opts.showLabels = false; break;
       case '--out': opts.out = next(); break;
       case '--package-dir': opts.packageDir = next(); break;
+      case '--font-family': opts.fontFamily = next(); break;
       default:
         throw new Error(`unknown argument: ${arg}`);
     }
@@ -150,6 +152,18 @@ function sizeFromViewBox(svg) {
   return { width: parseFloat(m[1]), height: parseFloat(m[2]) };
 }
 
+// The renderer tags diagram text with font-family="sans-serif". Some consumers
+// map that generic family to a glyph-poor built-in font (e.g. prawn-svg in
+// asciidoctor-pdf uses Helvetica, which lacks − U+2212 and ≥ U+2265). Rewriting
+// it to a named font that the consumer has registered fixes those glyphs.
+function applyFontFamily(svg, family) {
+  if (!family) return svg;
+  const q = family.replace(/"/g, '&quot;');
+  return svg
+    .replace(/font-family="sans-serif"/g, `font-family="${q}"`)
+    .replace(/font-family:\s*sans-serif/g, `font-family:${family}`);
+}
+
 function applySvgScale(svg, scale) {
   const size = sizeFromViewBox(svg);
   if (!size) return { svg, size };
@@ -184,7 +198,7 @@ async function main() {
   renderOptions.showLabels = opts.showLabels;
   const theme = opts.theme === 'dark' ? DARK_DIAGRAM : LIGHT_DIAGRAM;
 
-  let svg = renderDiagram(diagram, renderOptions, theme);
+  let svg = applyFontFamily(renderDiagram(diagram, renderOptions, theme), opts.fontFamily);
   const scaled = applySvgScale(svg, opts.scale);
   svg = scaled.svg;
   const size = scaled.size || { width: 0, height: 0 };
@@ -201,7 +215,7 @@ async function main() {
   const { Resvg } = await loadResvg(opts.packageDir);
   // Rasterise from the *unscaled* viewBox using resvg's own zoom, so the scale
   // multiplies device pixels crisply rather than baking a size into the SVG.
-  const base = renderDiagram(diagram, renderOptions, theme);
+  const base = applyFontFamily(renderDiagram(diagram, renderOptions, theme), opts.fontFamily);
   const resvg = new Resvg(base, {
     fitTo: { mode: 'zoom', value: opts.scale },
     background: 'white',

data/lib/asciidoctor/ldl/version.rb

@@ -2,6 +2,6 @@
 
 module Asciidoctor
   module Ldl
-    VERSION = '0.1.1'
+    VERSION = '0.1.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-ldl
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Daniel Mulholland