
GitHub Integration
Edit links and repository linking behavior

Arcane Lexicon provides GitHub integration through SiteConfig.githubUrl and SiteConfig.editBranch.

When githubUrl is configured and showEditLink is true, pages include an edit link.

SiteConfig(
  name: 'My Docs',
  githubUrl: 'https://github.com/myorg/myproject',
  editBranch: 'main',
  showEditLink: true,
)

Edit URL shape:

{githubUrl}/edit/{editBranch}/{contentDirectory}/{pagePath}.md

Example:

https://github.com/acme/docs/edit/main/content/guide/basics/installation.md

When githubUrl is present and the top/bottom navigation bar is enabled, the default KBTopBar renders a GitHub icon link.

SiteConfig(
  name: 'My Docs',
  githubUrl: 'https://github.com/myorg/myproject',
  navigationBarEnabled: true,
)

KBChangelog can generate release links when you pass githubUrl.

KBChangelog(
  versions: changelogVersions,
  githubUrl: 'https://github.com/myorg/myproject',
)

Release URL shape:

{githubUrl}/releases/tag/v{version}

sidebarFooter and sidebarFooterUrl exist on SiteConfig, but the default KBLayout path does not currently render them. Use a custom layout if you need them displayed.