Diff block
1 minute read
A diff block shows a change to a file as an ordered list: added lines, removed lines, and the context
around them. Each line carries a visible + or −, added and removed lines carry a "Added:" or
"Removed:" prefix for screen readers, and the copy button takes the new version of the file.
Syntax
Write the lines in the directive's body, or wrap a diff fence in it:
:::diff-block
```diff
publish:
- dir: build
+ dir: dist
keep:
```
:::
Each line starts with + for an added line, - for a removed line, or a space for context. A line
with no marker is context too. File and hunk headers (diff --git, ---, +++, @@) are shown with
the diff but left out of the copy.
Options
| Name | Type | Default | What it does |
|---|---|---|---|
id |
string | derived from the diff | Prefix for the block's label id. Give each identical block on a page its own id. |
Example
- --- a/slipway.yml
- +++ b/slipway.yml
- publish:
- Removed: dir: build
- Added: dir: dist
- keep:
The copy button starts hidden and the island reveals it when the browser can write to the clipboard.
Without JavaScript the list still shows the whole diff and the text can be selected by hand; the copy
text is also on the button's data-diff attribute.