Custom Pages URLs
The Aspect theme includes several types of built-in pages. This guide explains how to customize these pages and manage their navigation links throughout your site.
Built-in Pages Overview
The theme includes two types of built-in pages:
Pages with Custom Routes
These pages are defined in routes.yaml
:
- Sign-in (
/signin/
) - Sign-up (
/signup/
) - Archive (
/archive/
)
Pages with Predefined Templates
These pages use custom templates and require creation in Ghost admin:
- Authors (
/authors/
) - Membership (
/membership/
) - Recommendations (
/recommendations/
) - Tags (
/tags/
)
Customizing Page URLs
Pages with Custom Routes
To modify signin, signup, or archive pages, you need to update the Ghost routes configuration:
- Download your current
routes.yaml
file from Ghost admin - Modify the routes to your desired URLs:
routes: # Original /signup/: template: signup /signin/: template: signin # Example of custom URLs /login/: template: signin /join/: template: signup collections: # Original /archive/: permalink: /{slug}/ template: archive # Example of custom URLs /posts/: permalink: /{slug}/ template: archive
- Save the file and upload it back to Ghost admin
Pages with Predefined Templates
For pages using predefined templates (authors, membership, recommendations, and tags), follow these steps:
- Rename the respective template file in your theme folder:
page-authors.hbs
→page-your-new-slug.hbs
page-membership.hbs
→page-your-new-slug.hbs
page-recommendations.hbs
→page-your-new-slug.hbs
page-tags.hbs
→page-your-new-slug.hbs
- Update the page URL in Ghost admin to match your new slug
Managing Navigation Links
The theme includes built-in links to some pages in various templates. Not all pages have links in theme templates, but for those that do, you can manage them through the locales file.
Removing Links
To remove links from theme templates, edit /locales/en.json
:
{
"/signin/": "false",
"/signup/": "false",
"/recommendations/": "false",
"/tags/": "false",
"/authors/": "false"
}
Changing Link URLs
To update the URLs of these links, modify /locales/en.json
:
{
"/signin/": "/login/",
"/signup/": "/join/",
"/recommendations/": "/my-picks/",
"/tags/": "/topics/",
"/authors/": "/team/"
}
Removing Pages
Pages with Custom Routes
- Remove the corresponding route from the
routes.yaml
file - Optionally, remove links using the locales file if they exist in theme templates
Pages with Predefined Templates
- Delete the corresponding page in Ghost admin
- Optionally, remove links using the locales file if they exist in theme templates