aboutsummaryrefslogtreecommitdiff
path: root/cgitrc
diff options
context:
space:
mode:
authorSebastiano Tronto <sebastiano@tronto.net>2026-08-31 17:10:07 +0200
committerSebastiano Tronto <sebastiano@tronto.net>2026-08-31 17:10:07 +0200
commit66b54db812b01f5b944b0e5694a1473bdbcbaf32 (patch)
tree177d8c6120c8df5e5a63162417258e1522951c11 /cgitrc
downloadcgit-config-master.tar.gz
cgit-config-master.zip
Initial commitHEADmaster
Diffstat (limited to '')
-rw-r--r--cgitrc116
1 files changed, 116 insertions, 0 deletions
diff --git a/cgitrc b/cgitrc
new file mode 100644
index 0000000..c277991
--- /dev/null
+++ b/cgitrc
@@ -0,0 +1,116 @@
1virtual-root=/
2
3#######################################################################
4# General HTML customization
5#######################################################################
6
7# My logo, favicon and css served with every page. The favicon can be
8# in either .png or .ico format. For the CSS I started by copying the
9# default cgit.css and made some changes from there.
10# The path is relative to cgit's folder.
11logo=/custom/cgit.png
12favicon=/custom/favicon.png
13css=/custom/cgit.css
14
15# Custom pieces of HTML added to every page, at the top and and the
16# bottom respectively. My header currently contains only one <meta> tag
17# for better view on small screens. The footer is a custom signature
18# with link to my main website.
19# Note that we need to specify the full path, because this file is read
20# by cgit, not served directly by the web server (lighttpd).
21head-include=/usr/share/webapps/cgit/custom/head.html
22footer=/usr/share/webapps/cgit/custom/footer.html
23
24#######################################################################
25# Main page customization
26#######################################################################
27
28# Title and description
29root-title=Sebastiano's repositories
30root-desc=
31
32# Contents of the about page for the main page. Full path needed.
33root-readme=/usr/share/webapps/cgit/custom/README.html
34
35# Bare git repositories are, by convention, in folders that end in
36# .git. This option removes the suffix from the repository name in the
37# main page.
38remove-suffix=1
39
40# Do not show repository owner name (it is always me).
41enable-index-owner=0
42
43# Disable extra "links" column in the repository list. This is the
44# default, but I want to be explicit.
45enable-index-links=0
46
47# Show all repositories in one page.
48max-repo-count=0
49
50# Sort repository list by name. This is the default setting, but I want
51# to be explicit.
52repository-sort="name"
53
54#######################################################################
55# About (README) page configuration
56#######################################################################
57
58# Path to our custom "about filter". It uses lowdown for Markdown files
59# and the default txt2html filter shipped with cgit (inlined into the
60# custom script) for plain text files.
61about-filter=/usr/share/webapps/cgit/custom/about-filter.sh
62
63# Possible README files. I never use anything other than one of these
64# three. If necessary, the file name can be prefixed by the branch
65# name, e.g. main:README.md.
66readme=:README.md
67readme=:README.txt
68readme=:README
69
70#######################################################################
71# Repository page configuration
72#######################################################################
73
74# Sort branches by age instead of name.
75branch-sort="age"
76
77# Sort files in the repository case-sensitively. This is the default
78# setting, but I want to make it explicit.
79case-sensitive-sort=1
80
81# Show correct URL for cloning the repository.
82clone-prefix=https://git.tronto.net
83
84# Generate graphical overview of deleted / added lines for each commit.
85enable-commit-graph=1
86
87# Turn file names into links in the log view.
88enable-follow-links=1
89
90# Show number of files and number of lines modified in each commit log.
91enable-log-filecount=1
92enable-log-linecount=1
93
94# Show diffs side by side instead of "unidiffs".
95side-by-side-diffs=1
96
97# Generate download links for tar.gz and zip archives of each tag.
98# I would like them for the current state of the repo (master branch)
99# too, but it does not seem to be possible with cgit.
100snapshots=tar.gz zip
101
102#######################################################################
103# Cache settings
104#######################################################################
105
106# Global cache size setting. By default, cache is disabled.
107cache-size=1000
108
109#######################################################################
110# Scan path
111#######################################################################
112
113# The folder that contains all my git repositories. Since some other
114# settings must be placed before this one in order to be picked up
115# correctly, we put it at the bottom of this file.
116scan-path=/home/git

Generated with cgit - Back to sebastiano.tronto.net