How avelino/awesome-go works
Awesome Go is a curated directory of Go projects, with a Go program that turns the list into a static website. The visible workflow converts the source Markdown, extracts categories and links, builds project pages, rewrites index links, and produces a sitemap and copied assets. The code also fetches and caches GitHub/GitLab project metadata. Several implementation details fall in omitted portions of main.go, so the graph limits connections to relationships visible in the excerpts or explicitly documented by the README.
Main entry points: main.go Site builder · convert.go Markdown converter · generator.go Slug generator · tmpl HTML templates
Components 17
Site generation
- Site builder
main.go
Content processing
- Markdown converter
pkg/markdown/convert.go - Slug generator
pkg/slug/generator.go - Category extraction
main.go - Project pages
main.go
Project metadata
- Metadata fetching
main.go - Metadata cache
main.go
Site presentation
- Index rendering
main.go - Index link rewrite
main.go - Category rendering
main.go - Sitemap rendering
main.go - HTML templates
tmpl - Static assets
tmpl/assets
Other components
- List maintainer
- GitHub API
- GitLab API
- Generated site
Connections 18
- List maintainer → Site builder: updates list
README.md - Site builder → Index rendering: renders index
main.go - Index rendering → Markdown converter: converts Markdown
main.go - Markdown converter → Slug generator: generates IDs
pkg/markdown/convert.go - Site builder → Category extraction: extracts categories
main.go - Category extraction → Slug generator: creates slugs
main.go - Site builder → Project pages: builds pages
main.go - Site builder → Metadata fetching: fetches metadata
main.go - Metadata fetching → GitHub API: requests metadata
main.go - Metadata fetching → GitLab API: requests metadata
main.go - Metadata fetching → Metadata cache: reads and writes
main.go - Site builder → Index link rewrite: rewrites links
main.go - Site builder → Category rendering: renders categories
main.go - Category rendering → HTML templates: executes template
main.go - Site builder → Sitemap rendering: renders sitemap
main.go - Sitemap rendering → HTML templates: executes template
main.go - Site builder → Static assets: copies assets
main.go - Site builder → Generated site: writes site
main.go