Dope - Ghost Theme Documentation

Table of Contents

Installation

When you purchase a theme from IVEEL, you will have an access to the theme directly on your account page. Once you click the download link, an installable theme file will be downloaded to your computer.

  1. Navigate to Settings > Design on your Ghost Admin (yourblog.com/ghost).
  2. Click Upload a theme and select the downloaded installable theme file.
  3. Click Activate Now to start using the theme.

Tag Settings

  1. To setup tags, navigate to `Manage > Tags` on your Ghost Admin.
  2. Select a tag and its settings will be displayed on the right side.
  3. Choose a tag image (if the theme supports it), enter a tag name and description in the settings.
  1. To add tags to a post, navigate to Posts on your Ghost Admin.
  2. Select the post and click the settings icon on the top right corner.
  3. Add the tags in Tags field.

Disqus Comment

The theme has a built-in support for Disqus as a commenting system. Follow only these steps to setup Disqus. You don't need to follow the installation tutorial of Disqus on their site.

  1. Create a new site on your Disqus dashboard.
  2. Get your Disqus shortname. Please note that your Disqus shortname will be different than below.
  3. Insert the Disqus shortname in partials/config.hbs file.
    disqus_shortname: 'your_shortname',

Note: Remember to restart your Ghost when you made a change in hbs file.

Copyright Text

You can display some text on your blog's footer section. By default, it displays Powered by Ghost. To change the text, open partials/copyright.hbs file.

copyright: '© All rights reserved.',

You can also add some HTML markup.

copyright: '© All rights reserved. <a href="URL_HERE">More info</a>',

Note: Remember to restart your Ghost when you made a change in hbs file.

Add your social links in partials/config.hbs to display social links on your blog. All links must be full URL.

social_links: {
  facebook: 'https://www.facebook.com/iveelco',
  twitter: 'https://www.twitter.com/iveelco',
  instagram: '',
  dribbble: '',
  behance: '',
  github: '',
  linkedin: '',
  vk: '',
  rss: '',
},

Note: Remember to restart your Ghost when you made a change in hbs file.

Widgets

The widget files are in partials/widgets directory. To change the order the widgets or add/remove widgets, open partials/widgets/widgets.hbs and make the changes.

Note: Remember to restart your Ghost when you made a change in hbs file.

Facebook Widget

Open partials/widgets/widget-facebook.hbs file to setup the widget. The only attribute required to be changed is data-href which is your Facebook page's full URL.

AttributeDescription
data-hrefThe URL of your Facebook page
data-small-headerMake the header smaller
data-hide-coverHide cover photo in the header
data-show-facepileShow profile photos when friends like the page
data-hide-ctaHide the custom call to action button (if available)
data-tabsTabs to render. Possible values are none, timeline, events and messages

Links Widget

Open partials/widgets/widget-links.hbs file to setup the widget. Add/remove list items to customize the links. For example, replace _URL_ with an URL and About with some text.

<li>
  <a className="u-underline" href="_URL_">
    About
  </a>
</li>

To make a link open in a new tab, add target="_blank" rel="noopener noreferrer" attribute to the link.

<li>
  <a className="u-underline" href="_URL_" target="_blank" rel="noopener noreferrer">
    About
  </a>
</li>

Hosting Fonts Locally

  1. Click here to download the font files.
  2. Create a folder named fonts in assets directory.
  3. Unzip the downloaded file and copy the files to assets/fonts folder.
  4. Open default.hbs file and comment out the line (wrap inside {{!-- --}}) which embeds Google Fonts. You can search for "https://fonts.googleapis.com" to be more specific.
    {{!-- <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=..."> --}}
  5. Add the necessary CSS in Settings > Code injection > Site Header field.
    @font-face {
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 400;
  src: url('../fonts/raleway-v14-latin-regular.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-regular.woff') format('woff');
}
@font-face {
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 500;
  src: url('../fonts/raleway-v14-latin-500.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-500.woff') format('woff');
}
@font-face {
  font-family: 'Raleway';
  font-style: italic;
  font-weight: 400;
  src: url('../fonts/raleway-v14-latin-italic.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-italic.woff') format('woff');
}
@font-face {
  font-family: 'Raleway';
  font-style: italic;
  font-weight: 700;
  src: url('../fonts/raleway-v14-latin-700italic.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-700italic.woff') format('woff');
}
@font-face {
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 700;
  src: url('../fonts/raleway-v14-latin-700.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-700.woff') format('woff');
}
@font-face {
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 800;
  src: url('../fonts/raleway-v14-latin-800.woff2') format('woff2'),
       url('../fonts/raleway-v14-latin-800.woff') format('woff');
}

Hosting jQuery Locally

  1. Click here to download the latest version of jQuery.
  2. Save the file as jquery.min.js in assets/js folder.
  3. Open default.hbs file and search for "https://code.jquery.com" to find the <script> tag which embeds remote jQuery.
  4. Replace the entire <script>...</script> tag with:
    <script src="{{asset "js/jquery.min.js"}}"></script>