docs: restructuring images directory

see also previous commit
Also updates `scripting_intro.rst` to use literal includes, and uses individual image outputs to avoid the intermediary `.tex` file to join them all.

docs/source/_images/011/example_out.tex

@@ -1,18 +0,0 @@
-\documentclass[12pt,tikz]{standalone}
-\pdfinfoomitdate 1
-\pdfsuppressptexinfo 1
-\pdftrailerid{}
-\usepackage[utf8]{inputenc}
-\usepackage{tikz}
-\pagestyle{empty}
-
-\begin{document}
-\begin{tikzpicture}
-	\node[inner sep=0pt] at (0,0)
-		{\includegraphics[width=\linewidth]{example_00.pdf}};
-	\node[inner sep=0pt] at (0,-3.8)
-		{\includegraphics[width=\linewidth]{example_01.pdf}};
-	\node[inner sep=0pt] at (0,-7)
-		{\includegraphics[width=\linewidth]{example_02.pdf}};
-\end{tikzpicture}
-\end{document}

docs/source/_images/011/select_prod.tex

@@ -1,19 +0,0 @@
-\documentclass[12pt,tikz]{standalone}
-\pdfinfoomitdate 1
-\pdfsuppressptexinfo 1
-\pdftrailerid{}
-\usepackage[utf8]{inputenc}
-\pagestyle{empty}
-
-\begin{document}
-\begin{tikzpicture}
-	\node[inner sep=0pt] at (0,0)
-		{\hfill \includegraphics[width=4cm,trim=0 1cm 0 1cm]{sumprod_02.pdf}};
-	\node[inner sep=0pt] at (0,-2.8)
-		{\includegraphics[width=\linewidth,trim=0 0cm 0 1cm]{sumprod_03.pdf}};
-	\node[inner sep=0pt] at (0,-6.2)
-		{\includegraphics[width=\linewidth,trim=0 0cm 0 1cm]{sumprod_04.pdf}};
-	\node[inner sep=0pt] at (0,-9.2)
-		{\includegraphics[width=\linewidth,trim=0 1cm 0 1cm]{sumprod_05.pdf}};
-\end{tikzpicture}
-\end{document}

docs/source/_images/011/splitnets_libfile.tex

@@ -1,15 +0,0 @@
-\documentclass[12pt,tikz]{standalone}
-\pdfinfoomitdate 1
-\pdfsuppressptexinfo 1
-\pdftrailerid{}
-\usepackage[utf8]{inputenc}
-\pagestyle{empty}
-
-\begin{document}
-\begin{tikzpicture}
-	\node[inner sep=0pt] at (0,0)
-		{\includegraphics[height=\linewidth]{cmos_00.pdf}};
-	\node[inner sep=0pt] at (2,-8)
-		{\includegraphics[width=\linewidth]{cmos_01.pdf}};
-\end{tikzpicture}
-\end{document}

docs/source/_images/011/submod_dots.tex

@@ -1,27 +0,0 @@
-\documentclass[12pt,tikz]{standalone}
-\pdfinfoomitdate 1
-\pdfsuppressptexinfo 1
-\pdftrailerid{}
-\usepackage[utf8]{inputenc}
-\pagestyle{empty}
-
-\begin{document}
-\begin{tikzpicture}
-	\node[inner sep=0pt] at (0,0)
-		{\includegraphics[width=\linewidth,trim=0 1.3cm 0 0cm]{submod_00.pdf}};
-	\node at (0, -2.5)
-		{\tt memdemo};
-	\node[inner sep=0pt] at (0,-5)
-		{\includegraphics[width=\linewidth,trim=0 1.3cm 0 0cm]{submod_01.pdf}};
-	\node at (0, -7.5)
-		{\tt scramble};
-	\node[inner sep=0pt] at (0, -11)
-		{\includegraphics[width=\linewidth,trim=0 1.3cm 0 0cm]{submod_02.pdf}};
-	\node at (0, -14.8)
-		{\tt outstage};
-	\node[inner sep=0pt] at (0,-16.6)
-		{\includegraphics[width=\linewidth,trim=0 1.3cm 0 0cm]{submod_03.pdf}};
-	\node at (0, -19)
-		{\tt selstage};
-\end{tikzpicture}
-\end{document}

docs/source/_images/Makefile

@@ -1,62 +1,46 @@
-all: resources dots tex svg tidy
+all: examples all_tex tidy
 
-RES_LIST:= PRESENTATION_Intro/ PRESENTATION_ExSyn/ PRESENTATION_ExAdv/ PRESENTATION_ExOth/
-RES_DIRS:= $(addprefix ../../resources/,$(RES_LIST))
-.PHONY: resources
-resources: $(RES_DIRS)
+# set a fake time in pdf generation to prevent unnecessary differences in output
+FAKETIME := TZ='Z' faketime -f '2022-01-01 00:00:00 x0,001'
+
+# find all code example makefiles
+.PHONY: examples
+CODE_EXAMPLES := ../code_examples/*/Makefile
+examples: $(CODE_EXAMPLES)
+
+# target to convert specified dot file(s)
+.PHONY: convert
+TARG_DOT ?=
+convert: $(TARG_DOT:.dot=.pdf) $(TARG_DOT:.dot=.svg)
+
+# use empty FORCE target because .PHONY ignores % expansion, using find allows
+# us to generate everything in one pass, since we don't know all of the possible
+# outputs until the sub-makes run
 FORCE:
-../../resources/%: FORCE
-	@$(MAKE) -C $@
-	@mkdir -p res/$*
-	@cp --update -t res/$* $@*.dot
+../%/Makefile: FORCE
+	@make -C $(@D) dots
+	@mkdir -p $*
+	@find $(@D) -name *.dot -exec cp -u {} -t $* \;
+	@find $* -name *.dot -printf "%p " | xargs -i make --no-print-directory convert TARG_DOT="{}"
 
-TEX_SOURCE:= $(wildcard *.tex)
-DOT_LOC:= ../APPNOTE_011_Design_Investigation
-DOT_SOURCE:= $(wildcard $(DOT_LOC)/*.dot)
+# find and build all tex files
+.PHONY: all_tex
+TEX_FILES := $(wildcard **/*.tex)
+all_tex: $(TEX_FILES:.tex=.pdf) $(TEX_FILES:.tex=.svg)
 
-RES_DOTS:= $(wildcard res/*/*.dot)
-RES_DIRS:= $(sort $(dir $(RES_DOTS)))
-RES_PDF:= $(RES_DOTS:%.dot=%.pdf)
-
-TEX_SOURCE+= 011/example_out.tex
-011/example_out.pdf: 011/example_00.pdf 011/example_01.pdf 011/example_02.pdf
-TEX_SOURCE+= 011/select_prod.tex
-011/select_prod.pdf: 011/sumprod_02.pdf 011/sumprod_03.pdf 011/sumprod_04.pdf 011/sumprod_05.pdf
-TEX_SOURCE+= 011/splitnets_libfile.tex
-011/splitnets_libfile.pdf: 011/cmos_00.pdf 011/cmos_01.pdf
-TEX_SOURCE+= 011/submod_dots.tex
-011/submod_dots.pdf: 011/submod_00.pdf 011/submod_01.pdf 011/submod_02.pdf 011/submod_03.pdf
-
-TEX_PDF:= $(patsubst %.tex,%.pdf,$(TEX_SOURCE))
-DOT_PDF:= $(addprefix 011/,$(notdir $(patsubst %.dot,%.pdf,$(DOT_SOURCE))))
-SVG_OUTPUT:= $(patsubst %.pdf,%.svg,$(TEX_PDF) $(DOT_PDF) $(RES_PDF))
-
-dots: $(DOT_PDF) $(RES_PDF)
-tex: $(TEX_PDF)
-svg: $(SVG_OUTPUT)
-
-011/%.pdf: $(DOT_LOC)/%.dot
-	TZ='Z' faketime -f '2022-01-01 00:00:00 x0,001' dot -Tpdf -o $@ $<
-
-res/%.pdf: res/%.dot
-	TZ='Z' faketime -f '2022-01-01 00:00:00 x0,001' dot -Tpdf -o $@ $<
-
-011/%.pdf: 011/%.tex
-	cd 011 && TZ='Z' faketime -f '2022-01-01 00:00:00 x0,001' pdflatex $(<F) --interaction=nonstopmode
+%.pdf: %.dot
+	$(FAKETIME) dot -Tpdf -o $@ $<
 
 %.pdf: %.tex
-	pdflatex $< --interaction=nonstopmode
+	cd $(@D) && $(FAKETIME) pdflatex $(<F) --interaction=nonstopmode
 
 %.svg: %.pdf
 	pdf2svg $< $@
 
 .PHONY: clean tidy
 tidy:
-	rm -f *.log
-	rm -f *.aux
-	rm -f  011/*.log 011/*.aux
+	rm -f  **/*.log **/*.aux
+
 clean: tidy
-	rm -f *.pdf
-	rm -f *.svg
-	rm -f 011/*.pdf 011/*.svg
-	rm -rf $(RES_DIRS)
+	rm -rf code_examples
+	rm -f **/*.pdf **/*.svg