Skip to content

nehalist/ghoststa

Repository files navigation

ghoststa

IMPORTANT: Since I'm no longer using Ghost as a frontend this repository is unmaintained.

Responsive, minimalistic, clean and content-oriented theme, inspired by GitHub. This time for Ghost.

screenshot

Features

  • Responsive
  • Code highlighting
  • Placeholder for Disqus comments (see FAQ)
  • Tag / recent posts / authors list
  • Post search (by GhostHunter)

Download

Either clone and build it yourself or download it at GitHub Releases.

Requirements

It's recommended to enable the Public API in your backend, due to the usage of the {{get}}-helper to list tags and recent posts. As soon as the Ghost development team enables the public API by default (aka "when it's not beta anymore") this will be obsolet.

FAQ

Since the disqus_thread container already exists all you need to do is to paste the universal code from disqus into your blog footer in the backend.

Important: Pasting the code into your blog footer means that Disqus is loaded on every page. Since the disqus_thread container doesn't exist on every page this can cause problems. To avoid these problems just wrap the code in an if-statement to check if the container exists

<script>
if($("#disqus_thread").length) {
  // your disqus universal code
}
<script>
  • How to add code highlighting?

Code Highlighting is enabled by default and powered by Prism.

  • How does the search engine work?

See GhostHunter.

Development & Building

To develop or build the theme you'll need:

  • Bower
  • Grunt
  • SASS

To start developing install npm dependencies with npm install and start the default task, grunt.

Building is done by Grunt with grunt build. This task validates all scss and js files, creates and concatenates vendor files and copies bower files to its destination. Files generated by this build process are:

  • assets/css/style.css (compiled SASS)
  • assets/vendor/vendor.js (concatenated vendor JS)
  • assets/vendor/vendor.css (concatenated vendor CSS)
  • assets/fonts/* (font awesome icons)

Other tasks available are:

  • grunt validate: Validates all (scss and js) files
  • grunt clean: Cleans vendor files
  • grunt zip: Creates a zip file of the theme

During development the default task, grunt, will take care of most of your needs:

  • Reload theme on changes (with BrowserSync)
  • Compile SASS
  • Install bower dependencies (and re-build the vendor files)

The default task will also run the build task in case the autogenerated files are missing.

Credits

And @acburdine for testing!