Merge pull request #145 from KubaO/staging

Justthedocs performance fixes and book content gathering.

Author: KubaO

BOOKPLAN.md

@@ -6,4 +6,6 @@ _pdf/
 .jekyll-cache
 .jekyll-metadata
 *.af~lock~
-_bak
+_bak
+_profile/out/
+_profile/rbspy.exe

WIP.md

@@ -11,6 +11,12 @@ gem "logger"
 gem "fiddle"
 gem "bigdecimal"
 
+# Profiling. Not loaded by Jekyll automatically (not in :jekyll_plugins).
+# Activated by _profile/profile.rb via `require "ruby-prof"`.
+# force_ruby_platform: ruby-prof's x64-mingw-ucrt gem ships no
+# precompiled .so for Ruby 3.4+, so we compile from source instead.
+gem "ruby-prof", force_ruby_platform: true
+
 group :jekyll_plugins do
   gem "jekyll-sass-converter", "~> 2.2"
   gem "jekyll-include-cache"

docs/.gitignore

@@ -74,6 +74,7 @@ GEM
     logger (1.7.0)
     mercenary (0.4.0)
     octicons (19.21.1)
+    ostruct (0.6.3)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (7.0.0)
@@ -83,6 +84,12 @@ GEM
       ffi (~> 1.0)
     rexml (3.4.4)
     rouge (4.6.1)
+    ruby-prof (2.0.4)
+      base64
+      ostruct
+    ruby-prof (2.0.4-x64-mingw-ucrt)
+      base64
+      ostruct
     safe_yaml (1.0.5)
     sassc (2.4.0)
       ffi (~> 1.9)
@@ -112,6 +119,7 @@ DEPENDENCIES
   jekyll-sitemap
   just-the-docs (= 0.10.1)
   logger
+  ruby-prof
   tzinfo (>= 1, < 3)
   tzinfo-data
   wdm (~> 0.1)
@@ -150,13 +158,16 @@ CHECKSUMS
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
   mercenary (0.4.0) sha256=b25a1e4a59adca88665e08e24acf0af30da5b5d859f7d8f38fba52c28f405138
   octicons (19.21.1) sha256=52f7330d7896fd18521999d1f6e9191f8b85ab22268b77e9f6d983a988556485
+  ostruct (0.6.3) sha256=95a2ed4a4bd1d190784e666b47b2d3f078e4a9efda2fccf18f84ddc6538ed912
   pathutil (0.16.2) sha256=e43b74365631cab4f6d5e4228f812927efc9cb2c71e62976edcb252ee948d589
   public_suffix (7.0.0) sha256=f7090b5beb0e56f9f10d79eed4d5fbe551b3b425da65877e075dad47a6a1b095
   rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
   rb-fsevent (0.11.2) sha256=43900b972e7301d6570f64b850a5aa67833ee7d87b458ee92805d56b7318aefe
   rb-inotify (0.11.1) sha256=a0a700441239b0ff18eb65e3866236cd78613d6b9f78fea1f9ac47a85e47be6e
   rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
   rouge (4.6.1) sha256=5075346d5797d6864be93f7adc75a16047a7dbfa572c63c502419ffa582c77de
+  ruby-prof (2.0.4) sha256=42190ff6870e055a9d58b39df63e83442113ef7169c0e27b599942c3f15d1435
+  ruby-prof (2.0.4-x64-mingw-ucrt) sha256=5d8bcba77a384aa65234688be1199375753380b877c5cac4a70517779bd190a0
   safe_yaml (1.0.5) sha256=a6ac2d64b7eb027bdeeca1851fe7e7af0d668e133e8a88066a0c6f7087d9f848
   sassc (2.4.0) sha256=4c60a2b0a3b36685c83b80d5789401c2f678c1652e3288315a1551d811d9f83e
   terminal-table (3.0.2) sha256=f951b6af5f3e00203fb290a669e0a85c5dd5b051b3b023392ccfd67ba5abae91

docs/Gemfile

@@ -23,10 +23,10 @@ Private Sub OnPaint(ByVal Canvas As CustomControls.Canvas)  _
 You are passed a [`Canvas`](../../tB/Packages/CustomControls/Framework/Canvas) object that offers the following methods:
 
 ```tb
-Canvas.Width As Long    [Property-Get]
-Canvas.Height As Long   [Property-Get]
-Canvas.Dpi As Long      [Property-Get]
-Canvas.DpiScaleFactor As Double [Property-Get]
+Canvas.Width As Long    ' Property-Get
+Canvas.Height As Long   ' Property-Get]
+Canvas.Dpi As Long      ' Property-Get]
+Canvas.DpiScaleFactor As Double ' Property-Get
 Canvas.AddElement(Descriptor As ElementDescriptor)
 ```
 

docs/Gemfile.lock

@@ -1,7 +1,7 @@
 ---
 title: CustomControls
 parent: Tutorials
-permalink: /Tutorials/CustomControls
+permalink: /Tutorials/CustomControls/
 redirect_from:
   - /CustomControls
   - /CustomControls/Introduction
@@ -24,4 +24,4 @@ A few highlights;
 
 ## See also
 
-- [CustomControls package reference](../tB/Packages/CustomControls/) -- the full reference for the built-in `Waynes…` controls and the framework they are built on, including [`ICustomControl`](../tB/Packages/CustomControls/Framework/ICustomControl), [`Canvas`](../tB/Packages/CustomControls/Framework/Canvas), and the style helpers ([`Fill`](../tB/Packages/CustomControls/Styles/Fill), [`Corners`](../tB/Packages/CustomControls/Styles/Corners), [`Borders`](../tB/Packages/CustomControls/Styles/Borders), [`TextRendering`](../tB/Packages/CustomControls/Styles/TextRendering), …)
+- [CustomControls package reference](../../tB/Packages/CustomControls/) -- the full reference for the built-in `Waynes…` controls and the framework they are built on, including [`ICustomControl`](../../tB/Packages/CustomControls/Framework/ICustomControl), [`Canvas`](../../tB/Packages/CustomControls/Framework/Canvas), and the style helpers ([`Fill`](../../tB/Packages/CustomControls/Styles/Fill), [`Corners`](../../tB/Packages/CustomControls/Styles/Corners), [`Borders`](../../tB/Packages/CustomControls/Styles/Borders), [`TextRendering`](../../tB/Packages/CustomControls/Styles/TextRendering), …)

docs/Tutorials/CustomControls/Painting-drawing to your control.md

@@ -146,10 +146,16 @@ also_build_pdf: true
 # Patterns for files Jekyll produces in _site/ that have no purpose
 # in the offline tree -- Pages / crawler metadata, jekyll-redirect-
 # from output, Windows batch scripts Jekyll picks up from the source
-# directory, and the concatenated `book.html` that exists only to
-# feed `_plugins/pdfify.rb` (which copies it to _site-pdf/ and deletes
-# the _site/ copy). The online _site/ keeps the metadata files;
-# offlinify strips them from _site-offline/.
+# directory, and the concatenated `book.html` that feeds the PDF
+# build. When `also_build_pdf: true` the pdfify plugin captures
+# book.html in memory at :pages, :post_render and drops it from
+# site.pages at :site, :post_render, so `_site/book.html` is never
+# written -- but offlinify's per-page hook fires for book.html
+# before pdfify's removal, so the exclude pattern is what keeps it
+# out of _site-offline/. When `also_build_pdf: false` book.html
+# renders as a normal page on _site/ and the exclude does the same
+# job from a different angle. The online _site/ keeps the metadata
+# files; offlinify strips them from _site-offline/.
 #
 # Patterns are File.fnmatch-style with FNM_PATHNAME, matched against
 # each file's path relative to the site root. `*` does NOT cross
@@ -170,5 +176,16 @@ offline_exclude:
 exclude:
   - _site-offline
   - _site-pdf
+  - _profile
   - redirects.json
   - "*.bat"
+
+# Bypass just-the-docs's vendor/compress.html Liquid layout: it spends
+# ~3.5s on a single pre-block-protected whitespace collapse done via
+# Liquid split/join filters. The same compression runs as a Ruby
+# plugin in `_plugins/html-compress.rb`, ~10x faster.
+compress_html:
+  ignore:
+    envs: all
+
+