GitBlit as a Wiki

[Gian Marco Gherardi]

Hi all,

GitBlit can render plain text files containing Markdown as HTML and GIT mange file versioning.

Anyone used GitBlit as an internal wiki?

Does it lack something?

[James Moger]

Right now the markdown pages do not generate proper intra-document links so it wouldn't be a great tool - today - as a wiki.

Gitblit could be extended to support that, or perhaps ${reponame}-wiki.git, which I think GoogleCode uses.  Not sure about Github... that might use -wiki.git repos too.

Alternatively, you can serve static html documentation on an orphan branch refs/heads/gh-pages.  If this ref is present, it will display the "pages" link which will serve content directly from the ref like this:

e.g. https://demo-gitblit.rhcloud.com/pages/gitblit.git/

​

-J

[Gian Marco Gherardi]

I took a look at gh-pages branch, GitBlit also "guess" and sets the correct Content-Type for the file it is serving so files like images are correctly interpreted by the browser.

This can be a viable solution in conjunction with a static site generator like jekill.

Gian Marco Gherardi
http://gianmarco.gherardi.me

--
You received this message because you are subscribed to a topic in the Google Groups "gitblit" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/gitblit/G691QXMnEaQ/unsubscribe.
To unsubscribe from this group and all its topics, send an email to gitblit+u...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
 
 

[Gian Marco Gherardi]

On Sat, Jun 22, 2013 at 10:30 AM, Gian Marco Gherardi <gianmarco...@gmail.com> wrote:

GitBlit also "guess" and sets the correct Content-Type for the file it is serving

Maybe this is not really done by GitBlit, but is the servlet container that does this..

[James Moger]

Gitblit asks the servlet container for help on content types:

https://demo-gitblit.rhcloud.com/blob/gitblit.git/03232453be7624bc2fc8a942e8c280353606fe8b/src!main!java!com!gitblit!PagesServlet.java#L175

​Jekyll.  That is one way GitHub recommends to use the gh-pages (=github pages) branch.  GitHub does a checkout of this branch, runs  it through Jekyll, and serves the generated output.  Gitblit just serves the content directly from this branch without checkout and without transformation.

-J