docs:opkg: clean up RST

.gitignore

@@ -1,2 +1,5 @@
 .venv/
-docs/build/
+docs/build/
+
+# MAKEFILE INTERMEDIATE FILES
+docs/source/opkg/source_files/*.tar.gz

Makefile

@@ -2,29 +2,48 @@
 .DEFAULT_GOAL := all
 
 # DIRECTORIES
-srcdir := src
-# /DIRECTORIES
+srcdir = docs/source
+
 
 # BINARIES
 export MAKE ?= make
 export PYTHON ?= python3
 export SPHINXBUILD = $(PYTHON) -m sphinx
-# /BINARIES
+export TAR ?= tar
+
+export SPHINXOPTS ?= --fail-on-warning --keep-going
+
+
+# ==============================================================================
+# REAL TARGETS
+# ==============================================================================
+
+opkg_intro_dist = $(srcdir)/opkg/source_files/opkg-intro.tar.gz
+$(opkg_intro_dist) : $(shell find $(srcdir)/opkg/source_files/opkg-intro/ -type f)
+	$(TAR) -czf $@ -C $(@D) opkg-intro/
+
+
+dkms_opkg_dist = $(srcdir)/opkg/source_files/dkms-opkg.tar.gz
+$(dkms_opkg_dist) : $(shell find $(srcdir)/opkg/source_files/dkms-opkg/ -type f)
+	$(TAR) -czf $@ -C $(@D) dkms-opkg/
 
 
-# REAL TARGETS #
-################
+OBJ = \
+	$(opkg_intro_dist) \
+	$(dkms_opkg_dist)
 
 
-# PHONY TARGETS #
-#################
+# ==============================================================================
+# PHONY TARGETS
+# ==============================================================================
 
-all :
+all : $(OBJ)
 	$(MAKE) -C docs html
 .PHONY : all
 
 
 clean :
+	rm -rf $(OBJ)
 	$(MAKE) -C docs clean
 .PHONY : clean
 

docs/source/_static/custom.css

@@ -0,0 +1,6 @@
+div.body p,
+div.body dd,
+div.body li,
+div.body blockquote {
+    hyphens: manual;
+}

docs/source/conf.py

@@ -49,10 +49,14 @@
 #
 html_theme = 'bizstyle'
 
+html_css_files = [
+    "custom.css",
+]
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = []
+html_static_path = ["_static"]
 
 html_context = {
     'github_repo_url': 'https://github.com/ni/nilrt-docs/',
@@ -75,6 +79,7 @@
 
 linkcheck_ignore = [
     r"https://linux.die.net/.*",  # linux.die.next denies robots with 403
+    r"https://git\.yoctoproject\.org/opkg-utils/?",  # Cloudflare challenge causes unstable 403s in linkcheck
 ]
 
 linkcheck_anchors_ignore_for_url = [