docs: finishing touches for the cloudsite docs pipeline (#71)

* add a new envvar for cloudsite docs pipeline
* modify sys.path for the new plugin

.kokoro/docs/common.cfg

@@ -29,6 +29,11 @@ env_vars: {
     value: "docs-staging"
 }
 
+env_vars: {
+    key: "V2_STAGING_BUCKET"
+    value: "docs-staging-v2-staging"
+}
+
 # It will upload the docker image after successful builds.
 env_vars: {
     key: "TRAMPOLINE_IMAGE_UPLOAD"

.kokoro/publish-docs.sh

@@ -62,4 +62,4 @@ python3 -m docuploader create-metadata \
 cat docs.metadata
 
 # upload docs
-python3 -m docuploader upload docs/_build/html/docfx_yaml --metadata-file docs.metadata --destination-prefix docfx --staging-bucket "${STAGING_BUCKET}"
+python3 -m docuploader upload docs/_build/html/docfx_yaml --metadata-file docs.metadata --destination-prefix docfx --staging-bucket "${V2_STAGING_BUCKET}"

.trampolinerc

@@ -17,11 +17,13 @@
 # Add required env vars here.
 required_envvars+=(
     "STAGING_BUCKET"
+    "V2_STAGING_BUCKET"
 )
 
 # Add env vars which are passed down into the container here.
 pass_down_envvars+=(
     "STAGING_BUCKET"
+    "V2_STAGING_BUCKET"
 )
 
 # Prevent unintentional override on the default image.

docs/conf.py

@@ -20,6 +20,10 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 sys.path.insert(0, os.path.abspath(".."))
 
+# For plugins that can not read conf.py.
+sys.path.insert(0, os.path.abspath("."))
+
+
 __version__ = ""
 
 # -- General configuration ------------------------------------------------