From 88698067ac51e9546ec7c35c1df62fb50e902b24 Mon Sep 17 00:00:00 2001
From: Cristian Le <cristian.le@mpsd.mpg.de>
Date: Mon, 18 Mar 2024 10:19:27 +0100
Subject: [PATCH 1/2] Use `READTHEDOCS_CANONICAL_URL` as baseurl if defined

Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
---
 packages/myst-cli/src/build/html/index.ts | 34 +++++++++++++++++++----
 1 file changed, 28 insertions(+), 6 deletions(-)

diff --git a/packages/myst-cli/src/build/html/index.ts b/packages/myst-cli/src/build/html/index.ts
index 3d5277445..ac211fb28 100644
--- a/packages/myst-cli/src/build/html/index.ts
+++ b/packages/myst-cli/src/build/html/index.ts
@@ -81,22 +81,44 @@ function rewriteAssetsFolder(directory: string, baseurl?: string): void {
 }
 
 /**
- * Build a MyST project as a static HTML deployment
+ * Get the baseurl from BASE_URL or common deployment environments
  *
  * @param session session with logging
- * @param opts configuration options
  */
-export async function buildHtml(session: ISession, opts: any) {
-  const template = await getMystTemplate(session, opts);
-  // The BASE_URL env variable allows for mounting the site in a folder, e.g., github pages
-  const baseurl = process.env.BASE_URL;
+function get_baseurl(session: ISession): string | undefined {
+  let baseurl;
+  // BASE_URL always takes precedence. If it's not defined, check common deployment environments.
+  if ((baseurl = process.env.BASE_URL)) {
+    session.log.info('BASE_URL environment overwrite is set');
+  } else if ((baseurl = process.env.READTHEDOCS_CANONICAL_URL)) {
+    // Get only the path part of the RTD url, without trailing `/`
+    baseurl = new URL(baseurl).pathname.replace(/\/$/, '');
+    session.log.info(
+      `Building inside a ReadTheDocs environment for ${process.env.READTHEDOCS_CANONICAL_URL}`,
+    );
+  }
+  // Check if baseurl was set to any value, otherwise print a hint on how to set it manually.
   if (baseurl) {
     session.log.info(`Building the site with a baseurl of "${baseurl}"`);
   } else {
+    // The user should only use `BASE_URL` to set the value manually.
     session.log.info(
       'Building the base site.\nTo set a baseurl (e.g. GitHub pages) use "BASE_URL" environment variable.',
     );
   }
+  return baseurl;
+}
+
+/**
+ * Build a MyST project as a static HTML deployment
+ *
+ * @param session session with logging
+ * @param opts configuration options
+ */
+export async function buildHtml(session: ISession, opts: any) {
+  const template = await getMystTemplate(session, opts);
+  // The BASE_URL env variable allows for mounting the site in a folder, e.g., github pages
+  const baseurl = get_baseurl(session);
   // Note, this process is really only for Remix templates
   // We could add a flag in the future for other templates
   const htmlDir = path.join(session.buildPath(), 'html');

From 113569163d4514bd07f35388be377c463afe5fa1 Mon Sep 17 00:00:00 2001
From: Rowan Cockett <rowanc1@gmail.com>
Date: Wed, 17 Apr 2024 10:44:51 -0600
Subject: [PATCH 2/2] Add changeset

---
 .changeset/wet-buttons-heal.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/wet-buttons-heal.md

diff --git a/.changeset/wet-buttons-heal.md b/.changeset/wet-buttons-heal.md
new file mode 100644
index 000000000..2b289eedd
--- /dev/null
+++ b/.changeset/wet-buttons-heal.md
@@ -0,0 +1,5 @@
+---
+"myst-cli": patch
+---
+
+Use READTHEDOCS_CANONICAL_URL as baseurl if defined