Skip to content
Snippets Groups Projects
guix.texi 969 KiB
Newer Older
  • Learn to ignore specific revisions
  • 
    @end deffn
    
    @deftp {Data Type} git-daemon-configuration
    Data type representing the configuration for @code{git-daemon-service}.
    
    @table @asis
    @item @code{package} (default: @var{git})
    Package object of the Git distributed version control system.
    
    @item @code{export-all?} (default: @var{#f})
    Whether to allow access for all Git repositories, even if they do not
    have the @file{git-daemon-export-ok} file.
    
    @item @code{base-path} (default: @file{/srv/git})
    Whether to remap all the path requests as relative to the given path.
    If you run git daemon with @var{(base-path "/srv/git")} on example.com,
    then if you later try to pull @code{git://example.com/hello.git}, git
    daemon will interpret the path as @code{/srv/git/hello.git}.
    
    @item @code{user-path} (default: @var{#f})
    Whether to allow @code{~user} notation to be used in requests.  When
    specified with empty string, requests to @code{git://host/~alice/foo} is
    taken as a request to access @code{foo} repository in the home directory
    of user @code{alice}.  If @var{(user-path "path")} is specified, the
    same request is taken as a request to access @code{path/foo} repository
    in the home directory of user @code{alice}.
    
    @item @code{listen} (default: @var{'()})
    Whether to listen on specific IP addresses or hostnames, defaults to
    all.
    
    @item @code{port} (default: @var{#f})
    Whether to listen on an alternative port, which defaults to 9418.
    
    @item @code{whitelist} (default: @var{'()})
    If not empty, only allow access to this list of directories.
    
    @item @code{extra-options} (default: @var{'()})
    Extra options will be passed to @code{git daemon}, please run
    @command{man git-daemon} for more information.
    
    @end table
    @end deftp
    
    
    The @code{git://} protocol lacks authentication.  When you pull from a
    
    Tobias Geerinckx-Rice's avatar
    Tobias Geerinckx-Rice committed
    repository fetched via @code{git://}, you don't know whether the data you
    receive was modified or is even coming from the specified host, and your
    connection is subject to eavesdropping.  It's better to use an authenticated
    and encrypted transport, such as @code{https}.  Although Git allows you
    
    to serve repositories using unsophisticated file-based web servers,
    there is a faster protocol implemented by the @code{git-http-backend}
    program.  This program is the back-end of a proper Git web service.  It
    is designed to sit behind a FastCGI proxy.  @xref{Web Services}, for more
    on running the necessary @code{fcgiwrap} daemon.
    
    Guix has a separate configuration data type for serving Git repositories
    over HTTP.
    
    @deftp {Data Type} git-http-configuration
    Data type representing the configuration for @code{git-http-service}.
    
    @table @asis
    @item @code{package} (default: @var{git})
    Package object of the Git distributed version control system.
    
    @item @code{git-root} (default: @file{/srv/git})
    Directory containing the Git repositories to expose to the world.
    
    @item @code{export-all?} (default: @var{#f})
    Whether to expose access for all Git repositories in @var{git-root},
    even if they do not have the @file{git-daemon-export-ok} file.
    
    @item @code{uri-path} (default: @file{/git/})
    Path prefix for Git access.  With the default @code{/git/} prefix, this
    will map @code{http://@var{server}/git/@var{repo}.git} to
    @code{/srv/git/@var{repo}.git}.  Requests whose URI paths do not begin
    with this prefix are not passed on to this Git instance.
    
    @item @code{fcgiwrap-socket} (default: @code{127.0.0.1:9000})
    The socket on which the @code{fcgiwrap} daemon is listening.  @xref{Web
    Services}.
    @end table
    @end deftp
    
    There is no @code{git-http-service-type}, currently; instead you can
    create an @code{nginx-location-configuration} from a
    @code{git-http-configuration} and then add that location to a web
    server.
    
    @deffn {Scheme Procedure} git-http-nginx-location-configuration @
           [config=(git-http-configuration)]
    Compute an @code{nginx-location-configuration} that corresponds to the
    given Git http configuration.  An example nginx service definition to
    serve the default @file{/srv/git} over HTTPS might be:
    
    
    (service nginx-service-type
             (nginx-configuration
              (server-blocks
               (list
                (nginx-server-configuration
    
                 (server-name "git.my-host.org")
                 (ssl-certificate
                  "/etc/letsencrypt/live/git.my-host.org/fullchain.pem")
                 (ssl-certificate-key
                  "/etc/letsencrypt/live/git.my-host.org/privkey.pem")
                 (locations
                  (list
                   (git-http-nginx-location-configuration
                    (git-http-configuration (uri-path "/"))))))))))
    
    
    This example assumes that you are using Let's Encrypt to get your TLS
    certificate.  @xref{Certificate Services}.  The default @code{certbot}
    service will redirect all HTTP traffic on @code{git.my-host.org} to
    HTTPS.  You will also need to add an @code{fcgiwrap} proxy to your
    system services.  @xref{Web Services}.
    @end deffn
    
    Oleg Pykhalov's avatar
    Oleg Pykhalov committed
    @subsubheading Cgit Service
    
    @cindex Cgit service
    @cindex Git, web interface
    @uref{https://git.zx2c4.com/cgit/, Cgit} is a web frontend for Git
    repositories written in C.
    
    The following example will configure the service with default values.
    By default, Cgit can be accessed on port 80 (@code{http://localhost:80}).
    
    
    Oleg Pykhalov's avatar
    Oleg Pykhalov committed
    (service cgit-service-type)
    
    The @code{file-object} type designates either a file-like object
    (@pxref{G-Expressions, file-like objects}) or a string.
    
    
    @c %start of fragment
    
    Available @code{cgit-configuration} fields are:
    
    @deftypevr {@code{cgit-configuration} parameter} package package
    The CGIT package.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} nginx-server-configuration-list nginx
    NGINX configuration.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object about-filter
    
    Specifies a command which will be invoked to format the content of about
    pages (both top-level and for each repository).
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string agefile
    Specifies a path, relative to each repository path, which can be used to
    specify the date and time of the youngest commit in the repository.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object auth-filter
    
    Specifies a command that will be invoked for authenticating repository
    access.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string branch-sort
    Flag which, when set to @samp{age}, enables date ordering in the branch
    ref list, and when set @samp{name} enables ordering by branch name.
    
    Defaults to @samp{"name"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string cache-root
    Path used to store the cgit cache entries.
    
    Defaults to @samp{"/var/cache/cgit"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-static-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of repository pages accessed with a fixed SHA1.
    
    Defaults to @samp{-1}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-dynamic-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of repository pages accessed without a fixed SHA1.
    
    Defaults to @samp{5}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-repo-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of the repository summary page.
    
    Defaults to @samp{5}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-root-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of the repository index page.
    
    Defaults to @samp{5}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-scanrc-ttl
    Number which specifies the time-to-live, in minutes, for the result of
    scanning a path for Git repositories.
    
    Defaults to @samp{15}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-about-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of the repository about page.
    
    Defaults to @samp{15}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-snapshot-ttl
    Number which specifies the time-to-live, in minutes, for the cached
    version of snapshots.
    
    Defaults to @samp{5}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer cache-size
    The maximum number of entries in the cgit cache.  When set to @samp{0},
    caching is disabled.
    
    Defaults to @samp{0}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean case-sensitive-sort?
    Sort items in the repo list case sensitively.
    
    Defaults to @samp{#t}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} list clone-prefix
    List of common prefixes which, when combined with a repository URL,
    generates valid clone URLs for the repository.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} list clone-url
    List of @code{clone-url} templates.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object commit-filter
    
    Command which will be invoked to format commit messages.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string commit-sort
    Flag which, when set to @samp{date}, enables strict date ordering in the
    commit log, and when set to @samp{topo} enables strict topological
    ordering.
    
    Defaults to @samp{"git log"}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object css
    
    URL which specifies the css document to include in all cgit pages.
    
    Defaults to @samp{"/share/cgit/cgit.css"}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object email-filter
    
    Specifies a command which will be invoked to format names and email
    address of committers, authors, and taggers, as represented in various
    places throughout the cgit interface.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean embedded?
    Flag which, when set to @samp{#t}, will make cgit generate a HTML
    fragment suitable for embedding in other HTML pages.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-commit-graph?
    Flag which, when set to @samp{#t}, will make cgit print an ASCII-art
    commit history graph to the left of the commit messages in the
    repository log page.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-filter-overrides?
    Flag which, when set to @samp{#t}, allows all filter settings to be
    overridden in repository-specific cgitrc files.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-follow-links?
    Flag which, when set to @samp{#t}, allows users to follow a file in the
    log view.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-http-clone?
    If set to @samp{#t}, cgit will act as an dumb HTTP endpoint for Git
    clones.
    
    Defaults to @samp{#t}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-index-links?
    Flag which, when set to @samp{#t}, will make cgit generate extra links
    "summary", "commit", "tree" for each repo in the repository index.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-index-owner?
    Flag which, when set to @samp{#t}, will make cgit display the owner of
    each repo in the repository index.
    
    Defaults to @samp{#t}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-log-filecount?
    Flag which, when set to @samp{#t}, will make cgit print the number of
    modified files for each commit on the repository log page.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-log-linecount?
    Flag which, when set to @samp{#t}, will make cgit print the number of
    added and removed lines for each commit on the repository log page.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-remote-branches?
    Flag which, when set to @code{#t}, will make cgit display remote
    branches in the summary and refs views.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-subject-links?
    Flag which, when set to @code{1}, will make cgit use the subject of the
    parent commit as link text when generating links to parent commits in
    commit view.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-html-serving?
    Flag which, when set to @samp{#t}, will make cgit use the subject of the
    parent commit as link text when generating links to parent commits in
    commit view.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-tree-linenumbers?
    Flag which, when set to @samp{#t}, will make cgit generate linenumber
    links for plaintext blobs printed in the tree view.
    
    Defaults to @samp{#t}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean enable-git-config?
    Flag which, when set to @samp{#f}, will allow cgit to use Git config to
    set any repo specific settings.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object favicon
    
    URL used as link to a shortcut icon for cgit.
    
    Defaults to @samp{"/favicon.ico"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string footer
    The content of the file specified with this option will be included
    
    verbatim at the bottom of all pages (i.e.@: it replaces the standard
    "generated by..."@: message).
    
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string head-include
    The content of the file specified with this option will be included
    verbatim in the HTML HEAD section on all pages.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string header
    The content of the file specified with this option will be included
    verbatim at the top of all pages.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object include
    
    Name of a configfile to include before the rest of the current config-
    file is parsed.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string index-header
    The content of the file specified with this option will be included
    verbatim above the repository index.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string index-info
    The content of the file specified with this option will be included
    verbatim below the heading on the repository index page.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean local-time?
    Flag which, if set to @samp{#t}, makes cgit print commit and tag times
    in the servers timezone.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object logo
    
    URL which specifies the source of an image which will be used as a logo
    on all cgit pages.
    
    Defaults to @samp{"/share/cgit/cgit.png"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string logo-link
    URL loaded when clicking on the cgit logo image.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object owner-filter
    
    Command which will be invoked to format the Owner column of the main
    page.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-atom-items
    Number of items to display in atom feeds view.
    
    Defaults to @samp{10}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-commit-count
    Number of entries to list per page in "log" view.
    
    Defaults to @samp{50}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-message-length
    Number of commit message characters to display in "log" view.
    
    Defaults to @samp{80}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-repo-count
    Specifies the number of entries to list per page on the repository index
    page.
    
    Defaults to @samp{50}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-repodesc-length
    Specifies the maximum number of repo description characters to display
    on the repository index page.
    
    Defaults to @samp{80}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer max-blob-size
    Specifies the maximum size of a blob to display HTML for in KBytes.
    
    Defaults to @samp{0}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string max-stats
    Maximum statistics period.  Valid values are @samp{week},@samp{month},
    @samp{quarter} and @samp{year}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} mimetype-alist mimetype
    Mimetype for the specified filename extension.
    
    Defaults to @samp{((gif "image/gif") (html "text/html") (jpg
    "image/jpeg") (jpeg "image/jpeg") (pdf "application/pdf") (png
    "image/png") (svg "image/svg+xml"))}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object mimetype-file
    
    Specifies the file to use for automatic mimetype lookup.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string module-link
    Text which will be used as the formatstring for a hyperlink when a
    submodule is printed in a directory listing.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean nocache?
    If set to the value @samp{#t} caching will be disabled.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean noplainemail?
    If set to @samp{#t} showing full author email addresses will be
    disabled.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean noheader?
    Flag which, when set to @samp{#t}, will make cgit omit the standard
    header on all pages.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} project-list project-list
    
    A list of subdirectories inside of @code{repository-directory}, relative
    to it, that should loaded as Git repositories.  An empty list means that
    all subdirectories will be loaded.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object readme
    
    Text which will be used as default value for @code{cgit-repo-readme}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean remove-suffix?
    If set to @code{#t} and @code{repository-directory} is enabled, if any
    repositories are found with a suffix of @code{.git}, this suffix will be
    removed for the URL and name.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer renamelimit
    Maximum number of files to consider when detecting renames.
    
    Defaults to @samp{-1}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string repository-sort
    The way in which repositories in each section are sorted.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} robots-list robots
    Text used as content for the @code{robots} meta-tag.
    
    Defaults to @samp{("noindex" "nofollow")}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string root-desc
    Text printed below the heading on the repository index page.
    
    Defaults to @samp{"a fast webinterface for the git dscm"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string root-readme
    The content of the file specified with this option will be included
    verbatim below thef "about" link on the repository index page.
    
    Defaults to @samp{""}.
    
    @deftypevr {@code{cgit-configuration} parameter} string root-title
    Text printed as heading on the repository index page.
    
    Defaults to @samp{""}.
    
    @deftypevr {@code{cgit-configuration} parameter} boolean scan-hidden-path
    If set to @samp{#t} and repository-directory is enabled,
    repository-directory will recurse into directories whose name starts
    with a period.  Otherwise, repository-directory will stay away from such
    directories, considered as "hidden".  Note that this does not apply to
    the ".git" directory in non-bare repos.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} list snapshots
    Text which specifies the default set of snapshot formats that cgit
    generates links for.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} repository-directory repository-directory
    Name of the directory to scan for repositories (represents
    @code{scan-path}).
    
    Defaults to @samp{"/srv/git"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string section
    The name of the current repository section - all repositories defined
    after this option will inherit the current section name.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string section-sort
    Flag which, when set to @samp{1}, will sort the sections on the
    repository listing by name.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer section-from-path
    A number which, if defined prior to repository-directory, specifies how
    many path elements from each repo path to use as a default section name.
    
    Defaults to @samp{0}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} boolean side-by-side-diffs?
    If set to @samp{#t} shows side-by-side diffs instead of unidiffs per
    default.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    
    @deftypevr {@code{cgit-configuration} parameter} file-object source-filter
    
    Specifies a command which will be invoked to format plaintext blobs in
    the tree view.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer summary-branches
    Specifies the number of branches to display in the repository "summary"
    view.
    
    Defaults to @samp{10}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer summary-log
    Specifies the number of log entries to display in the repository
    "summary" view.
    
    Defaults to @samp{10}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} integer summary-tags
    Specifies the number of tags to display in the repository "summary"
    view.
    
    Defaults to @samp{10}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string strict-export
    Filename which, if specified, needs to be present within the repository
    for cgit to allow access to that repository.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} string virtual-root
    URL which, if specified, will be used as root for all cgit links.
    
    Defaults to @samp{"/"}.
    
    @end deftypevr
    
    @deftypevr {@code{cgit-configuration} parameter} repository-cgit-configuration-list repositories
    A list of @dfn{cgit-repo} records to use with config.
    
    Defaults to @samp{()}.
    
    Available @code{repository-cgit-configuration} fields are:
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-list snapshots
    A mask of snapshot formats for this repo that cgit generates links for,
    restricted by the global @code{snapshots} setting.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object source-filter
    
    Override the default @code{source-filter}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string url
    The relative URL used to access the repository.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object about-filter
    
    Override the default @code{about-filter}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string branch-sort
    Flag which, when set to @samp{age}, enables date ordering in the branch
    ref list, and when set to @samp{name} enables ordering by branch name.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-list clone-url
    A list of URLs which can be used to clone repo.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object commit-filter
    
    Override the default @code{commit-filter}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string commit-sort
    Flag which, when set to @samp{date}, enables strict date ordering in the
    commit log, and when set to @samp{topo} enables strict topological
    ordering.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string defbranch
    The name of the default branch for this repository.  If no such branch
    exists in the repository, the first branch name (when sorted) is used as
    default instead.  By default branch pointed to by HEAD, or "master" if
    there is no suitable HEAD.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string desc
    The value to show as repository description.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string homepage
    The value to show as repository homepage.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object email-filter
    
    Override the default @code{email-filter}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-commit-graph?
    
    A flag which can be used to disable the global setting
    @code{enable-commit-graph?}.
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-log-filecount?
    
    A flag which can be used to disable the global setting
    @code{enable-log-filecount?}.
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-log-linecount?
    
    A flag which can be used to disable the global setting
    @code{enable-log-linecount?}.
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-remote-branches?
    
    Flag which, when set to @code{#t}, will make cgit display remote
    branches in the summary and refs views.
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-subject-links?
    
    A flag which can be used to override the global setting
    @code{enable-subject-links?}.
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-html-serving?
    
    A flag which can be used to override the global setting
    @code{enable-html-serving?}.
    
    
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-boolean hide?
    Flag which, when set to @code{#t}, hides the repository from the
    repository index.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-boolean ignore?
    Flag which, when set to @samp{#t}, ignores the repository.
    
    Defaults to @samp{#f}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object logo
    
    Oleg Pykhalov's avatar
    Oleg Pykhalov committed
    URL which specifies the source of an image which will be used as a logo
    
    on this repo’s pages.
    
    Defaults to @samp{""}.
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string logo-link
    URL loaded when clicking on the cgit logo image.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-file-object owner-filter
    
    Override the default @code{owner-filter}.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string module-link
    Text which will be used as the formatstring for a hyperlink when a
    submodule is printed in a directory listing.  The arguments for the
    formatstring are the path and SHA1 of the submodule commit.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} module-link-path module-link-path
    Text which will be used as the formatstring for a hyperlink when a
    submodule with the specified subdirectory path is printed in a directory
    listing.
    
    Defaults to @samp{()}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string max-stats
    Override the default maximum statistics period.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string name
    The value to show as repository name.
    
    Defaults to @samp{""}.
    
    @end deftypevr
    
    @deftypevr {@code{repository-cgit-configuration} parameter} repo-string owner