aboutsummaryrefslogtreecommitdiff
path: root/cgitrc
blob: c277991b14d237b34129213347c1497b12d318a1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
virtual-root=/

#######################################################################
# General HTML customization
#######################################################################

# My logo, favicon and css served with every page. The favicon can be
# in either .png or .ico format. For the CSS I started by copying the
# default cgit.css and made some changes from there.
# The path is relative to cgit's folder.
logo=/custom/cgit.png
favicon=/custom/favicon.png
css=/custom/cgit.css

# Custom pieces of HTML added to every page, at the top and and the
# bottom respectively. My header currently contains only one <meta> tag
# for better view on small screens. The footer is a custom signature
# with link to my main website.
# Note that we need to specify the full path, because this file is read
# by cgit, not served directly by the web server (lighttpd).
head-include=/usr/share/webapps/cgit/custom/head.html
footer=/usr/share/webapps/cgit/custom/footer.html

#######################################################################
# Main page customization
#######################################################################

# Title and description
root-title=Sebastiano's repositories
root-desc=

# Contents of the about page for the main page. Full path needed.
root-readme=/usr/share/webapps/cgit/custom/README.html

# Bare git repositories are, by convention, in folders that end in
# .git. This option removes the suffix from the repository name in the
# main page.
remove-suffix=1

# Do not show repository owner name (it is always me).
enable-index-owner=0

# Disable extra "links" column in the repository list. This is the
# default, but I want to be explicit.
enable-index-links=0

# Show all repositories in one page.
max-repo-count=0

# Sort repository list by name. This is the default setting, but I want
# to be explicit.
repository-sort="name"

#######################################################################
# About (README) page configuration
#######################################################################

# Path to our custom "about filter". It uses lowdown for Markdown files
# and the default txt2html filter shipped with cgit (inlined into the
# custom script) for plain text files.
about-filter=/usr/share/webapps/cgit/custom/about-filter.sh

# Possible README files. I never use anything other than one of these
# three. If necessary, the file name can be prefixed by the branch
# name, e.g. main:README.md.
readme=:README.md
readme=:README.txt
readme=:README

#######################################################################
# Repository page configuration
#######################################################################

# Sort branches by age instead of name.
branch-sort="age"

# Sort files in the repository case-sensitively. This is the default
# setting, but I want to make it explicit.
case-sensitive-sort=1

# Show correct URL for cloning the repository.
clone-prefix=https://git.tronto.net

# Generate graphical overview of deleted / added lines for each commit.
enable-commit-graph=1

# Turn file names into links in the log view.
enable-follow-links=1

# Show number of files and number of lines modified in each commit log.
enable-log-filecount=1
enable-log-linecount=1

# Show diffs side by side instead of "unidiffs".
side-by-side-diffs=1

# Generate download links for tar.gz and zip archives of each tag.
# I would like them for the current state of the repo (master branch)
# too, but it does not seem to be possible with cgit.
snapshots=tar.gz zip

#######################################################################
# Cache settings
#######################################################################

# Global cache size setting. By default, cache is disabled.
cache-size=1000

#######################################################################
# Scan path
#######################################################################

# The folder that contains all my git repositories. Since some other
# settings must be placed before this one in order to be picked up
# correctly, we put it at the bottom of this file.
scan-path=/home/git

Generated with cgit - Back to sebastiano.tronto.net