Curious Documentation

Theme Installation

To install Curious on your Ghost site, follow the steps:

1. Log in to your Ghost Admin at yoursite.com/ghost.
2. In the left sidebar, go to Settings → Theme.
3. Click on Change theme.
4. Click on Upload theme.
5. Drag and drop your theme’s .zip file, or click to browse and select it.
6. Once the upload is complete, click Activate to apply the theme immediately, or Close to activate it later.

---

Getting Started

Uploading a Favicon

To add a favicon:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Click on Customize.
3. Click Upload icon next to Publication icon.
4. Save changes.

---

Uploading a Publication Logo

To add a logo:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Click on Customize.
3. Click Upload logo next to Publication logo.
4. Save changes.

---

Uploading a Publication Cover

The publication cover image is displayed in the background of the homepage hero and error pages.

To add a publication cover:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Click on Customize.
3. Click Upload cover next to Publication cover.
4. Save changes.

---

Adding Navigation

The theme supports primary and secondary navigation. Primary navigation is displayed in the site header and the slide-out sidebar, while the secondary navigation is displayed in the site footer.

Please note that the primary navigation in the site header shows up to four items. If the primary navigation has more than four items, the “More+” button appears which opens the slide-out sidebar when clicked. The slide-out sidebar displays the full list of the primary navigation items.

To set up navigation:

1. Go to Settings → Navigation in your Ghost Admin.
2. Click on Customize.
3. Add your navigation items by entering a page name in the label field and a destination URL in the URL field.
4. Once finished, click Save.

---

Adding Social Media Links

The social media links are displayed in the slide-out sidebar and the footer of the theme.

To add Facebook and X links:

1. Navigate to Settings → Social accounts in your Ghost Admin.
2. Enter the URLs of your Facebook and X profiles.
3. Save changes.

To add Instagram, Bluesky, and LinkedIn links:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Click on Customize.
3. Switch to the Theme tab.
4. Enter the URLs of your Instagram, Bluesky, and LinkedIn profiles.
5. Save changes.

All other social media links can be added manually in the social-links.hbs file located in the partials folder of the theme. For instance, if you want to add the link to your GitHub account use the following code:

<a href="GITHUB_LINK" class="button button-icon button-clear" target="_blank" rel="noopener" aria-label="GitHub">{{> "icons/github"}}</a>

To see the available icons, please check the /partials/icons folder of the theme.

---

Editing Hero Section

The hero section is located above the posts feed on the homepage. It can display the title and description, featured posts carousel or can be disabled at all.

To switch between the hero section variations:

1. Navigate to Settings → Design in your Ghost admin.
2. Expand the Homepage section.
3. Select the option from the Section above post feed dropdown.
4. Save changes.

---

Adding Cover Images

You can add cover images to all of your posts, pages as well as tag and author archive pages.

To add a post/page image:

1. Navigate to Posts (Pages) in your Ghost admin.
2. Create a new post (page) or open an existing one.
3. Click Add feature image located above the post (page) title and upload your image.
4. Save changes.

To add a tag image:

1. Navigate to Tags in your Ghost admin.
2. Create a new tag or open an existing one.
3. Click Upload tag image and upload your image.
4. Save changes.

To add an author image:

1. Navigate to Settings → Staff in your Ghost admin.
2. Select the author you want to edit.
3. Click Change Cover and upload your image.
4. Save changes.

---

Members

Ghost members feature allows you to turn your site into a membership business with member signup, paid subscriptions and email newsletters.

If members feature is enabled on your site, the theme displays Subscribe and Sign in links in the header and slide-out sidebar, connecting visitors directly to the Ghost Members portal.

---

Changing Post Layout

In addition to the default post layout, the theme includes four alternative layouts that can be enabled using internal tags: #post-vert-right, #post-vert-left, #post-horiz-top, #post-horiz-bottom.

To apply an alternative layout, simply add the desired internal tag (e.g. #post-vert-right) to your post:

---

Enabling Comments

Curious supports Ghost native or Disqus comments.

To enable Ghost native comments:

1. Navigate to Settings → Access in your Ghost Admin.
2. Select the suitable option from the Who can comment on posts? dropdown.
3. Save changes.

To enable Disqus commenting:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Switch to the Theme tab.
3. Turn on Enable Disqus and add your shortname in the Disqus shortname field.
4. Save changes.

---

Sidebar

The theme sidebar contains your blog navigation, member actions and social links.

Please note that the sidebar is always displayed on small screens and on large screens it is displayed only when the primary navigation has more than four items.

---

Editing Footer Sections

The site footer can display the authors list, popular posts list (posts tagged with #popular), tagcloud and about information.

To enable or edit any of these sections:

1. Navigate to Settings → Design & branding in your Ghost Admin.
2. Switch to the Theme tab.
3. Turn on or off the toggle buttons and fill the text fields.
4. Save changes.

---

Editing Copyright Information (Footer)

You can edit the copyright information via the .json translation file located in the /locales folder. Or you can edit it directly in the/partials/footer.hbs file using a code editor.

---

Adding Google Analytics

To add Google Analytics to your site, please follow the Google Analytics Integration guide by Ghost.

---

Theme Customization

Changing Color Scheme

Curious is available in light and dark color schemes. To change the theme color scheme:

1. Navigate to Settings → Design & branding in your Ghost admin.
2. Switch to the Theme tab.
3. Select the option from the Color scheme dropdown.
4. Save changes.

Changing Accent Color

To change the theme accent color:

1. Navigate to Settings → Design & branding in your Ghost admin.
2. Switch to the Brand tab.
3. Choose your color.
4. Save changes.

---

Changing Posts Per Page Number

You can set the number of post displayed per page in the package.json file of the theme. The default post number is set to 6:

"config": {
    "posts_per_page": 12
}

---

Theme Translation

The Curious theme is ready for translations. You can find the default file in the locales folder. Copy locales/en.json to locales/[language_code].json where “language_code” must be replaced with a valid code. You can edit the renamed translation file with any plain text editor.

Even if your site is in English, you can customize any theme texts by simply editing the default English file ( locales/en.json ), without modifying the theme templates.

You can find more information on how to translate the theme in Ghost documentation.

---

Adjusting Style

To customize the theme style, use the Code Injection tool and place your CSS rules in the Site Header field.

For instance, to adjust the site title size:

1. Navigate to Settings → Code Injection in your Ghost admin.
2. Add the necessary CSS rules to the Site header field.
3. Save changes.

---

Credits

• Montserrat font: https://www.google.com/fonts/specimen/Montserrat
• Simple icons: https://simpleicons.org/
• Reframe.js plugin: https://github.com/dollarshaveclub/reframe.js
• Swiper plugin: https://swiperjs.com/
• SimpleLightbox plugin: https://simplelightbox.com/

---

Support

The documentation included provides all the information needed to get the theme installed and customized. However, if you have any questions you can email us at support@justgoodthemes.com, and we will be happy to help you.

If you have any bug reports, or feature requests, please let us know!

---

Updates

As Ghost platform grows, so will this theme. We’re dedicated to keeping our Curious up to date.