From 63e6d2e63a63a3e81a07b03d6da1bcb459213201 Mon Sep 17 00:00:00 2001 From: elijah Date: Fri, 4 Mar 2016 12:31:20 -0800 Subject: updated quick start tutorials and added a 'getting started' page. --- pages/docs/platform/details/development.md | 78 ++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 pages/docs/platform/details/development.md (limited to 'pages/docs/platform/details/development.md') diff --git a/pages/docs/platform/details/development.md b/pages/docs/platform/details/development.md new file mode 100644 index 0000000..78915ad --- /dev/null +++ b/pages/docs/platform/details/development.md @@ -0,0 +1,78 @@ +@title = 'Development' +@summary = "Getting started with making changes to the LEAP platform" + +Installing leap_cli +------------------------------------------------ + +### From gem, for a single user + +Install the latest: + + gem install leap_cli --install-dir ~/leap + export PATH=$PATH:~/leap/bin + +Install a particular version: + + gem install leap_cli --version 1.8 --install-dir ~/leap + export PATH=$PATH:~/leap/bin + +### From gem, system wide + +Install the latest: + + sudo gem install leap_cli + +Install a particular version: + + sudo gem install leap_cli --version 1.8 + +### As a gem, built from source + + sudo apt-get install ruby ruby-dev rake + git clone https://leap.se/git/leap_cli.git + cd leap_cli + git checkout develop + rake build + sudo rake install + +### The "develop" branch from source, for a single user + + sudo apt-get install ruby ruby-dev rake + git clone https://leap.se/git/leap_cli.git + cd leap_cli + git checkout develop + +Then do one of the following to be able to run `leap` command: + + cd leap_cli + export PATH=$PATH:`pwd`/bin + alias leap="`pwd`/bin/leap" + ln -s `pwd`/bin/leap ~/bin/leap + +In practice, of course, you would put aliases or PATH modifications in a shell startup file. + +You can also clone from https://github.com/leap/leap_cli + +Running different leap_cli versions +--------------------------------------------- + +### If installed as a gem + +With rubygems, you can always specify the gem version as the first argument to any executable installed by rubygems. For example: + + sudo gem install leap_cli --version 1.7.2 + sudo gem install leap_cli --version 1.8 + leap _1.7.2_ --version + => leap 1.7.2, ruby 2.1.2 + leap _1.8_ --version + => leap 1.8, ruby 2.1.2 + +### If running from source + +Alternately, if you are running from source, you can alias different commands: + + git clone https://leap.se/git/leap_cli.git + cd leap_cli + git checkout develop + alias leap_develop="`pwd`/bin/leap` + -- cgit v1.2.3