Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jernejcic/GhostThemeStarter
Ghost Theme Starter is a repo to make it easy to get start creating a new theme for the Ghost blogging platform.
https://github.com/jernejcic/GhostThemeStarter
Last synced: about 2 months ago
JSON representation
Ghost Theme Starter is a repo to make it easy to get start creating a new theme for the Ghost blogging platform.
- Host: GitHub
- URL: https://github.com/jernejcic/GhostThemeStarter
- Owner: jernejcic
- License: mit
- Created: 2014-03-09T19:16:06.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2014-03-24T02:31:29.000Z (over 10 years ago)
- Last Synced: 2024-05-08T14:32:23.969Z (5 months ago)
- Language: JavaScript
- Size: 199 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ghost Theme Starter
===================Ghost Theme Starter is a repo to make it easy to get start creating a new theme for the Ghost blogging platform. The purpose it to create a bank canvas to experience Ghost theme designers to start from and to have enough functionaly built in that a designers new to Ghost can get started without having to learn a ton about the platform first.
Table of Content
----------------- [Requirements](#requirements)
- [Installation](#installation)
- [Tools](#tools)
- [settings.json](#settings.json)
- [CSS](#css)
- [Dependendices](#dependencies)
- [Documentation](#documentaiton)
- [Copyright and License](#copyright-and-license)Requirements
------------You need to have `Ruby` installed for SASS compilation.
Installation
------------Clone the repository from:
git clone https://github.com/jernejcic/GhostThemeStarter.git
Then install the dependencies using:
cd GhostThemeStarter
gem install sass
npm install
bower install
grunt initNow update `theme/settings.json` with the desired setup you would like. If you do not want to use a feature, then remove its value from the settings. See [Settings](#settings.json) below for more info.
After configuring the settings run:
grunt create
At this point you have a fully functional--though very simple--theme. You will find it in the `theme` folder. It would be suitable to use in a blog functionality wise.
The optional last step is to build a compressed version of the theme. This minifies the CSS and HTML and drops the theme in it's own folder with the name that you put in the `theme/settings.json` file. It is perfect to dropping into a live Ghost blog. Run this command to create it:
grunt build
Tools
-----When in development you use the following command to build the CSS. It will initiate a service to watch for changes SCSS files and automatically recompile them for you.
grunt server
When you need to build the theme for distribution, run the following command. It will compress the CSS files for you.
grunt build
When creating a new project, you can run this command to create the custom SCSS files:
grunt init
To manually build the CSS in expanded formatting use:
grunt sass:dev
To manually build the CSS files in compressed format use:
grunt sass:dist
settings.json
-------------You can remove any key/value from this JSON file if you do not want the corresponding service file to be created.
### THEME_NAME
### THEME_FOLDER
This is automatically create from the `THEME_NAME`. It can be overriden by adding it into the `theme/settings.json` file.
### DISQUS_SHORTNAME
### GOOGLE_ANALYTICS_CODE
### GOOGLE_ANALYTICS_DOMAIN
CSS
---The CSS files are built in "expanded" mode during development and are compressed when built using `grunt build`.
### screen.scss
Built as `screen.css`.
This is the main CSS file used on the front it. It links to the other SCSS files to build the master CSS file for the front-end.
### post.scss
Built as `post.css`.
This file should not be linked to in the theme. It is pulled into the `screen.css` file during compilation.
This file should contain all styling directly related to how text inside of a post will look on the page. Ghost currently has plans to allow dynamic styling in the post editor and will use this file.
### SCSS Compilation Errors
If you get an error when you first try to compile the SCSS, make sure that you created the following files:
- theme/assets/css/screen.custom.scss
- theme/assets/css/post.custom.scssDependencies
------------### Node
- grunt
- grunt-contrib-cssmin
- grunt-contrib-sass
- grunt-contrib-uglify
- grunt-contrib-watch### Bower
- bootstrap-sass
- modernizrDocumentation
-------------For more details on creating Ghost themes, you can find the official documentation at [http://docs.ghost.org/themes/](http://docs.ghost.org/themes/).
Copyright and License
---------------------Released under the [MIT license](LICENSE).