0c86e2ac3f
26ac84466 Bump version to 1.4.1 cc167887f Fix bad free in cgit_diff_tree 4a30da89c Bump version to 1.4.0 695515801 Tolerate short writes in print_slot 069d15447 git: update to v2.36.1 3374b0e7a git: update to v2.36.0 400fd7abb Use release_commit_memory() 93ce8fe3b Reset font size for blame oid 28c0cb6f7 Add a link to the parent commit in blame c5809a429 Fix fmt() off-by-one error 129d8a158 Allow to give readme head from query 44a004809 Bump version to 1.3.0 76d9396e4 Update information for fork d993e4be6 Remove Lua support e4ce4fa74 Merge remote-tracking branch 'ch/git-2-35' 065ee253a Silence owner-info error f92ba7ea8 Remove default favicon 03519c7bc Show about path in page title 20f0352d9 Generate valid Atom feeds 516175469 Merge up to git v2.32.0 12d91b897 Fix crash trying to print "this commit" on 404s 957855ffd Use owner-filter for repo page headers f9c417f24 Fix tests for diff spans be6a526a7 Use <pre> and <span> to print diffs a8e11db65 Use buffered stdio b2511f295 Remove redundant title on repo anchors 2d4c893db Improve button spacing for browsers w/o CSS 1e9f26ffb Improve decoration display for browsers without CSS 2843093cb Use <pre> for commit-msg 122f7a9be Improve pageheader display on text-based browsers 298f7d15f Use git raw note format 6524fe671 Add "this commit" option to switch form 8f9034884 Show subject in commit page title 41a17adaf Show symlink targets in tree listing 437d0b416 Disallow blame in robots.txt e75fa957e Don't link to blame for binary blobs 8bf017ec5 Bail from blame if blob is binary fa86ef6a3 Remove dependency on memrchr bbbaa29a9 git: update to v2.35.1 73e98c16e git: update to v2.35.0 11be5b818 git: update to v2.34.1 b8f2b675d git: update to v2.34.0 45eff4065 git: update to v2.33.0 5258c297b git: update to v2.32.0 6dbbffe01 git: update to v2.31.1 62eb8db45 md2html: use proper formatting for hr d889cae81 git: update to v2.31.0 4ffadc1e0 git: update to v2.30.1 bd6f5683f tests: t0107: support older and/or non-GNU tar f69626c68 md2html: use sane_lists extension cef27b670 git: update to v2.30.0 b1739247b git: update to v2.29.2 fe99c76ee git: update to v2.29.1 adcc4f822 tests: try with commit-graph a1039ab17 tests: do not copy snapshots to /tmp/ a4de0e810 global: replace hard coded hash length 779631c6d global: replace references to 'sha1' with 'oid' 629659d2c git: update to v2.29.0 205837d46 git: update to v2.28.0 f780396c0 git: update to v2.27.0 0462f08d8 git: update to v2.26.0 55fa25adb Bump version 6a8d6d4b5 global: use proper accessors for maybe_tree 892ba8c3c ui-snapshot: add support for zstd compression cc230bf04 tests: add tests for xz compressed snapshots 06671f4b2 ui-snapshot: add support for lzip compression fde897b81 git: update to v2.25.1 5e49023b0 tests: allow to skip git version tests fa146ccab Bump version bd68c9887 git: update to v2.25.0 ca98c9e7b tests: skip tests if strace is not functional d8e5dd25a git: update to v2.24.1 583aa5d80 ui-repolist: do not return unsigned (negative) value bfabd4519 git: update to v2.24.0 git-subtree-dir: third_party/cgit git-subtree-split: 26ac844661e95ee1ff3ddf4f8691de9904dad783
88 lines
2.6 KiB
Text
88 lines
2.6 KiB
Text
cgit-pink - CGI for Git
|
|
=======================
|
|
|
|
This is a fork of cgit, an attempt to create a fast web interface
|
|
for the Git SCM, using a built-in cache to decrease server I/O
|
|
pressure.
|
|
|
|
Installation
|
|
------------
|
|
|
|
Building cgit involves building a proper version of Git. How to do this
|
|
depends on how you obtained the cgit sources:
|
|
|
|
a) If you're working in a cloned cgit repository, you first need to
|
|
initialize and update the Git submodule:
|
|
|
|
$ git submodule init # register the Git submodule in .git/config
|
|
$ $EDITOR .git/config # if you want to specify a different url for git
|
|
$ git submodule update # clone/fetch and checkout correct git version
|
|
|
|
b) If you're building from a cgit tarball, you can download a proper git
|
|
version like this:
|
|
|
|
$ make get-git
|
|
|
|
When either a) or b) has been performed, you can build and install cgit like
|
|
this:
|
|
|
|
$ make
|
|
$ sudo make install
|
|
|
|
This will install `cgit.cgi` and `cgit.css` into `/var/www/htdocs/cgit`. You
|
|
can configure this location (and a few other things) by providing a `cgit.conf`
|
|
file (see the Makefile for details).
|
|
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
* libzip
|
|
* libcrypto (OpenSSL)
|
|
* libssl (OpenSSL)
|
|
|
|
Apache configuration
|
|
--------------------
|
|
|
|
A new `Directory` section must probably be added for cgit, possibly something
|
|
like this:
|
|
|
|
<Directory "/var/www/htdocs/cgit/">
|
|
AllowOverride None
|
|
Options +ExecCGI
|
|
Order allow,deny
|
|
Allow from all
|
|
</Directory>
|
|
|
|
|
|
Runtime configuration
|
|
---------------------
|
|
|
|
The file `/etc/cgitrc` is read by cgit before handling a request. In addition
|
|
to runtime parameters, this file may also contain a list of repositories
|
|
displayed by cgit (see `cgitrc.5.txt` for further details).
|
|
|
|
The cache
|
|
---------
|
|
|
|
When cgit is invoked it looks for a cache file matching the request and
|
|
returns it to the client. If no such cache file exists (or if it has expired),
|
|
the content for the request is written into the proper cache file before the
|
|
file is returned.
|
|
|
|
If the cache file has expired but cgit is unable to obtain a lock for it, the
|
|
stale cache file is returned to the client. This is done to favour page
|
|
throughput over page freshness.
|
|
|
|
The generated content contains the complete response to the client, including
|
|
the HTTP headers `Modified` and `Expires`.
|
|
|
|
Online presence
|
|
---------------
|
|
|
|
* The cgit-pink homepage is hosted by cgit at
|
|
<https://git.causal.agency/cgit-pink/about>
|
|
|
|
* Patches, bug reports, discussions and support should go to the cgit-pink
|
|
mailing list: <list+cgit@causal.agency>. Archives are available at:
|
|
<https://causal.agency/list/cgit.html>
|