Actions

Accessing the source code: Difference between revisions

From LimeSurvey Manual

No edit summary
No edit summary
Line 18: Line 18:
==Step-by-Step How-To (Windows)==
==Step-by-Step How-To (Windows)==
# Create a [https://github.com/ GitHub] account.
# Create a [https://github.com/ GitHub] account.
# Download and install Git for Windows from [http://code.google.com/p/msysgit/downloads/list]. Make sure that during install when asked for adding the Git path to your system path that you choose the "Run Git from the Windows Command Prompt" option.
# Download and install [http://www.syntevo.com/smartgit/download.html SmartGit].
# Download and install [http://www.syntevo.com/smartgit/download.html SmartGit].
# Clone the LimeSurvey repository at GitHub. You can find the right clone URL at  https://github.com/LimeSurvey/LimeSurvey .
# Clone the LimeSurvey repository at GitHub. You can find the right clone URL at  https://github.com/LimeSurvey/LimeSurvey .

Revision as of 15:19, 15 February 2012

General

Until recently we used Subversion as versioning control system but now have moved to Git.

Accessing the LimeSurvey Source Code

Always be aware that most of the LimeSurvey Source code is bleeding edge. Do not use it for production purposes (except fo the master branch!

As for many other free software projects only community support is available.

Access the LimeSurvey source code with a Subversion client for your operating system.

  • For Windows we recommend: SmartGit because it is very easy to use.
  • For Mac we recommend: Git. Commandline all the way ;)

Step-by-Step How-To (Windows)

  1. Create a GitHub account.
  2. Download and install Git for Windows from [1]. Make sure that during install when asked for adding the Git path to your system path that you choose the "Run Git from the Windows Command Prompt" option.
  3. Download and install SmartGit.
  4. Clone the LimeSurvey repository at GitHub. You can find the right clone URL at  https://github.com/LimeSurvey/LimeSurvey .
  5. The whole source code repository should be downloading now.
  6. By default you should see the 'master' branch in the current directory
  7. Use the Switch command from the SmartGit GUI to switch to the branch you need.
  8. That's it.

Please add instructions for other OSs or complete the existing ones.

Available branches

These are the available GitHub branches right now:

  • master - This is the always the current stable (plus) version including any fixes not yet released.
  • Dev - this is currently the branch for the 1.92 version being in Release candidate period
  • Yii - the branch for the Yii 2.0 version which is the bleeding edge currently
  • original_art and original_art 2: These are the SVG files for almost all icons the stable and Yii version.
  • other_scripts, server_scripts, translation status: These are scripts being used in limesurvey.org or for new releases. We will merge these to a single 'server-scripts' branch soon.
  • Codeigniter - The old CodeIgniter branch - it is deprecated, do not use it, and will be removed soon

Further documentation

Please make sure you code accoding to our Coding guidelines.