From 42517687bb675e5f4d3252b25158f0e51ccad6b0 Mon Sep 17 00:00:00 2001 From: James Coglan Date: Thu, 17 Sep 2009 15:51:21 +0100 Subject: [PATCH] Documentation for 'he create' command. --- README.rdoc | 20 ++++++++++++++++++-- bin/he | 2 ++ 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/README.rdoc b/README.rdoc index 5b43cc6..5cff287 100644 --- a/README.rdoc +++ b/README.rdoc @@ -66,9 +66,9 @@ To install from GitHub: rake install_gem With the gem installed, you can install a copy of the web app anywhere on your system -using the +he+ command with the name of the directory to create: +using the +he install+ command with the name of the directory to create: - he helium-app + he install helium-app This will give you the following files: @@ -117,10 +117,12 @@ in its metadata. For example, here's a jake.yml file for the +Panel+ pa source_directory: . build_directory: . layout: together + builds: min: shrink_vars: true private: true + packages: panel: files: @@ -145,6 +147,20 @@ Note that objects listed under +provides+ and +requires+ should be the runtime r names of JavaScript objects, and anything in the +requires+ list should be provided by some other package known to the deploy system. +If you're starting a new project, Helium comes with a command line tool that generates +some stub code, a jake.yml file and a test page. Just run the following to +create a new project, replacing project-name with the name of your library. + + he create project-name + +After generating a project, you will need to edit its dependencies in jake.yml +and edit test/index.html to reference your Helium server so that dependencies +can be loaded. + +Running +jake+ from the new project directory will build the library for you and generate +a JS.Packages manifest for it. The test page uses require() to load your library, +so you'll know if any of its dependency data is missing. + === The deployment process Our deployment system performs the following steps on every project registered: diff --git a/bin/he b/bin/he index 1883340..a5908b7 100644 --- a/bin/he +++ b/bin/he @@ -1,3 +1,5 @@ +#! /usr/bin/env ruby + home = File.join(File.dirname(__FILE__), '..') require 'fileutils'