mirror of
https://github.com/TryGhost/Ghost.git
synced 2025-01-20 22:42:53 -05:00
Update readme for 1.0 😱 (#7405)
This commit is contained in:
parent
25a9b4aa3a
commit
fa07cc7f52
1 changed files with 25 additions and 41 deletions
66
README.md
66
README.md
|
@ -1,9 +1,7 @@
|
||||||
<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://github.com/TryGhost/Ghost"><img src="https://cloud.githubusercontent.com/assets/120485/18661790/cf942eda-7f17-11e6-9eb6-9c65bfc2abd8.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>
|
<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>
|
||||||
|
|
||||||
![Ghost Screenshot](https://cloud.githubusercontent.com/assets/120485/6626466/6dae46b2-c8ff-11e4-8c7c-8dd63b215f7b.jpg)
|
<a href="https://dev.ghost.org/lts"><img src="https://cloud.githubusercontent.com/assets/120485/18661856/0930282e-7f18-11e6-948a-00546393fd93.png" alt="Warning: Major release in progress. Expect things to be broken in master." /></a>
|
||||||
|
|
||||||
![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)
|
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
@ -13,53 +11,45 @@ The project is maintained by a non-profit organisation called the **Ghost Founda
|
||||||
- [Theme Docs](http://themes.ghost.org)
|
- [Theme Docs](http://themes.ghost.org)
|
||||||
- [Contributing Guide](https://github.com/TryGhost/Ghost/blob/master/.github/CONTRIBUTING.md)
|
- [Contributing Guide](https://github.com/TryGhost/Ghost/blob/master/.github/CONTRIBUTING.md)
|
||||||
- [Feature Requests](http://ideas.ghost.org/)
|
- [Feature Requests](http://ideas.ghost.org/)
|
||||||
- [Dev Blog](http://dev.ghost.org)
|
- [Developer Blog](http://dev.ghost.org)
|
||||||
|
|
||||||
**NOTE: If you’re stuck, can’t 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.**
|
**NOTE: If you’re stuck, can’t 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.**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# Quick Start Install
|
# Quick Start Install
|
||||||
|
|
||||||
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/.
|
First, you’ll need **Node.js v4 LTS** or a [supported version](http://support.ghost.org/supported-node-versions/).
|
||||||
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
|
1. Download the [latest release](https://ghost.org/developers/) of Ghost
|
||||||
1. Unzip in the location you want to install
|
1. Unzip, and fire up terminal
|
||||||
1. Fire up a terminal
|
|
||||||
1. `npm install --production`
|
1. `npm install --production`
|
||||||
1. Start Ghost!
|
1. Start Ghost!
|
||||||
- Local environment: `npm start`
|
- Local environment: `npm start`
|
||||||
- On a server: `npm start --production`
|
- On a server: `npm start --production`
|
||||||
1. `http://localhost:2368/ghost` :tada:
|
1. `http://localhost:2368/ghost` :tada:
|
||||||
|
|
||||||
More [install docs](http://support.ghost.org/installation/) here in case you got stuck.
|
More [install docs](http://support.ghost.org/installation/) here in case you get stuck.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<a name="getting-started"></a>
|
<a name="getting-started"></a>
|
||||||
# Developer Install (from git)
|
# Developer Install
|
||||||
|
|
||||||
Install Node.js. (See [Supported Node.js versions](http://support.ghost.org/supported-node-versions/))
|
This is for if you want to hack on Ghost core. First, you’ll need **Node.js v4 LTS** or a [supported version](http://support.ghost.org/supported-node-versions/). Then:
|
||||||
|
|
||||||
```bash
|
|
||||||
# Node v4.2+ LTS - recommended
|
|
||||||
# Node v6.5+ and v0.12.x - supported
|
|
||||||
#
|
|
||||||
# Choose wisely
|
|
||||||
```
|
|
||||||
|
|
||||||
Clone :ghost:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone git://github.com/tryghost/ghost.git
|
git clone git://github.com/tryghost/ghost.git
|
||||||
cd ghost
|
cd ghost
|
||||||
```
|
```
|
||||||
|
|
||||||
Install grunt. No prizes here.
|
Install grunt
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install -g grunt-cli
|
npm install -g grunt-cli
|
||||||
```
|
```
|
||||||
|
|
||||||
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:
|
Install Ghost
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install
|
npm install
|
||||||
|
@ -71,34 +61,28 @@ Build the things!
|
||||||
grunt init
|
grunt init
|
||||||
```
|
```
|
||||||
|
|
||||||
Minify that shit for production?
|
Start your engines
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
grunt prod
|
grunt dev
|
||||||
```
|
```
|
||||||
|
|
||||||
Start your engines.
|
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). More general [install docs](http://support.ghost.org/installation/) here in case you got stuck.
|
||||||
|
|
||||||
```bash
|
|
||||||
npm start
|
|
||||||
|
|
||||||
## running production? Add --production
|
|
||||||
```
|
|
||||||
|
|
||||||
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).
|
|
||||||
|
|
||||||
More general [install docs](http://support.ghost.org/installation/) here in case you got stuck.
|
|
||||||
|
|
||||||
|
|
||||||
# Deploying Ghost
|
# Deploying Ghost
|
||||||
|
|
||||||
![Ghost(Pro) + DigitalOcean](https://cloud.githubusercontent.com/assets/120485/8180331/d6674e32-1414-11e5-8ce4-2250e9994906.png)
|
<a href="https://ghost.org/pricing"><img src="https://cloud.githubusercontent.com/assets/120485/18662071/f30da886-7f18-11e6-90f2-42c0ade79fd1.png" alt="Ghost(Pro)" /></a>
|
||||||
|
|
||||||
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.
|
The easiest way to deploy Ghost is with our official **[Ghost(Pro)](https://ghost.org/pricing/)** managed service. You can have a fresh instance up and running in a couple of clicks with a worldwide CDN, backups, security and maintenance all done for you.
|
||||||
|
|
||||||
All revenue from **Ghost(Pro)** goes to the Ghost Foundation, the non-profit org which funds the maintenance and further development of Ghost.
|
Not only will it save you [many hours per month](https://ghost.org/ghost-pro-vs-self-hosting/), but all revenue goes to the Ghost Foundation, which funds the maintenance and further development of Ghost itself. So you’ll be supporting open source software *and* getting a great service **at the same time**! Talk about win/win. :trophy:
|
||||||
|
|
||||||
[Other options](http://support.ghost.org/deploying-ghost/) are also available if you prefer playing around with servers by yourself.
|
[Other options](http://support.ghost.org/deploying-ghost/) are also available if you prefer playing around with servers by yourself, of course. The freedom of choice is in your hands.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# Staying Up to Date
|
# Staying Up to Date
|
||||||
|
@ -107,9 +91,9 @@ When a new version of Ghost comes out, you'll want to look over these [upgrade i
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
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.
|
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. :saxophone::turtle:
|
||||||
|
|
||||||
:saxophone::turtle:
|
|
||||||
|
|
||||||
|
|
||||||
# Copyright & License
|
# Copyright & License
|
||||||
|
|
Loading…
Add table
Reference in a new issue