# Example config for repo-render(1).
#
# Copy it to /etc/repo-render/repo-render.yaml, where repo-render looks
# for it, and edit it. The settings that are not commented out are
# required. The commented-out ones show their default values; uncomment
# one to change it.
#
# A relative path is relative to this file. Changing this file makes the
# next push re-render every repository. Run `repo-render check` after
# editing it.

# The site's host name. It is used for links back to the site, such as in
# the sitemap and the clone URLs.
host: code.example.com

# Where things are.
git_dir: /var/git                             # the bare repositories, NAME.git
htdocs: /var/www/htdocs/repo-render           # the rendered website
state_dir: /var/db/repo-render                # the renderer's saved state, its lock,
                                              # and the job queue that the hook adds to

# The private site, for repositories that are in no section below. It is
# served at /private/ behind a password, and must be outside htdocs.
# Without it, private repositories are not rendered at all.
#private_htdocs: /var/www/private/repo-render

# Directories of your own syntax highlighters, as NAME.xml files, searched
# before the built-in ones. See the lexers section below.
#lexer_dirs: [/etc/repo-render/lexers]

# Syntax highlighting colours: any chroma style, for dark mode and light
# mode. style_light: "" turns off light mode.
#style: tokyonight-night
#style_light: github

site:
  # The heading on every page.
  #title: Code

  # A line under the title on the index page.
  #tagline: ""

  # HTML at the bottom of every page. Write it as a folded block, like
  # this, so it needs no quoting.
  #footer: >-
  #  Built with <a href="/code/repo-renderer">Repo Renderer</a>.

  # The site's public address, if it isn't https://HOST.
  #url: https://code.example.com

  # The clone URL shown on each repository's page. {repo} is replaced by
  # the repository's name. The default is URL/git/{repo}.git.
  #clone_url: "https://code.example.com/git/{repo}.git"

  # An .svg, .png, .ico, .gif or .webp file to use instead of the built-in
  # favicon.
  #favicon: /etc/repo-render/favicon.svg

# Sections of the index page, in order. Each has a name, which a
# repository's git config puts it in by (repo-render.section; git selfhost
# and repo-render add set it), so the title can change. Within a section,
# repositories are in alphabetical order; a repository in no section is
# private. repo-render list shows which are where. Titles and
# descriptions are Markdown.
#sections:
#  - name: tools
#    title: Command line programs
#    description: >-
#      Small tools I use every day.
#  - name: tomo
#    title: "[Tomo](https://tomo.example.com)"

# Syntax highlighting for file types chroma doesn't know. The name is a
# NAME.xml file in lexer_dirs, a built-in one (tomo, bp and nomsu are
# built in), or a chroma lexer. globs pick it by file name, and aliases
# are the names that work after ``` in Markdown.
#lexers:
#  tomo:
#    globs: ["*.tm"]
#    aliases: [tomo, tm]
#  bp:
#    globs: ["*.bp"]
#    aliases: [bp]
#  nomsu:
#    globs: ["*.nom"]
#    aliases: [nomsu, nom]

# Settings for single repositories.
#repos:
#  tomo:
#    branch: main                 # the branch the site shows; default: the repository's HEAD
#    branches: [dev]              # more branches to render, each at /code/tomo@BRANCH