Follow Dungeon Church

Hugo ’linktree’ style site using the lynx theme.

Dice rolling animation from https://sarahrosannabusch.github.io/dice/

How it works

  1. Content: Edit list in config.toml
  2. Build: Push to main branch triggers Forgejo Actions workflow
  3. Deploy: Workflow builds Hugo site and pushes to pages branch
  4. Local Deploy: Deploys to dungeonchurch-links.static.brads.house for testing

Add SVG icon to assets/icons then add to config.toml:

{customname={href="/contact.vcf",text="Contact",icon="address-card",target="_self"}},

Styling: The key name (e.g., customname) becomes the CSS class link-customname. Style it in assets/css/custom.css:

.link-customname {
    background-color: #your-color !important;
    /* your custom styles */
}

Deployment

The local deployment is automatic, the production deployment is manual dispatch.

Secrets required

Build workflow (build-hugo.yml)

  • DEPLOY_SSH_KEY - SSH key for server
  • DEPLOY_HOST - Server hostname
  • DEPLOY_PORT - SSH port (default: 22)
  • DEPLOY_USER - SSH username
  • DEPLOY_PATH - Deployment directory on server

Production deployment (deploy-prod.yml)

  • DEPLOY_PROD_SSH_KEY - Production SSH key
  • DEPLOY_PROD_HOST - Production hostname
  • DEPLOY_PROD_PORT - Production SSH port (default: 22)
  • DEPLOY_PROD_USER - Production SSH username
  • DEPLOY_PROD_PATH - Production deployment directory