bherbruckandClaude Opus 5.5
0d7e456bc1
An mdBook under docs/book: a user guide (getting started, UI tour, sketching, features, parameters, components and joints, sheet metal, plastic, files, shortcuts, MCP) and a developer guide (CONTRIBUTING, architecture, command engine, kernel boundary, persistent naming, test harnesses, and the existing docs/*.md pages). `cargo xtask book` generates the command reference from `solvecraft-cli commands` and renders the screenshots with `solvecraft-cli snapshot`, then runs mdbook. .github/workflows/pages.yml publishes the book at /solvecraft/ and the web app at /solvecraft/app/ (skipped while the repository is private). .github/workflows/ci.yml runs `cargo xtask ci` on pull requests. README and Help → Documentation link to the book. Fixes #28 Fixes #8 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# Import and export
|
|
|
|
| Format | Read | Write |
|
|
|---|---|---|
|
|
| `.solvecraft` (JSON design, versioned) | yes | yes |
|
|
| STEP (AP203, AP214, AP242) | solids, assemblies, units, names, colours | AP242 with names, colours and the component tree |
|
|
| IGES 5.3 | manifold solids, or trimmed surfaces sewn into solids | manifold solids with names and colours |
|
|
| 3MF, STL, OBJ | mesh bodies | yes |
|
|
| DXF, SVG | into a sketch | sketches and flat patterns as DXF |
|
|
| PNG, JPEG | canvases and decals | |
|
|
|
|
Opening a STEP or IGES file creates a design with the file's bodies as a base feature, and
|
|
inserting one adds them to the current design. Later features build on them. Mesh bodies render,
|
|
measure, move and export, but solid features need B-rep bodies.
|
|
|
|
Saves are atomic: a crash at any moment leaves either the old file or the new one, and the
|
|
replaced version is kept as `<file>.bak`. Unsaved changes are autosaved to a recovery folder,
|
|
and the next launch offers to recover them. Older design files are upgraded on open, and files
|
|
from a newer version are refused with a message.
|