https://github.com/serenader2014/decent
A Ghost blog theme
https://github.com/serenader2014/decent
decent ghost ghost-theme theme
Last synced: about 1 year ago
JSON representation
A Ghost blog theme
- Host: GitHub
- URL: https://github.com/serenader2014/decent
- Owner: serenader2014
- Created: 2016-02-27T16:11:31.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-24T12:57:54.000Z (almost 9 years ago)
- Last Synced: 2025-04-14T14:15:03.499Z (about 1 year ago)
- Topics: decent, ghost, ghost-theme, theme
- Language: JavaScript
- Size: 30.6 MB
- Stars: 52
- Watchers: 6
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# decent
A Ghost blog theme, modified from [Casper](https://github.com/TryGhost/Casper). The main design is inspired by [Aquila](https://github.com/lxndio/Aquila).
Demo: [my blog](https://blog.serenader.me)
## 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](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](https://github.com/serenader2014/decent/releases), 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](docs/writing-markdown.md).
## Configuration
See [docs/configuration.md](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](http://gulpjs.com) 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
- [Ghost](https://ghost.org)
- [Casper](https://github.com/TryGhost/Casper)
- [Aquila](https://github.com/lxndio/Aquila)
- [Prism.js](http://prismjs.com/index.html)
- [Photoswipe](http://photoswipe.com/)
- [Duoshuo](http://duoshuo.com/)
- [Disqus](https://disqus.com/)
- [Progress.js](https://github.com/serenader2014/progress.js)
## License
MIT