Internal Links

How to link between pages in your site

Guidelines for linking to pages within your Astrolock site.

Link Format

Use absolute paths without trailing slashes:

[Link Text](/path/to/page)

Warning

Do NOT use trailing slashes. The site is configured with trailingSlash: never.

Examples

Linking to Collections

[View all blog posts](/blog)
[My DJ Mixes](/mixes)
[Photo Gallery](/gallery)

Linking to Specific Content

[Read this post](/blog/my-post-title)
[Listen to this mix](/mixes/summer-vibes)

Linking to Pages

[About Us](/about)
[Contact](/contact)

Linking Within Documentation

[Getting Started](/user-guide/getting-started)
[CLI Reference](/user-guide/reference/cli)
[Audio Frontmatter](/user-guide/reference/frontmatter/audio)

Common Mistakes

Wrong	Correct
`[Link](/blog/)`	`[Link](/blog)`
`[Link](blog)`	`[Link](/blog)`
`[Link](./blog)`	`[Link](/blog)`

External Links

For external sites, use the full URL:

[Astro Documentation](https://docs.astro.build)
[GitHub](https://github.com/eyelock/astrolock)

Images vs Links

Don’t confuse image syntax with links:

<!-- This is an image -->

![Alt text](/images/photo.jpg)

<!-- This is a link -->

[Link text](/page)

<!-- Image as a link -->

[![Alt text](/images/photo.jpg)](/destination)