Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Merge remote-tracking branch 'origin/blocksuite-labre-main' into feat…
…/canvas-viewer

# Conflicts:
#	docs/integrate/09-static-html.md
  • Loading branch information
Mathieu Jolly
Mathieu Jolly committed Nov 10, 2026
commit 227d722dc2f740259f10102aa882dad7aa400f04
13 changes: 11 additions & 2 deletions docs/integrate/09-static-html.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,12 +51,21 @@ Rewrite those to your routes, or pass your own base with

**The canvas.** `affine:surface` and what sits on it print nothing: a page shows
its page view. An `affine:surface-ref` prints
`<div class="affine-surface-ref" data-labre-surface-ref="<id>">` with its caption
inside, for you to mount a viewer on or leave as is. The viewer is
`<div class="affine-surface-ref" data-labre-surface-ref="<id>" data-labre-surface-ref-type="frame|group">`
holding `span.affine-surface-ref-title` (the frame's or group's title, read from
the page's own surface) and `span.affine-surface-ref-caption`, each only when
there is text, for you to mount a viewer on or leave as is. The viewer is
`mountCanvasViewer(host, state, options)` from `@labre/affine/canvas-viewer`
(ADR 0050): load it with a dynamic `import()` on a page that holds a canvas, it
weighs the whole view graph.

**Callouts and bookmarks.** A callout prints `div.affine-callout[data-emoji]`
with `span.affine-callout-emoji` then `div.affine-callout-body` (its own line as
a `<p>`, then its child blocks). A bookmark prints `a.affine-bookmark[rel=noopener]`
from the metadata stored with the link, never fetched: `span.affine-bookmark-title`
(the URL when no title was stored), `span.affine-bookmark-description` and
`span.affine-bookmark-host`, the favicon URL on `data-icon` when there is one.

**Formulas.** KaTeX prints HTML and MathML. Load `katex/dist/katex.min.css` on the
page, or the formula shows twice.

Expand Down
You are viewing a condensed version of this merge commit. You can view the full changes here.