A (static) git repository browser [mirror]
Go to file
Alberto Bertogli d7f0e4a265 views: Change the "repository" line into "git clone"
We display the location of the repository, but the entire row is not
convenient for copy-pasting.

This patch changes the wording to "git clone" so the entire row can be
copied and pasted into a terminal.

There's a trick, because if we just changed the wording to:

  <td>git clone</td> <td>https://example.com/repo</td>

that would get copied as:

  git clone\thttps://example.com/repo

which does not work well when pasted into a terminal (as the \t gets
"eaten" in most cases).

So this patch changes the HTML to have a space after "clone":

  <td>git clone </td> <td>https://example.com/repo</td>

and the CSS to preserve the space, so the following gets copied:

  git clone \thttps://example.com/repo

which works when pasting on a terminal.
2017-08-27 16:16:56 +01:00
hooks Add a post-receive hook 2013-03-12 22:09:25 +00:00
static views: Change the "repository" line into "git clone" 2017-08-27 16:16:56 +01:00
views views: Change the "repository" line into "git clone" 2017-08-27 16:16:56 +01:00
.gitignore Initial commit 2012-11-10 17:49:54 +00:00
git-arr Add a "prefix" configuration option 2017-07-30 20:33:37 +01:00
git.py Repo: retire new_in_branch() and notion of "bound" branch 2015-01-17 13:11:46 +00:00
LICENSE Initial commit 2012-11-10 17:49:54 +00:00
README Add a note about pygments in the README 2012-11-21 00:29:43 +00:00
sample.conf git-arr: Implement an "ignore" option 2015-11-07 12:04:09 +00:00
TODO Initial commit 2012-11-10 17:49:54 +00:00
utils.py markdown: Enable table and fenced code extensions 2016-11-03 01:45:46 +00:00

git-arr - A git repository browser
----------------------------------

git-arr is a git repository browser that can generate static HTML instead of
having to run dynamically.

It is smaller, with less features and a different set of tradeoffs than
other similar software, so if you're looking for a robust and featureful git
browser, please look at gitweb or cgit instead.

However, if you want to generate static HTML at the expense of features, then
it's probably going to be useful.

It's open source under the MIT licence, please see the LICENSE file for more
information.


Getting started
---------------

You will need Python, and the bottle.py framework (the package is usually
called python-bottle in most distributions).

If pygments is available, it will be used for syntax highlighting, otherwise
everything will work fine, just in black and white.


First, create a configuration file for your repositories. You can start by
copying sample.conf, which has the list of the available options.

Then, to generate the output to "/var/www/git-arr/" directory, run:

  $ ./git-arr --config config.conf generate --output /var/www/git-arr/

That's it!

The first time you generate, depending on the size of your repositories, it
can take some time. Subsequent runs should take less time, as it is smart
enough to only generate what has changed.


You can also use git-arr dynamically, although it's not its intended mode of
use, by running:

  $ ./git-arr --config config.conf serve

That can be useful when making changes to the software itself.


Contact
-------

If you want to report bugs, send patches, or have any questions or comments,
just let me know at albertito@blitiri.com.ar.