The program xake is the Ximera “make” program.

One-time setup

Here is a list of commands that need to be run for the setup of a course.

(a)

If you have a GPG key, do:

     gpg --list-keys
     

(b)

If you don’t already have a GPG key, then do

     gpg --gen-key
     

answer the questions, but leave the passphrase blank and copy the long hex string as YOUR-GPG-KEY-ID (ABCD3562DBF9929292 or whatever).

If you are using MacOS, you might not be able to leave the passphrase blank. In this case go to https://gpgtools.org/ and install the GPG Suite. This will provide a GUI that will produce a GPG key with spaces. Delete these spaces and this new key (without spaces) is your key. You should quite your terminal and open a new one.

     gpg --keyserver hkps://ximera.osu.edu/ --send-key YOUR-GPG-KEY-ID
     

Now do

(c)

Now do:

                                                                  

                                                                  
     xake -k YOUR-GPG-KEY-ID name yourxakename
     

(d)

You may get vague error messages here if you have not successfully set up your git name and email; you can do this with:

     git config --global user.name "YOUR-NAME"
      
git config --global user.email "YOUR-EMAIL"
     

Work flow

The commands above are simply for setup. On a regular basis, the work flow is much simpler.

You must work in the top level of your git directory.

git pull
 
git add -u
 
git commit
 
git push
 
xake bake
 
xake frost
 
xake serve