nixos/modules/services/misc/gitweb.nix

   1 { config, lib, pkgs, ... }:
   2 let
   3   cfg = config.services.gitweb;
   4
   5 in
   6 {
   7
   8   options.services.gitweb = {
   9
  10     projectroot = lib.mkOption {
  11       default = "/srv/git";
  12       type = lib.types.path;
  13       description = ''
  14         Path to git projects (bare repositories) that should be served by
  15         gitweb. Must not end with a slash.
  16       '';
  17     };
  18
  19     extraConfig = lib.mkOption {
  20       default = "";
  21       type = lib.types.lines;
  22       description = ''
  23         Verbatim configuration text appended to the generated gitweb.conf file.
  24       '';
  25       example = ''
  26         $feature{'highlight'}{'default'} = [1];
  27         $feature{'ctags'}{'default'} = [1];
  28         $feature{'avatar'}{'default'} = ['gravatar'];
  29       '';
  30     };
  31
  32     gitwebTheme = lib.mkOption {
  33       default = false;
  34       type = lib.types.bool;
  35       description = ''
  36         Use an alternative theme for gitweb, strongly inspired by GitHub.
  37       '';
  38     };
  39
  40     gitwebConfigFile = lib.mkOption {
  41       default = pkgs.writeText "gitweb.conf" ''
  42         # path to git projects (<project>.git)
  43         $projectroot = "${cfg.projectroot}";
  44         $highlight_bin = "${pkgs.highlight}/bin/highlight";
  45         ${cfg.extraConfig}
  46       '';
  47       defaultText = lib.literalMD "generated config file";
  48       type = lib.types.path;
  49       readOnly = true;
  50       internal = true;
  51     };
  52
  53   };
  54
  55   meta.maintainers = [ ];
  56
  57 }