Ghost/README.md

118 lines
4.7 KiB
Markdown
Raw Normal View History

2015-03-12 22:40:21 +03:00
<a href="https://github.com/TryGhost/Ghost"><img src="https://cloud.githubusercontent.com/assets/120485/6622822/c4c639fe-c8e7-11e4-9e64-5bec06c8b4c3.png" alt="Ghost" /></a>
<a href="https://travis-ci.org/TryGhost/Ghost"><img align="right" src="https://travis-ci.org/TryGhost/Ghost.svg?branch=master" alt="Build status" /></a>
2015-03-12 22:40:21 +03:00
![Ghost Screenshot](https://cloud.githubusercontent.com/assets/120485/6626466/6dae46b2-c8ff-11e4-8c7c-8dd63b215f7b.jpg)
2014-10-29 18:34:00 +03:00
2015-03-12 22:40:21 +03:00
![Ghost is a simple, powerful publishing platform that allows you to share your stories with the world.](https://cloud.githubusercontent.com/assets/120485/6626501/b2bb072c-c8ff-11e4-8e1a-2e78e68fd5c3.png)
2013-05-11 20:44:25 +04:00
2015-03-12 22:40:21 +03:00
The project is maintained by a non-profit organisation called the **Ghost Foundation**, along with an amazing group of independent [contributors](https://github.com/TryGhost/Ghost/contributors). We're trying to make publishing software that changes the shape of online journalism.
2015-03-12 22:40:21 +03:00
- [Ghost.org](https://ghost.org)
- [Latest Release](https://ghost.org/developers/)
- [Support](http://support.ghost.org/)
2015-03-12 22:40:21 +03:00
- [Theme Docs](http://themes.ghost.org)
- [Contributing Guide](https://github.com/TryGhost/Ghost/blob/master/.github/CONTRIBUTING.md)
2015-03-12 22:40:21 +03:00
- [Feature Requests](http://ideas.ghost.org/)
- [Dev Blog](http://dev.ghost.org)
**NOTE: If youre stuck, cant get something working or need some help, please head on over and join our [Slack community](https://ghost.org/slack/) rather than opening an issue.**
2013-11-12 13:05:57 +04:00
2015-03-12 22:40:21 +03:00
# Quick Start Install
2013-11-12 13:05:57 +04:00
Make sure you've installed Node.js - Latest **Node v4 LTS** release is required. We don't support 0.10.x anymore, see https://dev.ghost.org/end-of-node-js-0-10/.
For other versions [click here](http://support.ghost.org/supported-node-versions/). May contain nuts.
1. Download the [latest release](https://ghost.org/developers/) of Ghost
2015-03-12 22:40:21 +03:00
1. Unzip in the location you want to install
1. Fire up a terminal
1. `npm install --production`
1. Start Ghost!
- Local environment: `npm start`
- On a server: `npm start --production`
1. `http://localhost:2368/ghost` :tada:
2015-03-12 22:40:21 +03:00
More [install docs](http://support.ghost.org/installation/) here in case you got stuck.
<a name="getting-started"></a>
2015-03-12 22:40:21 +03:00
# Developer Install (from git)
Install Node.js. (See [Supported Node.js versions](http://support.ghost.org/supported-node-versions/))
2015-03-12 22:40:21 +03:00
```bash
# Node v4.2+ LTS - recommended
# Node v6.5+ and v0.12.x - supported
2015-03-12 22:40:21 +03:00
#
# Choose wisely
```
2015-02-28 19:46:16 +03:00
2015-03-12 22:40:21 +03:00
Clone :ghost:
2015-03-12 22:40:21 +03:00
```bash
git clone git://github.com/tryghost/ghost.git
cd ghost
```
2015-03-12 22:40:21 +03:00
Install grunt. No prizes here.
2015-03-12 22:40:21 +03:00
```bash
npm install -g grunt-cli
```
2015-03-12 22:40:21 +03:00
Install Ghost. If you're running locally, use [master](https://github.com/TryGhost/Ghost/tree/master). For production, use [stable](https://github.com/TryGhost/Ghost/tree/stable). :no_entry_sign::rocket::microscope:
2015-03-12 22:40:21 +03:00
```bash
npm install
```
2015-03-12 22:40:21 +03:00
Build the things!
2015-03-12 22:40:21 +03:00
```bash
grunt init
```
2015-03-12 22:40:21 +03:00
Minify that shit for production?
2015-03-12 22:40:21 +03:00
```bash
grunt prod
```
2015-03-12 22:40:21 +03:00
Start your engines.
2014-03-20 15:53:23 +04:00
2015-03-12 22:40:21 +03:00
```bash
npm start
2015-03-12 22:40:21 +03:00
## running production? Add --production
```
2014-03-20 15:53:23 +04:00
2015-12-23 23:36:44 +03:00
Congrats! You made it. BTW you can also just `npm install ghost` if you're into that sort of thing. NPM aficionados can also read up on using [Ghost as an NPM module](https://github.com/TryGhost/Ghost/wiki/Using-Ghost-as-an-npm-module).
2014-03-20 15:53:23 +04:00
2015-03-12 22:40:21 +03:00
More general [install docs](http://support.ghost.org/installation/) here in case you got stuck.
2015-03-12 22:40:21 +03:00
# Deploying Ghost
![Ghost(Pro) + DigitalOcean](https://cloud.githubusercontent.com/assets/120485/8180331/d6674e32-1414-11e5-8ce4-2250e9994906.png)
Save yourself time and headaches with our fully managed **[Ghost(Pro)](https://ghost.org/pricing/)** service. Deploy a new instance of Ghost in a couple of clicks running on [DigitalOcean](https://digitalocean.com)s rock solid infrastructure, with a worldwide CDN thrown in at no extra charge.
2015-08-28 02:48:15 +03:00
All revenue from **Ghost(Pro)** goes to the Ghost Foundation, the non-profit org which funds the maintenance and further development of Ghost.
[Other options](http://support.ghost.org/deploying-ghost/) are also available if you prefer playing around with servers by yourself.
2015-03-12 22:40:21 +03:00
# Staying Up to Date
2015-03-12 22:40:21 +03:00
When a new version of Ghost comes out, you'll want to look over these [upgrade instructions](http://support.ghost.org/how-to-upgrade/) for what to do next.
2015-09-29 14:10:04 +03:00
You can talk to other Ghost users and developers in our [public Slack team](https://ghost.org/slack/) (it's pretty awesome). We have a public meeting every Tuesday at 5:30pm UK time.
2015-03-12 22:40:21 +03:00
New releases are announced on the [dev blog](http://dev.ghost.org/tag/releases/). You can subscribe by email or follow [@TryGhost_Dev](https://twitter.com/tryghost_dev) on Twitter, if you prefer your updates bite-sized and facetious.
2015-03-12 22:40:21 +03:00
:saxophone::turtle:
2015-03-12 22:40:21 +03:00
# Copyright & License
2013-05-19 19:37:45 +04:00
2016-01-03 16:01:56 +03:00
Copyright (c) 2013-2016 Ghost Foundation - Released under the [MIT license](LICENSE).