Contents

Raspberry Pi & github

Setting up access

The first step is to create a github account. Then for those on the MagPi layout team, email the editor for permission to join the github organisation.

Since the Raspberry Pi does not have a great deal of processor power, it is better to use the command line tools to access github. For OSX and Windows there are GUI tools available for download on the github site.

Tools for Raspberry Pi or VirtualBox

Several people would rather not read the git book. Therefore, some scripts were written to simplify the usage slightly.

mp-git-setup.sh

to install and configure git. The script has no action if the installation and configuration is already okay.

mp-git-clone.sh

Type

mp-git-clone.sh

to check out the shinything repository. The script will not check out the repository again if a local copy already exists in the present working directory.

mp-git-commit.sh

Type

mp-git-commit.sh 'A message goes here'

where the string 'A message goes here' should be replaced with a sensible and informative message.
The script commits to the local repository, fetches and remote changes and then merges the local changes into the
remote repository.

Using github

At the start of an editing session (when you log into the Raspberry Pi), type:

ssh-agent
ssh-add

then enter your password for the ssh key. This step needs to be rebooted each time you log into the Raspberry Pi.

Then use the ssh read and write link from the github repository, e.g.:

git clone git@github.com:someorg/reponame.git

this will create a folder called reponame. The clone operation clones the repository to the local disk.