# permalinks.ts **[Source](https://github.com/ubugeeei-prod/ox-content/blob/main/npm/vite-plugin-ox-content/src/permalinks.ts)** > 8 documented symbols. Read the signatures first, then expand each item for parameters, return types, and examples.

8 symbols 4 functions 3 interfaces 1 modules 7 parameters 8 members 4 returns

## Reference

fnescapeAttribute(value: string): stringEscapes a value for use in an HTML attribute.1 paramreturns string

Escapes a value for use in an HTML attribute.

Signature

export function escapeAttribute(value: string): string

View source

Parameters

value string

Returns

string

modulepermalinksOpt-in permalink / slug routing and index frontmatter cascade. Resolution follows oxcontentssg::resolvepage_routes.…

Opt-in permalink / slug routing and _index frontmatter cascade.

Resolution follows ox_content_ssg::resolve_page_routes. The Vite plugin applies those URLs during SSG and collection manifest builds.

View source

fnresolveCascadeOptions(value: boolean | CascadeOptions | undefined): ResolvedCascadeOptionsResolves cascade. false / omitted stays off. true / {} enables.1 paramreturns ResolvedCascadeOptions

Resolves cascade. false / omitted stays off. true / {} enables.

Signature

export function resolveCascadeOptions(value: boolean | CascadeOptions | undefined): ResolvedCascadeOptions

View source

Parameters

value boolean | CascadeOptions | undefined

Returns

ResolvedCascadeOptions

interfaceResolvedRoutePageA page after cascade and optional permalink / slug rewriting.3 members

A page after cascade and optional permalink / slug rewriting.

Signature

export interface ResolvedRoutePage

View source

Members

Properties

Name	Type	Description
`frontmatter`	`Record<string, unknown>`
`source`	`string`
`urlPath`	`string`

resolvePageRoutes(input: { pages: readonly RoutePageInput[]; permalinks?: ResolvedPermalinksOptions | null; cascade?: ResolvedCascadeOptions | null; }): RouteResolveOutput

Applies cascade (when on) then permalink / slug rewriting (when on). Collisions…4 paramsreturns RouteResolveOutput

Applies cascade (when on) then permalink / slug rewriting (when on).

Collisions skip the later page and keep the first. Rejected permalinks stay on the file-tree URL. Hostile non-string values are ignored.

Signature

export function resolvePageRoutes(input: {
  pages: readonly RoutePageInput[];
  permalinks?: ResolvedPermalinksOptions | null;
  cascade?: ResolvedCascadeOptions | null;
}): RouteResolveOutput

View source

Parameters

input { pages: readonly RoutePageInput[]; permalinks?: ResolvedPermalinksOptions | null; cascade?: ResolvedCascadeOptions | null }
input.pages readonly RoutePageInput[]
input.permalinks? ResolvedPermalinksOptions | null

optional
input.cascade? ResolvedCascadeOptions | null

optional

Returns

RouteResolveOutput

fnresolvePermalinksOptions(value: boolean | PermalinksOptions | undefined): ResolvedPermalinksOptionsResolves permalinks. false / omitted stays off. true / {} enables.1 paramreturns ResolvedPermalinksOptions

Resolves permalinks. false / omitted stays off. true / {} enables.

Signature

export function resolvePermalinksOptions(value: boolean | PermalinksOptions | undefined): ResolvedPermalinksOptions

View source

Parameters

value boolean | PermalinksOptions | undefined

Returns

ResolvedPermalinksOptions

interfaceRoutePageInputOne page considered for cascade and permalink resolution.3 members

One page considered for cascade and permalink resolution.

Signature

export interface RoutePageInput

View source

Members

Properties

Name	Type	Description
`fileUrl`	`string`
`frontmatter`	`Record<string, unknown>`
`source`	`string`

interfaceRouteResolveOutputResolved pages plus collision / rejection errors.2 members

Resolved pages plus collision / rejection errors.

Signature

export interface RouteResolveOutput

View source

Members

Properties

Name	Type	Description
`errors`	`string[]`
`pages`	`ResolvedRoutePage[]`