Allow custom `YIELD` script for yielding sources

[Shrine-XSLT] / GNUmakefile

diff --git a/GNUmakefile b/GNUmakefile
index b8bbd4a0820324b743afbb39c17e36f8e7b7d8d1..fd272ee23e55d059e145d69b0d4c4c27a905dcd3 100644 (file)
--- a/GNUmakefile
+++ b/GNUmakefile
@@ -1,55 +1,87 @@
 SHELL = /bin/sh
 
 SHELL = /bin/sh
 

-# This GNUmakefile searches the `sources/` directory for files with an extension of `.xml` and applies `transform.xslt` to them, outputting the result in one of two locations :—
+# This GNUmakefile searches the `sources/` directory for files with an extension of `.atom` or `.xml` and applies `transform.xslt` to them, outputting the result in one of the following locations :—

 #
 # • For files with a location of `sources/index.xml` or `sources/index-*.xml`, the transformed file will be written to `public/%.html` (where `%` is the filename).
 #
 # • For all other files with a location of `sources/*.xml` or `sources/*/*.xml`, the transformed file will be written to `public/%/index.html` (where `%` is the filename and subdirectory if applicable).
 #
 # • For files with a location of `sources/index.xml` or `sources/index-*.xml`, the transformed file will be written to `public/%.html` (where `%` is the filename).
 #
 # • For all other files with a location of `sources/*.xml` or `sources/*/*.xml`, the transformed file will be written to `public/%/index.html` (where `%` is the filename and subdirectory if applicable).

-# Other files in the corresponding directory (i·e without the `.xml`) are copied over verbatim.
+# Any files in a corresponding sibling directory (i·e without the `.xml`) are copied over verbatim.

 # Only one level of subdirectory is supported.
 #
 # Only one level of subdirectory is supported.
 #

+# • For files with a location of `sources/*.atom` or `sources/*/*.atom`, the transformed file will be written to `public/%.atom` (where `%` is the filename and subdirectory if applicable).
+#

 # By default, running `make` will do this for all applicable source files.
 #
 # ___
 #
 # By default, running `make` will do this for all applicable source files.
 #
 # ___
 #

-# © 2022 Lady [@ Lady’s Computer]
+# © 2022–2023 Lady [@ Lady’s Computer]

 #
 # This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
 # If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
 
 #
 # This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
 # If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.
 

+BASEIRI = http://example.com
+DATETIME = $(shell date -Iseconds)
+FEED_EXT = .atom
+SOURCE_EXT = .xml
+TRANSFORM = transform.xslt

 XSLT = xsltproc
 XSLTOPTS =
 XSLT = xsltproc
 XSLTOPTS =

+YIELD = cat
+YIELD_DEPENDENCIES =

 
 headers := $(wildcard *-header.xml)
 footers := $(wildcard *-footer.xml)
 
 headers := $(wildcard *-header.xml)
 footers := $(wildcard *-footer.xml)

-override prerequisites := transform.xslt $(headers) $(footers)
+override prerequisites := $(YIELD_DEPENDENCIES) template.xml $(TRANSFORM) $(headers) $(footers)

 
 

-override indexsources := $(wildcard sources/index.xml sources/index-*.xml)
-override indices := $(patsubst sources/%.xml,public/%.html,$(indexsources))
+override indexsources := $(wildcard sources/index$(SOURCE_EXT) sources/index-*$(SOURCE_EXT))
+override indices := $(patsubst sources/%$(SOURCE_EXT),public/%.html,$(indexsources))

 
 

-override pagesources := $(filter-out $(indexsources),$(wildcard sources/*.xml sources/*/*.xml))
-override pages := $(patsubst sources/%.xml,public/%/index.html,$(pagesources))
+override pagesources := $(filter-out $(indexsources),$(wildcard sources/*$(SOURCE_EXT) sources/*/*$(SOURCE_EXT)))
+override pages := $(patsubst sources/%$(SOURCE_EXT),public/%/index.html,$(pagesources))

 
 override resourcesources := $(wildcard $(addsuffix /*,$(basename $(pagesources))))
 override resources := $(patsubst sources/%,public/%,$(resourcesources))
 
 
 override resourcesources := $(wildcard $(addsuffix /*,$(basename $(pagesources))))
 override resources := $(patsubst sources/%,public/%,$(resourcesources))
 

+override feedsources := $(filter-out $(resourcesources),$(wildcard sources/*$(FEED_EXT) sources/*/*$(FEED_EXT)))
+override feeds := $(patsubst sources/%$(FEED_EXT),public/%.atom,$(feedsources))
+

 override content := $(indices) $(pages)
 
 override content := $(indices) $(pages)
 

-override makexslt = $(XSLT) --nonet --novalid $(XSLTOPTS) -o $(2) transform.xslt $(1)
+# This function does the following :—
+#
+# • Calls `transform.xslt` with the `$(1)`, providing `$(BASEIRI)` and `$(DATETIME) as params and providing `$(2)` (minus the initial `public/`) as the param `OUTPUTPATH`.
+#
+# • Removes any `xmlns` prefix declarations from output to `.html` files (with `sed`).
+#
+# • Removes any doctype for root elements other than `html` (with `grep -v`).
+#
+# • Saves the output to `$(2)`.
+override makexslt = $(YIELD) $(1)\
+       | $(XSLT) --nonet --novalid $(XSLTOPTS) --stringparam BASEIRI "$(BASEIRI)" --stringparam DATETIME "$(DATETIME)" --stringparam OUTPUTPATH "$(patsubst public/%,/%,$(2))" transform.xslt -\
+       $(if $(filter %.html,$(2)),| sed 's/ xmlns:[0-9A-Za-z_-]*="[^"]*"//g',)\
+       | grep -v '^<!DOCTYPE \([^h]\|.[^t]\|..[^m]\|...[^l]\|....[^ >]\)'\
+       > $(2)

 
 

-all: $(content) $(resources);
+all: $(content) $(resources) $(feeds);

 
 

-$(indices): public/%.html: sources/%.xml $(prerequisites)
+$(indices): public/%.html: sources/%$(SOURCE_EXT) $(prerequisites)

        @echo "Generating $@…"
        @echo "Generating $@…"

+       @mkdir -p $(dir $@)

        @$(call makexslt,$<,$@)
 
        @$(call makexslt,$<,$@)
 

-$(pages): public/%/index.html: sources/%.xml $(prerequisites)
+$(pages): public/%/index.html: sources/%$(SOURCE_EXT) $(prerequisites)

        @echo "Generating $@…"
        @echo "Generating $@…"

+       @mkdir -p $(dir $@)

        @$(call makexslt,$<,$@)
 
 $(resources): public/%: sources/%
        @echo "Copying over $@…"
        @$(call makexslt,$<,$@)
 
 $(resources): public/%: sources/%
        @echo "Copying over $@…"

-       @mkdir -p $(dir $<)
+       @mkdir -p $(dir $@)

        @cp $< $@
 
        @cp $< $@
 

+$(feeds): public/%.atom: sources/%$(FEED_EXT) $(TRANSFORM)
+       @echo "Generating $@…"
+       @mkdir -p $(dir $@)
+       @$(call makexslt,$<,$@)
+

 .PHONY: all ;
 .PHONY: all ;