OpenSourceArk/Ghost
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,153 Commits 179 Branches 1,654 Tags 486 MiB
JavaScript 72.1%
TypeScript 14.1%
CSS 6.6%
Handlebars 6%
HTML 1.1%
7e9880ce8d
Go to file
Jacob Gable 7e9880ce8d Settings API Primary Document refactor 
Closes #2606

- Refactor settings api responses to { settings: [ ] } format
- Update all code using api.settings to handle new response format
- Update test stubs to return new format
- Update client site settings model to parse new format into one object of key/value pairs
- Refactor to include all setting values
- Remove unused settingsCollection method
- Update settingsCache to store all attributes
- Update settingsResult to send all attributes
- Remove unnecessary when() wraps
- Reject if editing a setting that doesn't exist
- Reject earlier if setting key is empty
- Update tests with new error messages
- Use setting.add instead of edit that was incorrectly adding
- Update importer to properly import activePlugins and installedPlugins
- Update expected setting result fields
- Fix a weird situation where hasOwnProperty didn't exist 🤷
2014-04-30 23:15:27 -05:00
content Updating to Casper 0.9.3 2014-03-20 19:23:13 +00:00
core Settings API Primary Document refactor 2014-04-30 23:15:27 -05:00
.bowerrc Adding .bowerrc 2014-04-03 09:43:47 +01:00
.gitignore Add shim for codemirror on touchscreens 2014-03-19 09:26:45 +00:00
.gitmodules in some cases the git protocol cannot be processed (port blocking or other reasons) with https it should work for everyone 2014-04-04 18:21:39 +02:00
.npmignore Cleanup more sass/ruby things 2014-03-09 22:19:59 +00:00
.travis.yml Server start refactor, route tests use ghost app 2014-04-04 12:45:18 +01:00
bower.json Updating Ghost-UI to 0.1.3 2014-03-26 12:47:53 +00:00
config.example.js Server start refactor, route tests use ghost app 2014-04-04 12:45:18 +01:00
CONTRIBUTING.md Update README & Contributing with details of stable branch 2014-04-01 00:22:04 +01:00
Gruntfile.js Add warning message about master branch to grunt prod 2014-04-16 11:17:00 +01:00
index.js Add promise to ghost startup process to allow 2014-03-11 11:41:45 -04:00
LICENSE Updating copyright range 2014-03-13 09:46:24 -07:00
package.json Update & grunt-groc and fix docs errors 2014-04-21 19:04:20 +01:00
README.md Made better-er 2014-04-22 00:40:16 +01:00
SECURITY.md Use less markup for links 2013-10-22 21:22:35 +01:00

README.md

Ghost Build Status

Ghost is a free, open, simple blogging platform that's available to anyone who wants to use it. Lovingly created and maintained by John O'Nolan + Hannah Wolfe + an amazing group of contributors.

Visit the project's website at http://ghost.org • docs on http://docs.ghost.org.

Getting Involved

Want to report a bug, request a feature, contribute or translate Ghost? Check out our in-depth guide to Contributing to Ghost. We need all the help we can get! You can also join in with our community to keep up-to-date and meet other Ghosters.

Getting Started

There are two main ways to get started with Ghost, take care to use the method which best suits your needs.

Please note - the downloadable zip files we provide on Ghost.org are pre-built packages designed for getting started quickly. Cloning from the git repository requires you to install several dependencies and build the assets yourself.

Getting Started Guide for Bloggers

If you just want to get a Ghost blog running in the fastest time possible, this method is for you.

For detailed instructions for various platforms visit the Ghost Installation Guide. If you get stuck, help is available on our forum.

  1. Install Node.js - Ghost requires Node v0.10.x
  2. Download the latest Ghost package from Ghost.org. If you cloned the GitHub repository you should follow the instructions for developers here.
  3. Create a new directory where you would like to run the code, and un-zip the package to that location.
  4. Fire up a Terminal, the Node Command Prompt or shell and change directory to the root of the Ghost application (where config.example.js and index.js are)
  5. run npm install --production to install the node dependencies. If you see error Error: ENOENT on this step, make sure you are in the project directory and try again.
  6. To start ghost, run npm start
  7. Visit http://localhost:2368/ in your web browser or go to http://localhost:2368/ghost to log in

Check out the Documentation for more detailed instructions, or get in touch via the forum if you get stuck.

Getting Started Guide for Developers

If you're a theme, app or core developer, or someone comfortable getting up and running from a git clone, this method is for you.

If you clone the GitHub repository, you will need to build a number of assets using grunt.

Please do NOT use the master branch of Ghost in production. If you are using git to deploy to production, please use the latest release or the stable branch which contains the latest release.

Quickstart:

  1. npm install -g grunt-cli
  2. npm install
  3. grunt init (and grunt prod if you want to run Ghost in production mode)
  4. npm start

Full instructions & troubleshooting tips can be found in the Contributing Guide under the heading "Working on Ghost Core".

Check out the Documentation for more detailed instructions, or get in touch via the forum if you get stuck.

If you want to use Ghost as a NPM module there is a Wiki entry where you can find instructions on how to get set up.

Upgrading to The Latest Version

Upgrade instructions are in the Ghost Guide

Logging in For The First Time

Once you have the Ghost server up and running, you should be able to navigate to http://localhost:2368/ghost/ from a web browser, where you will be prompted to register a new user. Once you have entered your desired credentials you will be automatically logged in to the admin area.

Community

Keep track of Ghost development and Ghost community activity.

  • Follow Ghost on Twitter, Facebook and Google+.
  • Read and subscribe to the The Official Ghost Blog.
  • Join in discussions on the Ghost Forum
  • Chat with Ghost developers on IRC. We're on irc.freenode.net, in the #Ghost channel. We have a public meeting every Tuesday at 5:30pm London time.

Versioning

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, Ghost will be maintained according to the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>-<build>

Constructed with the following guidelines:

  • A new major release indicates a large change where backwards compatibility is broken.
  • A new minor release indicates a normal change that maintains backwards compatibility.
  • A new patch release indicates a bugfix or small change which does not affect compatibility.
  • A new build release indicates this is a pre-release of the version.

Copyright & License

Copyright (c) 2013-2014 Ghost Foundation - Released under the MIT license.