docs: clarify new URL asset handling - #1824
Conversation
Deploying rslib with
|
| Latest commit: |
cae3332
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://c385c02e.rslib.pages.dev |
| Branch Preview URL: | https://david-docs-new-url-assets.rslib.pages.dev |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: cef4a0dcb0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
Pull request overview
This PR refines the static asset documentation (English + Chinese) to match the new URL(path, import.meta.url) asset behavior introduced in #1781, including what gets emitted, how URL parsing interacts with built-in loaders, and how to opt out globally or per-reference.
Changes:
- Clarifies that
new URL()asset references are rewritten to point at emitted output assets (with updated examples). - Documents that certain file types referenced via
new URL()are treated as URL assets and bypass built-in loaders. - Adds guidance for bundleless entry glob exclusions and opt-out mechanisms (disable URL parser /
rspackIgnore).
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| website/docs/en/guide/advanced/static-assets.mdx | Updates English docs for new URL() asset emission, bundleless exclusions, and opt-out options. |
| website/docs/zh/guide/advanced/static-assets.mdx | Updates Chinese docs for new URL() asset emission, bundleless exclusions, and opt-out options. |
Summary
This PR updates the English and Chinese static asset docs for the
new URL()behavior introduced in #1781.rspackIgnore, including asset copying and downstream consumption considerations.Related Links
new URLassets as relative URLs #1781Checklist