# Example learning routes

Every `.tex` file here is a complete document. Compile from the package root:

```sh
pdflatex -output-directory=tmp examples/mechanics-wedge-spring-pulley.tex
```

| Start with | What it teaches |
| --- | --- |
| `mechanics-wedge-spring-pulley.tex` | Grounded tall wedge, pulley-edge nose, spring and full-size hanging block |
| `debug-explorer.tex` | Reference card and selected anchor families inside TikZ |
| `debug-feature-tour.tex` | Seven-page `show anchors` and `show keys` tour of surfaces, wedges, ramps, fluids, optics, elements, paths, and pics |
| `debug-surface-anchor-tables.tex` | Complete anchor tables for unnamed ground, ceiling, walls, platforms, wedge, and ramps |
| `surface-anchor-coverage.tex` | `show anchors` review of 0, 50, and 100 percent points on every ground, ceiling, wall, and platform boundary |
| `wedge-anchor-coverage.tex` | All wedge orientations, contacts, and pulley-edge boundaries with numbered anchor tables |
| `ramp-anchor-coverage.tex` | Both ramp directions, every boundary, a tall wall, and guide points |
| `debug-pulley-edge.tex` | Platform and wedge pulley-edge anchors with in-picture references |
| `debug-scoped.tex` | Inherited debug settings and local false overrides |
| `wedge-contact-anchors.tex` | The same attachment method for all wedge orientations |
| `mechanics-primitives.tex` | Supports, rod, disk, force, velocity, torque, pendulum |
| `elements-circular-differentials.tex` | Polar area element, radial sector, differential ring, and its unwrapped strip |
| `elements-solid-geometries.tex` | Sphere shells and slices, hollow sphere, cylinder shell and slice, cone slice, and rectangular sheet element |
| `elements-fonts.tex` | Document and node font inheritance plus native `dots`, line-pattern, dashed-outline, and solid-fill variants |
| `short-names-platform-pulley.tex` | Minimal surface and pulley composition |
| `short-names-wedge-variants.tex` | Wedge angle, height and right-angle modes |
| `wedge-geometry-values.tex` | Read resolved angles and dimensions from a named wedge |
| `percentage-anchors-beginner.tex` | Named edges and percentage directions |
| `coordinate-projection.tex` | Horizontal/vertical connections using `|-` and `-|` |
| `surface-flat-walls.tex` | Ground, ceiling and vertical walls |
| `surface-platforms.tex` | Basic platform shapes |
| `surface-platform-variants.tex` | Bent platform layouts |
| `surface-platform-key-variants.tex` | Platform options and their effects |
| `surface-bent-platform.tex` | A complete bent platform |
| `surface-numeric-anchors.tex` | Edge-family gallery |
| `surface-wedge.tex` | Wedge geometry |
| `ramp-straight-system.tex` | Wall, floor and sharp incline |
| `ramp-curved-system.tex` | Tangent placement on a circular ramp |
| `ramps-gallery.tex` | Ramp variations |
| `mechanics-spring-block.tex` | Basic spring connection |
| `mechanics-block-pulley.tex` | Basic pulley system |
| `mechanics-pulley-flat-plane.tex` | Horizontal plane and hanging mass |
| `mechanics-pulley-bent-platform.tex` | Pulley on a bent platform |
| `mechanics-pulley-edge-platforms.tex` | Continuous left, right, both, and inclined pulley-edge platforms |
| `mechanics-pulley-two-masses.tex` | Two hanging masses |
| `mechanics-pulley-string-variants.tex` | Over, under and explicit string routes |
| `optics-components.tex` | All optical components |
| `optics-mirrors.tex` | Mirror shapes |
| `optics-ray-composition.tex` | Rays composed from optical anchors |
| `optics-complete-ray-diagrams.tex` | Complete diagrams with stated optical assumptions |
| `debug-demo.tex`, `debug-anchor.tex` | Original debug examples |

The [feature reference](../docs/reference.md) lists keys and anchors for each object.
The [debug overlay guide](../docs/debug-overlays.md) explains which drawing
APIs use node overlays and which use `\physicshelp` cards.

## Fluids and font inheritance

- `fluid-mechanics-gallery.tex`: all fourteen fluid primitives.
- `fluid-mechanics-reference-scenes.tex`: the thirteen supplied diagram families composed with native TikZ.
- `elements-fonts.tex`: document/picture/node fonts and font-relative arrows.

- `fluid-mechanics-nodes.tex`: eight real node shapes with standard anchors.
- `fluid-patterns.tex`: native patterns, fill, dashes, and positioning.