Theme Installation

Follow the steps below to upload the theme:

  1. Log in to your publication admin section at yoursite.com/ghost/
  2. Go to Settings > Design ( yoursite.com/ghost/#/settings/design/ )
  3. Click Change theme and then click Upload theme and select the noise.zip file.
  4. After the upload is complete click Activate

Routes Setup

⚠️
For the theme to function properly you must upload the routes.yaml file.

Follow the steps below to upload the routes.yaml file (The file is located inside the zip)

  1. Log in to your publication admin section at yoursite.com/ghost/
  2. Go to Settings > Labs.
  3. Click on Upload routes YAML button and select the file from the root directory of the theme.
Ghost routes.yaml

The routing file defines the following custom routes and collections:

  • / - the homepage (index.hbs)
  • /authors/ - custom template to show all authors
  • /tags/ - custom template to show all tags
  • /articles/ - custom template to show all posts
  • /featured/ - custom template to show only featured posts
  • /members/ - custom template to show only members-only or paid posts

Custom Settings

The theme comes with custom design settings that are accessible from the Ghost Admin panel. To view and edit these settings, go to Settings > Design ( yoursite.com/ghost/#/settings/design/)

Custom settings are defined in the package.json file. These settings are placed under three categories:

  1. Site-wide settings
  2. Homepage settings

Site-wide settings

  1. Default color scheme: Select the default colour scheme. Choose from
    1. Light: Light theme
    2. Dark: Dark theme
    3. System: System theme of the website visitor
  2. Logo for dark mode: Logo for dark mode. Ensure the dimensions are same as that of your default logo.
  3. Footer paragraph: Site-wide footer paragraph. If left blank the paragraph will be hidden.
  4. Primary font: Choose from 50+ fonts. Used for headings and titles.
  5. Secondary font: Choose from 50+ fonts. Used for the rest of the body and paragraphs.

Homepage settings

  1. Title: Used as the H1 heading on homepage hero. If not set, then Site Title will be used.
  2. Sub title: Used as paragraph below H1 heading on homepage hero. If not set, then Site Description will be used.
  3. Hero button label: Used as paragraph below H1 heading on homepage hero. If not set, then Site Description will be used.
  4. Hero button url: Link for hero section CTA button. To hide the button, remove the text from Hero Button Label.
  5. Show brand logos: Carousel of brand logos on homepage. Add brand logos in assets/images/brand-logos directory.
  6. Welcome title: Title for the welcome section. If this is left blank then the complete section will be hidden.
  7. Welcome sub title: Paragraph for the welcome section. To hide the Welcome section, remove the Welcome Title text above.
  8. Show pagination: Show pagination on home page or show a button to open All Articles page.

Custom Pages

As explained in the routes setup, the theme comes with a couple of custom pages, to activate these pages, there are some actions you have to take.

⚠️
Uploading the routes.yaml file is a key requirement for these custom pages.

To create a Page:

  1. Log in to your publication admin section at yoursite.com/ghost/
  2. Go to Pages ( yoursite.com/ghost/#/pages/ )
  3. Click New page and set the Title and Page URL
  4. Finally, click Publish

Ensure the slug of the custom page are:

  1. Members Page: members
  2. Featured Page: featured
  3. Articles Page: articles
  4. Tags Page: tags
  5. Authors Page: authors