Documentation

Table of contents:

  1. Features
  2. Configuring
  3. Installing
  4. Changelog
  5. License

Features

  • Fully responsive design
  • Content focused
  • Major browser compatibility
  • Free lifetime updates
  • Disqus commenting system
  • Sharing options
  • Responsive embedded videos
  • Font Awesome
  • Search engine
  • Color palette

Configuring

Before turning on your theme live, you should set up some of the functions you want to use. Most configurable files are located in corvus/partials/ folder.

  • I. Various metatags - meta.hbs
  • II. Disqus commenting system - default.hbs & post.hbs
  • III. Google Analytics
  • IV. Changing main theme color - default.hbs
  • V. Navigation - menu.hbs
  • VI. Creating your post categories - category.hbs
  • VII. Footer icons - footer.hbs
  • VIII. Search page - search-page.hbs

I. Various metatags - meta.hbs

This is optional: Open meta.hbs file with your text editor and enter your data in the fields you want to use:

  1. twitter:site Used for Twitter Card identification, the twitter @username of the owner of this card's domain. Read More
    <meta name="twitter:site" content="@YourTwitterBlog" />

  2. twitter:creator Used for Twitter Card identification, the twitter @username of the author of this content. Read More
    <meta name="twitter:creator" content="@YourTwitter" />

  3. google-site-verification Used for Google Webmaster Tools identification. Read More
    <meta name="google-site-verification" content="YOUR_CODE_HERE" />

  4. fb:admins Used for Facebook Insights identification. Read More
    <meta property="fb:admins" content="YOUR_CODE_HERE" />

II. Disqus commenting system

If you want to use Disqus commenting system you will need to configure it by replacing your shortname Disqus ID. Read More

  1. Open default.hbs and post.hbs files with your text editor.
  2. Now find and replace Disqus shortname with your own and save the files. (default is: example)

    <script type="text/javascript">
    var disqus_shortname = 'example'; // required: replace example with your Disqus shortname
    ..
    

III. Google Analytics

This is optional: To connect Google Analytics:

  1. Log in to your ghost dashboard.
  2. In Settings -> Labs, enable the code injection interface.
  3. Now go to Settings -> Code Injection and paste your Google Analytics code. Read More

Example:
Code Injection

IV. Changing main theme color

In assets/css/colors.css file you can find a set of twenty colors to choose from.
Available colors are: red, pink, purple, deep-purple, indigo, blue, light-blue, cyan, teal, green, light-green, lime, yellow, amber, orange, deep-orange, brown, grey, blue-grey, dark.

Note: You can always create your own color by duplicating/modifying existing one in the css file.

  1. Open default.hbs file with your text editor and find this line of code:

    <body id="indigo" class="{{body_class}}">
    
  2. Now replace your chosen color name within id="" (default color is indigo).

  3. Example: We have chosen green color for our theme accent, so our code should looks like this: <body id="green" class="{{body_class}}">

Result: Green theme accent.
Green accent

V. Navigation - menu.hbs

Open menu.hbs file with your text editor to add/modify links.
menu code

  1. First list is created for your static pages:
    Example:<li><a href="[email protected]}}/about/">About</a></li>
  2. Second list is the Dropdown menu designed for your categories (tags) links and you can modify them in Ghost Settings -> Navigation area.
    menu code

Results:
menu example

VI. Creating your post categories

Open category.hbs file with your text editor and replace your own names, colors and icons for your categories (tags):

Example:

category code

  1. Type your category based on tag(s):
    {{#has tag="rocket science"}} You can also supply a comma-separated list of tags, which is the equivalent of an 'or' query, asking if a post has any one of the given tags {{#has tag="rocket science, space, technology"}}

  2. Now choose a category color:
    <div class="article-category_corvus blue-grey"> Our pick is blue-grey here.

    In assets/css/colors.css file you can find a set of twenty colors to choose from. Available colors are: red, pink, purple, deep-purple, indigo, blue, light-blue, cyan, teal, green, light-green, lime, yellow, amber, orange, deep-orange, brown, grey, blue-grey, dark.

    Note: You can always create your own color by duplicating/modifying existing one in the css file.

  3. Set the appropriate url for category tag:
    <a href="[email protected]}}/tag/rocket-science">...

  4. Choosing category icon:
    <i class="fa fa-rocket"></i> Our pick is here fa-rocket.

    Visit Font Awesome Cheatsheet website, pick your icon class name from the list and replace it.

  5. Enter a name for the tag labels.
    <h5 class="category-label_corvus">rocket science</h5>

  6. At the end of category.hbs file, remember to close the has helper for each category:
    {{/has}}.

  7. Save file, restart ghost and you're done.

Result: Your new blog posts with rocket science tag should looked like that.
category result

VII. Footer icons

To add your social media links in Footer area, simply open footer.hbs file with your text editor, paste your links in the right place and save the file.

Example:

    <a href="https://twitter.com/golemioThemes">
        <i class="fa fa-twitter"></i>
    </a>

To choose different icons visit Font Awesome Cheatsheet website, pick your icon class name from the list and replace it.

VIII. Search page

To activate Search page:

  1. Go to your admin ghost panel and create a new empty post titled Search
    create search page
  2. Set it as a static page.
    create search page
  3. Hit Publish and you're done.

Installing

  1. Copy the unziped corvus folder into your Ghost theme directory ghost/content/themes
  2. Restart Ghost and log in to your dashboard.
  3. In settings under themes select Corvus and save.
  4. Done, your new theme is now up and runnig.

Changelog

For detailed history of changes, see our Changelog at - golem.io/ghost-themes/corvus/changelog


License

Simple License - golem.io/license © 2015 golem.io