[Docs] Move docs requirements to docs/requirements.txt to make compatible with pypi (#718)

Author: oulgen

.github/workflows/docs-deploy.yml

@@ -46,9 +46,10 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-docs-
 
-      - name: Install project with docs dependencies
+      - name: Install docs requirements and project
         run: |
-          pip install -e ".[docs]"
+          pip install -r docs/requirements.txt
+          pip install -e .
 
       - name: Setup Pages
         uses: actions/configure-pages@v5

.github/workflows/docs-test.yml

@@ -34,9 +34,10 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-docs-
 
-      - name: Install project with docs dependencies
+      - name: Install docs requirements and project
         run: |
-          pip install -e ".[docs]"
+          pip install -r docs/requirements.txt
+          pip install -e .
 
       - name: Build documentation
         run: |

docs/requirements.txt

@@ -0,0 +1,14 @@
+sphinx==7.2.6
+pytorch_sphinx_theme2 @ git+https://github.com/pytorch/pytorch_sphinx_theme.git@pytorch_sphinx_theme2#egg=pytorch_sphinx_theme2
+sphinxcontrib.katex==0.9.10
+docutils==0.18.1,<0.21
+sphinx-design==0.6.1
+sphinxcontrib-mermaid==1.0.0
+myst-parser
+sphinx-gallery==0.14.0
+sphinx-sitemap==2.7.1
+sphinx-autodoc-typehints
+linkify-it-py
+sphinx-autobuild
+sphinxext-opengraph
+pillow

pyproject.toml

@@ -28,22 +28,6 @@ dev = [
     "pytest",
     "pre-commit"
 ]
-docs = [
-    "sphinx==7.2.6",
-    "pytorch_sphinx_theme2 @ git+https://github.com/pytorch/pytorch_sphinx_theme.git@pytorch_sphinx_theme2#egg=pytorch_sphinx_theme2",
-    "sphinxcontrib.katex==0.9.10",
-    "docutils==0.18.1,<0.21",
-    "sphinx-design==0.6.1",
-    "sphinxcontrib-mermaid==1.0.0",
-    "myst-parser",
-    "sphinx-gallery==0.14.0",
-    "sphinx-sitemap==2.7.1",
-    "sphinx-autodoc-typehints",
-    "linkify-it-py",
-    "sphinx-autobuild",
-    "sphinxext-opengraph",
-    "pillow",
-]
 
 [project.urls]
 Homepage = "https://github.com/pytorch/helion"