Skip to content

shoot_docs retakes 161 IDE pictures, and the help add-in's project file is published as a download - #225

Merged
KubaO merged 22 commits into
twinbasic:mainfrom
KubaO:staging
Oct 9, 2026
Merged

KubaO merged 22 commits into
twinbasic:mainfrom
KubaO:staging

Conversation

@KubaO

@KubaO KubaO commented Oct 9, 2026

Copy link
Copy Markdown
Collaborator

Replaces the help add-in's screenshot tool with shoot_docs, which takes the IDE pictures across the documentation, and publishes the help add-in as a project file that includes the offline archive.

  • docs: 158 IDE pictures retaken at 2x in the dark theme and shown at half size, and 3 new. IDE-FeatureMap (twelve labelled features) replaces the community screenshot and its copy, and the two LLVM JPGs become PNGs. Eight pictures are deleted: those four, three obsolete glyphs and one unreferenced picture. Static files fall from 258 to 253. Prose the new pictures contradict is corrected, in the WebView2 and CustomControls tutorials, Debug Console, New Project and Status Bar. Help Add-In (renamed from Documentation Help) offers the download first and the source route second.
  • shoot_docs (new; replaces shoot_help_addin): takes the pictures from IDEs on private desktops, one per setup, with fixture projects under test/shots/. It draws the annotations (arrows, boxes, rings, labels, badges), composites and replicas of native select lists itself, and rewrites a picture only when its bytes differ. --jobs runs setups at once (a full run takes about 110 s) and --diffs writes difference pictures. WIP.Screenshots.md (new) has the plan.
  • build: tbdocs packs add-in/ into tB/IDE/AddIns/downloads/tbDocsHelp.twinproj on every build, CI's included (addinProject task, about 28 MB): the files git tracks, the build's symbol index and its offline archive, so the add-in built from it needs no internet. The archive is now the build's helpArchive task. CI no longer passes --no-help-archive, and check_ci_workflows refuses it. The offline tree links to the file on the website. scripts/impexp.mjs is the one scripts/ module builder/ may import.
  • help add-in: a 2 px line in the theme's text colour separates the results list from the page. In the detached window, whose frame blocks storage, the pages followed Windows' app mode instead of the IDE's theme and a link dropped the pane layout; both are now kept in window.name.
  • tests: test/addin-project.test.mjs (new) is a test.bat and CI gate. The help lane checks the line and the window's theme in Light and Dark.

shoot_docs and the help lane need a twinBASIC install, so they stay outside every gate and CI. shoot_docs's command-line cases need none and run in test.bat.

KubaO added 22 commits October 9, 2026 21:30
…rer, panel, menu and package pictures retaken
…gs setups, {span} anchor; llvmdoc1 as png, three obsolete glyphs dropped
…tures equals it, else two that agree; page baseline 255 after the three glyphs went
… waits for sleeps, --jobs, shots set their own state; --diffs difference pictures; Popup's new bytes
…mple 6, Global Search, Toolbar_2 and View As JSON pictures retaken
…gners, Format menus and Toolbar_3 retaken; increment 4 decisions
…e names an absolute path under docs (failed on Linux CI)
…ettings-webview2; Anchors, QR code, FAQ ICON crop and WebView2 tutorial pictures retaken
…stomcontrols fixture and setup; Editor, FindReplace_Direction, 2a1c71fd, 4c8b881e and six CustomControls pictures retaken
…Compiler Constants pair, flags-attribute, CustomControls code pictures and tbWebView2CreateEvent retaken
…xture) replaces the community screenshot; Services_Operational retaken; increment 6 dispositions
…load; Help Add-In page offers it first, keeps the source route; addin-project test gate
…s list and the page, in the pane and the window; help lane checks it
…e layout where storage is blocked (window.name); theme-toggle mirrors the page's theme; help lane tests both places
@KubaO
KubaO merged commit 04ab4ea into twinbasic:main Oct 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant