From 03be7b056fe1bc81c76124ab13a1dfdb94308321 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Mon, 16 Nov 2026 13:45:07 +0100 Subject: [PATCH] Fix book format tier pill layout and explanations --- docs/canvas-pilot/changelog.md | 4 ++- docs/canvas-pilot/guide/format-matrix.md | 31 +++++++++++++++++------- docs/manuals/canvas-pilot/manual.css | 22 +++++++++++++++++ 3 files changed, 47 insertions(+), 10 deletions(-) diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index 570535c..981024d 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -4,7 +4,9 @@ ## Unreleased -No changes yet. +- Fixed format-tier pills in the book: labels now wrap horizontally instead of + stacking as illustrations. Separate tier headings clarify project backups, + optional snapshots and geometry exchange; download-table pills use the same sizing. ## v0.8.0 — 2026-11-16 diff --git a/docs/canvas-pilot/guide/format-matrix.md b/docs/canvas-pilot/guide/format-matrix.md index 1cf7481..beca3a6 100644 --- a/docs/canvas-pilot/guide/format-matrix.md +++ b/docs/canvas-pilot/guide/format-matrix.md @@ -18,15 +18,28 @@ a reference, not interactive controls. Tiers describe preservation of Canvas Pilot settings. Formats within a tier are tied; choose the one your editor supports. -- **🥇 Gold — complete project:** ![Canvas Pilot](../../images/formats/project.svg)
- `.pilot.json` retains editable state and images. **It is Canvas Pilot’s own - project format, intended to be opened only in Canvas Pilot—not an industry - standard or a file for other editors.** For sharing with another application, - choose one of the exchange formats below. -- **🥈 Silver — optional snapshot:** ![SVG](../../images/formats/svg.svg) ![draw.io](../../images/formats/drawio.svg) ![JSON](../../images/formats/json.svg) ![HTML](../../images/formats/html.svg) ![PowerPoint](../../images/formats/pptx.svg) ![FigCraft](../../images/formats/figcraft.svg) ![CSV](../../images/formats/csv.svg) ![DXF](../../images/formats/dxf.svg)
- These formats preserve advanced settings when extra parameters are enabled. -- **🥉 Bronze — geometry/artwork:** ![Figma](../../images/formats/fig.svg) ![DWG](../../images/formats/dwg.svg) ![Illustrator](../../images/formats/illustrator.svg)
- These formats need a companion project to retain editable settings. +### 🥇 Gold — complete project + +![Canvas Pilot](../../images/formats/project.svg) + +Save a `.pilot.json` to keep editable state and images together. +**This format opens only in Canvas Pilot.** It is not an industry exchange +standard; choose a format below to work in another application. + +### 🥈 Silver — exchange with an optional snapshot + +![SVG](../../images/formats/svg.svg) ![draw.io](../../images/formats/drawio.svg) ![JSON](../../images/formats/json.svg) ![HTML](../../images/formats/html.svg) ![PowerPoint](../../images/formats/pptx.svg) ![FigCraft](../../images/formats/figcraft.svg) ![CSV](../../images/formats/csv.svg) ![DXF](../../images/formats/dxf.svg) + +Enable **extra Canvas Pilot parameters** when exporting to retain an optional +snapshot of advanced settings. Recover it with **Restore parameters from export**. +Other editors may discard this snapshot; keep a project file as your backup. + +### 🥉 Bronze — geometry and artwork + +![Figma](../../images/formats/fig.svg) ![DWG](../../images/formats/dwg.svg) ![Illustrator](../../images/formats/illustrator.svg) + +Use these formats for their destination editors. Keep a companion `.pilot.json` +for editable crops, masks, input settings and other Canvas Pilot state. See the [advanced feature matrix](advanced-exchange.md) for every saved feature. diff --git a/docs/manuals/canvas-pilot/manual.css b/docs/manuals/canvas-pilot/manual.css index fbf6c99..3921d6d 100644 --- a/docs/manuals/canvas-pilot/manual.css +++ b/docs/manuals/canvas-pilot/manual.css @@ -3,3 +3,25 @@ table td, table thead th { padding: 4px 10px; } + +/* Format pills are inline labels, not full-width guide illustrations. + Override mdBook's block-image margins on both tier and download pages. */ +.content img[src*="/images/formats/"] { + display: inline-block; + width: auto; + height: 22px; + margin: 2px 4px 2px 0; + vertical-align: middle; +} + +/* mdBook wraps Markdown images in block-level click-to-zoom labels. + Pills need neither that block layout nor a full-screen zoom control. */ +.content .checkbox-label:has(> img[src*="/images/formats/"]) { + display: inline-block; + pointer-events: none; + vertical-align: middle; +} +.content .checkbox-label:has(> img[src*="/images/formats/"]) > input, +.content .checkbox-label:has(> img[src*="/images/formats/"]) > .img-wrapper { + display: none; +}