Add volto docs submodule

tiberiuichim · tiberiuichim · commit 9806dfdecc9b · 2022-01-22T18:24:16.000+02:00
diff --git a/.gitignore b/.gitignore
@@ -8,3 +8,5 @@
 package-lock.json
 pyvenv.cfg
 /_build
+*~
+lib64
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "submodules/volto"]
+	path = submodules/volto
+	url = git@github.com:plone/volto.git
diff --git a/Makefile b/Makefile
@@ -1,6 +1,10 @@
 # Makefile for Sphinx documentation
 #
 
+# Now we can activate virtualenv
+SHELL=bash
+.DEFAULT_GOAL = all
+
 # You can set these variables from the command line.
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
@@ -35,8 +39,12 @@ build:  ## Set up training: Install requirements
 	@echo "Please activate your Python virtual environment with"
 	@echo "source bin/activate"
 
+bin/python:	build
+	@echo
+
 .PHONY: html
-html: ## Build html
+html: bin/python		# Build html
+	source bin/activate; \
 	cd $(DOCS_DIR) && $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
@@ -195,3 +203,15 @@ livehtml:  ## Rebuild Sphinx documentation on changes, with live-reload in the b
 
 .PHONY: all
 all: clean spellcheck linkcheck html ## Run checks and build html
+
+.PHONY: activate
+activate:
+
+submodules/volto:
+	# git submodule add git@github.com:plone/volto.git submodules/volto
+	git submodule init
+	ln -s ../submodules/volto/docs/source ./docs/volto
+
+.PHONY: serve-docs
+serve-docs:		## Start an HTTP server for docs
+	python -m http.server --directory ./_build/html
diff --git a/docs/index.md b/docs/index.md
@@ -16,6 +16,7 @@ html_meta:
 
 backend/index
 classic-ui/index
+volto/plone6index
 contributing/index
 ```
 
diff --git a/submodules/volto b/submodules/volto
@@ -0,0 +1 @@
+Subproject commit 609913d8caaac168ee4e6b041541e054b962aca2

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+[submodule "submodules/volto"]`
	`2`	`+ path = submodules/volto`
	`3`	`+ url = [email protected]:plone/volto.git`