Player guide covers the two supported hardware paths (Lighthouse and Quest), the SteamVR runtime install that needs no Steam account or client, and which titles work, including the ones that do not: Half-Life Alyx and The Lab need a real SteamVR backend, No Man's Sky VR is broken through the translation layer, and VRChat/Rec Room/Zenith depend on their companies' servers. Operator reference covers the architecture, the routing decision tree, why per-process XR_RUNTIME_JSON is preferred over the machine-wide registry switch, why OpenVR routing uses a per-game DLL swap, and the staging/import ordering constraint. Both state plainly that only runtime startup has been validated: tracking and per-title rendering are unverified on real hardware.
111 lines
3.6 KiB
JavaScript
111 lines
3.6 KiB
JavaScript
// @ts-check
|
|
import { defineConfig } from "astro/config";
|
|
import starlight from "@astrojs/starlight";
|
|
import starlightThemeRapide from "starlight-theme-rapide";
|
|
// starlightLinksValidator disabled for this deployment: 0.24.1 (the version
|
|
// pinned by the upstream lockfile at the commit we mirror) throws
|
|
// "[AstroUserError] The configured 'markdown.processor' is not supported.
|
|
// Switch to 'unified()'" against astro@7.1.1, an upstream compat bug
|
|
// (reproduces even with upstream's own frozen pnpm-lock.yaml, so this isn't
|
|
// something our link rewrites caused). It's a build-time-only dev checker,
|
|
// not a runtime feature, so dropping it doesn't change the shipped site —
|
|
// just re-enable once upstream bumps past this version.
|
|
// import starlightLinksValidator from "starlight-links-validator";
|
|
import starlightImageZoom from "starlight-image-zoom";
|
|
|
|
// https://astro.build/config
|
|
export default defineConfig({
|
|
integrations: [
|
|
starlight({
|
|
plugins: [
|
|
starlightThemeRapide(),
|
|
// starlightLinksValidator(),
|
|
starlightImageZoom(),
|
|
],
|
|
title: "Drop OSS",
|
|
logo: { src: "./src/assets/wordmark.png", replacesTitle: true },
|
|
tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 4 },
|
|
social: [
|
|
{
|
|
icon: "github",
|
|
label: "GitHub",
|
|
href: "https://devops.quasarke.net/drop-oss/",
|
|
},
|
|
{
|
|
icon: "discord",
|
|
label: "Community",
|
|
href: "https://drop.quasarke.net/community",
|
|
},
|
|
{
|
|
icon: "matrix",
|
|
label: "Matrix",
|
|
href: "https://matrix.to/#/%23drop-oss:matrix.org",
|
|
},
|
|
],
|
|
sidebar: [
|
|
{
|
|
label: "Users",
|
|
items: [
|
|
{ slug: "user" },
|
|
{
|
|
label: "Install",
|
|
items: [{ autogenerate: { directory: "user/install" } }],
|
|
},
|
|
{
|
|
label: "Usage",
|
|
items: [{ slug: "user/usage/proton" }],
|
|
},
|
|
],
|
|
},
|
|
{
|
|
label: "Admin",
|
|
items: [
|
|
{ slug: "admin/quickstart" },
|
|
{ slug: "admin/guides/migrating" },
|
|
{
|
|
label: "Guides",
|
|
items: [
|
|
{ slug: "admin/guides/exposing" },
|
|
{ slug: "admin/guides/creating-library" },
|
|
{ slug: "admin/guides/import-game" },
|
|
{ slug: "admin/guides/import-version" },
|
|
],
|
|
},
|
|
{
|
|
label: "Going further",
|
|
items: [{ autogenerate: { directory: "admin/going-further" } }],
|
|
},
|
|
{
|
|
label: "Metadata",
|
|
items: [{ autogenerate: { directory: "admin/metadata" } }],
|
|
},
|
|
{
|
|
label: "Authentication",
|
|
items: [{ autogenerate: { directory: "admin/authentication" } }],
|
|
},
|
|
],
|
|
},
|
|
{
|
|
label: "Reference",
|
|
items: [{ autogenerate: { directory: "reference" } }],
|
|
},
|
|
{
|
|
label: "Quasarke Edition",
|
|
items: [
|
|
{ slug: "quasarke" },
|
|
{ slug: "quasarke/community" },
|
|
{ slug: "quasarke/client-auth" },
|
|
{ slug: "quasarke/launch-wrapper" },
|
|
{ slug: "quasarke/goldberg" },
|
|
{ slug: "quasarke/vr" },
|
|
{ slug: "quasarke/vr-support" },
|
|
{ slug: "quasarke/known-gaps" },
|
|
],
|
|
},
|
|
],
|
|
customCss: ["./src/styles/drop.css"],
|
|
}),
|
|
],
|
|
site: "https://drop-docs.quasarke.net",
|
|
base: "/docs",
|
|
});
|