This repository contains the source code for the primary GHC website.

Updating content

The site is generated using the Hakyll static-site generator. Use cabal to build the ghc-homepage executable.

The website can be built using the ghc-homepage build command.

The website can be previewed locally using ghc-homepage watch. You can then run ./check.sh to run linkcheck on your local copy.

Since 7.10.2 we auto-generate the tarball links on the release download pages. This requires metadata describing the files available from the download site (e.g. downloads.haskell.org) which are stored in the downloads-indices directory. There is one such file for each release; these files can be updated using the gen-index executable provided by this package, passing the path to a local checkout of the downloads repository on the command line.

The tarballs described by the metadata files can be referenced in downloads pages using the $tarballs syntax (e.g. see here).

Nix

This project can be built with Nix. E.g. to run ghc-homepage watch in a Nix environment, execute:

nix run -f . -c ghc-homepage watch

Deploying

Deployment occurs via the continuous integration job