Skip to content

Commit cee694d

Browse files
jnarebgitster
jnareb
authored and
gitster
committed
gitweb: Move information about installation from README to INSTALL
Almost straightformard moving of "How to configure gitweb for your local system" section from gitweb/README to gitweb/INSTALL, as it is about build time configuration. Updated references to it. Signed-off-by: Jakub Narebski <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent a6605d7 commit cee694d

File tree

2 files changed

+113
-116
lines changed

2 files changed

+113
-116
lines changed

‎gitweb/INSTALL‎

Lines changed: 113 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,7 @@ scripts).
2828
Build time configuration
2929
------------------------
3030

31-
See also "How to configure gitweb for your local system" in README
32-
file for gitweb (in gitweb/README).
31+
See also "How to configure gitweb for your local system" section below.
3332

3433
- There are many configuration variables which affect building of
3534
gitweb.cgi; see "default configuration for gitweb" section in main
@@ -73,6 +72,118 @@ file for gitweb (in gitweb/README).
7372
substitute gitweb.min.js and gitweb.min.css for all uses of gitweb.js and
7473
gitweb.css in the help files.
7574

75+
76+
How to configure gitweb for your local system
77+
---------------------------------------------
78+
79+
You can specify the following configuration variables when building GIT:
80+
81+
* GIT_BINDIR
82+
Points where to find the git executable. You should set it up to
83+
the place where the git binary was installed (usually /usr/bin) if you
84+
don't install git from sources together with gitweb. [Default: $(bindir)]
85+
* GITWEB_SITENAME
86+
Shown in the title of all generated pages, defaults to the server name
87+
(SERVER_NAME CGI environment variable) if not set. [No default]
88+
* GITWEB_PROJECTROOT
89+
The root directory for all projects shown by gitweb. Must be set
90+
correctly for gitweb to find repositories to display. See also
91+
"Gitweb repositories" in the INSTALL file for gitweb. [Default: /pub/git]
92+
* GITWEB_PROJECT_MAXDEPTH
93+
The filesystem traversing limit for getting the project list; the number
94+
is taken as depth relative to the projectroot. It is used when
95+
GITWEB_LIST is a directory (or is not set; then project root is used).
96+
This is meant to speed up project listing on large work trees by limiting
97+
search depth. [Default: 2007]
98+
* GITWEB_LIST
99+
Points to a directory to scan for projects (defaults to project root
100+
if not set / if empty) or to a file with explicit listing of projects
101+
(together with projects' ownership). See "Generating projects list
102+
using gitweb" in INSTALL file for gitweb to find out how to generate
103+
such file from scan of a directory. [No default, which means use root
104+
directory for projects]
105+
* GITWEB_EXPORT_OK
106+
Show repository only if this file exists (in repository). Only
107+
effective if this variable evaluates to true. [No default / Not set]
108+
* GITWEB_STRICT_EXPORT
109+
Only allow viewing of repositories also shown on the overview page.
110+
This for example makes GITWEB_EXPORT_OK to decide if repository is
111+
available and not only if it is shown. If GITWEB_LIST points to
112+
file with list of project, only those repositories listed would be
113+
available for gitweb. [No default]
114+
* GITWEB_HOMETEXT
115+
Points to an .html file which is included on the gitweb project
116+
overview page ('projects_list' view), if it exists. Relative to
117+
gitweb.cgi script. [Default: indextext.html]
118+
* GITWEB_SITE_HEADER
119+
Filename of html text to include at top of each page. Relative to
120+
gitweb.cgi script. [No default]
121+
* GITWEB_SITE_FOOTER
122+
Filename of html text to include at bottom of each page. Relative to
123+
gitweb.cgi script. [No default]
124+
* GITWEB_HOME_LINK_STR
125+
String of the home link on top of all pages, leading to $home_link
126+
(usually main gitweb page, which means projects list). Used as first
127+
part of gitweb view "breadcrumb trail": <home> / <project> / <view>.
128+
[Default: projects]
129+
* GITWEB_SITENAME
130+
Name of your site or organization to appear in page titles. Set it
131+
to something descriptive for clearer bookmarks etc. If not set
132+
(if empty) gitweb uses "$SERVER_NAME Git", or "Untitled Git" if
133+
SERVER_NAME CGI environment variable is not set (e.g. if running
134+
gitweb as standalone script). [No default]
135+
* GITWEB_BASE_URL
136+
Git base URLs used for URL to where fetch project from, i.e. full
137+
URL is "$git_base_url/$project". Shown on projects summary page.
138+
Repository URL for project can be also configured per repository; this
139+
takes precedence over URLs composed from base URL and a project name.
140+
Note that you can setup multiple base URLs (for example one for
141+
git:// protocol access, another for http:// access) from the gitweb
142+
config file. [No default]
143+
* GITWEB_CSS
144+
Points to the location where you put gitweb.css on your web server
145+
(or to be more generic, the URI of gitweb stylesheet). Relative to the
146+
base URI of gitweb. Note that you can setup multiple stylesheets from
147+
the gitweb config file. [Default: static/gitweb.css (or
148+
static/gitweb.min.css if the CSSMIN variable is defined / CSS minifier
149+
is used)]
150+
* GITWEB_LOGO
151+
Points to the location where you put git-logo.png on your web server
152+
(or to be more generic URI of logo, 72x27 size, displayed in top right
153+
corner of each gitweb page, and used as logo for Atom feed). Relative
154+
to base URI of gitweb. [Default: static/git-logo.png]
155+
* GITWEB_FAVICON
156+
Points to the location where you put git-favicon.png on your web server
157+
(or to be more generic URI of favicon, assumed to be image/png type;
158+
web browsers that support favicons (website icons) may display them
159+
in the browser's URL bar and next to site name in bookmarks). Relative
160+
to base URI of gitweb. [Default: static/git-favicon.png]
161+
* GITWEB_JS
162+
Points to the location where you put gitweb.js on your web server
163+
(or to be more generic URI of JavaScript code used by gitweb).
164+
Relative to base URI of gitweb. [Default: static/gitweb.js (or
165+
static/gitweb.min.js if JSMIN build variable is defined / JavaScript
166+
minifier is used)]
167+
* GITWEB_CONFIG
168+
This Perl file will be loaded using 'do' and can be used to override any
169+
of the options above as well as some other options -- see the "Runtime
170+
gitweb configuration" section below, and top of 'gitweb.cgi' for their
171+
full list and description. If the environment variable GITWEB_CONFIG
172+
is set when gitweb.cgi is executed, then the file specified in the
173+
environment variable will be loaded instead of the file specified
174+
when gitweb.cgi was created. [Default: gitweb_config.perl]
175+
* GITWEB_CONFIG_SYSTEM
176+
This Perl file will be loaded using 'do' as a fallback if GITWEB_CONFIG
177+
does not exist. If the environment variable GITWEB_CONFIG_SYSTEM is set
178+
when gitweb.cgi is executed, then the file specified in the environment
179+
variable will be loaded instead of the file specified when gitweb.cgi was
180+
created. [Default: /etc/gitweb.conf]
181+
* HIGHLIGHT_BIN
182+
Path to the highlight executable to use (must be the one from
183+
http://www.andre-simon.de due to assumptions about parameters and output).
184+
Useful if highlight is not installed on your webserver's PATH.
185+
[Default: highlight]
186+
76187
Build example
77188
~~~~~~~~~~~~~
78189

‎gitweb/README‎

Lines changed: 0 additions & 114 deletions
Original file line numberDiff line numberDiff line change
@@ -7,120 +7,6 @@ The one working on:
77
From the git version 1.4.0 gitweb is bundled with git.
88

99

10-
How to configure gitweb for your local system
11-
---------------------------------------------
12-
13-
See also the "Build time configuration" section in the INSTALL
14-
file for gitweb (in gitweb/INSTALL).
15-
16-
You can specify the following configuration variables when building GIT:
17-
* GIT_BINDIR
18-
Points where to find the git executable. You should set it up to
19-
the place where the git binary was installed (usually /usr/bin) if you
20-
don't install git from sources together with gitweb. [Default: $(bindir)]
21-
* GITWEB_SITENAME
22-
Shown in the title of all generated pages, defaults to the server name
23-
(SERVER_NAME CGI environment variable) if not set. [No default]
24-
* GITWEB_PROJECTROOT
25-
The root directory for all projects shown by gitweb. Must be set
26-
correctly for gitweb to find repositories to display. See also
27-
"Gitweb repositories" in the INSTALL file for gitweb. [Default: /pub/git]
28-
* GITWEB_PROJECT_MAXDEPTH
29-
The filesystem traversing limit for getting the project list; the number
30-
is taken as depth relative to the projectroot. It is used when
31-
GITWEB_LIST is a directory (or is not set; then project root is used).
32-
This is meant to speed up project listing on large work trees by limiting
33-
search depth. [Default: 2007]
34-
* GITWEB_LIST
35-
Points to a directory to scan for projects (defaults to project root
36-
if not set / if empty) or to a file with explicit listing of projects
37-
(together with projects' ownership). See "Generating projects list
38-
using gitweb" in INSTALL file for gitweb to find out how to generate
39-
such file from scan of a directory. [No default, which means use root
40-
directory for projects]
41-
* GITWEB_EXPORT_OK
42-
Show repository only if this file exists (in repository). Only
43-
effective if this variable evaluates to true. [No default / Not set]
44-
* GITWEB_STRICT_EXPORT
45-
Only allow viewing of repositories also shown on the overview page.
46-
This for example makes GITWEB_EXPORT_OK to decide if repository is
47-
available and not only if it is shown. If GITWEB_LIST points to
48-
file with list of project, only those repositories listed would be
49-
available for gitweb. [No default]
50-
* GITWEB_HOMETEXT
51-
Points to an .html file which is included on the gitweb project
52-
overview page ('projects_list' view), if it exists. Relative to
53-
gitweb.cgi script. [Default: indextext.html]
54-
* GITWEB_SITE_HEADER
55-
Filename of html text to include at top of each page. Relative to
56-
gitweb.cgi script. [No default]
57-
* GITWEB_SITE_FOOTER
58-
Filename of html text to include at bottom of each page. Relative to
59-
gitweb.cgi script. [No default]
60-
* GITWEB_HOME_LINK_STR
61-
String of the home link on top of all pages, leading to $home_link
62-
(usually main gitweb page, which means projects list). Used as first
63-
part of gitweb view "breadcrumb trail": <home> / <project> / <view>.
64-
[Default: projects]
65-
* GITWEB_SITENAME
66-
Name of your site or organization to appear in page titles. Set it
67-
to something descriptive for clearer bookmarks etc. If not set
68-
(if empty) gitweb uses "$SERVER_NAME Git", or "Untitled Git" if
69-
SERVER_NAME CGI environment variable is not set (e.g. if running
70-
gitweb as standalone script). [No default]
71-
* GITWEB_BASE_URL
72-
Git base URLs used for URL to where fetch project from, i.e. full
73-
URL is "$git_base_url/$project". Shown on projects summary page.
74-
Repository URL for project can be also configured per repository; this
75-
takes precedence over URLs composed from base URL and a project name.
76-
Note that you can setup multiple base URLs (for example one for
77-
git:// protocol access, another for http:// access) from the gitweb
78-
config file. [No default]
79-
* GITWEB_CSS
80-
Points to the location where you put gitweb.css on your web server
81-
(or to be more generic, the URI of gitweb stylesheet). Relative to the
82-
base URI of gitweb. Note that you can setup multiple stylesheets from
83-
the gitweb config file. [Default: static/gitweb.css (or
84-
static/gitweb.min.css if the CSSMIN variable is defined / CSS minifier
85-
is used)]
86-
* GITWEB_LOGO
87-
Points to the location where you put git-logo.png on your web server
88-
(or to be more generic URI of logo, 72x27 size, displayed in top right
89-
corner of each gitweb page, and used as logo for Atom feed). Relative
90-
to base URI of gitweb. [Default: static/git-logo.png]
91-
* GITWEB_FAVICON
92-
Points to the location where you put git-favicon.png on your web server
93-
(or to be more generic URI of favicon, assumed to be image/png type;
94-
web browsers that support favicons (website icons) may display them
95-
in the browser's URL bar and next to site name in bookmarks). Relative
96-
to base URI of gitweb. [Default: static/git-favicon.png]
97-
* GITWEB_JS
98-
Points to the location where you put gitweb.js on your web server
99-
(or to be more generic URI of JavaScript code used by gitweb).
100-
Relative to base URI of gitweb. [Default: static/gitweb.js (or
101-
static/gitweb.min.js if JSMIN build variable is defined / JavaScript
102-
minifier is used)]
103-
* GITWEB_CONFIG
104-
This Perl file will be loaded using 'do' and can be used to override any
105-
of the options above as well as some other options -- see the "Runtime
106-
gitweb configuration" section below, and top of 'gitweb.cgi' for their
107-
full list and description. If the environment variable GITWEB_CONFIG
108-
is set when gitweb.cgi is executed, then the file specified in the
109-
environment variable will be loaded instead of the file specified
110-
when gitweb.cgi was created. [Default: gitweb_config.perl]
111-
* GITWEB_CONFIG_SYSTEM
112-
This Perl file will be loaded using 'do' as a fallback if GITWEB_CONFIG
113-
does not exist. If the environment variable GITWEB_CONFIG_SYSTEM is set
114-
when gitweb.cgi is executed, then the file specified in the environment
115-
variable will be loaded instead of the file specified when gitweb.cgi was
116-
created. [Default: /etc/gitweb.conf]
117-
* HIGHLIGHT_BIN
118-
Path to the highlight executable to use (must be the one from
119-
http://www.andre-simon.de due to assumptions about parameters and output).
120-
Useful if highlight is not installed on your webserver's PATH.
121-
[Default: highlight]
122-
123-
12410
Runtime gitweb configuration
12511
----------------------------
12612

0 commit comments

Comments
 (0)