nbk2pdf 1.3.1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ccec0cdb3e5ca8a449dd015d8e720d3e198d6e9e531f49099930f2330aa3032
-  data.tar.gz: daf75cccf961cd53bbca9556e77f29144fdd3e6ad8a639d350d03fb1a743d6f2
+  metadata.gz: cae6562263eb8906556769aad7b8ecb5b70e5f07a305c9898a3b7ddc192f306c
+  data.tar.gz: e3d9e7a6087eb7b70daf805150a1a1263aae18e9c67a01c0803596e67af09ccf
 SHA512:
-  metadata.gz: 417d4e2d331a69dd88abfe57187a192f12fa9011f7ac016954ab9ca2bebd580d8e3bd2be92a21a0e0310bf3c34481a40e7a622cac52c679effab54ae68d41d98
-  data.tar.gz: 130afb0068cc4cf40d04e139f9bea52ef2dc407690cabfd6eaae6e9e60db6ca2b26ca5473eb5ee8d265bbaa3afb9b29dda70cae269cd9d6f0f8aeb209761be58
+  metadata.gz: 337fb011c64b8ab1d163a037a9672dd4346adceace697819ac0ba6c03f79aa75732e7ed1d2f20fada82ee9c9c96e4ea506cdb410e23c81ce0648a2a3de951896
+  data.tar.gz: bc187d384008cb127fc42c5e7253e63f2d1e64769848723cb6a782fa5b76a532a1fdf486a574e81ca7cdc8adfca82edc125f9e267b877a0b38455f3e6296f2ee

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.2] - 2026-11-05
+
+### Changed
+
+- The ruled or squared background is drawn 20% thinner and lighter than
+  stored (`#A0A0A0`) instead of 50% (`#C4C4C4`), since the lines from 1.3.0
+  vanished on some printers.
+
+### Added
+
+- `--template-fade PERCENT` sets how much thinner and lighter the background
+  is drawn: 0 draws it as stored, 50 as in 1.3.0. A fade other than the
+  default tags the file name, e.g. `NAME.fade50.pdf`.
+
 ## [1.3.1] - 2026-11-04
 
 ### Changed

data/README.md

@@ -105,6 +105,7 @@ the same directory with different options keeps each output side by side:
 | `--flip-on-edge short`              | `short-edge`                 |
 | `--paper SIZE`, other than `letter` | the size, e.g. `a4`          |
 | `--no-template`                     | `no-template`                |
+| `--template-fade N`, other than 20  | `fadeN`                      |
 | `--no-page-numbers`                 | `no-page-numbers`            |
 | `--annotations`, on documents only  | `annotations`                |
 
@@ -276,6 +277,7 @@ Options:
         --verbose                    With sync, report each source and its output in full
     -t, --titles FILE                JSON/YAML map of notebook uuid to the name you gave it
         --[no-]template              Draw the notebook's ruled background (default: yes)
+        --template-fade PERCENT      Draw the background PERCENT thinner and lighter (default: 20)
     -p, --paper SIZE                 Page size: letter (default), a4, native, ...
     -2, --two-up                     Put notebook pages in pairs side by side on landscape paper
     -b, --booklet                    Lay notebook pages out to fold into a booklet
@@ -393,11 +395,11 @@ It can be:
 
 A template draws itself in its own 1860 x 2480 space with a flat op list --
 `0 x y` to move, `1 x y` to draw, `4` to close -- plus an ARGB colour and a line
-width. The converter scales that space onto the page. At the stored colour and
-width (`#888888`, 4 units) the lines print about as heavy as the ink, where the
-e-ink screen shows them faint, so they are drawn at half the width and halfway
-to white (`#C4C4C4`). `TEMPLATE_WIDTH` and `TEMPLATE_LIGHTEN` in
-`pdf_renderer.rb` set both.
+width. The converter scales that space onto the page. `--template-fade PERCENT`
+draws the lines that much thinner than stored and that far towards white. The
+default, 20, turns the stored `#888888` at 4 units into `#A0A0A0` at 3.2. At 0
+a grid prints about as heavy as the ink; at 50 (`#C4C4C4`, half the width) it
+can vanish on a printer.
 
 ### 5. Rendering (`pdf_renderer.rb`)
 

data/lib/kindle_notebook/cli.rb

@@ -53,7 +53,7 @@ module KindleNotebook
       @err = err
       @device = device
       @options = { template: true, quiet: false, annotations: false, two_up: false, page_numbers: true,
-                   revisions: true }
+                   revisions: true, template_fade: PdfRenderer::TEMPLATE_FADE }
     end
 
     # Runs the command and returns the process exit status.
@@ -105,6 +105,12 @@ module KindleNotebook
       opts.on("--[no-]template", "Draw the notebook's ruled background (default: yes)") do |draw|
         options[:template] = draw
       end
+      opts.on("--template-fade PERCENT", Integer,
+              "Draw the background PERCENT thinner and lighter (default: #{PdfRenderer::TEMPLATE_FADE})") do |percent|
+        raise OptionParser::InvalidArgument, "--template-fade #{percent}" unless (0..100).cover?(percent)
+
+        options[:template_fade] = percent
+      end
       opts.on("-p", "--paper SIZE", "Page size: letter (default), a4, native, ...") do |size|
         options[:paper] = size
       end
@@ -272,7 +278,7 @@ module KindleNotebook
     end
 
     def converter
-      @converter ||= Converter.new(titles: titles, render_template: options[:template],
+      @converter ||= Converter.new(titles: titles, template: template_fade,
                                    paper: PdfRenderer.paper(options[:paper]),
                                    annotations: options[:annotations],
                                    two_up: options[:two_up], page_numbers: options[:page_numbers],
@@ -280,6 +286,9 @@ module KindleNotebook
                                    variant: options)
     end
 
+    # The renderer's fade, or nil for no template.
+    def template_fade = (options[:template_fade] / 100.0 if options[:template])
+
     # Sync keeps its own, in its destination, unless told otherwise.
     def titles = @titles ||= Titles.load(options[:titles] || (File.join(@destination, TITLES_FILE) if @destination))
 

data/lib/kindle_notebook/converter.rb

@@ -39,8 +39,7 @@ module KindleNotebook
       return options[:annotations] ? %w[annotations] : [] if document
 
       [*layout_tags(options), paper_tag(options[:paper]),
-       ("no-template" if options[:template] == false),
-       ("no-page-numbers" if options[:page_numbers] == false)].compact
+       template_tag(options), ("no-page-numbers" if options[:page_numbers] == false)].compact
     end
 
     def self.layout_tags(options)
@@ -50,8 +49,15 @@ module KindleNotebook
       ["booklet", ("sig#{booklet[:signature]}" if booklet[:signature]), ("short-edge" if booklet[:flip] == :short)]
     end
 
+    def self.template_tag(options)
+      return "no-template" if options[:template] == false
+
+      fade = options[:template_fade]
+      "fade#{fade}" if fade && fade != PdfRenderer::TEMPLATE_FADE
+    end
+
     def self.paper_tag(paper) = (paper.to_s.downcase if paper && PdfRenderer.paper(paper) != PdfRenderer.paper)
-    private_class_method :layout_tags, :paper_tag
+    private_class_method :layout_tags, :template_tag, :paper_tag
 
     # Converts one notebook, or annotates one PDF. +output+ may be a file path
     # or a directory.

data/lib/kindle_notebook/document_renderer.rb

@@ -18,7 +18,7 @@ module KindleNotebook
 
     def initialize(annotations: false)
       @annotations = annotations
-      @renderer = PdfRenderer.new(render_template: false, paper: nil)
+      @renderer = PdfRenderer.new(template: nil, paper: nil)
       @grains = {}
     end
 

data/lib/kindle_notebook/manifest.rb

@@ -24,7 +24,7 @@ module KindleNotebook
     SUPERSEDED = File.join(".nbk2pdf", "superseded")
 
     # The options that change what is rendered.
-    RENDERING = %i[template paper annotations two_up page_numbers booklet revisions].freeze
+    RENDERING = %i[template template_fade paper annotations two_up page_numbers booklet revisions].freeze
 
     # ponytail: an unreadable manifest is treated as empty; the cost is one
     # full render, which rewrites it.

data/lib/kindle_notebook/pdf_renderer.rb

@@ -30,12 +30,10 @@ module KindleNotebook
   class PdfRenderer
     MIN_LINE_WIDTH = 0.15
 
-    # A template's lines at the colour and width it stores come out about as
-    # heavy as the ink on paper, where the e-ink screen shows them faint. They
-    # are drawn this much thinner, and this far towards white: #888888 comes
-    # out as #C4C4C4.
-    TEMPLATE_WIDTH = 0.5
-    TEMPLATE_LIGHTEN = 0.5
+    # Percent by which a template's lines are drawn thinner and lighter than
+    # stored. At 0 a grid prints about as heavy as the ink; at 50 it can
+    # vanish on a printer.
+    TEMPLATE_FADE = 20
 
     # The device paints the highlighter an opaque light grey and keeps the
     # darker of it and whatever is underneath, so overlapping bands stay one
@@ -88,9 +86,12 @@ module KindleNotebook
     # +two_up+ puts pages in pairs side by side on the paper turned landscape.
     # +page_numbers+ numbers each page. +booklet+, when given, is a
     # hash of the options PdfRenderer.booklet takes; it implies +two_up+.
-    def initialize(render_template: true, paper: self.class.paper, two_up: false, page_numbers: true,
+    # +template+ is nil to leave the template out, or a fade from 0 to 1 that
+    # draws its lines that much thinner and that far towards white: 0 draws
+    # them as stored, 0.5 turns #888888 into #C4C4C4 at half the width.
+    def initialize(template: TEMPLATE_FADE / 100.0, paper: self.class.paper, two_up: false, page_numbers: true,
                    booklet: nil)
-      @render_template = render_template
+      @template_fade = template
       @paper = paper
       @two_up = two_up || !booklet.nil?
       @page_numbers = page_numbers
@@ -311,7 +312,7 @@ module KindleNotebook
       document.cap_style(:round)
       document.join_style(:round)
       fitted(document, page, box) do
-        draw_template(document, page) if @render_template
+        draw_template(document, page) if @template_fade
         page.strokes.each { |stroke| @layers.around(document, stroke) { draw_stroke(document, page, stroke) } }
       end
     end
@@ -350,8 +351,8 @@ module KindleNotebook
 
       scale_x, scale_y = scale
       height = page.height_in_points
-      document.stroke_color(Colour.hex(Colour.lighten(shape.color, TEMPLATE_LIGHTEN)))
-      document.line_width([shape.width * scale_x * TEMPLATE_WIDTH, MIN_LINE_WIDTH].max)
+      document.stroke_color(Colour.hex(Colour.lighten(shape.color, @template_fade)))
+      document.line_width([shape.width * scale_x * (1 - @template_fade), MIN_LINE_WIDTH].max)
       with_alpha(document, alpha) do
         shape.segments.each do |segment|
           polyline(document, segment.map { |x, y| [x * scale_x, height - (y * scale_y)] })

data/lib/kindle_notebook/version.rb

@@ -3,7 +3,7 @@
 # frozen_string_literal: true
 
 module KindleNotebook
-  VERSION = "1.3.1"
+  VERSION = "1.3.2"
 
   # The name this library is published and invoked under.
   PROGRAM = "nbk2pdf"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nbk2pdf
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.3.2
 platform: ruby
 authors:
 - Sergey Avseyev