Revert PRs 5 and 6 (omec-project#87)

Signed-off-by: Arrobo, Gabriel <gabriel.arrobo@intel.com>

Author: gab-arrobo

Makefile

@@ -1,4 +1,3 @@
-# SPDX-FileCopyrightText: 2026 Intel Corporation
 # SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
 # SPDX-License-Identifier: Apache-2.0
 
@@ -16,19 +15,7 @@ BUILDDIR     ?= _build
 # name of python virtualenv that is used to run commands
 VENV_NAME      := venv-docs
 
-# Git repository information for versioning
-GIT_BRANCH     := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
-GIT_TAG        := $(shell git describe --tags --exact-match 2>/dev/null || echo "")
-VERSION_TAGS   := $(shell git tag --sort=-version:refname | head -3)
-
-# Temporary directory for git worktrees
-WORKTREE_DIR   := $(BUILDDIR)/worktrees
-
-# Use variable for file location
-VERSION_INDEX_TEMPLATE = _templates/version_index.html
-
-.PHONY: help Makefile test doc8 dict-check sort-dict license clean clean-all \
-        multiversion add-nojekyll create-version-index version-info clean-worktrees
+.PHONY: help Makefile test doc8 dict-check sort-dict license clean clean-all
 
 # Put it first so that "make" without argument is like "make help".
 help: $(VENV_NAME)
@@ -71,106 +58,11 @@ clean:
 clean-all: clean
 	rm -rf $(VENV_NAME)
 
-# Clean up git worktrees
-clean-worktrees:
-	@echo "Cleaning up git worktrees..."
-	@if [ -d "$(WORKTREE_DIR)" ]; then \
-		for worktree in $(WORKTREE_DIR)/*; do \
-			if [ -d "$$worktree" ]; then \
-				echo "Removing worktree: $$worktree" ;\
-				git worktree remove "$$worktree" 2>/dev/null || rm -rf "$$worktree" ;\
-			fi ;\
-		done ;\
-		rmdir "$(WORKTREE_DIR)" 2>/dev/null || true ;\
-	fi
-
-# Ensure .nojekyll file exists for GitHub Pages
-add-nojekyll:
-	@echo "Adding .nojekyll file for GitHub Pages..."
-	@if [ -d "$(BUILDDIR)/html" ]; then \
-		touch "$(BUILDDIR)/html/.nojekyll"; \
-		echo "Created .nojekyll in $(BUILDDIR)/html/"; \
-	fi
-	@if [ -d "$(BUILDDIR)/multiversion" ]; then \
-		touch "$(BUILDDIR)/multiversion/.nojekyll"; \
-		echo "Created .nojekyll in $(BUILDDIR)/multiversion/"; \
-	fi
-
-# Build single version (current branch/tag)
-build: $(VENV_NAME) Makefile
-	source $</bin/activate ; set -u ;\
-	$(SPHINXBUILD) -b html "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS)
-	$(MAKE) add-nojekyll
-	@echo "Documentation built successfully!"
-	@echo "Open $(BUILDDIR)/html/index.html in your browser"
-
-# Build multiple versions
-multiversion: $(VENV_NAME) Makefile clean-worktrees
-	@echo "Building multi-version documentation..."
-	@echo "Current branch: $(GIT_BRANCH)"
-	@echo "Available tags: $(VERSION_TAGS)"
-	rm -rf "$(BUILDDIR)/multiversion"
-	mkdir -p "$(BUILDDIR)/multiversion"
-	mkdir -p "$(WORKTREE_DIR)"
-	@echo "Building latest version from current working directory..."
+# build multiple versions
+multiversion: $(VENV_NAME) Makefile
 	source $</bin/activate ; set -u ;\
-	$(SPHINXBUILD) -b html "$(SOURCEDIR)" "$(BUILDDIR)/multiversion/latest" $(SPHINXOPTS)
-	@if [ -n "$(VERSION_TAGS)" ]; then \
-		for tag in $(VERSION_TAGS); do \
-			echo "Building documentation for tag: $$tag using git worktree..." ;\
-			worktree_path="$(WORKTREE_DIR)/$$tag" ;\
-			if git worktree add "$$worktree_path" "$$tag" 2>/dev/null; then \
-				echo "Created worktree for $$tag at $$worktree_path" ;\
-				source $</bin/activate ; set -u ;\
-				$(SPHINXBUILD) -b html "$$worktree_path" "$(BUILDDIR)/multiversion/$$tag" $(SPHINXOPTS) || echo "Warning: Failed to build $$tag" ;\
-				git worktree remove "$$worktree_path" 2>/dev/null || echo "Warning: Failed to remove worktree $$worktree_path" ;\
-			else \
-				echo "Warning: Could not create worktree for tag $$tag" ;\
-			fi ;\
-		done ;\
-	else \
-		echo "No version tags found, building only latest version" ;\
-	fi
-	$(MAKE) create-version-index
-	$(MAKE) add-nojekyll
-	$(MAKE) clean-worktrees
-	@echo "Multi-version documentation built successfully!"
-	@echo "Open $(BUILDDIR)/multiversion/index.html in your browser"
-
-# Create version selection index page
-create-version-index:
-	@echo "Creating version index page..."
-	@mkdir -p "$(BUILDDIR)/multiversion"
-	@if [ ! -f "$(VERSION_INDEX_TEMPLATE)" ]; then \
-		echo "Error: Template file $(VERSION_INDEX_TEMPLATE) not found"; \
-		exit 1; \
-	fi
-	@cp "$(VERSION_INDEX_TEMPLATE)" "$(BUILDDIR)/multiversion/index.html"
-	@if [ -n "$(VERSION_TAGS)" ]; then \
-		version_cards="" ;\
-		for tag in $(VERSION_TAGS); do \
-			version_cards="$$version_cards        <a href=\"$$tag/\" class=\"version-card\">"$$'\n' ;\
-			version_cards="$$version_cards            <div class=\"version-title\">$$tag</div>"$$'\n' ;\
-			version_cards="$$version_cards            <div class=\"version-desc\">Release $$tag documentation</div>"$$'\n' ;\
-			version_cards="$$version_cards        </a>"$$'\n' ;\
-		done ;\
-		sed -i.bak "s|{{VERSION_CARDS}}|$$version_cards|g" "$(BUILDDIR)/multiversion/index.html" ;\
-		rm -f "$(BUILDDIR)/multiversion/index.html.bak" ;\
-	else \
-		sed -i.bak "s|{{VERSION_CARDS}}||g" "$(BUILDDIR)/multiversion/index.html" ;\
-		rm -f "$(BUILDDIR)/multiversion/index.html.bak" ;\
-	fi
-
-# Show current version information
-version-info:
-	@echo "=== Version Information ==="
-	@echo "Git Branch: $(GIT_BRANCH)"
-	@echo "Git Tag: $(GIT_TAG)"
-	@echo "Recent Tags: $(VERSION_TAGS)"
-	@if [ -f "VERSION" ]; then echo "Version File: $$(cat VERSION)"; fi
-	@echo "Build Directory: $(BUILDDIR)"
-	@echo "Worktree Directory: $(WORKTREE_DIR)"
-	@echo "=========================="
+	sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/multiversion" $(SPHINXOPTS)
+	cp "$(SOURCEDIR)/_templates/meta_refresh.html" "$(BUILDDIR)/multiversion/index.html"
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

_static/css/furo_custom.css

@@ -0,0 +1,23 @@
+/*
+ * SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
+ * SPDX-License-Identifier: Apache-2.0
+*/
+
+/* Don't restrict content width on the RTD theme
+ * from: https://stackoverflow.com/a/32898444 */
+
+.wy-nav-content {
+  max-width: none;
+}
+
+.wy-table-responsive table td, .wy-table-responsive table th {
+  white-space: normal;
+}
+
+.wy-side-nav-search {
+  background-color: #d9d9d9;
+}
+
+.wy-side-nav-search>div.version {
+  color: #404040;
+}

_static/css/rtd_theme_mods.css

@@ -1,7 +1,7 @@
 <!--
 SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org>
 SPDX-License-Identifier: Apache-2.0
--->
+--!>
 <html><head>
     <meta charset="UTF-8">
     <meta http-equiv="refresh" content="0;url=main/index.html" />

_templates/meta_refresh.html

@@ -0,0 +1,31 @@
+<!--
+SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org>
+SPDX-License-Identifier: Apache-2.0
+--!>
+{%- if current_version %}
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
+  <span class="rst-current-version" data-toggle="rst-current-version">
+    <span class="fa fa-book"> Other Versions</span>
+    v: {{ current_version.name }}
+    <span class="fa fa-caret-down"></span>
+  </span>
+  <div class="rst-other-versions">
+    {%- if versions.tags %}
+    <dl>
+      <dt>Tags</dt>
+      {%- for item in versions.tags %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+    {%- if versions.branches %}
+    <dl>
+      <dt>Branches</dt>
+      {%- for item in versions.branches %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+  </div>
+</div>
+{%- endif %}