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. Disqus commenting system - default.hbs & post.hbs
  • II. Google Analytics
  • III. Changing main theme color - default.hbs
  • IV. Navigation - menu.hbs
  • V. Creating your post categories - category.hbs
  • VI. Footer icons - footer.hbs
  • VII. Search page - search-page.hbs

I. Disqus commenting system - disqus.hbs

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

  1. Open disqus.hbs file with your text editor.
  2. Now enter your Disqus shortname in the right place and save the file.

Example:

var disqus_shortname = 'example'; // required: replace example with your Disqus shortname

II. Google Analytics

This is optional: To connect Google Analytics:

  • Log in to your ghost dashboard and go to Settings/Code Injection and paste your Google Analytics code. Read More

Example:
Code Injection

III. 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

IV. 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="{{@blog.url}}/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

V. 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="{{@blog.url}}/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

VI. 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.

VII. 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 or upload a zip file in Settings->Design in ghost admin panel.
  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