fix internal links

Signed-off-by: Shubham Kumar <chmodshubham@gmail.com>

Author: chmodshubham

.github/workflows/deploy-docs.yml

@@ -63,10 +63,8 @@ jobs:
     - name: Add .nojekyll file and create index.html
       run: |
         touch _build/html/.nojekyll
-        # Create index.html from the main index file for GitHub Pages
-        if [ -f "_build/html/index" ]; then
-          cp _build/html/index _build/html/index.html
-        fi
+        # Create index.html files for all directories
+        find _build/html -name "index" -type f -exec sh -c 'cp "$1" "${1%index}index.html"' _ {} \;
         
     - name: Verify build output
       run: |

Makefile

@@ -38,7 +38,8 @@ html:
 html-github:
 	. $(VENV); export GITHUB_ACTIONS=true; $(SPHINXBUILD) -c . -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)" -w .sphinx/warnings.txt --keep-going
 	touch "$(BUILDDIR)/.nojekyll"
-	if [ -f "$(BUILDDIR)/index" ]; then cp "$(BUILDDIR)/index" "$(BUILDDIR)/index.html"; fi
+	# Create index.html files for all directories
+	find "$(BUILDDIR)" -name "index" -type f -exec sh -c 'cp "$$1" "$${1%index}index.html"' _ {} \;
 
 epub:
 	. $(VENV); $(SPHINXBUILD) -c . -b epub "$(SOURCEDIR)" "$(BUILDDIR)" -w .sphinx/warnings.txt