docs: Adding initial Sphinx doc structure.
Signed-off-by: Tim 'mithro' Ansell <tansell@google.com>
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..6fd5945
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,62 @@
+# Minimal makefile for Sphinx documentation
+
+DOCSDIR := $(dir $(lastword $(MAKEFILE_LIST)))
+TOPDIR := $(realpath $(DOCSDIR)/..)
+
+include $(TOPDIR)/scripts/make/conda.mk
+
+SHELL = /bin/bash
+
+EXP_OPEN := $$((
+EXP_CLOSE := ))
+CPU_CORES := $(shell nproc)
+CPU_CORES_2 := $(shell echo $(EXP_OPEN) $(CPU_CORES) * 2 $(EXP_CLOSE))
+
+SPHINXOPTS = -j $(CPU_CORES_2)
+SPHINXBUILD = $(IN_CONDA_ENV) sphinx-build
+SPHINXAUTOBUILD = $(IN_CONDA_ENV) sphinx-autobuild
+SPHINXPROJ = SkyWaterPDK
+SOURCEDIR = $(DOCSDIR)
+BUILDDIR = $(DOCSDIR)/_build
+
+# Put it first so that "make" without argument is like "make help".
+help: | $(CONDA_ENV_PYTHON)
+ @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# Vim makes a '4913' file for file system checking. Seriously.
+livehtml: | $(CONDA_ENV_PYTHON)
+ @$(SPHINXAUTOBUILD) \
+ -b html \
+ --delay 5 \
+ \
+ --ignore \*.swp \
+ --ignore \*~ \
+ --ignore env \
+ --ignore _build \
+ --ignore .git \
+ --ignore */4913 \
+ \
+ $(SPHINXOPTS) \
+ "$(SOURCEDIR)" \
+ "$(BUILDDIR)/html"
+
+.PHONY: help livehtml Makefile
+
+# Various automated fixups that can be run
+fixup:
+ # Make sure it is SkyWater
+ find ../ -type f -name \*.rst -exec sed -i 's/Skywater/SkyWater/gi' \{\} \+
+ # Strip trailing space
+ find ../ -type f -name \*.rst -exec sed -i 's/ \+$$//' \{\} \+
+ # Make sure all library names have the :lib: role.
+ find ../ -type f -name \*.rst -exec sed -i -e'/:name:.*/!s/\(:lib:\)\?`\?\(sky130_[a-z0-9]\+_[a-z0-9]\+\(_[a-z0-9]\+\)\?\)`\?\(\s\|$$\)/:lib:`\2`\4/g' \{\} \+
+
+.PHONY: fixup
+
+echo: | $(CONDA_ENV_PYTHON)
+ @echo '$(SPHINXBUILD) -M XXXX "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)'
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
+.DEFAULT: | $(CONDA_ENV_PYTHON)
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
