This is a small demo example project meant as an introduction to help physicists work with git/github. It is designed to write a small article including a sections of famous physicists. Most of the resources are taken from wikipedia. This repository is meant as a small supplement to a presentation and introduction session.
Consider the steps below as an example how to work with a project on github.
-
Take this repository and create a fork.
-
Clone the forked repository to your computer. Using the command
git clone <similar_address_as_below>
. This will create a directory with the projects name. Be aware that the user name will be changed as you will be cloning your fork instead.Note: If you want to clone using SSH follow this instructions to add ssh keys to github.
-
On your local machine go to the cloned directory and create a new branch by using
git checkout -b <branch_name>
. Use a meaningful name for the branch. -
Edit the file
my-favorite-physicist.tex
and the corresponding subfiles. -
Check if it is compiling and working properly and then commit the changes using
git add <changed_file>
to track the modified files. Add a commit by usinggit commit
which should open an editor for you. Remember: First line (max 80 characters) is used as a commit heading - make this short and describe your changes extensively below. Better describe more than less. -
Now you can push the changes to github using
git push -u origin <the_name_of_branch>
. -
Go to your fork and create a pull request. You can add figures and additional informations to your pull request, e.g. your motivation behind your changes.
-
Wait ⌚ until your pull request will be accepted.