Files
Marc Gravell c0b2097129 Pin the docs site config, and give it a favicon (#2224)
The site was running on GitHub's defaults, which take the title and description
from the repo's name and description fields - so an edit in the repo settings UI
quietly changed the site's metadata. Those are pinned now, along with the URL,
which is what jekyll-seo-tag uses to build canonical and og:url.

Also: strip_title, so the page title stops being printed twice (once in the
theme's header banner, once as the heading it was derived from); jekyll-sitemap,
which is not in the always-on GitHub Pages plugin set, for the sitemap.xml and
robots.txt the site did not have; and a favicon built from the project logo,
hooked up via the head-custom.html include the theme provides for exactly this.

Claude-Session: https://claude.ai/code/session_01NxkjXSR7CSGzyw89tJJVtw
2026-08-18 14:42:43 +01:00

28 lines
967 B
YAML

# Jekyll config for the published docs site (https://dapperlib.dev).
# Pinned here rather than left to GitHub's defaults, which take the site title and
# description from the repo's name and description fields.
title: Dapper
description: A simple object mapper for .NET
url: https://dapperlib.dev
theme: jekyll-theme-cayman
# Cayman renders "Download .zip/.tar.gz" buttons in its header when this is on, and
# GitHub's default config turns it on; these ship as NuGet packages, not tarballs.
show_downloads: false
# Cayman renders the page title in its header banner, and the title comes from each page's
# first heading - so without this the heading reads twice, banner then body.
titles_from_headings:
strip_title: true
# Not in the always-on GitHub Pages plugin set, so it has to be asked for; generates
# sitemap.xml and robots.txt.
plugins:
- jekyll-sitemap
# Present only so the docs show up in the solution; not site content.
exclude:
- docs.csproj