Skip to content

Gouna - Ghost


Current Version: In Review …



Theme Installation

  • Log into the admin section of your Ghost blog yourblog.com/ghost.
  • Select Design from the left hand side of your admin area and go to the Themes section.
  • Click on the Upload a Theme green button.
  • An upload box will open, then choose the theme (gouna.zip) within the downloaded package.
  • Once uploaded, click on Activate now button to activate the theme immediately or Close if you want to activate it later.

Enable the Public API

Public API is important for some functionality like search, tags page, and subscribe form to work properly. You can enable the Public API from Ghost admin. Go to Labs > Beta features section and check the Public API mark to enable it.

enable-public-api


Static Pages

In order to create a static page you create a new post, just like you would any other post. Once you have opened up the new post, there is a cog wheel icon next to where it says “Save Draft” or “Update Post” depending on if you have published the post or not. Click on that cog, and check the “Turn this post into a static page” box. This will convert your post to a static page.

static page


You can add, edit, delete and reorder menu links on your Ghost blog, directly from the navigation tool within the blog admin area, located at /ghost/settings/navigation/.

navigation menu

To include a static page on your navigation menu, first, type the name of the page as you’d like it to appear on your menu in the label field.

label field

Next, click inside the URL field of the menu item. The blog URL will auto-populate with http://yourdomain.com/. You will need to add in the page slug after the final /. Once satisfied with your page link, click the blue Save button to add the page to the navigation menu.


For the search to work properly, please make sure that the Public API is enabled.


Tags Page

To create the tags page:

  • Enable the Public API.
  • Create a new post and call it Tags for example, and make sure that the POST URl is tags.
  • Click the Turn this post into a static page checkbox.
  • Publish the page.
  • To add the page to the navigation, please check the Navigation section above.

static page


Authors Page

To create the Authors page:

  • Enable the Public API.
  • Create a new post and call it Authors for example, and make sure that the POST URl is authors.
  • Click the Turn this post into a static page checkbox.
  • Publish the page.
  • To add the page to the navigation, please check the Navigation section above.

static page


Disqus Comments

Gouna Theme comes with Disqus comments enabled.

Open partials/disqus.hbs file, and change the aspirethemes-demos value for the disqus_shortname variable to match your Disqus account shortname.

var disqus_shortname = 'aspirethemes-demos';

So, if your Disqus shortname is exampleone, the final code above should be:

var disqus_shortname = 'exampleone';

That’s all you need to setup Disqus from the theme side. If you get any issue regarding that comments are unable to load. First, make sure you have registered your website with Disqus (Step 1)

And also check Disqus troubleshooting guide if you still have issues.


Twitter

To set up the Twitter feed:

  • Go to publish.twitter.com.
  • Enter a Twitter URl into the input box and press Enter.
  • Select Embedded Timeline.
  • You will see a Timeline preview and you can customize it as required.
  • Copy the code by clicking the Copy Code button.
  • Open partials/sidebar/widget-twitter.hbs file and replace line 4 with the copied code.
  • Save and you are done.
 

Instagram

The Instagram feed is working using Instafeed.js to show the photos.

First, you will need to get your account userId and accessToken from the following URLs:

Second, open the assets/js/instagram.js file and replace the userId and accessToken values.

var instagramFeed = new Instafeed({
  get: 'user',
  limit: 9,
  resolution: 'thumbnail',
  userId: '',
  accessToken: ''
});

You can control how much images to show by changing the limit number. Theme default is set to 9 images.


Posts Per Page

With Ghost 1.0, the Posts per page setting is now part of the theme. The config purpose is to control how many posts to show per page from the package.json file like this:

"config": {
  "posts_per_page": 12
}

Gouna theme default value is set to 12 posts per page.


Related posts will be visible on the single post page when there are similar posts with similar tags, and will be hidden otherwise.

Enabling the Public API is required.


Google Analytics

To integrate Google Analytics, I would recommend reading Google Analytics integration steps by Ghost.


Subscribe Form

Subscribers can be enabled via a checkbox on the Labs page (Labs > Beta features), in your Ghost admin panel:

enable subscribers

Once you enabled this feature, the form will appear in the footer.

You can read more about Subscribers Beta.


Social media links are placed in the partials/social-icons.hbs file.

Ghost supports adding Facebook and Twitter profile URLs from the admin panel, go to General > Social accounts and add your URLs, this will update the Facebook and Twitter URLs within the 3 locations mentioned above.

social-accounts

For using other social accounts, the theme is using Evil Icons, which contains very simple and clean icons. Here you can find a list of the social media icons to use:

Twitter

<span data-icon='ei-sc-twitter' data-size='s'></span>

Facebook

<span data-icon='ei-sc-facebook' data-size='s'></span>

Instagram

<span data-icon='ei-sc-instagram' data-size='s'></span>

Pinterest

<span data-icon='ei-sc-pinterest' data-size='s'></span>

Vimeo

<span data-icon='ei-sc-vimeo' data-size='s'></span>

Google Plus

<span data-icon='ei-sc-google-plus' data-size='s'></span>

SoundCloud

<span data-icon='ei-sc-soundcloud' data-size='s'></span>

Tumblr

<span data-icon='ei-sc-tumblr' data-size='s'></span>

Youtube

<span data-icon='ei-sc-youtube' data-size='s'></span>

To edit or update other excisted and static social links, for exmaple, the Instagram code block:

<li class='c-social-icons__item'>
  <a href='#' aria-label='Instagram' target='_blank' rel='noopener'>
    <span class='c-social-icons__icon' data-icon='ei-sc-instagram' data-size='s'></span>
  </a>
</li>

The code above contains the ICON code from the above list, the social media link (a) within a list element (li).

Next, replace your Instagram full URL with the link href value so if your Instagram URL is:

https://www.instagram.com/ghost/

the new code will be:

<li class='c-social-nav__item'>
  <a href='https://www.instagram.com/ghost/' aria-label='Instagram' target='_blank' rel='noopener'>
    <span class='c-social-nav__icon' data-icon='ei-sc-instagram' data-size='s'></span>
  </a>
</li>

If you want to completly remove Instagram, you can delete all the code block, the li, a, and the icon.

This concept is applied to all the custom icon list available in the 3 social media places.


Update Favicon

The favicon in Ghost 1.0 could be changed from the Blog settings from the Publication icon section.

Update favicon


Theme Development

If you are a developer and need to do customization work, the theme is using Gulp to compile Sass and JavaScript. This improves the development flow and making it much faster.

First, make sure you have Node.js, npm, and Bower installed, then run the-the following commands in the theme root directory to install npm and bower dependencies.

npm install

To start Gulp, run:

gulp

This will compile Sass and JavaScript files, and start watching changes as you edit files.


To create a clean and small theme package, you can exclude different directories using the following command line:

zip -r gouna.zip gouna -x *node_modules* *bower_components* *git*

This will exclude node_modules, bower_components, and git directories from the final zip file.


Another option is to use the Ghost Code Injection feature. This is great if you don’t want to touch the theme files which is recommended to receive the future theme updates without losing your customizations.


Support

If you have any questions, I’d be happy to help.