build: automate landing page build and update docs

Integrate the landing page generation into the deployment workflow and provide updated documentation for the new project structure. These changes ensure the live site remains synchronized with its source and offer clear instructions for local development and site maintenance.

Author: jackfromeast

.github/workflows/deploy-website.yml

@@ -26,6 +26,13 @@ jobs:
           cd website/source
           hugo --baseURL="/wiki/" --destination="../wiki"
 
+      - name: Build landing page
+        run: |
+          cd website/source-landing
+          hugo --destination="../_build"
+          cp ../_build/index.html ../index.html
+          rm -rf ../_build
+
       - name: Stage publish directory
         run: |
           mkdir -p _publish

website/README.md

@@ -6,14 +6,18 @@ Static website for the Python Class Pollution research project, including the la
 
 ```
 website/
-├── index.html       # Landing page
-├── img/             # Hero icon and demo GIFs
-├── source/          # Wiki source (Hugo content + layouts)
-│   ├── content/     # Markdown pages
-│   ├── layouts/     # Custom Hugo templates
-│   ├── static/      # Wiki CSS and assets
-│   └── hugo.toml    # Hugo config
-└── wiki/            # Built wiki (generated from source/)
+├── index.html         # Landing page (generated from source-landing/)
+├── img/               # Hero icon and demo GIFs
+├── source-landing/    # Landing-page source (Hugo, single home page)
+│   ├── content/       # _index.md — landing page markdown
+│   ├── layouts/       # index.html template with the landing styles
+│   └── hugo.toml      # Hugo config
+├── source/            # Wiki source (Hugo content + layouts)
+│   ├── content/       # Markdown pages
+│   ├── layouts/       # Custom Hugo templates
+│   ├── static/        # Wiki CSS and assets
+│   └── hugo.toml      # Hugo config
+└── wiki/              # Built wiki (generated from source/)
 ```
 
 ## Running locally
@@ -41,6 +45,15 @@ hugo --baseURL="/wiki/" --destination="../wiki"
 
 This generates the static site under `website/wiki/`.
 
+## Rebuilding the landing page
+
+The landing page is generated from `source-landing/content/_index.md` using a single Hugo home template at `source-landing/layouts/index.html` (which contains the page's inline styles). To edit copy, edit the markdown — don't edit `index.html` directly.
+
+```bash
+cd source-landing 
+hugo --destination=/tmp/landing-build && cp /tmp/landing-build/index.html ../index.html
+```
+
 ## Deployment
 
 The site is deployed to <https://class-pollution.github.io> via the GitHub Actions workflow at `.github/workflows/deploy-website.yml`. On every push to `main` that touches `website/`, the workflow: