# base configuration, common to all repos class base: # location of the darcs logo darcslogo = "darcs.png" # location of the darcs favicon darcsfav = "minidarcs.png" # the CSS file to use cssfile = 'style.css' # this script's name, usually just "darcsweb.cgi" unless you rename # it; if you leave this commented it will be detected automatically #myname = "darcsweb.cgi" # our url, used only to generate RSS links, without the script name; # if you leave this commented it will be detected automatically #myurl = "http://example.com/darcsweb" # optionally, you can specify the path to the darcs executable; if you # leave this commented, the one on $PATH will be used (this is # normally what you want) #darcspath = "/home/me/bin/" # the text to appear in the top of repo list; this is also optional, # and html-formatted #summary = "I love darcs!" # in case you want to change the beautiful default, you can specify an # alternative footer here; it's optional, of course #footer = "I don't like shoes" # It is possible to have a cache where darcsweb will store the pages # it generates; entries are automatically updated when the repository # changes. This will speed things up significatively, specially for # popular sites. # It's recommended that you clean the directory with some regularity, # to avoid having too many unused files. A simple rm will do just # fine. # If you leave the entry commented, no cache will be ever used; # otherwise the directory is assumed to exist and be writeable. # If you use this option you must set the "myname" and "myurl" # variables. #cachedir = '/tmp/darcsweb-cache' # By default, darcsweb's search looks in the last 100 commits; you can # change that number by specifying it here. # Note that search are not cached, so if you have tons of commits and # set the limit to a very high number, they will take time. #searchlimit = 100 # If you want to log the times it took darcsweb to present a page, # uncomment this option. The value should be a file writeable by # darcsweb. #logtimes = "/tmp/darcsweb_times" # If you want darcsweb to automatically detect embedded URLs, # define them here, using python-style regexps like the examples # below. They will be replaced in summaries, logs, and commits. # The following variables are replaced: # myreponame: repository link (darcsweb.cgi?r=repo) # reponame: repository name (repo) # #url_links = ( # Format is: (regexp, replacement) # Some examples: # # Detect '#NNN' as a reference to bug database #(r'#([0-9]+)', # r'#\1'), # # Replace hashes with commit-links. #(r'(\d{14}-[0-9a-f]{5}-[0-9a-f]{40}\.gz)', # r'\1'), #) # If you want to generate links from patch author names, define the url # here. Example for CIA: #author_links = "http://cia.navi.cx/stats/author/%(author)s" # If you want to disable the annotate feature (for performance reasons, # the http connection will time out on slow machines), uncomment this # option. #disable_annotate = True # If you'd like a wider range of README file types than darcsweb # provides, set readme_converter to a program which takes a single # argument--the name of the readme file--and outputs HTML. #readme_converter = 'ruby -rubygems /var/lib/gems/1.8/gems/github-markup-0.5.3/bin/github-markup' # # From now on, every class is a repo configuration, with the same format # There are no restrictions on the class' name, except that it can't be named # "base" (because it's the name of the one above). # # If you have a lot of repos and/or you're too lazy to do this by hand, you # can use the configuration generator that comes with darcsweb, called # "mkconfig.py". # class repo1: # the descriptive name reponame = 'repo1' # a brief description repodesc = 'Example repository' # the real path to the repository repodir = '/usr/src/repo1' # an url so people know where to do "darcs get" from repourl = 'http://example.com/repos/repo1/' # the encoding used in the repo # NOTE: if you use utf8, you _must_ write 'utf8' (and not the variants # like 'utf-8' or 'UTF8') if you expect darcsweb to work properly. # This is because to workaround a bug in darcs we need to do some # codec mangling and it needs special cases for UTF8. # You can, optionally, specify multiple encodings; they're tried in # order, and if one fails to decode a string, the next one is tried. # Example: repoencoding = "utf8", "latin1" repoencoding = "latin1" # as with the base configuration, the footer is also optional, and it # affects only this repository; if you don't specify, the one # specified in base is used (and if you don't specify one there # either, a default one is used) #footer = "I don't like being cold" # Each repository may show a link to some website associated with it. # This is typically useful if you've got a website describing the # software in your repository. #repoprojurl = 'http://example.com/projects/repo1/' class repo2: reponame = 'repo2' repodesc = 'Second example repository' repodir = '/usr/src/repo2' repourl = 'http://example.com/repos/repo2/' repoencoding = 'latin1' # # If you have several repositories in a single directory and don't want to # create a configuration entry for each one, you can use a "multidir" entry, # which serves as a "template" for all the repositories in that directory. # The name is taken from the directory, and inside the variables the string # "%(name)s" gets expanded to the it. If displayname is set, "%(dname)s" gets # expanded to it; otherwise it's the same as "%(name)s". # # If you set multidir_deep to True (note the capitalization) then all # subdirectories are searched for darcs repositories. Subdirectories starting # with a dot (.) are not searched. This may be slow, if huge directory trees # must be searched. It's unnecesary unless you have a multidir with several # nested repositories. It defaults to False, and it's optional. # class multi1: multidir = '/usr/local/src' #multidir_deep = False repodesc = 'Repository for %(name)s' repourl = 'http://example.com/repos/%(name)s/' repoencoding = 'latin1' # if you want to change the display name of the repositories (i.e. the # name it will have on the listings, urls, etc.), you can set it here. # You can use "%(name)s" expansion, see above. #displayname = "local/%(name)s" # optional, see above #repoprojurl = 'http://example.com/projects/%(name)s/' # if you want to exclude some directories, add them to this list (note # they're relative to multidir, not absolute) #exclude = 'dir1', 'dir2' # if you want the descriptions to be picked up automatically from the # file named "_darcs/third_party/darcsweb/desc" (one line only), set # this to True. It defaults to False #autodesc = True # if you want to exclude all the repositories which do NOT have a # directory named "_darcs/third_party/darcsweb/" inside, set this to # True. It defaults to False. #autoexclude = True # if you want urls to be picked up automatically from the file named # "_darcs/third_party/darcsweb/url" (one line only), set this to # True. It defaults to False. #autourl = True # if you want the projects urls to be picked up automatically from the # file named "_darcs/third_party/darcsweb/projurl" (one line only), set # this to True. It defaults to False. #autoprojurl = True