Seven new diagrams, a colour rule for the old ones, and 18 titles that match the app
New diagrams: the three Regular Polygon tools, Paint Region in three panes,
Point: Center of Circle, Reverse Direction, Show Region Direction.
Colour, on Blossom's call: a diagram carries the colour of what it produces.
Curves green, regions orange, direction marks take the colour of the thing
they mark, clicked points navy, calculated points hollow point-blue. Ten
draw-tool scenes lost their fill and went green; five shape-node cards had
their fill matched to their stroke and gained numbered points with a socket
legend. Select is deliberately untouched: its blue and green are the marquee
colours, not output types.
Naming: 18 page titles disagreed with the app's own command names, Compass
Circle being the oldest of them. All 18 retitled, with their breadcrumbs,
17 Menu paths, 137 link texts and 2 stale node link texts. Slugs left alone
so the app's Help buttons still resolve.
Also: the socket legend work caught two wrong labels, a socket called Point
that is really On Circle, and Major and Minor for Major Axis and Minor Axis.
Revert to Saved loses the switch-documents section, an edge case documented
in more detail than the behaviour deserved.
The weave nodes, Undo and Redo, Revert to Saved, and prose for 17 commands
Pages for Weave, Crossing Census and Stability Sweep, which nothing documented:
the Calculate button and why evaluate cannot solve, that the result is not saved
in the document, that Tol comes from the sweep plateau, and that the census
counts four-end crossings only where Weave also reads an eight-end tangency.
Undo and Redo get a page, one for both commands: two histories, one per window,
a hundred steps each, acting on the window you are in. Revert to Saved gets one
too, including that it clears both undo histories, so a revert cannot be undone.
The command prose pass is finished, 35 of 35. Ten Draw pages, five Edit, two
Transform, each written against the source rather than the old one-liner. They
turned up behaviour nothing had written down: a shape owns only the corner
points the tool itself made, a guide crossing gives a free point and not a bound
one, Directed Rectangle's third click is a distance that leaves a width handle,
and Clean Up asks for a merge tolerance and skips merges that would destroy a
derived point.
selection.md gains a Select Same section covering all six commands, which had
only ever had a row each.
Every one of the ten pages the menu-order rule governs now carries the app's own
rows in the app's own order, and Schematic finally has its icon.
Preview is an endpoint, and the Regular Polygon tools get their pages
PREVIEW (#591) no longer passes its input through - the socket is gone, because
whatever left it was exactly what arrived. Its page loses the Outputs section
and the two "passes through" asides. nodes-display.md carried the same claim in
Preview's one-line entry and was not in the patch, so the index would have
contradicted the page it links to.
THE POLYGON PAGES existed only as untracked files in the app's generated help
directory, which is rebuilt from this wiki - so the first vendor run erased
them, and the test that guards the help table started failing on pages that had
never had a source. Written here, where they survive.
One page per tool, spliced into the Draw chain between Square and Dimension,
with the sidebar to match. Each says what you click rather than leading with
inscribed and circumscribed - those words describe a circle you cannot see, and
the one called circumscribed has the SMALLER radius, which is the wrong way
round from how it reads. Each also says which side counts are exact and which
are not, and that the tools will draw either.
No icons or diagrams: none exist for these tools yet, and referencing files that
are not there renders broken. No node links either - both Regular Polygon nodes
have no page yet. The constructibility reasoning is stated rather than linked,
because the document it came from is not public.
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.
The icons land, Circle Tangent to... moves to Construct, and the Window menu becomes Nodes
Eighteen icon tiles rendered from Vera's glyphs, so every heading and menu row
that was carrying an icon-pending comment carries its icon again. Two are
re-renders: tool/tangent and node/tangent were redrawn in the app and the wiki
was still showing the old art.
Circle Tangent to... derives a circle from a centre and the thing it must touch,
so it sits in Construct now, after Circle: Apollonius, and Label is the last item
in Draw. Menu pages, sidebar and the Previous/Next chain follow. The page keeps
its draw-circle-tangent-to slug: renaming it would break the app's Help links and
change nothing a reader sees. menu-construct was also missing Circle: Apollonius
altogether; that row is in.
menu-nodes replaces menu-window. The node editor's placement is three checked
items now, Docked, Separate Window and Closed, and Closed is the one that needs
saying out loud: the graph keeps being evaluated, so what it realizes stays live
on the canvas. two-window follows, with an anchor for the new section.
A real crossing outranks an alignment snap line: where a guide cuts a segment,
ray or circle, the hover shows the crossing marker and the cursor lands on the
crossing itself.
Circle Tangent to... as a tool and a node, the Label tool, and two rules the code added
Alignment Snaps: dwell to acquire, proximity lines, a cap of two, Alt to
suppress, and why a snap line is not a guide.
How new objects are named: the two-letter prefix, the running number, the
points that keep their letters, and what Update Object Names restates.
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: macOS+Windows support, and click-to-enlarge on diagram images
Draw pages: simplify the node Related line
Drop the jargon clause; the line now just notes the same construction is available as a node.
Draw tool pages: add Related section pointing to the node twin
Each Draw tool page (Point, Line, Segment, Ray, the three Circles, Arc, Ellipse, Elliptical Arc, the two Rectangles, Square) gains a bottom Related section noting the same construction is available as a node that arrays across a pattern.
Draw menu: 18 per-command tool pages nested under Draw; nav descends into them