From 83effbc323984256d6a8ebfb0f9423771af6ab12 Mon Sep 17 00:00:00 2001
From: Woojoong Kim <woojoong.kim@intel.com>
Date: Mon, 18 Nov 2024 21:38:23 -0800
Subject: [PATCH] fix subdoc

---
 .github/workflows/publish.yml |  3 +++
 Makefile                      | 14 +++++++++++---
 conf.py                       |  2 +-
 hw_install_index.rst          | 16 ++++++++--------
 index.rst                     | 36 +++++++++++++++++------------------
 5 files changed, 41 insertions(+), 30 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index fe7e90c..5f4cbed 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -133,6 +133,9 @@ jobs:
         with:
           python-version: 3.11
 
+      - name: Build docs
+        run: make html
+
       - name: Build docs
         run: make multiversion
 
diff --git a/Makefile b/Makefile
index ebb3914..5ad9d2f 100644
--- a/Makefile
+++ b/Makefile
@@ -65,6 +65,7 @@ clean-all: clean
 # checkout the repos inside repos/ dir
 repos:
 	mkdir repos
+	mkdir -p subdocs
 
 # build directory paths in repos/* to perform 'git clone <repo>' into
 CHECKOUT_REPOS   = $(foreach repo,$(OTHER_REPO_DOCS),repos/$(repo))
@@ -107,9 +108,16 @@ prep: | $(OTHER_REPO_DOCS)
 
 # build multiple versions
 multiversion: $(VENV_NAME) Makefile | prep $(OTHER_REPO_DOCS)
-	source $</bin/activate ; set -u ;\
-  sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/multiversion" $(SPHINXOPTS)
-	cp "$(SOURCEDIR)/_templates/meta_refresh.html" "$(BUILDDIR)/multiversion/index.html"
+#	source $</bin/activate ; set -u ;\
+#  	sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/multiversion" $(SPHINXOPTS)
+#	cp "$(SOURCEDIR)/_templates/meta_refresh.html" "$(BUILDDIR)/multiversion/index.html"
+	for i in $$(ls -d $(BUILDDIR)/multiversion/*/); \
+	do \
+		for j in $$(echo $(OTHER_REPO_DOCS)); \
+		do \
+			cp -R $$j $$i; \
+		done; \
+  	done
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
diff --git a/conf.py b/conf.py
index ade5f52..40372a3 100644
--- a/conf.py
+++ b/conf.py
@@ -45,7 +45,7 @@ def get_version():
 # needs_sphinx = '1.0'
 
 # make all warnings errors
-warning_is_error = True
+warning_is_error = False
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
diff --git a/hw_install_index.rst b/hw_install_index.rst
index 8a3382b..bd2b837 100644
--- a/hw_install_index.rst
+++ b/hw_install_index.rst
@@ -10,12 +10,12 @@ Hardware Installation
    :hidden:
    :caption: Hardware Installation
 
-   sdran-in-a-box/docs/HW_Installation_intro
-   sdran-in-a-box/docs/HW_Installation_prereq
-   sdran-in-a-box/docs/HW_Installation_omec
-   sdran-in-a-box/docs/HW_Installation_ric
-   sdran-in-a-box/docs/HW_Installation_oai_enb
-   sdran-in-a-box/docs/HW_Installation_oai_ue
-   sdran-in-a-box/docs/HW_Installation_ops
-   sdran-in-a-box/docs/HW_Installation_troubleshooting
+   subdocs/sdran-in-a-box/docs/HW_Installation_intro
+   subdocs/sdran-in-a-box/docs/HW_Installation_prereq
+   subdocs/sdran-in-a-box/docs/HW_Installation_omec
+   subdocs/sdran-in-a-box/docs/HW_Installation_ric
+   subdocs/sdran-in-a-box/docs/HW_Installation_oai_enb
+   subdocs/sdran-in-a-box/docs/HW_Installation_oai_ue
+   subdocs/sdran-in-a-box/docs/HW_Installation_ops
+   subdocs/sdran-in-a-box/docs/HW_Installation_troubleshooting
 
diff --git a/index.rst b/index.rst
index be845be..fddc469 100644
--- a/index.rst
+++ b/index.rst
@@ -31,24 +31,24 @@ can be found on the `ONF Wiki <https://wiki.opennetworking.org/>`_.
    :hidden:
    :caption: Components
 
-   repos/onos-api/README
-   repos/onos-ric-sdk-go/README
-   repos/onos-operator/README
-   repos/onos-e2t/README
-   repos/onos-a1t/README
-   repos/onos-e2-sm/README
-   repos/onos-kpimon/README
-   repos/onos-pci/README
-   repos/onos-config/README
-   repos/onos-topo/README
-   repos/onos-uenib/README
-   repos/onos-proxy/README
-   repos/onos-cli/README
-   repos/onos-exporter/README
-   repos/onos-mlb/README
-   repos/onos-mho/README
-   repos/onos-rsm/README
-   repos/ran-simulator/README
+   subdocs/onos-api/README
+   subdocs/onos-ric-sdk-go/README
+   subdocs/onos-operator/README
+   subdocs/onos-e2t/README
+   subdocs/onos-a1t/README
+   subdocs/onos-e2-sm/README
+   subdocs/onos-kpimon/README
+   subdocs/onos-pci/README
+   subdocs/onos-config/README
+   subdocs/onos-topo/README
+   subdocs/onos-uenib/README
+   subdocs/onos-proxy/README
+   subdocs/onos-cli/README
+   subdocs/onos-exporter/README
+   subdocs/onos-mlb/README
+   subdocs/onos-mho/README
+   subdocs/onos-rsm/README
+   subdocs/ran-simulator/README
    oai_cu_cp
 
 .. toctree::