ci/rtfd: building both fast docs on PR (#18738)

Borda · web-flow · commit 0777aab31e07 · 2023-10-07T11:57:50.000+02:00
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -39,12 +39,15 @@ build:
   commands:
     - printenv
     - pwd ; ls -lh
-    - pip install -U pip awscli --user
+    - pip install -U pip awscli py-tree --user
     - python -m awscli s3 sync --no-sign-request s3://sphinx-packages/ dist/ ; ls -lh dist/
     - >
-      pip install -e . -q -r requirements/pytorch/docs.txt -r _notebooks/.actions/requires.txt \
+      pip install -e . -q -r _notebooks/.actions/requires.txt \
+          -r requirements/fabric/docs.txt \
+          -r requirements/pytorch/docs.txt \
           -f 'https://download.pytorch.org/whl/cpu/torch_stable.html' -f dist/ ;
       pip list
     # this need to be split so `sphinx-build` is picked from previous installation
     - bash docs/rtfd-build.sh
-    - mkdir -p _readthedocs ; mv docs/build/html _readthedocs/html
+    - cd docs/build ; python -m py_tree --depth_limit=1
+    - mkdir -p _readthedocs ; mv docs/build _readthedocs/html
diff --git a/docs/crossroad.html b/docs/crossroad.html
@@ -0,0 +1,15 @@
+<!doctype html>
+<html>
+  <head>
+    <title>RTFD cross-road</title>
+    <style>
+      body {
+        text-align: center;
+      }
+    </style>
+  </head>
+  <body>
+    <a href="fabric/"><button>Fabric</button></a>
+    <a href="pytorch/"><button>PyTorch</button></a>
+  </body>
+</html>
diff --git a/docs/rtfd-build.sh b/docs/rtfd-build.sh
@@ -2,12 +2,23 @@
 
 if ! [ $READTHEDOCS_VERSION == "latest" -o $READTHEDOCS_VERSION == "stable" ];
 then
-    cd ./docs/source-pytorch ;
     export FAST_DOCS_DEV=1 ;
-    make html --jobs  $(nproc) ;
-    ls -lh ../build
+    root=$(pwd) ;
+    # build Fabric
+    cd $root/docs/source-fabric ;
+    make html --jobs $(nproc) ;
+    cd $root/docs ;
+    mv build/html build/fabric ;
+    # build PyTorch
+    cd $root/docs/source-pytorch ;
+    make html --jobs $(nproc) ;
+    cd $root/docs ;
+    mv build/html build/pytorch ;
+    # cross-road
+    rm -rf build/doctrees ;
+    cp crossroad.html build/index.html
 else
     echo "Void build... :-]" ;
-    mkdir -p ./docs/build/html
-    cp ./docs/redirect.html ./docs/build/html/index.html
+    mkdir -p ./docs/build
+    cp ./docs/redirect.html ./docs/build/index.html
 fi
