link
resolver
The link
resolver transforms file paths into proper route slugs or static asset URLs. Use it for handling navigation links, image sources, and other file references.
Schema definition
export const tags: Record<string, Schema> = {
card: {
render: 'Card',
attributes: {
title: {
type: String
},
to: {
type: String,
resolver: 'link'
},
icon: {
type: String,
resolver: 'link'
}
},
}
}
Usage examples
Navigation links:
{% card to="../file.md" icon="/images/icon.png" /%}
Relative paths:
{% card to="./getting-started/installation.md" /%}
Absolute paths:
{% card to="/docs/api-reference" /%}
Static assets:
{% card icon="/static/images/logo.svg" /%}
What it does
The link
resolver:
- converts relative file paths to their corresponding route slugs
- resolves static assets to their final URLs
- validates that referenced files exist
- handles both relative and absolute paths
- supports query parameters and hash fragments
Handle errors
The link
resolver provides comprehensive error handling:
- File Not Found: Throws descriptive errors when referenced files don't exist.
- Invalid Paths: Validates path formats and provides helpful error messages.
- Build-time Validation: All errors are caught during the build process.