Docs: American spellings, Explode retirement, new nodes, prose pass
American spellings throughout. 346 replacements across the public text:
centre, colour, grey where it was not the noun, millimetre, behaviour,
organise and the rest. Gray keeps its E, which is how Blossom spells it.
No UI label in the app was ever British, so the wiki and the app agree.
Explode is now one node. node-explode.md is new and answers for every
shape, taking a group apart a layer at a time. The six per-type pages
stay reachable and each carries a retirement notice pointing at it;
documents built with them still open and still work.
Two new node pages, Compare and Select by Condition, both with an icon
pending note for Vera.
Export grouping documented in preferences, export-svg and export-dxf:
Group by Layers and Group by Outline Color, alongside hairline black.
Math gains Absolute Value. Tangent rewritten to the new behaviour:
options shown, nearest one chosen, click again for the other.
Select Parents and Select Children written into selection.md from
Theo's spec, with two rows in menu-select.md and dead icon references.
Not shipped yet. Both ADD to the selection rather than replacing it.
Node prose pass. Every node page now carries at least a short
explanation, on the principle that a reader landed there because the
interface did not explain itself. Command pages are getting the same
treatment, 14 of 34 so far.
First-pattern figures rebuilt. The Slider and Math wires crossed on the
way into Rotate, which made the Home page banner read as though Angle
and Repeat were swapped. They were not; the layout was wrong. Also
dropped a degree sign from the Angle socket label, which the app does
not have.
Bottom nav on every page, Apollonius, and the Combine menu completed
Navigation
- Every page's own Previous/Next line is now repeated at the bottom, directly
above the Related heading. Done by tools/add_bottom_nav.py, which finds that
heading BY NAME rather than by position, so the nav never lands in the middle
of a real section.
circles-arcs
- New Apollonius section with its own figure, apollonius-cases.png, built by a
new generator build_apollonius.mjs. Three worked cases: two lines and a
circle, three circles, two points and a line. One solution solid, the rest
light and dotted. Placed immediately before the Arc tool heading.
- circle-methods.png reverted: Apollonius gets a separate diagram, not a
fourth panel on the existing one.
selection
- Select Outer Edges removed. It is a node-side command and does not belong on
the modeling-view page. Added a Related link to the node page instead.
transform-tools
- Rewritten so the page only ever speaks of transforming POINTS. Locus does not
transform objects, it transforms the free root points an object is built
from, and everything standing on them re-solves and follows.
- New callout before the Transform menu heading: if root points are shared with
objects you do not want to move, run Edit > Detach first.
- Reference and handle clicks snap in all the same ways a point does.
align-distribute
- The same Detach callout added at the bottom, below the refusal paragraph.
regions-booleans
- Paint Region added to the list of ways to build a region.
menu-combine
- The Combine menu has eight commands and this page listed six. Paint Region
and Split (Bake) added, in menu order.
- Two new pages: combine-paint.md and combine-split.md. Split's page says
plainly that it is a one-shot bake, not a live boolean.
- The Previous/Next chain shifted, so combine-fill, combine-autoregion,
combine-difference and menu-transform changed their nav lines, and _Sidebar
gained both entries.
- Both icons rendered by the normal exporter from Vera's glyphs, tinted region
like the rest of the row.
A Videos page, the point glyphs in every figure, and the layers anatomy rebuilt
The figures now draw the rule the canvas follows: a solid disc is free, a ring
with a dot slides along its host, a hollow ring is calculated. The glider's
green halo and the intersection's crosshair are gone, since the glyph says it.
A circle's divisions are drawn as sliders, a segment's and an arc's as hollow,
which is the distinction the code makes. The struck arc now ends in open space,
because ending both ends on crossings implied an arc has to.
Constructed geometry is green rather than accent blue on the lines, circles,
ellipses, arcs, primer and rectangle figures. Blue means POINT in the data-types
legend, and a blue constructed line beside dark points told the reader the
wrong thing.
The layers panel anatomy is rebuilt. Its object names come from the app's own
prefix table, so the figure and the page above it finally agree: Grp1, Cir1,
Seg1. Its thirteen callouts are legible again after the canvas was trimmed to
what is actually drawn.
New page: Videos. The tutorial playlist with each video matched to the pages it
covers, and the two tutorial files linked under the videos they belong to.
Linked from Home as the first thing a newcomer sees, from the sidebar, from the
footer, and through the Getting Started chain.
Alt text follows the figures on points, lines, point on object, selection and
both divide pages. The divide alt now distinguishes a circle's divisions, which
you can turn, from a segment's, which you cannot.
Three rules the code added: the point glyph, the division ring, and which point a snap takes
A point is drawn to say whether you can move it. Solid disc is a free point,
ring with a dot moves on a leash, and a hollow ring is calculated: a crossing, a
midpoint, a division, a tangent point. The geometry decides where those are, so
there is nothing to drag (blossommerz/locus-hub#567).
A circle's divisions are a ring you can turn. On a centre-and-point circle
division zero follows the radius point; on any other circle you drag a division
and the whole ring rotates, arrow keys included. Two Divides on one circle give
two independent rings. Segments and arcs have ends, so theirs stay pinned
(blossommerz/locus-hub#565).
When two points sit on the same spot the snap takes the visible one. Hidden
points are still snappable, and auto-hide leaves plenty of them about, but
visible wins; age only decides between two of the same kind
(blossommerz/locus-hub#566).
Keyboard characters only: sweep all 245 English pages
Every character that cannot be typed on a US keyboard is replaced. Em dash
becomes a colon where it introduces a list bullet's description, matching how
the Italian pages already read, and a spaced hyphen everywhere else. The
Previous/Next angle quotes and the breadcrumb arrows become < and >, the menu
path triangle becomes >, arrows spell out as -> and <->, the ellipsis becomes
three periods, and the en dash and minus sign become a hyphen.
Two characters do two jobs and are split by context. The middle dot is a pipe
where it separates links and " x " where it is multiplication, as in Min + k x
Step and Radius x cos(Angle). The degree sign becomes " degrees" after a digit
and is dropped after a letter, where it was a stale reference to the Rotate
node's Angle socket, which no longer carries one.
Also: superscript two becomes 2, the square root sign becomes sqrt, the
division sign becomes /, less-than-or-equal becomes <=, and the decorative
emoji in Home, the footer, the sidebar, community and licensing are removed.
Kept: the command, shift and option key glyphs in the shortcut lines, and the
Greek letters used as math notation.
Verified: no file changed its line count, and no markdown table row changed its
cell count.
Docs: sync English wiki to v0.1.348 behavior (19 pages — Divide arcs, Inspect read-out, color opacity, compass chains, auto-hide points, guides, zoom shortcuts, localization, cluster library)
Docs: macOS+Windows support, and click-to-enlarge on diagram images
Concept + cleanup pages: add Related section pointing to node twins
The multi-method concept pages (circles-arcs, ellipses, rectangles, lines) list their node family; points links the single Point node; edit-cleanup links the Cleanup node.
Diagram-first: move every section diagram above its description (20 pages)
Nav: left-justified plain-text line below breadcrumb, all pages
Nav: right-aligned borderless (div align=right) below breadcrumb, all pages
Nav bar: breadcrumb left, prev/next hard right; straightedge-compass diagrams under headings
Nav right-justified on the breadcrumb line (all pages); straightedge-compass: section-then-diagram-then-text + add-to-system section
Add prev/next nav below breadcrumb on all sidebar pages; straightedge-compass: selection figures side-by-side + add-to-system section
Add Region node effect and points arrow-key nudge diagrams
Add modeling-geometry diagrams: points, lines, circles/arcs, ellipses, rectangles
Breadcrumb + section header on all pages; wallpaper-groups → intro + four lattice pages; remove Fundamental domains
Add breadcrumb nav to all content pages; split wallpaper-groups into intro + 4 lattice pages; remove Fundamental domains
Docs: wiki pages for the Aug 11-14 feature batch (licensing, ticks, coordinate entry, Explode/Filter nodes, fills, status bar, adaptive grid, macro/cluster libraries)
Publish documentation to the Wiki