Part of #154
This PR, following the idea of this
[comment](https://github.com/Qiskit/documentation/issues/154#issuecomment-2104751884),
moves all the images in the folders `start`, `build`, `transpile`,
`verify`, and `run` to a new folder called `guides`, updating all the
docs to point to that new folder.
To change the links, I used the following script that updates all but 3
links that are missed by the regex. I changed them manually.
<details>
<summary>Script</summary>
```python
from __future__ import annotations
import re
import glob
from pathlib import Path
from main import OLD_FOLDERS
def update_link(markdown: str, image_folder: str, link: str) -> str:
new_link = link.replace(f"/images/{image_folder}/", "/images/guides/")
return markdown.replace(link, new_link)
def main() -> None:
inline_link_re = re.compile(r"\!\[([^\]]+)\]\(([^)]+)\)")
for folder in [*OLD_FOLDERS, "api/migration-guides"]:
image_folder = folder if folder != "api/migration-guides" else "run"
for file_path in glob.glob(f"docs/{folder}/*"):
file = Path(file_path)
markdown = file.read_text()
new_markdown = re.sub(
inline_link_re,
lambda m: update_link(m[0], image_folder, m[2]),
markdown,
)
if markdown != new_markdown:
file.write_text(new_markdown)
if __name__ == "__main__":
main()
```
</details>
679617cc5d
