cgitext.git/cgitrc.5.txt, branch master

theming: include solarized.css theme addon

2026-08-01T10:50:26Z

The solarized.css includes adoption of Solarized Light/Dark themes for cgit, switching between light and dark variant depending on preferred color scheme. It is not used by default, but can be easily switched on with css directive.

logo: include svg variant for both favicon and logo

2026-08-01T06:15:38Z

The reasoning behind using svg as primary defaults is simple – at close-up it is much neater, plus svg favicon is supported since 2015 in Firefox, 2020 in Chromium, 2025 in Safari. For old browsers ico is still kept as a fallback. The svg was auto-generated using a Python script and then simplified to a path, but kept close to an original.

licensing: add author preambles where changes were done

2026-07-31T04:38:28Z

Add a copyright for changes done by me, also note in README the nature of this repo

ui-ci: let a ci-filter decide whether the tab is shown

2026-07-30T05:27:31Z

cgit cannot know whether the ref being viewed actually has a pipeline, so the "ci" tab is offered for every ref and only reveals a missing one once followed. Probing the ci system from cgit is not an option: the tab is part of the page header, so it would mean a blocking request for every page of every repository, cgit links no http client, and job pages are usually not readable anonymously. Add a ci filter instead, which receives the ref, whether it is a branch or a tag, and the expanded url, and answers with its exit status. This keeps credentials, timeouts and caching in a script, where they belong; filters/ci-jenkins.sh demonstrates all three against Jenkins' REST API. The verdict is memoized, so the filter runs once per request rather than once for the tab and again for the redirect, and it governs the page as well as the tab, so a hidden tab cannot be reached by typing the url. Signed-off-by: Saya Andy

ui-ci: add a "ci" tab which redirects to an external ci system

2026-07-30T05:26:52Z

Add a "ci" page which redirects to an external ci system for the ref being viewed, along with a tab for it in the repository header. The target is a url template, configurable globally or per repository, with separate settings for branches and tags because pipelines for the two commonly live at different locations: on a Jenkins multibranch pipeline a branch is at job//job/ while a tag is at job//view/tags/job/. $ref, $repo and $slug are substituted, $slug being the repository url with any ".git" suffix removed and slashes replaced by dashes, which is the shape job names usually take. An explicit repo.ci-url drops the branch and tag urls the repository would otherwise inherit from the global settings, as it could never take effect otherwise. The expansion is written to the Location header verbatim rather than through cgit_redirect(), which percent-encodes '?', '=' and '%' and would corrupt any url carrying a query string. An expansion containing CR or LF is refused so that it cannot smuggle in further headers. Signed-off-by: Saya Andy

ui-log: allow link following to be disabled per-repo

2026-02-24T10:49:35Z

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

config: add js

2022-12-19T15:50:21Z

Just like the config allows setting css URL path, add a config for setting the js URL path Signed-off-by: Andy Green Reviewed-by: John Keeping Signed-off-by: Christian Hesse

css: change to be a list

2022-12-19T15:49:09Z

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 Signed-off-by: Christian Hesse

cgitrc: handle value "0" for max-repo-count

2022-12-19T15:22:26Z

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

about: allow to give head from query

2022-12-19T15:13:58Z

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