The slides to this workshop can be found here
The recordings of the Workshop can be found on the NHM intranet under I:\Public\mkapun\FrontiersInMolecularSystematics\Workshop_III_GitHub
For additional very basic info to the usage of git, see here
a) Obtain GitHub desktop from here
b) Once installed, choose File > Option… to log in to your account
c) Once successfully logged in, GitHub Desktop will list all your repositories. Pick your previously created 1st repository. Choose the path to where you want to put the files on your computer
d) The overview window shows that there are no current changes to “My1stRep”
e) Now click “Show in Explorer”. This will show all the files that GitHub Desktop copied.
f) Double click on README and open with the Editor program. Now you can edit the text and, for example, try some markdown codes. Then save your changes and go back to GitHub Desktop
g) GitHub Desktop shows that README.md was modified and highlights the changes in the right-hand panel. In the bottom left, you can now add a description and commit the changes
h) Once the local changes are committed, you also need to upload these to GitHub. Press “Push origin” on the right hand side. Then you can see your updates on the GitHub page of the repository
Before you start, have a quick refresher what Atom is and how Atom works, see here
Find login field on GitHub tab on the right of the Atom window
Get your token by logging into your browser under https://GitHub.atom.io/login. Then copy token and paste into empty field in Atom
## create GitHub directory in home folder
mkdir ~/github
cd ~/github
## check if your git is set up correctly
git config --global --list
# 1) clone private My1stRepo repository
## note that you need your access tocken for that
firefox https://GitHub.atom.io/login
# then enter the tocken when prompted
git clone https://[email protected]/capoony/My1stRep
# 2) clone public repository
git clone https://GitHub.com/nhmvienna/Workshop_III_GitHubSee also here
Add a new project folder which contains the data that you want to publish, or create a new folder and add it as a project folder
Once the Folder appears in the project tab, you can see, that it is neither initialized, i.e. under version control with git, nor published on GitHub
Once you press “initialize”, you can decide where to publish Please ALWAYS use your private account, unless the repo is (1) a software project to be published or (2) a resource for the NHM. By default, it is published public, which may be not what you want!
A new /.git folder will appear within the project, which represents the git repository. New files will appear in green as unstaged (and thus not yet version-controlled) files.
Once they are staged, they are ready to be committed
You need to write a description for every commit, in this case, it is our “initial commit”
Last, but not least you need to “publish”, which, is very well hidden at the right bottom. Congrats, now, your repo is online!
When you make edits to your files under version control, the changes in the text will be highlighted by vertical bars in the editor and by changes to the color of the filename
As before, you need to stage the changes and add a description before committing the changes. Once this is done, you can push the changes, by pressing the same small button as before.
