Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Preserve the exact upstream font license bytes and their original whitespace.
docs/assets/playground/fonts/*-OFL.txt -text whitespace=-blank-at-eol
docs/assets/playground/LICENSES.txt text eol=lf whitespace=-blank-at-eol
15 changes: 15 additions & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,22 @@ jobs:
with:
python-version: '3.12'
cache: pip
- uses: actions/setup-node@v6
with:
node-version: '22'
- uses: dtolnay/rust-toolchain@stable
with:
toolchain: '1.97.0'
targets: wasm32-wasip1
- run: python -m pip install -r requirements.txt
- run: python tools/build_playground.py
- run: node tools/verify_playground.mjs
- uses: actions/upload-artifact@v4
with:
name: playground-verification
path: |
docs/assets/playground/build.json
docs/assets/playground/verification.json
- run: python -m mkdocs build --strict
- run: python tools/check_site.py site
- name: Include search notification ownership file
Expand Down
8 changes: 8 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1 +1,9 @@
site/
playground/node_modules/
playground/engine/target/
playground/verification/
docs/assets/playground/fullbleed.wasm
docs/assets/playground/fonts.zip
docs/assets/playground/wasi/
docs/assets/playground/build.json
docs/assets/playground/verification.json
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,21 @@ Published at https://docs.fullbleed.dev/ using GitHub Pages.

```bash
python -m pip install -r requirements.txt
rustup target add wasm32-wasip1
python tools/build_playground.py
node tools/verify_playground.mjs
python -m mkdocs build --strict
python tools/check_site.py site
python -m mkdocs serve
```

Changes to `main` build, check internal links and metadata, then deploy through `.github/workflows/docs.yml`. Pull requests run the same build checks without deployment.

The browser playground build needs Rust and Node 20 or newer. CI uses Rust
1.97.0 and Node 22. Its locked adapter compiles the published engine; it does not
modify or vendor the engine source. See [playground/README.md](playground/README.md)
for limits, privacy behavior, and native/WASI verification.

## Updating a release

Reference pages come from the engine repository's release tag. Keep hand-authored introductions and guides here; import API, CLI, CSS, architecture, print, and performance references with:
Expand Down
Loading
Loading