Skip to content

Restore code formatting lost from Tekton Pro Bold runs in docx#48

Merged
cycomachead merged 1 commit into
mainfrom
claude/interesting-mendel-989179
May 10, 2026
Merged

Restore code formatting lost from Tekton Pro Bold runs in docx#48
cycomachead merged 1 commit into
mainfrom
claude/interesting-mendel-989179

Conversation

@cycomachead
Copy link
Copy Markdown
Member

Summary

  • Cross-referenced _support/conversion/document_formatted.xml (the original Word doc XML) against the chapter markdown files. Words/phrases styled in Tekton Pro Bold in the docx are the convention for inline code, but pandoc didn't preserve all of them in the conversion.
  • Identified the gaps with a script that extracts every Tekton-formatted run from the XML, filters out phrases that also appear in narrative text (so common English words don't produce false positives), and then searches each chapter for unwrapped occurrences (ignoring text already inside backticks, <code>, <kbd>, <var>, fenced code blocks, MyST {…} directives, and URLs).
  • Wrapped ≈140 occurrences in backticks across chapters 01, 02, 05–08, 10–12. The bulk of the changes are in chapter 12 (settings menu, cloud menu, context-menu options, sprite-corral options, watcher options, stage options).

What's affected

  • Block names restored to code: throw/catch, cascade, butfirst/bf, rational?/infinite?/numerator/real-part, case-independent comparisons, change by x: y:, distance to, move 100 steps, repeat 3, if/else, call w/continuation, split by blocks, my blocks, my categories, custom? of block, replace item, definition of, etc.
  • Menu/option labels in ch. 12: Restore unsaved project, Costumes…/Backgrounds…/Sounds…, Login…/Signup…/Logout/Change password…, Language…/Zoom blocks.../Fade blocks…/Stage size…, Plain prototype labels, Thread safe scripts, HSL pen color model, script pic…/result pic…/scripts pic…, redrop/clean up/add comment/make a block…, delete/duplicate/export block definition…, slider min…/slider max…/raw data…/export…, parent…/pic…/svg…, etc.
  • Index entries updated to use the same backtick convention as nearby existing entries (e.g. :::{index} \speak` block`).

Italic and bold formatting from the docx came through pandoc cleanly, so no separate fix-up was needed for those styles — only the Tekton Pro Bold → backtick mapping required cleanup.

Test plan

  • Build the manual locally and spot-check chapter 12 (largest set of changes) for layout/render regressions
  • Spot-check chapter 10 (continuations) where several inline throw/catch references were re-coded
  • Confirm the PDF build is unaffected

🤖 Generated with Claude Code

Cross-referenced document_formatted.xml (the docx XML source) against
the chapter markdown files to find words that were styled in
Tekton Pro Bold in the original Word doc but lost their code
formatting during the pandoc conversion. Wrapped those phrases in
backticks (or the existing <code>/<var> equivalents where appropriate).

Touches block names, menu/option labels, and identifier-style text
across chapters 01, 02, 05-08, and 10-12. Bulk of the changes are in
chapter 12 (UI elements: settings menu, cloud menu, context-menu
options, sprite-corral options, watcher options, stage options).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cycomachead cycomachead merged commit 5493c59 into main May 10, 2026
1 check passed
@cycomachead cycomachead deleted the claude/interesting-mendel-989179 branch May 29, 2026 19:06
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