# Website build and SGK integration

The SDK includes a static developer site and a proposed replacement EpicTuner
landing page. They share SGK Embedded's dark surface and red accent. The product
page links to practical onboarding and the SDK reference.

## Generate and preview

```sh
python -m pip install -r tools/requirements.txt
python tools/build-docs.py --output site
python -m http.server 8080 --bind 127.0.0.1 --directory site
```

Open `http://127.0.0.1:8080/epictuner/` and
`http://127.0.0.1:8080/epictuner/sdk/`. Search works locally without a backend
or network request. Code blocks have copy buttons; articles include page anchors,
source links, keyboard focus styling and responsive navigation.
Every page also links to `EpicTuner-SDK-Manual.md`: one generated UTF-8 file
containing all guide chapters, public C/C++ headers, schemas and complete starter
and cascading example sources. Authors can download it and give it to their
coding agent. A `.md.sha256` sidecar identifies the exact generated manual.

The generator verifies local links, anchors and images and fails on a broken
link or a reference outside the public SDK. To recheck existing output:

```sh
python tools/build-docs.py --output site --check
```

## Deployable structure

```text
site/epictuner/index.html          Product landing page
site/epictuner/downloads/index.html Packages, requirements and release status
site/epictuner/assets/             Shared styling, scripts and screenshots
site/epictuner/sdk/index.html      SDK home
site/epictuner/sdk/docs/           Guides and API contracts
site/epictuner/sdk/examples/       Example guides, source and synthetic fixtures
site/epictuner/sdk/include/        Public C/C++ headers
```

The generated files can be served from a static route under
`www.sgkembedded.com/epictuner/`. All internal links are relative, so a staging
subdirectory works too. If the existing site framework owns `/epictuner`, port
`website/landing.html` into that route and serve the SDK output under
`/epictuner/sdk/`. Preserve path casing or redirect old links consistently.

No changes to the live SGK website are made by this generator. The landing page
links to a downloads page with package descriptions, provisional requirements
and disabled Coming soon buttons. Add artifact URLs, versions, sizes, SHA-256
checksums and release notes when an approved release is available. The proprietary SDK terms permit plugin development and distribution, but prohibit
redistributing the SDK itself; see `../REDISTRIBUTION.md`.

## Edit the content

Edit Markdown under `docs` and example READMEs. The generator uses those same
sources in the SDK archive and the website. Edit `website/page.html` for the
documentation shell, `website/landing.html` for product copy,
`website/downloads.html` for packages and requirements, and
`website/assets/site.css` for the shared design.

Product screenshots are real SDK example captures using synthetic data. Replace
them with fresh approved captures when the UI changes. The page avoids the old
landing page's public-GitHub claim: repository publication and production release
hosting are separate decisions.