'\" t
.\"     Title: gitit
.\"    Author: Giovanni Mascellani <gio@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 12/31/2018
.\"    Manual: Gitit User Manual
.\"    Source: gitit
.\"  Language: English
.\"
.TH "GITIT" "1" "12/31/2018" "gitit" "Gitit User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gitit \- wiki engine backed by a git or darcs filestore
.SH "SYNOPSIS"
.HP \w'\fBgitit\fR\ 'u
\fBgitit\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR}] [{\fB\-v\fR\ |\ \fB\-\-version\fR}] [{\fB\-p\ \fR\fB\fIport\fR\fR\ |\ \fB\-\-port=\fR\fB\fIport\fR\fR}] [{\fB\-l\ \fR\fB\fIinterface\fR\fR\ |\ \fB\-\-listen=\fR\fB\fIinterface\fR\fR}] [{\fB\-f\ \fR\fB\fIconfigfile\fR\fR\ |\ \fB\-\-config\-file=\fR\fB\fIconfigfile\fR\fR}] [\fB\-\-debug\fR] [\fB\-\-print\-default\-config\fR]
.SH "DESCRIPTION"
.PP
\fBgitit\fR
is a wiki enging backed by a git or darcs filestore\&. When run for the first time, it creates a file standard files and directories that contains the structure of a basic wiki, then listens for incoming HTTP connections\&. When run in a directory that already contains a gitit wiki, it uses the information already present\&.
.PP
The directory
\fBwikidata\fR
contains the repository that hosts the pages in the wiki\&. You can change its content both from the Web interface and by modifying directly the repository (via commit/record or push/pull)\&.
.SH "OPTIONS"
.PP
The program follows the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&.
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Displays a brief help about the parameters, then quits\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Displays the installed version of gitit, then quits\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR, \fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Intruct gitit to listen on the specified port\&.
.RE
.PP
\fB\-l \fR\fB\fIinterface\fR\fR, \fB\-\-listen=\fR\fB\fIinterface\fR\fR
.RS 4
Intruct gitit to listen on the specified interface\&.
.RE
.PP
\fB\-f \fR\fB\fIconfigfile\fR\fR, \fB\-\-config\-file=\fR\fB\fIconfigfile\fR\fR
.RS 4
Override default configuration with the values specified in file
\fIconfigfile\fR\&. To see this file\*(Aqs syntax and the configurable fields (with default values and documentation), use
\fB\-\-print\-default\-config\fR\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Enable debug mode: gitit will print information about all the requests it handles\&.
.RE
.PP
\fB\-\-print\-default\-config\fR
.RS 4
Prints the default configuration values, along with some documentation\&.
.RE
.SH "AUTHOR"
.PP
\fBGiovanni Mascellani\fR <\&gio@debian\&.org\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2011 Giovanni Mascellani
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp