2.3 Collections

A collection is a named site serving git repositories: gitlab.com, github.com, a private gitlab or gitea instance, or a plain git server. The collection database is made of files of ‘ergo:define-collection’ forms, in three layers: built-in (distributed with ‘ergo’), site (the ‘ergo/collections.d/’ subdirectory of the ‘$XDG_CONFIG_DIRS’ directories), and user (‘$XDG_CONFIG_HOME/ergo/collections.d/’, ie. ‘~/.config/ergo/collections.d/’ by default). A user definition overrides a site or built-in definition with the same name.

;; ~/.config/ergo/collections.d/my-collections.lisp
(ergo:define-collection origin
  :kind       plain
  :git-user   "pjb"
  :git-server "git.informatimago.com"
  :git-root   "/srv/git/public")

ergo collections’ lists the database in search order.