Using Shithub

If you need an account setup, please contact Ori. After that, creating a repository:
	rcpu -h shithub.us \
		-c newrepo -d 'description' \
		-c 'contact@me.com' repo
	git/push -u hjgit://shithub.us/$user/repo

Your repositories live under

	/usr/git/$user

A repo contains a few control files for the web interface. All of them live under the repository, in /usr/git/$user/$repo/.git/$file. These are the control files that are currently supported:

webpublish
If this file exists, then the repository is published in the public web list of repositories.
desc, description
The short description of the repository. It shows up in the repo list.
contact
Contact information for submitting patches. Shows up on the repository info page.
README
A readme file, shown in the info page of the repository. If this file is not present, then a README from within the repository will be used, and if neither exist, then the description will be used.

You can cd into there create the repository, and flag them as web-visible by hand, or you can use the newrepo script, which is a small wrapper around git/init that creates the control files:

	newrepo [-d description] [-c contact] reponame

README files in the repo will be rendered, but if you don't want to clutter root of your repository with junk, you can also add README files here:

	/usr/git/$user/$repo/.git/README

Unix and Shithub

Shithub is hosted on 9front, and uses dp9ik authentication for pushing code. In order to push from Unix, you'll need a git remote helper that allows pushing hjgit:// urls

One is available here.

Repositories can be created as above, using 9cpu in place of cpu.