Official Sagemath guide
Setting up local development copy
- Get develop branch of sage.
git clone https://github.com/sagemath/sage cd ~/sage git checkout develop
- Build sage.
cd ~/sage export MAKE='make -j 48' nice -n 19 make build
Setting up trac
Go here to make an account: https://trac.sagemath.org/ . (At some point, the password here is stored as plain text on your local machine...)
The sage people made a cool tool (https://github.com/sagemath/git-trac-command) to help interact with the sage trac servers!
Setup trac command
cd git clone https://github.com/sagemath/git-trac-command cd ~/git-trac-command python setup.py install --user
- Authenticate with user/token
cd ~/sage git trac config --user USERNAME --token <TOEKN FROM TRAC>
- Authenticate with ssh keys
- make the key-pair
cd ssh-keygen # follow the prompts
- Show the public key
- copy this over to the trac.sagemath.org in your account settings
Make a ticket!!
- Hit the new ticket button.
- Fill things in!
Checkout the ticket
cd ~/sage git trac checkout <ticket number>
Make a commit
- Do some edits.
git add <file>to tell git to track these edits.
- Run some tests
git commit -m "<one line description>"to make a commit.
git trac pushto send to the trac server.
- Edit the ticket appropriately.