[DO NOT MERGE] Redirect ecosystem page (#752)

### Summary

This PR removes the website generation logic and sets up a HTML redirect
to the new ecosystem page. I decided on a HTML redirect as it seems
[`external-sites.json`](https://docs.github.com/en/contributing/writing-for-github-docs/configuring-redirects#configuring-external-redirects)
is actually for GitHub docs contributors, not GitHub pages. From what I
can tell, there's no way to server-side redirect a GitHub pages site.

> [!Caution]
> **Do not merge**
>
> The redirect will take effect immediately after merging. Please do not
merge until the new page is live.

Commit-wise review may be easier.

***

Closes #741

docs/project_overview.md

@@ -44,10 +44,11 @@ class.
 
 ### Webpage
 
-To generate the webpage from the TOML files, run:
+To generate the ecosystem data from the TOML files, run:
 
 ```sh
 tox -e website
 ```
 
-Then open `website/index.html` in your browser. A GitHub action publishes the result of this command on every push to main.
+Then open `website/ecosystem.json`. A GitHub action publishes the result of this command on every push to main.
+This command also generates `website/index.html`, which is HTML file that redirects to the ecosystem page. This is needed because we used to host the ecosystem page on GitHub pages.

ecosystem/cli/website.py

@@ -1,162 +1,33 @@
 """CliWebsite class for controlling all CLI functions."""
-from __future__ import annotations
 
+from __future__ import annotations
 
-from pathlib import Path
-from typing import Any
-import json
 import re
-import toml
-
-from jinja2 import Environment, PackageLoader, Template
-
-from ecosystem.daos import DAO
-from ecosystem.models.repository import Repository
-
-
-def build_website(resources: str, output: str) -> None:
-    """
-    Generates the ecosystem web page from data in `resources` dir, writing to `output` dir.
-    """
-    html, css = build_website_strings(resources)
-    Path(output).write_text(html)
-    (Path(output).parent / "style.css").write_text(css)
-
+from pathlib import Path
 
-def build_website_strings(resources: str) -> tuple[str, str]:
-    """
-    Generates the ecosystem web page and css from data in `resources` dir.
-    """
-    projects, web_data, label_descriptions, templates, custom_css = _load_from_file(
-        Path(resources)
-    )
-    html = _build_html(projects, web_data, label_descriptions, templates)
-    css = templates["css"].render(
-        custom_css=custom_css, standalone=web_data.get("standalone", True)
-    )
-    return html, css
+NEW_URL = "https://ibm.com/quantum/ecosystem"
 
 
-def _load_from_file(
-    resources_dir: Path,
-) -> tuple[
-    list[Repository], dict[str, Any], dict[str, str], dict[str, Template], str | None
-]:
+def build_website(output: str) -> None:
     """
-    Loads website data from file.
-    Returns:
-        * Projects: List of Repository objects from `members` folder.
-        * Web data: Strings (title / descriptions etc.) from `website.toml`.
-        * Label descriptions: from `labels.json`.
-        * Jinja templates: from `html_templates` folder.
-        * Any custom css to be appended to the css file.
+    Generates a HTML redirect to the new ecosystem web page.
     """
-    # Projects list
-    dao = DAO(path=resources_dir)
-    projects = sorted(
-        dao.get_all(),
-        key=lambda item: (
-            -(item.stars or 0),
-            item.name,
-        ),
-    )
-
-    # Label descriptions: We flatten the dict to the form { label_name: description }
-    label_descriptions = {}
-    for category in json.loads((resources_dir / "labels.json").read_text()).values():
-        for label in category:
-            label_descriptions[label["name"]] = label["description"]
-    label_descriptions["IBM maintained"] = "Officially maintained by IBM Quantum"
-
-    # Website strings
-    web_data = toml.loads((resources_dir / "website.toml").read_text())
-
-    # Custom css
-    custom_css = None
-    if web_data.get("custom-css", False):
-        custom_css = (resources_dir / web_data["custom-css"]).read_text()
-
-    # Jinja templates
-    environment = Environment(loader=PackageLoader("ecosystem", "html_templates/"))
-    templates = {
-        "website": environment.get_template("webpage.html.jinja"),
-        "card": environment.get_template("card.html.jinja"),
-        "tag": environment.get_template("tag.html.jinja"),
-        "link": environment.get_template("link.html.jinja"),
-        "css": environment.get_template("style.css.jinja"),
-    }
-    return projects, web_data, label_descriptions, templates, custom_css
-
-
-def _build_html(projects, web_data, label_descriptions, templates) -> str:
-    """
-    Take all data needed to build the website and produce a HTML string.
+    html = f"""
+    <!DOCTYPE HTML>
+    <html lang="en-US">
+        <head>
+            <meta charset="UTF-8">
+            <meta http-equiv="refresh" content="0; url={NEW_URL}">
+            <script type="text/javascript">
+                window.location.href = "{NEW_URL}"
+            </script>
+            <title>Qiskit ecosystem</title>
+        </head>
+        <body>
+            If you are not redirected automatically, go to <a href="{NEW_URL}">{NEW_URL}</a>.
+        </body>
+    </html>
     """
-    # pylint: disable=too-many-locals
-    sections = {group["id"]: group for group in web_data["groups"]}
-    for section in sections.values():
-        section.setdefault("html", "")
-
-    max_chars_description_visible = 400
-    min_chars_description_hidden = 100
-    count_read_more = 1
-    for repo in projects:
-        if repo.ibm_maintained:
-            repo.labels.append("IBM maintained")
-        # Card tags
-        tags = ""
-        for index, label in enumerate(repo.labels):
-            tags += templates["tag"].render(
-                color="purple",
-                text=label,
-                tooltip=label_descriptions[label],
-                # Sometimes tooltips are clipped by the browser window.
-                # While not perfect, the following line solves 95% of cases
-                alignment="bottom" if (index % 3) == 2 else "bottom-left",
-            )
-
-        # Card links
-        links = ""
-        for url, link_text in (
-            (repo.url, "repository"),
-            (repo.website, "website"),
-            (repo.reference_paper, "paper"),
-            (repo.documentation, "documentation"),
-        ):
-            if url:
-                links += templates["link"].render(url=url, place=link_text)
-
-        # Card description
-        if (
-            len(repo.description) - max_chars_description_visible
-            >= min_chars_description_hidden
-        ):
-            description = [
-                repo.description[:max_chars_description_visible],
-                repo.description[max_chars_description_visible:],
-            ]
-            id_read_more = str(count_read_more)
-            count_read_more += 1
-        else:
-            description = [repo.description, ""]
-            id_read_more = "None"
-
-        # Create the card
-        card = templates["card"].render(
-            title=repo.name,
-            tags=tags,
-            description_visible=description[0],
-            description_hidden=description[1],
-            id_read_more=id_read_more,
-            links=links,
-        )
-
-        # Adding the card to a section
-        sections[repo.group]["html"] += card
-
-    html = templates["website"].render(
-        is_standalone=web_data.get("standalone", True),
-        header=web_data["header"],
-        sections=sections.values(),
-    )
-    return re.sub(r"^\s+", "", html, flags=re.MULTILINE)
+    html = re.sub(r"\n\s*", "", html)
+    Path(output).parent.mkdir(parents=True, exist_ok=True)
+    Path(output).write_text(html)