Create empty repository page and link to that in repositories list

[gitblit]

Originally reported on Google Code with ID 31

For sure this is not a bug but more a request to enhance the documentation.

I have posted the same question on stackoverflow already - but had not any answer yet.
(http://stackoverflow.com/questions/8427845/how-to-use-gitblit) 
=======================
Gitblit (http://gitblit.com/) looks pretty interessting to run a GIT server, so I installed
it (which is realy easy).

But now I'm having some problems to get my way around the tool. Its easy to create
repos, but after that, I'm stuck - after creation I was not able to "dive" into the
repo itself e.g. like on this screenshot: http://gitblit.com/screenshots/03.png

I also noticed that in my installation I have only the first three menu items on top
('repositories', 'users' and 'federation') - which seems logical, as they should appear
when "diving" into a repo e.g. 'branches', 'tags' and 'tree'.

I think it is not a security issue, as I disabled security and I also was able to greate
a repo. I'm just missing a link or a button to select a reo and see all the infos about
it. There is only a 'edit' link, but that brings me back to the same screen as when
creating a repo.
====================
The thing is, that you provide many screenshots on things one can (or should be able)
to do/see in gitblit. But you have no guide on how to walk through the UI or how to
get the first repo showing anything.

I installed gitblit on three different environment so far (windows, Solaris and Mac)
and had the same issue on all of these.
I just can't see more then the listing of any repos. Could not find a way to select
and dive into a repo.

I also tried with 3 different browsers with no luck (IE, FF, Safari).

Reported by dominik.bartholdi on 2011-12-08 19:20:26

[gitblit]

Gitblit is a Git server and repository viewer.  Newly created repositories are empty.
 They have no commits.  Because they have no commits (i.e. no content) it does not
make much sense to attempt to view nothing.

You must first push content into your newly created repository.  To do that you'll
need a Git client like:

1. standard command-line Git
2. Eclipse/EGit
3. SmartGit
4. One of the many Mac clients
etc.

I think once you have some commits in your repository then things will be more clear.

Reported by James.Moger on 2011-12-08 19:46:50

• Status changed: Done

[gitblit]

If you are new to Git you may want to review one of the many Git primers available.

A quick Google search picked-up this one:
http://danielmiessler.com/study/git

You can use Gitblit locally as a repo viewer or it can be used as a remote repository
server as sort-of described here:
http://danielmiessler.com/study/git/#remote_repositories

Reported by James.Moger on 2011-12-08 19:54:41

[gitblit]

...I do know git, but I'm just not able to push anything...

$> git push origin master
fatal: http://localhost:8888/test.git/info/refs not found: did you run git update-server-info
on the server?

Reported by dominik.bartholdi on 2011-12-08 21:27:35

[gitblit]

Ok.  I can clear that up.  This is a related issue reported in the Google group and
I'm going to hijack your issue for this purpose.

(The clone urls are only displayed on the summary page, but the summary page is unaccessible
for an empty repository.)

Perhaps in the future I will look into serving the git repositories on the root url,
but for now they are served on /git so the answer to push problem is:

e.g. http://localhost:8888/git/test.git

I'll create a new empty repository page and display clone urls and some sort of information
on how to proceed with populating your repository.  It won't be a Git tutorial, but
at least it will explain what is going on.

Reported by James.Moger on 2011-12-08 22:03:16

• Status changed: Accepted
• Labels added: Milestone-0.8.0

[gitblit]

perfect - that now works. 
thanks for the help! I think exactly such a page would help :)

Reported by dominik.bartholdi on 2011-12-09 04:43:55

[gitblit]

I have implemented an empty repository page and deployed the current snapshot to my
demo instance on RedHat's OpenShift cloud:

http://demo-gitblit.rhcloud.com

Click on the empty.git repository.

Would that page have helped you?

Reported by James.Moger on 2011-12-09 14:22:18

[gitblit]

sorry, I can't access the demo...

Reported by dominik.bartholdi on 2011-12-10 06:02:44

[gitblit]

Grrr...  I have to make time to understand what about OpenShift is disrupting Gitblit.
I've attached a screenshot of the empty page.

Reported by James.Moger on 2011-12-10 17:12:34

---

- _Attachment: emptytest.png
_

[gitblit]

What is the url of your gitblit instance?

Reported by James.Moger on 2012-01-05 16:23:45

[gitblit]

that page is perfect!
would be great to hav it in the next release.

Reported by dominik.bartholdi on 2012-01-06 11:14:17