Instructions for installing Ximera locally

Ximera can also be run on your own machine rather than through CoCalc. Note that you will need to initialize your own git repos if you are not running through the CoCalc xandbox using git init.

Terminal commands for installing xake on Ubuntu 16.04

sudo apt-get install golang-go

Corresponding libgit2 and git2go installations are needed:

sudo apt-get install libgit2-dev
 
sudo apt-get install golang-git2go-dev  
mkdir -p ~/go/src/github.com/ximeraproject  
export GOPATH=$HOME/go  
cd ~/go/src/github.com/ximeraproject  
git clone https://github.com/XimeraProject/xake.git  
cd ~/go/src/github.com/libgit2/git2go  
git checkout v24  
cd ~/go/src/github.com/ximeraproject/xake  
go get .  
go build .  
Use command ./xake or better yet, add xake to PATH by...  
Also set your PATH so that ~/go/bin/ is in it: (edit .profile)  
PATH=$PATH:~/go/bin

Reboot! Now you should be able to use the command xake

Terminal commands for installing xake on Mac

(a)
First you need HomeBrew. Follow the link and the instructions there.
(b)
Then you need to install Go. Note: the first instruction is to install HomeBrew, which you have already done.
(c)
You might need to install ’’pkg-config and ’’libgit2. This can be done via HomeBrew:
     brew install pkg-config
      
brew install libgit2  
brew install gpg  
brew install mupdf

(d)
Now perform the following commands in terminal:
     mkdir -p ~/go/src/github.com/ximeraproject
      
export GOPATH=$HOME/go  
cd ~/go/src/github.com/ximeraproject  
git clone https://github.com/XimeraProject/xake.git  
cd xake  
go get .  
go build .

(e)
If you dont already have a GPG key, then do gpg --gen-key, answer the questions, and copy the long hex string as YOUR-GPG-KEY-ID ( ABCD3562DBF9929292 or whatever)
     gpg --keyserver hkps://ximera.osu.edu/ --send-key YOUR-GPG-KEY-ID
      
 
PATH=$PATH:~/go/bin  
 
xake -k YOUR-GPG-KEY-ID name yourxakename

You will need to enter your passkey; prompt may be broken but try typing it and hitting enter anyway
(f)
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 "NAME
      
git config --global user.email EMAIL