Rewrite installation instructions

docs/requirements.txt

@@ -3,3 +3,4 @@ myst-parser
 sphinx>=7.3
 sphinx-copybutton
 sphinxext-opengraph
+sphinx-design

docs/source/conf.py

@@ -51,11 +51,14 @@
     "sphinx.ext.inheritance_diagram",
     "sphinxcontrib.programoutput",
     "myst_parser",
+    "sphinx_design",
 ]
 
 # Automatically generate stub pages when using the .. autosummary directive
 autosummary_generate = True
 
+myst_enable_extensions = ["colon_fence"]
+
 # generate documentation from type hints
 ALIAS_DOCS_DICT = parse_module_attributes()[0]
 autodoc_typehints = "description"

docs/source/faq/installation.md

@@ -120,6 +120,7 @@ of [ManimPango's README](https://github.com/ManimCommunity/ManimPango).
 
 ---
 
+(not-on-path)=
 ## I am using Windows and get the error `X is not recognized as an internal or external command, operable program or batch file`
 
 Regardless of whether `X` says `python` or `manim`, this means that the executable you

docs/source/installation.rst

@@ -61,40 +61,13 @@ The following pages show how to install Manim in a conda environment:
 Installing Manim locally
 ************************
 
-Manim is a Python library, and it can be
-installed via `pip <https://pypi.org/project/manim/>`__
-or `conda <https://anaconda.org/conda-forge/manim/>`__. However,
-in order for Manim to work properly, some additional system
-dependencies need to be installed first. The following pages have
-operating system specific instructions for you to follow.
-
-Manim requires Python version ``3.9`` or above to run.
-
-.. hint::
-
-   Depending on your particular setup, the installation process
-   might be slightly different. Make sure that you have tried to
-   follow the steps on the following pages carefully, but in case
-   you hit a wall we are happy to help: either `join our Discord
-   <https://www.manim.community/discord/>`__, or start a new
-   Discussion `directly on GitHub
-   <https://github.com/ManimCommunity/manim/discussions>`__.
+Check out :doc:`this page <installation/local>` if you want to install Manim
+on your local machine.
 
 .. toctree::
-   :maxdepth: 2
-
-   installation/windows
-   installation/macos
-   installation/linux
-
-Once Manim is installed locally, you can proceed to our
-:doc:`quickstart guide <tutorials/quickstart>` which walks you
-through rendering a first simple scene.
-
-As mentioned above, do not worry if there are errors or other
-problems: consult our :doc:`FAQ section </faq/index>` for help
-(including instructions for how to ask Manim's community for help).
+   :hidden:
 
+   installation/local
 
 
 .. _docker-installation:
@@ -140,6 +113,11 @@ If you're using Visual Studio Code you can install an extension called
 of the animation inside the editor. The extension can be installed through the
 `marketplace of VS Code <https://marketplace.visualstudio.com/items?itemName=Rickaym.manim-sideview>`__.
 
+.. caution::
+
+   This extension is not officially maintained by the Manim Community.
+   If you run into issues, please report them to the extension's author.
+
 
 Installation for developers
 ***************************