DocsAspectCustom Pages URLs

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:

  1. Download your current routes.yaml file from Ghost admin
  2. 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
  3. 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:

  1. Rename the respective template file in your theme folder:
    • page-authors.hbspage-your-new-slug.hbs
    • page-membership.hbspage-your-new-slug.hbs
    • page-recommendations.hbspage-your-new-slug.hbs
    • page-tags.hbspage-your-new-slug.hbs
  2. Update the page URL in Ghost admin to match your new slug

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.

To remove links from theme templates, edit /locales/en.json:

{
  "/signin/": "false",
  "/signup/": "false",
  "/recommendations/": "false",
  "/tags/": "false",
  "/authors/": "false"
}

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