mirror of
https://github.com/git/git
synced 2024-11-04 16:17:49 +00:00
2eb14bb2d4
With this patch it is possible to launch git-instaweb by using Python http.server CGI handler via `-d python` option. git-instaweb generates a small wrapper around the http.server (in GIT_DIR/gitweb/) that address a limitation of the CGI handler where CGI scripts have to be in a cgi-bin subdirectory and directory index can't be easily changed. To keep the implementation small, gitweb is running on url `/cgi-bin/gitweb.cgi` and an automatic redirection is done when opening `/`. The generated wrapper is compatible with both Python 2 and 3. Python is by default installed on most modern Linux distributions which enables running `git instaweb -d python` without needing anything else. Signed-off-by: Arti Zirk <arti.zirk@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
94 lines
2.3 KiB
Text
94 lines
2.3 KiB
Text
git-instaweb(1)
|
|
===============
|
|
|
|
NAME
|
|
----
|
|
git-instaweb - Instantly browse your working repository in gitweb
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git instaweb' [--local] [--httpd=<httpd>] [--port=<port>]
|
|
[--browser=<browser>]
|
|
'git instaweb' [--start] [--stop] [--restart]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
A simple script to set up `gitweb` and a web server for browsing the local
|
|
repository.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
-l::
|
|
--local::
|
|
Only bind the web server to the local IP (127.0.0.1).
|
|
|
|
-d::
|
|
--httpd::
|
|
The HTTP daemon command-line that will be executed.
|
|
Command-line options may be specified here, and the
|
|
configuration file will be added at the end of the command-line.
|
|
Currently apache2, lighttpd, mongoose, plackup, python and
|
|
webrick are supported.
|
|
(Default: lighttpd)
|
|
|
|
-m::
|
|
--module-path::
|
|
The module path (only needed if httpd is Apache).
|
|
(Default: /usr/lib/apache2/modules)
|
|
|
|
-p::
|
|
--port::
|
|
The port number to bind the httpd to. (Default: 1234)
|
|
|
|
-b::
|
|
--browser::
|
|
The web browser that should be used to view the gitweb
|
|
page. This will be passed to the 'git web{litdd}browse' helper
|
|
script along with the URL of the gitweb instance. See
|
|
linkgit:git-web{litdd}browse[1] for more information about this. If
|
|
the script fails, the URL will be printed to stdout.
|
|
|
|
start::
|
|
--start::
|
|
Start the httpd instance and exit. Regenerate configuration files
|
|
as necessary for spawning a new instance.
|
|
|
|
stop::
|
|
--stop::
|
|
Stop the httpd instance and exit. This does not generate
|
|
any of the configuration files for spawning a new instance,
|
|
nor does it close the browser.
|
|
|
|
restart::
|
|
--restart::
|
|
Restart the httpd instance and exit. Regenerate configuration files
|
|
as necessary for spawning a new instance.
|
|
|
|
CONFIGURATION
|
|
-------------
|
|
|
|
You may specify configuration in your .git/config
|
|
|
|
-----------------------------------------------------------------------
|
|
[instaweb]
|
|
local = true
|
|
httpd = apache2 -f
|
|
port = 4321
|
|
browser = konqueror
|
|
modulePath = /usr/lib/apache2/modules
|
|
|
|
-----------------------------------------------------------------------
|
|
|
|
If the configuration variable `instaweb.browser` is not set,
|
|
`web.browser` will be used instead if it is defined. See
|
|
linkgit:git-web{litdd}browse[1] for more information about this.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:gitweb[1]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|