This documentation is intended to help you properly install and configure Ghostium to your needs. If you have any questions, please contact me via twitter, email or post a comment on this post.


Installing

Using Git

  1. Navigate to your Ghost theme directory ghost/content/themes
  2. Clone the theme repository using the command below
$ git clone https://github.com/oswaldoacauan/ghostium/ "ghostium"
  1. Restart ghost and log in to your dashboard
  2. In settings under themes select ghostium and save
  3. That's all, now its time to configure your theme

Manually

  1. Download the files using the GitHub .zip download option
  2. Unzip the files and rename the folder to ghostium
  3. Copy the folder into your Ghost theme directory ghost/content/themes
  4. Restart ghost and log in to your dashboard
  5. In settings under themes select ghostium and save
  6. That's all, now its time to configure your theme

Configuring

All configurable files are located in ghostium/partials/custom.

config.hbs

Configurable javascript identifiers.

  • ga_ua (optional): Your Google Analitycs account identifier
  • disqus_shortname (optional): Your Disqus unique identifier
  • enable_pjax (enabled by default): A flag to enable and disable asynchronous (AJAX) content loading via pjax

meta.hbs

Configurable meta tags.

  • twitter:site: Used for Twitter Card identification, the twitter @username of the owner of this card's domain
  • twitter:creator: Used for Twitter Card identification, the twitter @username of the author of this content
  • google-site-verification: Used for Google Webmaster Tools identification
  • fb:admins: Used for Facebook Insights identification

Your site navigation items, markups templates bellow. Ghostium uses Font Awesome for all icons you can find a list of all icons available here.

<!-- A link item -->  
<li class="drawer-list-item">  
  <a href="#" title="Follow me on twitter!">
    <i class="fa fa-twitter"></i> Follow me
  </a>
</li>

<!-- Separator item -->  
<li class="drawer-list-divider"></li>

<!-- A title item -->  
<li class="drawer-list-item drawer-list-title">  
  Follow me
</li>  

featured.hbs

A free handlebars template who will be placed before the post list on homepage