Cloud9 3.0 SDK for Plugin Development
 
 
 
 
 
 
Go to file
nightwing 26a48f9224 remove dom parser 2017-05-24 17:31:05 +04:00
bin remove old code and add support for loading plugins from cdn 2017-04-03 01:01:02 +04:00
build fix build-standalone script 2017-04-07 19:47:23 +00:00
configs Merge pull request +15232 from c9/ide-plugins 2017-05-05 16:07:31 +04:00
docs Merge remote-tracking branch 'remotes/origin/pull/core/375' 2016-11-26 22:29:11 +04:00
local fix local version 2017-02-18 22:05:19 +04:00
node_modules add a way to list all open tmux sessions 2017-05-23 19:10:31 +04:00
plugins remove dom parser 2017-05-24 17:31:05 +04:00
scripts improve gh-pages of c9/core 2017-05-11 23:32:30 +04:00
settings allow running without .git/HEAD 2017-02-21 18:57:05 +04:00
test fix test runner in the sdk 2017-02-16 16:53:58 +00:00
user-plugins/scripts better name for extensions folder 2017-02-06 19:48:18 +00:00
.eslintignore Ignore language infer tests 2017-01-30 11:32:41 +00:00
.eslintrc Disable comment rule 2017-01-27 09:08:15 +00:00
.gitignore c9-auto-bump 3.1.2814 2016-06-26 13:53:19 +02:00
.nakignore c9-auto-bump 3.1.2814 2016-06-26 13:53:19 +02:00
LICENSE c9-auto-bump 3.1.2814 2016-06-26 13:53:19 +02:00
LICENSE-COMMERCIAL-USE c9-auto-bump 3.1.2814 2016-06-26 13:53:19 +02:00
NOTICE Add NOTICE 2016-07-07 19:40:01 +00:00
README.md bump 2017-02-28 22:08:32 +01:00
package.json c9-auto-bump 3.1.3601 2017-05-24 14:26:30 +02:00
server.js use builtin module resolution instead of reimplementing it in architect 2017-01-29 14:22:04 +04:00

README.md

Cloud9 3.0 SDK for Plugin Development

This is the core repository for the Cloud9 v3 SDK. The SDK allows you to run a version of Cloud9 that allows you to develop plugins and create a custom IDE based on Cloud9.

Project Status: ALPHA

During the alpha stage, expect many things to break, not work or simply fail.

Creating Plugins

The best and easiest way to create plugins is on c9.io. Please check out this tutorial for how to get started writing plugins.

We also have a tutorial for how to get started working on the core plugins. Check out that tutorial here.

Documentation

We have several documentation resources for you:

SDK documentationhttp://cloud9-sdk.readme.io/v0.1/docs
API documentationhttp://docs.c9.io/api
User documentationhttp://docs.c9.io

Please join the mailinglist to get support or give support to the growing community of plugin developers: https://groups.google.com/forum/#!forum/cloud9-sdk

Installation

Follow these steps to install the SDK:

git clone git://github.com/c9/core.git c9sdk
cd c9sdk
scripts/install-sdk.sh

To update the SDK to the latest version run:

git pull origin master
scripts/install-sdk.sh

Please note that Cloud9 v3 is currently developed with Node.js 0.12 and 0.10. Newer versions of node should work too.

Starting Cloud9

Start the Cloud9 as follows:

node server.js

The following options can be used:

--settings       Settings file to use
--help           Show command line options.
-t               Start in test mode
-k               Kill tmux server in test mode
-b               Start the bridge server - to receive commands from the cli  [default: false]
-w               Workspace directory
--port           Port
--debug          Turn debugging on
--listen         IP address of the server
--readonly       Run in read only mode
--packed         Whether to use the packed version.
--auth           Basic Auth username:password
--collab         Whether to enable collab.
--no-cache       Don't use the cached version of CSS

Now visit http://localhost:8181/ide.html to load Cloud9.

Running Tests

Run server side tests with:

npm run test

Run client side tests with:

npm run ctest

Then visit http://localhost:8181/static/test in your browser.

Contributing

We actively encourage and support contributions. We accept pull requests to the core as well as to any of the open source plugins and libraries that we maintain under the c9 organization on GitHub.

Feel free to fork and improve/enhance the Cloud9 SDK and the open source plugins in any way you want. Then please open a pull request. For more information on our contributing guidelines, see our contributing guide: http://cloud9-sdk.readme.io/v0.1/docs/contributing-to-cloud9

To protect the interests of the Cloud9 contributors and users we require contributors to sign a Contributors License Agreement (CLA) before we pull the changes into the main repository. Our CLA is the simplest of agreements, requiring that the contributions you make to an ajax.org project are only those you're allowed to make. This helps us significantly reduce future legal risk for everyone involved. It is easy, helps everyone, takes ten minutes, and only needs to be completed once. There are two versions of the agreement:

  1. The Individual CLA: use this version if you're working on the Cloud9 SDK or open source plugins in your spare time, or can clearly claim ownership of copyright in what you'll be submitting.
  2. The Corporate CLA: have your corporate lawyer review and submit this if your company is going to be contributing to the Cloud9 SDK and/or open source plugins.

If you want to contribute to the Cloud9 SDK and/or open source plugins please go to the online form, fill it out and submit it.

Happy coding, Cloud9