Developer Setup Instructions
Git
- Go to http://code.google.com/p/msysgit/downloads/list (Mac-User: http://code.google.com/p/git-osx-installer/)
- Download Git-1.7.7
- Start the installer
- Choose 'Run git from the windows command prompt' and 'use OpenSSH'.
Default selection can be used for all other settings.
- Start GitBash (Mac-Users: use "Terminal")
- Type: git config --global user.name "Your Name"
Enter your first and lastname.
- Type: git config --global user.email my@mail.com
Enter the mail address with which you want to sign up at github.
- Type: ssh-keygen -t rsa -C "my@mail.com"
The mail address need to match the mail address you just entered
- Just keep the standard path. You don't need to provide a password.
GitHub
- Go to https://github.com/signup/free
- Enter your data to create an account
- Go to your account settings
- Choose SSH Public Keys
- Click "Add another public key"
- Find the file C:\Users\Name.ssh\id_rsa.pub
(Mac-User: Finder => Shift+Cmd+G => /Users/<>/.ssh and open id_rsa.pub
with TextEdit )
- Copy and paste the content of the file into the field on the github website
- Save Changes
- Go to GitBash (Mac: Terminal) and type ssh -T git@github.com to check your settings
- "Are you sure you want to continue?" ==> YES
- You should get the messaege "Hi <>! You've successfully authenticated,
but GitHub does not provide shell access."
- Goto https://github.com/WWI09SWB/DualonCMS and create a fork (Click "Fork")
Local development environment
- Create a directory on your hard drive
- Start GitBash
- Change to the directory you just created
- Type: git clone git@github.com:<< username >>/DualonCMS.git
- Type: cd DualonCMS
- Type: git remote add upstream git@github.com:WWI09SWB/DualonCMS.git
- Type: git fetch upstream
Eclipse
- Download Eclipse Indigo
- Via Help -> Install new software... install the following components:
- PHP Development Tools (PDT)
- Eclipse EGit
- Switch to "Git Repository Exploring" perspective (you might have to add
it via Window -> Open Perspective
- Click: "Add an existing local Git Repository to this view"
- Select the directory where you created the repository and add it
- Right click on you Repository and select Import projects
- Select Import general project
- After creating the project switch to the PHP perspective
- Right click on your project and select Configure -> Add PHP Support
Developing
- Create a new branch for every new feature or bugfix. The name of the
branch should match the name of the task in the project management system.
- To create a branch select: Team -> Switch to -> New branch
- When you're done with all changes commit the changes: Team -> Commit
- You can merge Branches via Team -> Merge
Other things to to (everything can also be accessed via Team in Eclipse)
- to push your local changes to the github repository type:
git push origin branchname
- to update things that changed in the master repository type:
git pull upstream master
- delete a branch
git branch -d name
Sending code to the master repository
- go to your github site and select the branch, that contains all the commits you did
- click on "pull request"
- you can then review your commit and type in a message for the admins
- you can manage your requests by clicking "Pull requests" on your dashboard