.. _sardana-other-versions:

================================
Docs for other Sardana versions
================================

This page links to built documentation for recent Sardana releases.

* `develop <https://sardana.readthedocs.io/en/develop/>`__
* `3.7.1 (2026-09-22) <https://sardana-org.gitlab.io/-/sardana/-/jobs/16658285027/artifacts/public/index.html>`__
* `3.7.0 (2026-05-13) <https://sardana-org.gitlab.io/-/sardana/-/jobs/14349044449/artifacts/public/index.html>`__
* `3.6.0 (2025-09-04) <https://sardana-org.gitlab.io/-/sardana/-/jobs/11243941297/artifacts/public/index.html>`__
* `3.5.2 (2025-04-08) <https://sardana-org.gitlab.io/-/sardana/-/jobs/9659035103/artifacts/public/index.html>`__
* `3.5.1 (2025-02-17) <https://sardana-org.gitlab.io/-/sardana/-/jobs/9158495554/artifacts/public/index.html>`__
* `3.5.0 (2024-06-26) <https://sardana-org.gitlab.io/-/sardana/-/jobs/7190417255/artifacts/public/index.html>`__
* `3.4.4 (2024-03-20) <https://sardana-org.gitlab.io/-/sardana/-/jobs/6440318575/artifacts/public/index.html>`__
* `3.4.3 (2023-11-16) <https://sardana-org.gitlab.io/-/sardana/-/jobs/5569707571/artifacts/public/index.html>`__
* `3.4.2 (2023-09-01) <https://sardana-org.gitlab.io/-/sardana/-/jobs/4996409755/artifacts/public/index.html>`__
* `3.4.1 (2023-08-30) <https://sardana-org.gitlab.io/-/sardana/-/jobs/4982294362/artifacts/public/index.html>`__
* `3.4.0 (2023-04-06) <https://sardana-org.gitlab.io/-/sardana/-/jobs/4478930943/artifacts/public/index.html>`__


Select a version to show its documentation URL:

.. raw:: html

    <form class="other-versions-selector">
      <label for="sardana-other-version">Sardana version</label>
      <select id="sardana-other-version" name="sardana-other-version">
        <option value="">Select a version...</option>
        <option value="develop">develop</option>
        <option value="3.7.1">3.7.1</option>
        <option value="3.7.0">3.7.0</option>
        <option value="3.6.0">3.6.0</option>
        <option value="3.5.2">3.5.2</option>
        <option value="3.5.1">3.5.1</option>
        <option value="3.5.0">3.5.0</option>
        <option value="3.4.4">3.4.4</option>
        <option value="3.4.3">3.4.3</option>
        <option value="3.4.2">3.4.2</option>
        <option value="3.4.1">3.4.1</option>
        <option value="3.4.0">3.4.0</option>
        <option value="3.3.8">3.3.8</option>
        <option value="3.3.7">3.3.7</option>
        <option value="3.3.6">3.3.6</option>
        <option value="3.3.5">3.3.5</option>
        <option value="3.3.4">3.3.4</option>
        <option value="3.3.3">3.3.3</option>
        <option value="3.2.1">3.2.1</option>
        <option value="3.2.0">3.2.0</option>
        <option value="2.4.0">2.4.0</option>
        <option value="1.6.2">1.6.2</option>
      </select>
    </form>
    <p>
      <a id="sardana-other-version-url" href=""></a>
    </p>
    <script>
      document.getElementById("sardana-other-version").addEventListener(
        "change",
        function () {
          const urlElement = document.getElementById(
            "sardana-other-version-url"
          );
          if (!this.value) {
            urlElement.removeAttribute("href");
            urlElement.textContent = "";
            return;
          }
          if (this.value === "develop") {
            const url = "https://sardana.readthedocs.io/en/develop/";
            urlElement.href = url;
            urlElement.textContent = url;
            return;
          }          
          const parts = this.value.split(".").map(Number);
          const hasArtifactDocs = (
            parts[0] > 3 ||
            (parts[0] === 3 && parts[1] > 2) ||
            (parts[0] === 3 && parts[1] === 2 && parts[2] >= 0)
          );
          if (hasArtifactDocs) {
            const url = (
              "https://gitlab.com/sardana-org/sardana/-/jobs/artifacts/REF" +
              "/file/public/index.html?job=build-doc"
            ).replace(
              "REF",
              encodeURIComponent(this.value)
            );
            urlElement.href = url;
            urlElement.textContent = url;
            return;
          }
          if (this.value === "2.4.0") {
            const url = "https://sardana.readthedocs.io/en/latest/docs.html";
            urlElement.href = url;
            urlElement.textContent = url;
            return;
          }
          if (this.value === "1.6.2") {
            const url = "https://sardana.readthedocs.io/en/1.6.2/docs.html";
            urlElement.href = url;
            urlElement.textContent = url;
            return;
          }
          urlElement.removeAttribute("href");
          urlElement.textContent = "Documentation is unavailable.";
        }
      );
    </script>