Switch to env var for spec url

Foorack · Foorack · commit de2ecc5c7ed9 · 2021-10-16T14:09:23.000+02:00
diff --git a/content/tutorials/contribute-api.markdown b/content/tutorials/contribute-api.markdown
@@ -127,12 +127,21 @@ npm install -g http-server
 
 # Start it in the "dist/" folder
 # The "--cors" part at the end allows the website on port 1313 to reach the spec on the different port 8080.
-http-server dist/ --cors 
+http-server dist/ --cors
 ```
 
-Your version of the specification is now available at `http://localhost:8080/openapi.yaml`. Switch VSCode window to the website project and modify the `spec-url` URL at the top of the `layouts/docs/single.html` file to point to this file instead.
+Your version of the specification is now available at `http://localhost:8080/openapi.yaml`. Switch VSCode window to the website project and restart the hugo server with the following command:
 
-(Note: The API Docs will not automatically reload if you re-bundle the API spec.)
+```bash
+# Windows cmd.exe
+set SPEC_URL=http://localhost:8080/openapi.yaml
+./hugo.exe server
+
+# Linux or Git Bash
+SPEC_URL=http://localhost:8080/openapi.yaml ./hugo server
+```
+
+(Note: The API Docs will **not** automatically reload if you re-bundle the API spec.)
 
 ![](/assets/img/tutorials/contribute-api/result.png)
 
diff --git a/layouts/docs/single.html b/layouts/docs/single.html
@@ -3,7 +3,7 @@
 
 <rapi-doc
     id="rapi-doc"
-    spec-url="https://vrchatapi.github.io/specification/openapi.yaml"
+    spec-url={{ getenv "SPEC_URL" | default "https://vrchatapi.github.io/specification/openapi.yaml" }}
     sort-endpoints-by = "none"
 
     theme = "light"
