How to contribute code using Github
This page describes how you can contribute code to the Hydrogen project using Github
- goto github.com
- create a Gihub account
- upload your public key ``for SSH access
- clone the hydrogen repo :
- goto https://github.com/hydrogen-music/hydrogen
- click the 'fork' button (upper right) :
- wait
- now you have created a clone of the hydrogen repo in your Github repo that can be accessed via https://github.com/yourname/hydrogen
- clone the code from your Github repo to your PC
-
on your github repo page you will see a 'SSH clone URL' box :
-
copy the URL using the clipboard icon next to it
-
on your pc create a directory that will hold your local repo
-
open a terminal and cd to the directory you just created
-
now enter 'git clone [email protected]:thijz/hydrogen.git' :
$ git clone [email protected]:thijz/hydrogen.git
Cloning into 'hydrogen'...
remote: Counting objects: 28218, done.
remote: Compressing objects: 100% (16/16), done.
remote: Total 28218 (delta 8), reused 0 (delta 0), pack-reused 28202
Receiving objects: 100% (28218/28218), 15.39 MiB | 2.94 MiB/s, done.
Resolving deltas: 100% (19189/19189), done.- cd to the new Hydrogen subdir that was created and check the git status with 'git status' :
me@mypc:~/Git/Hydrogen/thijz$ cd hydrogen
me@mypc:~/Git/Hydrogen/thijz/hydrogen$ git status
# On branch master
nothing to commit (working directory clean)-
build hydrogen (see this wiki page)
-
fix a bug or create your own new Hydrogen feature
-
build hydrogen and test your new feature
-
commit your changes
- using the git status command you can see what files have been modified
me@mypc:~/Git/Hydrogen/thijz/hydrogen$ git status
# On branch master
# Your branch is behind 'origin/master' by 1 commits, and can be fast-forwarded.
#
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: src/gui/src/SongEditor/SongEditorPanelTagWidget_UI.ui
#
no changes added to commit (use "git add" and/or "git commit -a")- first you will have to add these files to your local repo :
me@mypc:~/Git/Hydrogen/thijz/hydrogen$ git add src/gui/src/SongEditor/SongEditorPanelTagWidget_UI.ui- now lets check the git status again :
me@mypc:~/Git/Hydrogen/thijz/hydrogen$ git status
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: src/gui/src/SongEditor/SongEditorPanelTagWidget_UI.ui
#