Website Summary Files Commits Branches @commit @diff @stats
path: root / cgitrc.5.txt
Commit message (Collapse)AuthorAgeLinesSHA
* ui-log: allow link following to be disabled per-repo
 Jason A. Donenfeld		2026-02-24-0/+40d28d54
| | | | | | | This exists for other CPU heavy operations like blame, but doesn't for the follow functionality. Add it for that. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* config: add js
 Andy Green		2022-12-19-0/+5aee39b4
| | | | | | | | | Just like the config allows setting css URL path, add a config for setting the js URL path Signed-off-by: Andy Green <andy@warmcat.com> Reviewed-by: John Keeping <john@keeping.me.uk> Signed-off-by: Christian Hesse <mail@eworm.de>
* css: change to be a list
 Andy Green		2022-12-19-1/+2093ac96
| | | | | | | | | | | Without changing the default behaviour of including /cgit.css if nothing declared, allow the "css" config to be given multiple times listing one or more alternative URL paths to be included in the document head area. Signed-off-by: Andy Green <andy@warmcat.com> Signed-off-by: Christian Hesse <mail@eworm.de>
* cgitrc: handle value "0" for max-repo-count
 Christian Hesse		2022-12-19-1/+291f2590
| | | | | | | Setting max-repo-count to "0" makes cgit loop forever generating page links. Make this a special value to show all repositories. Signed-off-by: Christian Hesse <mail@eworm.de>
* about: allow to give head from query
 Christian Hesse		2022-12-19-5/+5a0f6669
| | | | | | | | Reading the README from repository used to be limited to default branch or a branch given in configuration. Let's allow a branch from query if not specified explicitly. Signed-off-by: Christian Hesse <mail@eworm.de>
* ui-snapshot: add support for zstd compression
 Christian Hesse		2020-03-12-3/+6892ba8c
| | | | | | | | | | This patch adds support for zstd [0] compressed snapshots (*.tar.zst). We enable multiple working threads (-T0), but keep default compression level. The latter can be influenced by environment variable. [0] https://www.zstd.net/ Signed-off-by: Christian Hesse <mail@eworm.de>
* ui-snapshot: add support for lzip compression
 Hanspeter Portner		2020-02-26-2/+206671f4
| | | | | | | | | This patch adds support for lzip [1] compressed snapshots (*.tar.lz) [1] https://www.nongnu.org/lzip/ Signed-off-by: Hanspeter Portner <dev@open-music-kontrollers.ch> Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* ui-tree: allow per repository override for enable-blame
 Christian Hesse		2019-06-25-0/+4e1ad15d
| | | | | | | The blame operation can cause high cost in terms of CPU load for huge repositories. Let's add a per repository override for enable-blame. Signed-off-by: Christian Hesse <mail@eworm.de>
* cgitrc.5: add local tar signature example
 Jason A. Donenfeld		2018-07-05-3/+1422583c4
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* cgitrc.5: document new signature notes
 Jason A. Donenfeld		2018-07-03-1/+17c4167cb
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* extra-head-content: introduce another option for meta tags
 Jason A. Donenfeld		2018-07-03-0/+4b522a30
| | | | | | | This is to support things like go-import meta tags, which are on a per-repo basis. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* manpage: fix sorting order
 Andy Green		2018-06-27-88/+889086260
| | | | | | | | You maybe didn't know you had OCD until you saw an alpha sorted list that has stuff out of order in it. Signed-off-by: Andy Green <andy@warmcat.com> Reviewed-by: John Keeping <john@keeping.me.uk>
* global: remove functionality we deprecated for cgit v1.0
 Christian Hesse		2018-06-27-21/+054d37dc
| | | | | | | | The man page states these were deprecated for v1.0. We are past v1.1, so remove the functionality. Signed-off-by: Christian Hesse <mail@eworm.de> Reviewed-by: John Keeping <john@keeping.me.uk>
* snapshot: support special value 'all' to enable all formats
 Christian Hesse		2018-06-27-0/+130a378b
| | | | | Signed-off-by: Christian Hesse <mail@eworm.de> Reviewed-by: John Keeping <john@keeping.me.uk>
* Add "snapshot-prefix" repo configuration
 John Keeping		2018-06-27-0/+7c1572bb
| | | | | | | | | | | | Allow using a user-specified value for the prefix in snapshot files instead of the repository basename. For example, files downloaded from the linux-stable.git repository should be named linux-$VERSION and not linux-stable-$VERSION, which can be achieved by setting: repo.snapshot-prefix=linux Signed-off-by: John Keeping <john@keeping.me.uk> Reviewed-by: Christian Hesse <mail@eworm.de>
* ui-blame: add blame UI
 Jeff Smith		2017-10-03-0/+9c1cd290
| | | | | | | | | | Implement a page which provides the blame view of a specified file. This feature is controlled by a new config variable, "enable-blame", which is disabled by default. Signed-off-by: Jeff Smith <whydoubt@gmail.com> Reviewed-by: John Keeping <john@keeping.me.uk>
* Fix spelling in man page
 Peter Colberg		2016-07-06-2/+2ccf79b3
| | | | Signed-off-by: Peter Colberg <peter@colberg.org>
* Renamed repo-specific configuration for enable-html-serving in cgitrc.5.txt
 Matt Comben		2016-03-08-1/+139735d9
|
* ui-shared: add homepage to tabs
 Jason A. Donenfeld		2016-02-22-5/+85f2664f
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* ui-plain: add enable-html-serving flag
 Jason A. Donenfeld		2016-01-14-0/+11c326f3e
| | | | Unrestricts plain/ to contents likely to be executed by browser.
* log: allow users to follow a file
 John Keeping		2015-08-12-0/+430304d8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach the "log" UI to behave in the same way as "git log --follow", when given a suitable instruction by the user. The default behaviour remains to show the log without following renames, but the follow behaviour can be activated by following a link in the page header. Follow is not the default because outputting merges in follow mode is tricky ("git log --follow" will not show merges). We also disable the graph in follow mode because the commit graph is not simplified so we end up with frequent gaps in the graph and many lines that do not connect with any commits we're actually showing. We also teach the "diff" and "commit" UIs to respect the follow flag on URLs, causing the single-file version of these UIs to detect renames. This feature is needed only for commits that rename the path we're interested in. For commits before the file has been renamed (i.e. that appear later in the log list) we change the file path in the links from the log to point to the old name; this means that links to commits always limit by the path known to that commit. If we didn't do this we would need to walk down the log diff'ing every commit whenever we want to show a commit. The drawback is that the "Log" link in the top bar of such a page links to the log limited by the old name, so it will only show pre-rename commits. I consider this a reasonable trade-off since the "Back" button still works and the log matches the path displayed in the top bar. Since following renames requires running diff on every commit we consider, I've added a knob to the configuration file to globally enable/disable this feature. Note that we may consider a large number of commits the revision walking machinery no longer performs any path limitation so we have to examine every commit until we find a page full of commits that affect the target path or something related to it. Suggested-by: René Neumann <necoro@necoro.eu> Signed-off-by: John Keeping <john@keeping.me.uk>
* Add repo.hide and repo.ignore
 Lukas Fleischer		2015-01-29-0/+10c58cec9
| | | | | | | | These options can be used to hide a repository from the index or completely ignore a repository, respectively. They are particularly useful when used in combination with scan-path. Signed-off-by: Lukas Fleischer <cgit@cryptocrack.de>
* repolist: add owner-filter
 Chris Burroughs		2014-12-23-0/+1896ceb9a
| | | | | | This allows custom links to be used for repository owners by configuring a filter to be applied in the "Owner" column in the repository list.
* cgitrc.5: we mean a cgi response, not request
 Jason A. Donenfeld		2014-08-01-1/+1efa2879
|
* remove trailing whitespaces from source files
 Christian Hesse		2014-04-17-1/+1b431282
|
* Clean up cache documentation.
 Jason A. Donenfeld		2014-02-21-22/+252e8e9af
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* Skip cache slot when time-to-live is zero
 Lukas Fleischer		2014-02-21-8/+146ceba45
| | | | | | | | | | If time-to-live is set to zero, we don't need to regenerate the cache slots on every request. Instead, just skip the caching process and immediately provide the dynamically generated version of the page. Setting time-to-live to zero is useful when you want to disable caching for certain pages. Signed-off-by: Lukas Fleischer <cgit@cryptocrack.de>
* Add a cache-snapshot-ttl configuration variable
 Lukas Fleischer		2014-02-20-0/+5a3722ec
| | | | | | | | | | | | | This can be used to specify the TTL for snapshots. Snapshots are usually static and do not ever change. On the other hand, tarball generation is CPU intensive. One use case of this setting (apart from increasing the lifetime of snapshot cache slots) is caching of snapshots while disabling the cache for static/dynamic HTML pages (by setting TTL to zero for everything except for snapshot requests). Signed-off-by: Lukas Fleischer <cgit@cryptocrack.de>
* auth: have cgit calculate login address
 Jason A. Donenfeld		2014-01-16-2/+3a431326
| | | | | | | This way we're sure to use virtual root, or any other strangeness encountered. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* authentication: use hidden form instead of referer
 Jason A. Donenfeld		2014-01-16-1/+2b826537
| | | | | | | This also gives us some CSRF protection. Note that we make use of the hmac to protect the redirect value. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* auth: add basic authentication filter framework
 Jason A. Donenfeld		2014-01-16-1/+35d6e9200
| | | | | | | | | | | | | | | | This leverages the new lua support. See filters/simple-authentication.lua for explaination of how this works. There is also additional documentation in cgitrc.5.txt. Though this is a cookie-based approach, cgit's caching mechanism is preserved for authenticated pages. Very plugable and extendable depending on user needs. The sample script uses an HMAC-SHA1 based cookie to store the currently logged in user, with an expiration date. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* filter: allow returning exit code from filter
 Jason A. Donenfeld		2014-01-14-1/+26ca734d
| | | | | | | Filters can now indicate a status back to cgit by means of the exit code for exec, or the return value from close for Lua. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* cgitrc.5.txt: Fix documentation of the snapshot mask
 Lukas Fleischer		2014-01-14-6/+770546a3
| | | | | | | | Mention that the snapshot setting only specifies the formats that links are generated for and not the set of formats that are accessible via HTTP. Signed-off-by: Lukas Fleischer <cgit@cryptocrack.de>
* filter: add page source to email filter
 Jason A. Donenfeld		2014-01-14-7/+8786609b
| | | | | | | | Since the email filter is called from lots of places, the script might benefit from knowing the origin. That way it can modify its contents and/or size depending. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* filter: add support for email filter
 Jason A. Donenfeld		2014-01-14-0/+18a5e1553
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* filter: add lua support
 Jason A. Donenfeld		2014-01-14-0/+29f43b228
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* filter: introduce "filter type" prefix
 John Keeping		2014-01-14-0/+94bb87cb
| | | | | | | | This allows different filter implementations to be specified in the configuration file. Currently only "exec" is supported, but it may now be specified either with or without the "exec:" prefix. Signed-off-by: John Keeping <john@keeping.me.uk>
* Add a suggestion to the manpage
 Přemysl Janouch		2014-01-08-2/+34f6fb32
| | | | | | | So that people wishing to use "enable-http-clone" don't have to find out the correct settings on their own. Signed-off-by: Přemysl Janouch <p.janouch@gmail.com>
* Fix the example configuration
 Přemysl Janouch		2014-01-08-1/+117e6a2a
| | | | | | "enable-git-clone" doesn't exist, replaced with "enable-http-clone". Signed-off-by: Přemysl Janouch <p.janouch@gmail.com>
* Fix some spelling errors
 Přemysl Janouch		2014-01-08-5/+588028ad
| | | | Signed-off-by: Přemysl Janouch <p.janouch@gmail.com>
* Fix silly spelling error.
 Jason A. Donenfeld		2013-08-16-1/+1cf15260
|
* add a note about generating agefile in hook
 Christian Hesse		2013-08-12-1/+2820df9c
|
* cache: document negative ttls and add about ttl
 Jason A. Donenfeld		2013-08-12-10/+1861ff100
| | | | | | | | | | | | | | We've long supported negative ttls, for infinite cache, except the documentation incorrectly showed one of our defaults as being 5 and not -1. As well, with a negative ttl, we were actually making the HTTP expired header go backwards. This changes it to go ahead ten years instead. Further, we add an cache-about-ttl option to set a different ttl for about pages, which are now increasingly being filtered through markdown or just sent statically anyway. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* use favicon by default
 Christian Hesse		2013-08-12-3/+3830eb6f
|
* cgitrc.5: improve example config
 Jason A. Donenfeld		2013-05-27-0/+53d6d3dbc
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* readme: use string_list instead of space deliminations
 Jason A. Donenfeld		2013-05-26-2/+3dcbc043
| | | | | | | | | | | | | | | | | | | | | | | | | | Now this is possible in cgitrc - readme=:README.md readme=:readme.md readme=:README.mkd readme=:readme.mkd readme=:README.rst readme=:readme.rst readme=:README.html readme=:readme.html readme=:README.htm readme=:readme.htm readme=:README.txt readme=:readme.txt readme=:README readme=:readme readme=:INSTALL.txt readme=:install.txt readme=:INSTALL readme=:install Suggested-by: John Keeping <john@keeping.me.uk> Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* cgitrc.5: information on directory traversal and multiple readme files
 Jason A. Donenfeld		2013-05-25-6/+112a1ead3
| | | | Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* ui-summary: Pass filename to about-filter
 Jason A. Donenfeld		2013-05-25-3/+5c0dfaf1
| | | | | | | | | | This gives the about-filter API the same semantics as source-filter, where the filter receives the filename so it can decide what to do next with it. While we're at it, plug a memory leak. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* ui-summary: Use default branch for readme if : prefix
 Jason A. Donenfeld		2013-05-25-1/+33cb5d86
| | | | | | | If the readme value begins with ":", and has no specified branch before it, use the repository's default branch. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
* cgitrc.5.txt: Specify when scan-path must be defined before.
 Jason A. Donenfeld		2013-04-10-9/+11a8d613e
| | | | | | | | Several options must be specified prior to scan-path. This is consistant source of user confusion. Document these facts. Suggested-by: Lukas Fleischer <cgit@cryptocrack.de> Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
generated by cgit v1.3.1-23-gd82d (git 2.54.0) at 2026-11-07 17:23:55 +0000