/decent

A Ghost blog theme

Primary LanguageJavaScript

decent

A Ghost blog theme, modified from Casper. The main design is inspired by Aquila.

Demo: my blog

screenshot

Compatibility

Since v3.x this theme is fully support Ghost v1.x, and will no longer compatible with Ghost v0.x version. If you want to use this theme under Ghost v0.x version, please look at previous release, all v2.x and v1.x release should work well under Ghost v0.8 ~ Ghost v0.11. If you want to hack into the source code, please checkout the ghost-v0.x branch. The master branch will reflects the latest development.

Screenshot

Moved to docs/screenshot.md

Features

  • Ajax powered page loading.
  • Minimalist design, less is more.
  • Syntax highlighting.
  • Responsive deign.
  • Quote with author supported.
  • Image caption supported.
  • Image alignment supported.
  • Image gallery supported.
  • Google Analytics service.
  • Duoshuo comment service.
  • Disqus comment service.
  • All Optional services can be configured in the Ghost admin page, you don't have to manually modify the code.

Installation

  1. Download this theme from Github release page, and extract the files to the Ghost's theme folder: content/themes.
  2. Restart Ghost: pm2 restart ghost (assuming you're using pm2)
  3. In the Ghost admin page, navigate to General section, change the theme to decent
  4. In the Ghost admin page, navigate to Code Injection section, add some configurations, for example, add Google Analytics service or Duoshuo comment service.
  5. Everything is done. Just visit your blog's home page to enjoy the theme.

Writing markdown

This theme support some custom styles, it enable you to write some cool styles in markdown, such as image caption, image alignment and so on. The detailed documentation can be found at docs/writing-markdown.md.

Configuration

See docs/configuration.md.

Development

  • Fork this project, and clone it to Ghost theme's folder.
  • Run npm install to install dependencies.
  • Run gulp to start development(make sure your Ghost is running, and you have set decent as your Ghost's theme.)

Gulp will watch your files' changes, and automatically generate the bundle file, like screen.css and bundle.min.js. So you don't need to build these files by yourself. And when the bundle file changes, the browser will automatically reload itself, to see the latest changes.

Thanks to

License

MIT