-SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: CC0-1.0
The following hash indicates a commit in which the metadata format
generated by ⛩📰 书社 was different than it currently is :—
-c84c2b38caf34807fd1c52a8f19fcf0af7e9807e
+d64a8d34c7638243f90421664268766df75a42d7
The purpose of this file is to serve as a trackable dependency which
will prompt a rebuild of metadata when the generation mechanism
-# SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
+# SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
# SPDX-License-Identifier: MPL-2.0
SHELL = /bin/sh
║╰────────────────────────────────────────────────────────────╯║
╟┬ ¶ Copyright & License ─────────────────────────────────────┬╢
║│ │║
-║│ Copyright © 2023–2024 Lady [@ Ladys Computer]. │║
+║│ Copyright © 2023–2025 Lady [@ Ladys Computer]. │║
║│ │║
║│ This Source Code Form is subject to the terms of the │║
║│ Mozilla Public License, v 2.0. If a copy of the M·P·L was │║
FINDRULES := '!' '(' '(' -name '[.-]*' -a '!' -name '.' -o -name '*[][*?:|$$%\#\\; ]*' -o -name '*[)]' ')' -a -prune ')'$(if $(EXTRAFINDRULES), -a '(' $(EXTRAFINDRULES) ')',)
FINDINCLUDERULES := $(FINDRULES)$(if $(EXTRAFINDINCLUDERULES), -a '(' $(EXTRAFINDINCLUDERULES) ')',)
+# Options to use when calling Make for the first build of a two‐stage build.
+#
+# This can be used to override variables which are only applicable to the second build.
+DATAOPTS :=
+
# File extensions which indicate files in `SRCDIR´ which should be built as part of the first, rather than second, stage of the two‐stage `MODE´.
DATAEXT := rdf
EXTRAFINDDATARULES :=
FINDDATARULES := -name '.' $(foreach ext,$(DATAEXT), -o -name '$(subst ','"'"',[!.]*.$(ext))')$(if $(EXTRAFINDDATARULES), -a '(' $(EXTRAFINDDATARULES) ')',)
+# A semicolon‐separated list of regular expressions which paths should be required to match when finding files.
+FINDFILTERONLY :=
+
+# A semicolon‐separated list of regular expressions for paths which should be filtered out when finding files.
+FINDFILTEROUT :=
+
+# A semicolon‐separated list of regular expressions for paths which paths should be required to match when finding includes.
+#
+# This is generally only useful when `SRCDIR´ and `INCLUDEDIR´ point to the same location.
+# In that situation, this variable can be used to select certain files as includes, leaving the others to be recognized as sources instead.
+#
+# Otherwise, appropriately constructing `FINDFILTERONLY´ to look at the base directory of the files it finds should be sufficient.
+FINDINCLUDEFILTERONLY :=
+
+# A semicolon‐separated list of regular expressions for paths which should be filtered out in addition to those in `FINDFILTEROUT´ when finding includes.
+#
+# This is generally only useful when `SRCDIR´ and `INCLUDEDIR´ point to the same location.
+# In that situation, this variable can be used to exclude certain files from being recognized as includes, which will make them recognized as sources instead.
+#
+# Otherwise, appropriately constructing `FINDFILTEROUT´ to look at the base directory of the files it finds should be sufficient.
+FINDINCLUDEFILTEROUT :=
+
+# If not empty, the regular expression provided by `FINDFILTERONLY´ is an extended regular expression.
+FINDFILTERONLYEXTENDED :=
+
+# If not empty, the regular expression provided by `FINDFILTEROUT´ is an extended regular expression.
+#
+# By default, this matches `FINDFILTERONLYEXTENDED´
+FINDFILTEROUTEXTENDED := $(FINDFILTERONLYEXTENDED)
+
+# If not empty, the regular expression provided by `FINDFILTEROUT´ is an extended regular expression.
+#
+# By default, this matches `FINDFILTERONLYEXTENDED´
+FINDINCLUDEFILTERONLYEXTENDED := $(FINDFILTERONLYEXTENDED)
+
+# If not empty, the regular expression provided by `FINDINCLUDEFILTEROUT´ is an extended regular expression.
+#
+# By default, this matches `FINDFILTEROUTEXTENDED´
+FINDINCLUDEFILTEROUTEXTENDED := $(and $(FINDFILTERONLYEXTENDED),$(FINDFILTEROUTEXTENDED),1)
+
# The list of magic files to use when determining media types.
#
# Some are provided as part of this repository, but you can add more if you need different media type detection.
# Posix timezone information.
TZ := UTC0
-export UTC0
+export TZ
# The default target for this makefile.
.DEFAULT_GOAL := all
# (callable) Quote the given string for use within shell calls.
override quote = '$(subst ','"'"',$1)'
+# (callable) Quote the given string for use defining a variable to send to a submake.
+override varquote = $(subst $$,$$$$,$(call quote,$1))
+
# The command to use for percent‐decoding.
override perdeccmd := $(SED) 's/|/%7C/g;s/[\]/%5C/g;s/%[0123456789ABCDEFabcdef]\{2\}/|&|/g' | $(TR) '|' '\n' | $(SED) '/^%[0123456789ABCDEFabcdef]\{2\}$$/!s/%/|%25|/' | $(TR) '|' '\n' | $(AWK) '$$0!~/%/{printf "%s",$$0}/%/{d="0123456789ABCDEF";v=substr(toupper($$0),2,2);printf "\\%04o",(index(d,substr(v,1,1))-1)*16+index(d,substr(v,2,1))-1}' | $(SED) $(call quote,s/'/'"'"'/g;s/^/'/;s/$$/'/;$$!s/$$/\\/) | $(XARGS) -E '' $(PRINTF) '%b'
# If `$(notbuilding)´ is non·empty, this variable produces no result to avoid unnecessary work.
#
# ☡ This variable creates at least one subshell every time it is computed.
-override diffprereqs = $(if $(notbuilding),,$(and $(subst $(shell $(CAT) $(call quote,$(BUILDDIR)/lastprereqs/$1) 2>>/dev/null || :),,$2),$(shell $(call ensuredirectory,$(BUILDDIR)/lastprereqs) && $(PRINTF) '%s\n' $(call quote,$2) >|$(BUILDDIR)/lastprereqs/$1),)$2 $(BUILDDIR)/lastprereqs/$1)
+override diffprereqs = $(if $(notbuilding),,$(and $(or $(wildcard $(BUILDDIR)/lastprereqs/$1),$(shell $(TOUCH) $(call quote,$(BUILDDIR)/lastprereqs/$1)),1),$(subst $(shell $(CAT) $(call quote,$(BUILDDIR)/lastprereqs/$1) 2>>/dev/null || :),,$2),$(shell $(call ensuredirectory,$(BUILDDIR)/lastprereqs) && $(PRINTF) '%s\n' $(call quote,$2) >|$(call quote,$(BUILDDIR)/lastprereqs/$1)),)$2 $(BUILDDIR)/lastprereqs/$1)
# ─ ¶ Recipe Variable Definitions ─────────────────────────────────────
override extracttext = $(PRINTF) '%s' '<transform xmlns="http://www.w3.org/1999/XSL/Transform" version="1.0"><output method="text" encoding="UTF-8"/></transform>' | $(XSLTPROC) --nonet --novalid --nomkdir --nowrite - $(call quote,$1)
# (callable) Process the provided transformation result and output the result to the provided location, given the provided relative path.
-override processresultto = if $(call xpath,/*[local-name()="raw-text" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then $(call extracttext,$1) >|$(call quote,$2); elif $(call xpath,/*[local-name()="base64-binary" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then { $(PRINTF) '%s\n' 'begin-base64 644 -'; $(call extracttext,$1) | $(TR) -d '\t\n\f\r '; $(PRINTF) '\n%s\n' '===='; } | $(UUDECODE) -o /dev/stdout >|$(call quote,$2); elif $(call xpath,/*[local-name()="archive" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then $(MAKE) -f $(makefile) NAME=$(call quote,$3) SRC=$(call quote,$1) BUILDDIR=$(call quote,$(BUILDDIR)/archive/$3) DESTDIR=$(call quote,$(patsubst %/,%,$(dir $2))) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:archive' $(call quote,$2); else $(FINALIZE) $(call quote,$1) >|$(call quote,$2); fi
+override processresultto = if $(call xpath,/*[local-name()="raw-text" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then $(call extracttext,$1) >|$(call quote,$2); elif $(call xpath,/*[local-name()="base64-binary" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then { $(PRINTF) '%s\n' 'begin-base64 644 -'; $(call extracttext,$1) | $(TR) -d '\t\n\f\r '; $(PRINTF) '\n%s\n' '===='; } | $(UUDECODE) -o /dev/stdout >|$(call quote,$2); elif $(call xpath,/*[local-name()="archive" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$1); then $(MAKE) -f $(makefile) NAME=$(call varquote,$3) SRC=$(call varquote,$1) BUILDDIR=$(call varquote,$(BUILDDIR)/archive/$3) DESTDIR=$(call varquote,$(patsubst %/,%,$(dir $2))) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:archive' $(call varquote,$2); else $(FINALIZE) $(call quote,$1) >|$(call quote,$2); fi
# ━ § BEGIN DEFAULT MAKE·FILE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
override sedesc = $(subst /,[/],$(subst $$,\$$,$(subst *,\*,$(subst .,\.,$(subst [,\[,$(subst ^,\^,$(subst \,\\,$1)))))))
# (overridable) Collect all of the applicable includes from the includes directory.
-sourceincludes := $(if $(and $(INCLUDEDIR),$(wildcard $(INCLUDEDIR))),$(patsubst ./%,%,$(shell $(FIND) $(foreach dir,$(INCLUDEDIR),$(call quote,$(dir))) '(' $(FINDINCLUDERULES) ')' -a -type f -a -print)),)
+sourceincludes := $(foreach dir,$(INCLUDEDIR),$(and $(dir),$(wildcard $(dir)),$(patsubst ./%,%,$(shell $(FIND) $(call quote,$(dir)) '(' $(FINDINCLUDERULES) ')' -a -type f -a -print$(and $(FINDFILTERONLY),$(space)| $(GREP)$(and $(FINDFILTERONLYEXTENDED),$(space)-E) $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDFILTERONLY)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter)))))$(and $(FINDINCLUDEFILTERONLY),$(space)| $(GREP)$(and $(FINDINCLUDEFILTERONLYEXTENDED),$(space)-E) $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDINCLUDEFILTERONLY)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter)))))$(and $(FINDFILTEROUT),$(space)| $(GREP)$(and $(FINDFILTEROUTEXTENDED),$(space)-E) -v $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDFILTEROUT)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter)))))$(and $(FINDINCLUDEFILTEROUT),$(space)| $(GREP)$(and $(FINDINCLUDEFILTEROUTEXTENDED),$(space)-E) -v $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDINCLUDEFILTEROUT)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter)))))))))
# (overridable) Collect all of the applicable source files from the source directory, removing any which are also includes.
-sourcefiles := $(if $(and $(SRCDIR),$(wildcard $(SRCDIR))),$(filter-out $(sourceincludes),$(patsubst ./%,%,$(shell $(FIND) $(foreach dir,$(SRCDIR),$(call quote,$(dir))) '(' $(FINDRULES) ')' -a -type f -a -print))))
+sourcefiles := $(filter-out $(sourceincludes),$(foreach dir,$(SRCDIR),$(and $(dir),$(wildcard $(dir)),$(patsubst ./%,%,$(shell $(FIND) $(call quote,$(dir)) '(' $(FINDRULES) ')' -a -type f -a -print$(and $(FINDFILTERONLY),$(space)| $(GREP)$(and $(FINDFILTERONLYEXTENDED),$(space)-E) $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDFILTERONLY)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter)))))$(and $(FINDFILTEROUT),$(space)| $(GREP)$(and $(FINDFILTEROUTEXTENDED),$(space)-E) -v $(foreach filter,$(shell $(PRINTF) '%s\n' $(call quote,$(FINDFILTEROUT)) | $(TR) ' ;' '; '),-e $(call quote,$(subst ;, ,$(filter))))))))))
# Figure out the file type of each source file and source include.
ifneq ($(wildcard $(BUILDDIR)/magic.mgc),)
# (callable) Get base64 data u·r·i’s for the given files.
#
# ☡ This variable creates a subshell every time it is computed.
-override datauri = $(foreach file,$1,data:$(call typeoffile,$(file));base64,$(shell $(UUENCODE) -m $(call quote,$(file)) _ | $(SED) '2,$$!d;$$d' | $(TR) -d ' \n'))
+override datauri = $(foreach file,$1,data:$(call typeoffile,$(file));base64,$(shell $(UUENCODE) -m $(call quote,$(abspath $(file))) _ | $(SED) '2,$$!d;$$d' | $(TR) -d ' \n'))
# Pair each source file and include with its local u·r·i.
override sourcelocalpair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|about:shushe?$(if $(filter $(file),$(sourceincludes)),include=$(call pathenc,$(call includepath,$(file))),source=$(call pathenc,$(call sourcepath,$(file)))))
# Pair each source file and include with its metadata location.
override sourcemetadatapair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|$(BUILDDIR)/$(if $(filter $(file),$(sourceincludes)),includes.metadata/$(call includepath,$(file)),sources.metadata/$(call sourcepath,$(file))))
-# (callable) Get the location of the transformed X·M·L files for the given source files.
+# (callable) Get the location of the metadata files for the given source files.
override metadata = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcemetadatapair))))
-# (callable) Get the source files for the given parsed file.
+# (callable) Get the source files for the given metadata files.
override datadata = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(sourcemetadatapair))))
# Pair each source file and include with its parsed location.
-override sourceparsedpair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|$(BUILDDIR)/$(if $(filter $(file),$(sourceincludes)),includes/$(call includepath,$(file)),sources/$(call sourcepath,$(file))))
+override sourceparsedpair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|$(BUILDDIR)/$(if $(filter $(file),$(sourceincludes)),includes.parsed/$(call includepath,$(file)),sources.parsed/$(call sourcepath,$(file))))
# (callable) Get the location of the transformed X·M·L files for the given source files.
override parsed = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourceparsedpair))))
-# (callable) Get the source files for the given parsed file.
+# (callable) Get the source files for the given parsed files.
override unparsed = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(sourceparsedpair))))
-# Pair each build directory, transform, source file, or parsed file with its file u·r·i.
-override fileuripairs := $(join $(patsubst %,%|,$(BUILDDIR) $(TRANSFORMS) $(sourcefiles) $(sourceincludes) $(call parsed,$(sourcefiles) $(sourceincludes))),$(call pathenc,$(foreach uriable,$(BUILDDIR) $(TRANSFORMS) $(sourcefiles) $(sourceincludes) $(call parsed,$(sourcefiles) $(sourceincludes)),file://$(abspath $(uriable)))))
+# Pair each source file and include with its parsed result location.
+override parsepair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|$(BUILDDIR)/$(if $(filter $(file),$(sourceincludes)),includes/$(call includepath,$(file)),sources/$(call sourcepath,$(file))))
+
+# (callable) Get the location of the parsed results for the given source files.
+override parseresult = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(parsepair))))
+
+# (callable) Get the source files for the given parsed results.
+override parsesource = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(parsepair))))
+
+# Pair each build directory, transform, source file, or parsed file, parse result file with its file u·r·i.
+override fileuripairs := $(join $(patsubst %,%|,$(BUILDDIR) $(TRANSFORMS) $(sourcefiles) $(sourceincludes) $(call parsed,$(sourcefiles) $(sourceincludes)) $(call parseresult,$(sourcefiles) $(sourceincludes))),$(call pathenc,$(foreach uriable,$(BUILDDIR) $(TRANSFORMS) $(sourcefiles) $(sourceincludes) $(call parsed,$(sourcefiles) $(sourceincludes)) $(call parseresult,$(sourcefiles) $(sourceincludes)),file://$(abspath $(uriable)))))
# (callable) Get the file u·r·is for the given transforms, source file or parsed files.
override fileuri = $(foreach file,$1,$(or $(patsubst $(file)|%,%,$(filter $(file)|%,$(fileuripairs))),$(error Unable to get file u·r·i for `$(file)´)))
# (callable) Get the destination for the given source files, or return `.NOTDEF/$1´.
#
# The fallback here is because destinations are used to generate targets and thus must always be non·empty and should be unique, even when they haven’t been generated yet.
-override destination = $(foreach file,$1,$(or $(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcedestinationpair))),.NOTDEF/$1))
+override destination = $(foreach file,$1,$(subst ;, ,$(or $(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcedestinationpair))),.NOTDEF/$1)))
# Pair each source file with its compiled location.
-override sourcecompiledpair := $(foreach file,$(sourcefiles),$(file)|$(BUILDDIR)/results/$(call destination,$(file)))
+override sourcecompiledpair := $(foreach file,$(sourcefiles),$(file)|$(subst $(space),;,$(patsubst %,$(BUILDDIR)/results/%,$(call destination,$(file)))))
# (callable) Get the location of the transformed X·M·L files for the given source files.
-override compiled = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcecompiledpair))))
+override compiled = $(foreach file,$1,$(subst ;, ,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcecompiledpair)))))
# (callable) Get the location of the source files for the given compiled file.
-override uncompiled = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(sourcecompiledpair))))
+override uncompiled = $(foreach pair,$(sourcecompiledpair),$(foreach src,$(firstword $(subst |, , $(pair))),$(if $(filter $(subst ;, ,$(patsubst $(src)|%,%,$(pair))),$1),$(src),)))
# (callable) Get the location of the final built files for the given source files.
override built = $(foreach file,$1,$(patsubst $(BUILDDIR)/results/%,$(BUILDDIR)/public/%,$(call compiled,$(file))))
override unbuilt = $(foreach file,$1,$(call uncompiled,$(patsubst $(BUILDDIR)/public/%,$(BUILDDIR)/results/%,$(file))))
# (callable) Get the installed locations for the given source files.
-override installed = $(foreach file,$1,$(DESTDIR)/$(call destination,$(file)))
+override installed = $(foreach file,$1,$(patsubst %,$(DESTDIR)/%,$(call destination,$(file))))
# ─ ¶ Recipe Variable Definitions ─────────────────────────────────────
# (callable) Sanitize and wrap the provided plaintext file in X·M·L, printing to `stdout´.
-override wrapplaintext = { $(PRINTF) '%s\n%s' '<?xml version="1.0"?>' '<script xmlns="http://www.w3.org/1999/xhtml" type="$(call typeoffile,$1)"><![CDATA['; $(TR) '\000\013\014' '\032\011\012' <$(call quote,$1) | $(SED) "$$($(PRINTF) '%b' 's/]]>/]]]]><!\\[CDATA\\[>/g\ns/\0357\0277\0276/�/g\ns/\0357\0277\0277/�/g\n$$!s/\\r$$//g\ns/\\r/\\n/g\n$$!s/\0302\0205$$//g\ns/\0302\0205/\\n/g\ns/\0342\0200\0250/\\n/g\ns/[\0001\0002\0003\0004\0005\0006\0007\0010]/�/g\ns/[\0016\0017\0020\0021\0022\0023\0024\0025\0026\0027\0031\0032\0033\0034\0035\0036\0037]/�/g')"; $(PRINTF) '%s\n' ']]></script>'; }
+override wrapplaintext = { $(PRINTF) '%s\n%s' '<?xml version="1.0"?>' '<script xmlns="http://www.w3.org/1999/xhtml" type="$(call typeoffile,$1)"><![CDATA['; $(TR) '\000\013\014' '\032\011\012' <$(call quote,$(abspath $1)) | $(SED) "$$($(PRINTF) '%b' 's/]]>/]]]]><!\\[CDATA\\[>/g\ns/\0357\0277\0276/�/g\ns/\0357\0277\0277/�/g\n$$!s/\\r$$//g\ns/\\r/\\n/g\n$$!s/\0302\0205$$//g\ns/\0302\0205/\\n/g\ns/\0342\0200\0250/\\n/g\ns/[\0001\0002\0003\0004\0005\0006\0007\0010]/�/g\ns/[\0016\0017\0020\0021\0022\0023\0024\0025\0026\0027\0031\0032\0033\0034\0035\0036\0037]/�/g')"; $(PRINTF) '%s\n' ']]></script>'; }
# (callable) Check if the provided X·M·L file is X·M·L 1.1, and if so, coerce to X·M·L 1.0 as best as possible, printing the result (or the original file contents) to `stdout´.
#
# The X·M·L declaration will be dropped and character escapes for C0 control codes will be replaced with a literal `U+0091 PRIVATE USE ONE´, which is invalid in X·M·L 1.1, but valid X·M·L 1.0 (making the replacement obvious).
#
# This isn’t a perfect substitution (it makes some assumptions about the format of the underlying X·M·L), but it should be workable for most sensible, welformed files.
-override serializexml = $(SED) "$$($(PRINTF) '%b' '/<?xml[ \t]\\{1,\\}version=[\0042\0047]1.1/,$${ s/<?xml[^>]*?>/<!--<?xml version=\00421.1\0042?>-->/\n s/&\0043x0*[12345678BCEFbcef];/\0302\0221/g\n s/&\0043x0*1[0123456789ABCDEFabcdef];/\0302\0221/g\n s/&\00430*[12345678];/\0302\0221/g\n s/&\00430*1[12456789];/\0302\0221/g\n s/&\00430*2[0123456789];/\0302\0221/g\n s/&\00430*3[01];/\0302\0221/g\n}')" <$(call quote,$1) | $(SED) "$$($(PRINTF) '%b' ':a\n/^\\n*$$/{ $$d\n N\n ba\n}')"
+override serializexml = $(SED) "$$($(PRINTF) '%b' '/<?xml[ \t]\\{1,\\}version=[\0042\0047]1.1/,$${ s/<?xml[^>]*?>/<!--<?xml version=\00421.1\0042?>-->/\n s/&\0043x0*[12345678BCEFbcef];/\0302\0221/g\n s/&\0043x0*1[0123456789ABCDEFabcdef];/\0302\0221/g\n s/&\00430*[12345678];/\0302\0221/g\n s/&\00430*1[12456789];/\0302\0221/g\n s/&\00430*2[0123456789];/\0302\0221/g\n s/&\00430*3[01];/\0302\0221/g\n}')" <$(call quote,$(abspath $1)) | $(SED) "$$($(PRINTF) '%b' ':a\n/^\\n*$$/{ $$d\n N\n ba\n}')"
# ─ ¶ Phony Targets ───────────────────────────────────────────────────
# List all source files and includes and their computed types.
list :
- @$(PRINTF) '%b' $(call quote,$(foreach file,$(sort $(sourcefiles)) $(sort $(sourceincludes)),\0033[1m$(file)\0033[22m|$(call typeoffile,$(file))|[\0033[3m$(if $(filter $(file),$(xmlfiles)),xml,$(if $(filter $(file),$(plaintextfiles)),text,asset))$(if $(filter $(file),$(sourceincludes)),|include,)\0033[23m]$(if $(call dependencies,$(file))$(call recursives,$(file)), $(strip $(foreach recursive,$(call recursives,$(file)),\0033[93;41m•|Recursive|Dependency|\0033[39;49m|$(recursive)) $(foreach dependency,$(call dependencies,$(file)),\0033[2m•|Dependency|\0033[22m|$(dependency))))$(if $(filter $(file),$(sourcefiles)), →|<\0033[4m/$(call destination,$(file))\0033[24m>,) )) | $(TR) ' |' '\n '
+ @$(PRINTF) '%b' $(call quote,$(foreach file,$(sort $(sourcefiles)) $(sort $(sourceincludes)),\0033[1m$(file)\0033[22m|$(call typeoffile,$(file))|[\0033[3m$(if $(filter $(file),$(xmlfiles)),xml,$(if $(filter $(file),$(plaintextfiles)),text,asset))$(if $(filter $(file),$(sourceincludes)),|include,)\0033[23m]$(if $(call dependencies,$(file))$(call recursives,$(file)), $(strip $(foreach recursive,$(call recursives,$(file)),\0033[93;41m•|Recursive|Dependency|\0033[39;49m|$(recursive)) $(foreach dependency,$(call dependencies,$(file)),\0033[2m•|Dependency|\0033[22m|$(dependency))))$(if $(filter $(file),$(sourcefiles)), $(foreach dest,$(call destination,$(file)),→|<\0033[4m/$(dest)\0033[24m>),) )) | $(TR) ' |' '\n '
# Lists out the destinations of all resulting files (relative to `DESTDIR´).
listout :
# Destroy installed files.
uninstall :
- $(foreach file,$(installablefiles),$(if $(wildcard $(call installed,$(file))),$(silent)$(PRINTF) '%s\n' $(call quote,Removing </$(patsubst $(DESTDIR)/%,%,$(call installed,$(file)))>…)$(newline)$(silent)$(RM) -f $(call quote,$(call installed,$(file)))$(newline),))
+ $(foreach file,$(installablefiles),$(if $(wildcard $(call installed,$(file))),$(silent)$(PRINTF) '%s\n' $(call quote,Removing </$(patsubst $(DESTDIR)/%,%,$(call installed,$(file)))>…)$(newline)$(silent)$(RM) -f -R $(call quote,$(call installed,$(file)))$(newline),))
# Raise an error when attempting to build any files with recursive dependencies.
$(call built,$(recursivefiles)) :
# ─ ¶ Build Targets ───────────────────────────────────────────────────
-# Generate R·D·F metadata for files.
-$(call metadata,$(sourcefiles) $(sourceincludes)) : % : $$(call datadata,$$@) $(THISDIR)/.metadata-format-changed-since $(typeupdates)
- $(call inform,$(PRINTF) '%s\n' $(call quote,Generating metadata for `$<´…) >&2)
- $(silent)$(call ensuredirectory,$(dir $@))
- $(silent){ if $(TEST) ! -f $(call quote,$(BUILDDIR)/.mtime); then $(PRINTF) '%b' '\n' >|$(call quote,$(BUILDDIR)/.mtime); fi; $(TOUCH) -r $(call quote,$<) $(call quote,$(BUILDDIR)/.mtime); $(DIFF) -u $(call quote,$(BUILDDIR)/.mtime) /dev/null | $(SED) '1!d;s/.* \([^ ]*\) \([^ ]*\).*$$/\1T\2Z/'; $(CKSUM) $(call quote,$<) | $(SED) 's/[ ].*//'; } | $(xargsmultiquote) | $(XARGS) -E '' $(PRINTF) '<?xml version="1.0"?><书社vocab:$(if $(filter $<,$(sourceincludes)),IncludeFile,SourceFile) xmlns:nie="http://www.semanticdesktop.org/ontologies/2007/01/19/nie#" xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:书社vocab="urn:fdc:ladys.computer:20231231:Shu1She4:vocab:" rdf:about="%s" 书社vocab:path="%s" nfo:fileUrl="%s"><nie:interpretedAs>$(if $(filter $<,$(assetfiles)),<nfo:InformationElement nie:mimeType="%s"/>,<nfo:PlainTextDocument nie:mimeType="%s"/>)</nie:interpretedAs><书社vocab:hasParsedFile nfo:fileUrl="%s"/><nfo:fileLastModified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">%s</nfo:fileLastModified><nfo:hasHash nfo:hashAlgorithm="CRC32" nfo:hashValue="%s"/></书社vocab:$(if $(filter $<,$(sourceincludes)),IncludeFile,SourceFile)>' $(call quote,$(call attresc,$(call localuri,$<))) $(call quote,$(call attresc,$(if $(filter $<,$(sourceincludes)),$(call includepath,$<),$(call sourcepath,$<)))) $(call quote,$(call attresc,$(call fileuri,$<))) $(call quote,$(call attresc,$(call typeoffile,$<))) $(call quote,$(call attresc,$(call fileuri,$(call parsed,$<)))) >|$(call quote,$@)
-
# Parse the files.
#
# Even plain X·M·L files are parsed, because they may contain X·H·T·M·L `<script>´ elements which contain other kinds of data.
$(call parsed,$(sourcefiles) $(sourceincludes)) : % : $$(call unparsed,$$@) $(BUILDDIR)/parser.xslt $(PARSERLIBS) $(typeupdates)
$(call inform,$(PRINTF) '%s\n' $(call quote,Processing `$<´…) >&2)
$(silent)$(call ensuredirectory,$(dir $@))
- $(silent)$(if $(filter $<,$(assetfiles)),$(PRINTF) '%s\n' $(call quote,<?xml version="1.0"?><object xmlns="http://www.w3.org/1999/xhtml" type="$(call typeoffile,$<)" data="$(call datauri,$<)"/>) >|$(call quote,$@),$(if $(filter $<,$(plaintextfiles)),$(call wrapplaintext,$<),$(call serializexml,$<)) | $(XSLTPROC) --nonet --novalid --nomkdir --nowrite --stringparam BUILDTIME $$($(DATE) -u '+%Y-%m-%dT%H:%M:%SZ') --stringparam IDENTIFIER $(call quote,$(call localuri,$<))$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) $(call quote,$(BUILDDIR)/parser.xslt) - >|$(call quote,$@))
+ $(silent)$(if $(filter $<,$(assetfiles)),$(PRINTF) '%s\n' $(call quote,<?xml version="1.0"?><parsed xmlns="urn:fdc:ladys.computer:20231231:Shu1She4"><result><object xmlns="http://www.w3.org/1999/xhtml" type="$(call typeoffile,$<)" data="$(call datauri,$<)"/></result></parsed>) >|$(call quote,$@),$(if $(filter $<,$(plaintextfiles)),$(call wrapplaintext,$<),$(call serializexml,$<)) | $(XSLTPROC) --nonet --novalid --nomkdir --nowrite --stringparam BUILDTIME $$($(DATE) -u '+%Y-%m-%dT%H:%M:%SZ') --stringparam IDENTIFIER $(call quote,$(call localuri,$<))$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) $(call quote,$(abspath $(BUILDDIR)/parser.xslt)) - >|$(call quote,$@))
+
+# Extract the results from the parsed files.
+$(call parseresult,$(sourcefiles) $(sourceincludes)) : % : $$(call parsed,$$(call parsesource,$$@))
+ $(silent)$(call ensuredirectory,$(dir $@))
+ $(silent)$(PRINTF) '%s\n' '<transform xmlns="http://www.w3.org/1999/XSL/Transform" xmlns:s="urn:fdc:ladys.computer:20231231:Shu1She4" version="1.0"><template match="/"><copy-of select="s:parsed/s:result/node()"/></template></transform>' | $(XSLTPROC) --nonet --novalid --nomkdir --nowrite - $(call quote,$<) >|$(call quote,$@)
+
+# Generate R·D·F metadata for files.
+$(call metadata,$(sourcefiles) $(sourceincludes)) : % : $$(call datadata,$$@) $(THISDIR)/.metadata-format-changed-since
+ $(call inform,$(PRINTF) '%s\n' $(call quote,Generating metadata for `$<´…) >&2)
+ $(silent)$(call ensuredirectory,$(dir $@))
+ $(silent){ if $(TEST) ! -f $(call quote,$(BUILDDIR)/.mtime); then $(PRINTF) '%b' '\n' >|$(call quote,$(BUILDDIR)/.mtime); fi; $(TOUCH) -r $(call quote,$<) $(call quote,$(BUILDDIR)/.mtime); $(DIFF) -u $(call quote,$(BUILDDIR)/.mtime) /dev/null | $(SED) '1!d;s/.* \([^ ]*\) \([^ ]*\).*$$/\1T\2Z/'; $(CKSUM) $(call quote,$<) | $(SED) 's/[ ].*//'; } | $(xargsmultiquote) | $(XARGS) -E '' $(PRINTF) '<?xml version="1.0"?><书社vocab:$(if $(filter $<,$(sourceincludes)),IncludeFile,SourceFile) xmlns:nie="http://www.semanticdesktop.org/ontologies/2007/01/19/nie#" xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:书社vocab="urn:fdc:ladys.computer:20231231:Shu1She4:vocab:" rdf:about="%s" 书社vocab:path="%s" nfo:fileUrl="%s"><nie:interpretedAs>$(if $(filter $<,$(assetfiles)),<nfo:InformationElement nie:mimeType="%s"/>,<nfo:PlainTextDocument nie:mimeType="%s"/>)</nie:interpretedAs><书社vocab:hasParsedFile nfo:fileUrl="%s"/><书社vocab:hasParsedFileWithMetadata nfo:fileUrl="%s"/><nfo:fileLastModified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">%s</nfo:fileLastModified><nfo:hasHash nfo:hashAlgorithm="CRC32" nfo:hashValue="%s"/></书社vocab:$(if $(filter $<,$(sourceincludes)),IncludeFile,SourceFile)>' $(call quote,$(call attresc,$(call localuri,$<))) $(call quote,$(call attresc,$(if $(filter $<,$(sourceincludes)),$(call includepath,$<),$(call sourcepath,$<)))) $(call quote,$(call attresc,$(call fileuri,$<))) $(call quote,$(call attresc,$(call typeoffile,$<))) $(call quote,$(call attresc,$(call fileuri,$(call parseresult,$<)))) $(call quote,$(call attresc,$(call fileuri,$(call parsed,$<)))) >|$(call quote,$@)
# Collect the metadata into a single file, and generate the dependencies and destinations files as side·effects.
#
# Doing this all in one step reduces the number of calls to `xsltproc´ required, but requires that it be called from the build directory (necessitating a subshell).
-$(BUILDDIR)/dependencies $(BUILDDIR)/destinations $(BUILDDIR)/metadata : $(call diffprereqs,metadatas,$(call metadata,$(sort $(sourcefiles) $(sourceincludes)))) $(call parsed,$(filter-out $(assetfiles),$(sourcefiles) $(sourceincludes))) $(THISDIR)/lib/expandmetadata.xslt
+$(BUILDDIR)/dependencies $(BUILDDIR)/destinations $(BUILDDIR)/metadata : $(call diffprereqs,metadatas,$(call metadata,$(sort $(sourcefiles) $(sourceincludes)))) $$(call parseresult,$(sourcefiles) $(sourceincludes)) $(THISDIR)/lib/expandmetadata.xslt
$(call inform,$(PRINTF) '%s\n' 'Compiling metadata…' >&2)
$(silent){ $(PRINTF) '<?xml version="1.0"?><rdf:RDF xmlns:nie="http://www.semanticdesktop.org/ontologies/2007/01/19/nie#" xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:书社vocab="urn:fdc:ladys.computer:20231231:Shu1She4:vocab:"><书社vocab:BuildDirectory nfo:fileUrl="%s"/>' $(call quote,$(call attresc,$(call fileuri,$(BUILDDIR)))); {$(foreach meta,$(call metadata,$(sort $(sourcefiles) $(sourceincludes))), $(CAT) $(call quote,$(meta));) } | $(SED) 's/<?xml version="1.0"?>//g'; $(PRINTF) '%s\n' '</rdf:RDF>'; } | ( $(CD) $(call quote,$(BUILDDIR)); $(XSLTPROC) --nonet --novalid --nomkdir $(call quote,$(abspath $(THISDIR)/lib/expandmetadata.xslt)) - ) | $(XMLLINT) --nonet --nsclean - >|$(call quote,$(BUILDDIR)/metadata)
# • When the metadata of ⹐source files they depend on⹑ change.
#
# This is to reduce the number of needless regenerations of files with no substantial change.
-$(call compiled,$(compilablefiles)) : $(BUILDDIR)/results/% : $$(call parsed,$$(call uncompiled,$$@)) $$(call parsed,$$(call dependencies,$$(call uncompiled,$$@))) $(BUILDDIR)/transform.catalog $(TRANSFORMLIBS) $$(call metadata,$$(call dependencies,$$(call uncompiled,$$@)))
+$(call compiled,$(compilablefiles)) : $(BUILDDIR)/results/% : $$(call parseresult,$$(call uncompiled,$$@)) $$(call parseresult,$$(call dependencies,$$(call uncompiled,$$@))) $(BUILDDIR)/transform.catalog $(THISDIR)/lib/catalog2transform.xslt $(TRANSFORMLIBS) $$(call metadata,$$(call dependencies,$$(call uncompiled,$$@)))
$(call inform,$(PRINTF) '%s\n' $(call quote,Compiling </$*>…) >&2)
$(silent)$(call ensuredirectory,$(dir $@))
- $(silent)$(XSLTPROC) --nonet --novalid --nomkdir --nowrite --stringparam METADATA 'metadata' --stringparam BUILDTIME $$($(DATE) -u '+%Y-%m-%dT%H:%M:%SZ') --stringparam IDENTIFIER $(call quote,$(call localuri,$(call uncompiled,$@)))$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) $(call quote,$(BUILDDIR)/transform.xslt) $(call quote,$<) >|$(call quote,$@)
+ $(silent)$(XSLTPROC) --nonet --novalid --nomkdir --nowrite --stringparam METADATA 'metadata' --stringparam BUILDTIME $$($(DATE) -u '+%Y-%m-%dT%H:%M:%SZ') --stringparam IDENTIFIER $(call quote,$(call localuri,$(call uncompiled,$@)))$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) --stringparam DESTINATION $(call quote,$*) $(call quote,$(BUILDDIR)/transform.xslt) $(call quote,$<) >|$(call quote,$@)
# Create the final files from the compiled results (or error in the case of recursive ones).
-$(call built,$(compilablefiles)) : $(BUILDDIR)/public/% : $(BUILDDIR)/results/%
+$(call built,$(compilablefiles)) : $(BUILDDIR)/public/% : $(BUILDDIR)/results/% $(THISDIR)/lib/archive2extractor.xslt
$(call inform,$(PRINTF) '%s\n' $(call quote,Building </$*>…) >&2)
$(silent)$(call ensuredirectory,$(dir $@))
$(silent)$(RM) -f -R $(call quote,$@)
# ─ ¶ Non‐Recipe Variable Definitions ─────────────────────────────────
# Non·empty if this is a two‐step build.
-override twostep := $(if $(DATADIR),$(shell if $(TEST) -d $(call quote,$(DATADIR)); then $(PRINTF) '%s\n' '1'; fi),)
+override twostep := $(if $(DATADIR),$(call not,$(shell for dir in $(foreach dir,$(DATADIR),$(call quote,$(dir))); do if $(TEST) '!' -d "$$dir"; then $(PRINTF) '%s\n' '0'; fi; done)),)
# Pair each source magic file with its location in the build directory.
override magicpair := $(foreach magicfile,$(MAGIC),$(magicfile)|$(BUILDDIR)/magic/$(call namehash,$(magicfile)))
shusheopts := MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:default'
else
# (overridable) Options to use when calling ⛩📰 书社 the first time.
-shushedataopts := INCLUDEDIR=$(call quote,$(DATADIR)) BUILDDIR=$(call quote,$(BUILDDIR)/data) FINDRULES=$(subst $$,$$$$,$(call quote,$(FINDRULES) -a '(' $(FINDDATARULES) ')')) FINDINCLUDERULES=$(subst $$,$$$$,$(call quote,$(FINDINCLUDERULES))) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:default'
+shushedataopts := $(and $(DATAOPTS),$(DATAOPTS)$(space))INCLUDEDIR=$(call varquote,$(DATADIR)) BUILDDIR=$(call varquote,$(BUILDDIR)/data) FINDRULES=$(call varquote,$(FINDRULES) -a '(' $(FINDDATARULES) ')') FINDINCLUDERULES=$(call varquote,$(FINDINCLUDERULES)) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:default'
# (overridable) Options to use when calling ⛩📰 书社 the second time.
-shushesiteopts := INCLUDEDIR=$(call quote,$(INCLUDEDIR) $(BUILDDIR)/data/public) BUILDDIR=$(call quote,$(BUILDDIR)/site) FINDRULES=$(subst $$,$$$$,$(call quote,$(FINDRULES) -a '!' '(' $(FINDDATARULES) ')')) FINDINCLUDERULES=$(subst $$,$$$$,$(call quote,$(FINDINCLUDERULES))) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:default'
+shushesiteopts := INCLUDEDIR=$(call varquote,$(INCLUDEDIR) $(BUILDDIR)/data/public) BUILDDIR=$(call varquote,$(BUILDDIR)/site) FINDRULES=$(call varquote,$(FINDRULES) -a '!' '(' $(FINDDATARULES) ')') FINDINCLUDERULES=$(call varquote,$(FINDINCLUDERULES)) MODE='urn:fdc:ladys.computer:20231231:Shu1She4:mode:default'
endif
# ─ ¶ Recipe Variable Definitions ─────────────────────────────────────
ifneq ($(twostep),)
# Build the data and remove outdated data files.
data : $(BUILDDIR)/data.out
- $(silent)$(FIND) $(call quote,$(BUILDDIR)/data/public) '!' -exec $(GREP) -F -q -x '{}' $(call quote,$<) ';' -a '(' -type d -o -print ')' | $(xargsmultiquote) | $(XARGS) -E '' $(RM)
+ $(silent)$(FIND) $(call quote,$(BUILDDIR)/data/public) '!' '(' -exec $(GREP) -F -q -x '{}' $(call quote,$<) ';' -a -prune ')' -a '(' -type d -o -print ')' | $(xargsmultiquote) | $(XARGS) -E '' $(RM)
endif
# Provide help.
<!--
-SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: CC0-1.0
-->
# ⛩📰 书社
| `exsl:` | `http://exslt.org/common` |
| `exslstr:` | `http://exslt.org/strings` |
| `html:` | `http://www.w3.org/1999/xhtml` |
+| `rdf:` | `http://www.w3.org/1999/02/22-rdf-syntax-ns#` |
| `svg:` | `http://www.w3.org/2000/svg` |
| `xlink:` | `http://www.w3.org/1999/xlink` |
| `xslt:` | `http://www.w3.org/1999/XSL/Transform` |
default, to enable additional rules without overriding the existing
ones.
+- **`DATAOPTS`:**
+ Additional options to use when calling Make during the first stage of a two‐stage build using `DATADIR`.
+
+ This can be used to override variables which are only applicable during the second stage.
+ Note that when supplying this variable on the shell, it will need to be double‐quoted.
+
- **`DATAEXT`:**
A list of file extensions which signify “data” files during a two‐stage build using `DATADIR`.
default, to enable additional rules without overriding the existing
ones.
+- **`FINDFILTERONLY`:**
+ A semicolon‐separated list of regular expressions, at least one of which the paths for sources and includes are required to match, unless empty (default: empty).
+
+- **`FINDFILTEROUT`:**
+ A semicolon‐separated list of regular expressions, each of which matches paths that should _not_ be considered sources or includes (default: empty).
+
+- **`FINDINCLUDEFILTERONLY`:**
+ A semicolon‐separated list of regular expressions, at least one of which the paths for includes are required to match, unless empty (default: empty).
+
+ Note that only paths which already match `FINDFILTERONLY` are considered.
+
+- **`FINDINCLUDEFILTEROUT`:**
+ A semicolon‐separated list of regular expressions, each of which matches paths that should _not_ be considered includes, but may still be considered sources (default: empty).
+
+- **`FINDFILTERONLYEXTENDED`:**
+ If non·empty, `FINDFILTERONLY` is an extended regular expression; otherwise, it is basic (default: empty).
+
+- **`FINDFILTEROUTEXTENDED`:**
+ If non·empty, `FINDFILTEROUT` is an extended regular expression; otherwise, it is basic (default: matches `FINDFILTERONLYEXTENDED`).
+
+- **`FINDINCLUDEFILTERONLYEXTENDED`:**
+ If non·empty, `FINDINCLUDEFILTERONLY` is an extended regular expression; otherwise, it is basic (default: matches `FINDFILTERONLYEXTENDED`).
+
+- **`FINDINCLUDEFILTEROUTEXTENDED`:**
+ If non·empty, `FINDINCLUDEFILTEROUT` is an extended regular expression; otherwise, it is basic (default: `1` if either `FINDFILTEROUTEXTENDED` or `FINDINCLUDEFILTERONLYEXTENDED` is non·empty).
+
- **`PARSERS`:**
A white·space‐separated list of parsers to use (default:
`$(THISDIR)/parsers/*.xslt`).
- A `@书社:media-type` attribute, giving the identified media type of
the plaintext node.
+### Parsed metadata
+
+It is possible to extract metadata from a document at the same time as
+ it is being parsed.
+This is done by creating result elements in the `书社:about` mode;
+ these should be R·D·F property elements which apply to the conceptual
+ entity that is the document being parsed.
+
+During transformation, metadata for the file with identifier `$FILE`
+ can be read from the children of
+ `$书社:about//*[@rdf:about=$FILE]/nie:interpretedAs/*`.
+
## Output Redirection
By default, ⛩📰 书社 installs files to the same location in `DESTDIR`
This attribute is read after parsing, but before transformation (where
it is silently dropped).
+Multiple destinations can be provided if the same file should be output to multiple places.
+The file is retransformed each time, with the value of the `DESTINATION` global param set appropriately.
+
## Embedding
Documents can be embedded in other documents using a `<书社:link>`
This conversion happens during the finalization phase, after the main
transformation.
+- **`transforms/expansion.xslt`:**
+ Performs embedding, as described above.
+
- **`transforms/metadata.xslt`:**
Provides basic `<html:head>` metadata.
This metadata is generated from `<html:meta>` elements with one of
- **`THISREV`:**
The value of the `THISREV` variable (if present).
+In transforms, the following params are additionally available :—
+
+- **`DESTINATION`:**
+ The destination being targeted by this transform.
+
+- **`书社:about`:**
+ R·D·F metadata about all of the documents ⛩📰 书社 knows about.
+ Use `$书社:about//*[@rdf:about=$IDENTIFIER]` to get the metadata for
+ the current document.
+
+- **`书社:source`:**
+ The parsed source document being transformed, prior to any expansion.
+
+- **`书社:expansion`:**
+ The document after the all embeds have been expanded.
+ Unavailable during the `书社:expand` stage.
+
+- **`书社:result`:**
+ The document after the main set of transformations have been applied.
+ Only available during the `书社:finalize` stage, where it is used to
+ apply output wrapping and other clean·up.
+
## Output Wrapping
Provided at least one toplevel result element belongs to the H·T·M·L
<?xml version="1.0"?>
<!--
-SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: MPL-2.0
-->
<!--
⁌ ⛩📰 书社 ∷ lib/archive2extractor.xslt
-© 2024 Lady [@ Ladys Computer].
+© 2024–2025 Lady [@ Ladys Computer].
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
<xslt:variable name="href">
<value-of select="@书社:archived-as"/>
</xslt:variable>
- <xslt:copy-of select="书社:archive/*[@书社:archived-as=$href][1]"/>
+ <xslt:for-each select="书社:archive/*[@书社:archived-as=$href][1]">
+ <xslt:copy>
+ <xslt:copy-of select="@*[not(namespace-uri()='urn:fdc:ladys.computer:20231231:Shu1She4' and local-name()='archived-as')]|node()"/>
+ </xslt:copy>
+ </xslt:for-each>
</exsl:document>
<xslt:text>
<value-of select="$href"/>
<?xml version="1.0"?>
<!--
-SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: MPL-2.0
-->
<!--
⁌ ⛩📰 书社 ∷ lib/catalog2parser.xslt
-© 2023–2024 Lady [@ Ladys Computer].
+© 2023–2025 Lady [@ Ladys Computer].
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
-->
+<!DOCTYPE transform [
+ <!ENTITY rdf "http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
xmlns:catalog="urn:oasis:names:tc:entity:xmlns:xml:catalog"
xmlns:exsl="http://exslt.org/common"
xmlns:exslstr="http://exslt.org/strings"
xmlns:html="http://www.w3.org/1999/xhtml"
- xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#"
- xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xslt="http://www.w3.org/1999/XSL/TransformAlias"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
</xslt:for-each>
</xslt:template>
<xslt:template match="/">
- <xslt:apply-templates select="node()" mode="书社:parse"/>
+ <xslt:variable name="about">
+ <xslt:apply-templates select="node()" mode="书社:about"/>
+ </xslt:variable>
+ <xslt:variable name="result">
+ <xslt:apply-templates select="node()" mode="书社:parse"/>
+ </xslt:variable>
+ <xslt:element name="书社:parsed">
+ <xslt:element name="书社:result">
+ <xslt:copy-of select="$result"/>
+ </xslt:element>
+ <xslt:element name="书社:metadata">
+ <xslt:element name="rdf:RDF" namespace="&rdf;">
+ <xslt:element name="rdf:Description" namespace="&rdf;">
+ <xslt:copy-of select="$about"/>
+ </xslt:element>
+ </xslt:element>
+ </xslt:element>
+ </xslt:element>
</xslt:template>
<xslt:template match="@*|node()" priority="-1">
<xslt:copy>
<xslt:apply-templates select="@*|node()" mode="书社:parse"/>
</xslt:copy>
</xslt:template>
+ <xslt:template match="@*|node()" mode="书社:about" priority="-1">
+ <xslt:apply-templates select="@*|node()" mode="书社:about"/>
+ </xslt:template>
<xslt:template match="html:script[@type]" mode="书社:parse" priority="1">
<xslt:variable name="parserdiv" select="exsl:node-set($书社:parsers)//html:div[html:dd=current()/@type]"/>
<xslt:choose>
<xslt:when test="$parserdiv">
- <xslt:variable name="result">
+ <xslt:variable name="result-fragment">
<xslt:apply-templates select="."/>
</xslt:variable>
- <xslt:variable name="reparsed-result">
- <xslt:apply-templates select="exsl:node-set($result)/node()" mode="书社:parse"/>
+ <xslt:variable name="applied-fragment">
+ <xslt:call-template name="书社:apply-parsed-by">
+ <xslt:with-param name="id" select="string($parserdiv/html:dt)"/>
+ <xslt:with-param name="media-type" select="string(@type)"/>
+ <xslt:with-param name="result" select="exsl:node-set($result-fragment)"/>
+ </xslt:call-template>
</xslt:variable>
- <xslt:call-template name="书社:apply-parsed-by">
- <xslt:with-param name="id" select="string($parserdiv/html:dt)"/>
- <xslt:with-param name="media-type" select="string(@type)"/>
- <xslt:with-param name="result" select="exsl:node-set($reparsed-result)"/>
- </xslt:call-template>
+ <xslt:apply-templates select="exsl:node-set($applied-fragment)/node()" mode="书社:parse"/>
</xslt:when>
<xslt:otherwise>
<xslt:apply-templates select="."/>
<?xml version="1.0"?>
<!--
-SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: MPL-2.0
-->
<!--
⁌ ⛩📰 书社 ∷ lib/catalog2transform.xslt
-© 2023–2024 Lady [@ Ladys Computer].
+© 2023–2025 Lady [@ Ladys Computer].
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
-->
<!DOCTYPE transform [
<!ENTITY 书社 "urn:fdc:ladys.computer:20231231:Shu1She4">
+ <!ENTITY xhtml "http://www.w3.org/1999/xhtml">
<!ENTITY xml "http://www.w3.org/XML/1998/namespace">
]>
<transform
xmlns:exsl="http://exslt.org/common"
xmlns:exslfunc="http://exslt.org/functions"
xmlns:exslstr="http://exslt.org/strings"
- xmlns:html="http://www.w3.org/1999/xhtml"
- xmlns:nie="http://www.semanticdesktop.org/ontologies/2007/01/19/nie#"
+ xmlns:html="&xhtml;"
xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
</if>
</for-each>
</variable>
- <xslt:transform exclude-result-prefixes="nie nfo" extension-element-prefixes="exsl exslfunc exslstr" version="1.0">
+ <xslt:transform exclude-result-prefixes="nfo 书社vocab" extension-element-prefixes="exsl exslfunc exslstr" version="1.0">
<xslt:param name="BUILDTIME" select="'1972-12-31T00:00:00Z'"/>
+ <xslt:param name="DESTINATION" select="false()"/>
<xslt:param name="IDENTIFIER" select="false()"/>
<xslt:param name="SRCREV" select="false()"/>
<xslt:param name="THISREV" select="false()"/>
</apply-templates>
</xslt:variable>
<xslt:variable name="书社:about" select="exsl:node-set($书社:about-fragment)"/>
+ <for-each select="//catalog:uri">
+ <xslt:include href="{@uri}">
+ <attribute name="书社:id">
+ <value-of select="@name"/>
+ </attribute>
+ </xslt:include>
+ </for-each>
<xslt:variable name="书社:expansion-fragment">
<xslt:apply-templates select="$书社:source/node()" mode="书社:expand"/>
</xslt:variable>
</xslt:variable>
<xslt:variable name="书社:result" select="书社:document-with-attributes-applied(exsl:node-set($书社:result-fragment))"/>
<xslt:variable name="书社:destination" select="string($书社:about//*[@rdf:about=$IDENTIFIER]/@书社vocab:destination)"/>
- <for-each select="//catalog:uri">
- <xslt:include href="{@uri}">
- <attribute name="书社:id">
- <value-of select="@name"/>
- </attribute>
- </xslt:include>
- </for-each>
<xslt:template name="书社:apply-attributes">
<xslt:param name="context-nodes" select="/.."/>
<xslt:param name="destination-nodes" select="/.."/>
<xslt:apply-templates select="$modalinput/node()" mode="书社:metadata"/>
</xslt:variable>
<xslt:variable name="metadata" select="exsl:node-set($metadata-fragment)"/>
- <html:html>
+ <xslt:element name="html" namespace="&xhtml;">
<xslt:copy-of select="$nodes[self::html:html]/@*"/>
<xslt:if test="not($nodes[self::html:html]/@书社:archived-as) and $nodes/@书社:archived-as">
<xslt:attribute name="书社:archived-as">
<xslt:value-of select="$nodes[self::html:*]/@lang|$nodes[self::svg:*]/@lang|$nodes/@xml:lang"/>
</xslt:attribute>
</xslt:if>
- <html:head>
+ <xslt:element name="head" namespace="&xhtml;">
<xslt:copy-of select="$nodes[self::html:html]/html:head/@*|$nodes[self::html:head]/@*"/>
- <html:title>
+ <xslt:element name="title" namespace="&xhtml;">
<xslt:for-each select="$metadata/html:title">
<xslt:value-of select="."/>
<xslt:if test="position()!=last()">
</xslt:text>
</xslt:if>
</xslt:for-each>
- </html:title>
+ </xslt:element>
<xslt:copy-of select="$metadata/node()[not(self::html:title or self::html:meta and @name='generator')]"/>
- <html:meta name="generator">
+ <xslt:element name="meta" namespace="&xhtml;">
+ <xslt:attribute name="name">
+ <xslt:text>
+ <text>generator</text>
+ </xslt:text>
+ </xslt:attribute>
<xslt:attribute name="content">
<xslt:for-each select="$metadata/html:meta[@name='generator']">
<xslt:value-of select="@content"/>
</xslt:text>
</xslt:if>
</xslt:attribute>
- </html:meta>
- </html:head>
- <html:body>
- <xslt:copy-of select="$nodes[self::html:html]/html:body/@*|$nodes[self::html:body]/@*"/>
+ </xslt:element>
+ </xslt:element>
+ <xslt:element name="body" namespace="&xhtml;">
+ <xslt:copy-of select="($nodes[self::html:html]/html:body/@*|$nodes[self::html:body]/@*)[not(namespace-uri()='&书社;' and local-name()='archived-as')]"/>
<xslt:apply-templates select="$modalinput/node()" mode="书社:header"/>
- <xslt:copy-of select="$nodes[not(self::html:html or self::html:head or self::html:body)]|$nodes[self::html:html]/node()[not(self::html:head or self::html:body)]|$nodes[self::html:html]/html:body/node()|$nodes[self::html:body]/node()"/>
+ <xslt:for-each select="$nodes[not(self::html:html or self::html:head or self::html:body)]|$nodes[self::html:html]/node()[not(self::html:head or self::html:body)]|$nodes[self::html:html]/html:body/node()|$nodes[self::html:body]/node()">
+ <xslt:copy>
+ <xslt:copy-of select="@*[not(namespace-uri()='&书社;' and local-name()='archived-as')]|node()"/>
+ </xslt:copy>
+ </xslt:for-each>
<xslt:apply-templates select="$modalinput/node()" mode="书社:footer"/>
- </html:body>
- </html:html>
+ </xslt:element>
+ </xslt:element>
</xslt:template>
<xslt:template match="/">
<xslt:variable name="finalization-fragment">
<xslt:apply-templates select="@*|node()" mode="书社:apply"/>
</xslt:copy>
</xslt:template>
- <xslt:template match="书社:link[@xlink:show='embed' and (not(@xlink:actuate) or @xlink:actuate='none')]" mode="书社:expand" priority="1">
- <xslt:variable name="link" select="."/>
- <xslt:variable name="identifier" select="string(@xlink:href)"/>
- <xslt:variable name="is-dir" select="substring($identifier, string-length($identifier))='/'"/>
- <xslt:variable name="included" select="$书社:about//*[@rdf:about=$identifier or $is-dir and starts-with(@rdf:about, $identifier)]"/>
- <xslt:choose>
- <xslt:when test="$included">
- <xslt:for-each select="$included">
- <xslt:sort select="@rdf:about" data-type="text" lang="zxx" case-order="upper-first"/>
- <xslt:variable name="uri" select="书社vocab:hasParsedFile/@nfo:fileUrl"/>
- <xslt:variable name="expanded">
- <xslt:apply-templates select="document($uri)" mode="书社:expand">
- <xslt:with-param name="identifier" select="string(@rdf:about)"/>
- </xslt:apply-templates>
- </xslt:variable>
- <xslt:for-each select="exsl:node-set($expanded)/node()">
- <xslt:copy>
- <xslt:choose>
- <xslt:when test="self::html:*">
- <xslt:variable name="existing-types" select="exslstr:tokenize(@itemtype)"/>
- <xslt:attribute name="itemscope">itemscope</xslt:attribute>
- <xslt:attribute name="itemtype">
- <xslt:for-each select="$existing-types/token[string()!='&书社;:document']">
- <xslt:if test="position()!=1">
- <xslt:text>
- <text> </text>
- </xslt:text>
- </xslt:if>
- <xslt:value-of select="."/>
- </xslt:for-each>
- <xslt:if test="not($existing-types/token[string()='&书社;:embed'])">
- <xslt:if test="$existing-types/token[string()!='&书社;:document']">
- <xslt:text>
- <text> </text>
- </xslt:text>
- </xslt:if>
- <xslt:text>
- <text>&书社;:embed</text>
- </xslt:text>
- </xslt:if>
- </xslt:attribute>
- <xslt:choose>
- <xslt:when test="$link/@书社:archived-as">
- <xslt:copy-of select="$link/@书社:archived-as"/>
- </xslt:when>
- <xslt:when test="@书社:archived-as">
- <xslt:copy-of select="@书社:archived-as"/>
- </xslt:when>
- </xslt:choose>
- <xslt:copy-of select="@*[not(namespace-uri()='' and (local-name()='itemscope' or local-name()='itemtype')) and not(namespace-uri()='&书社;' and local-name()='archived-as')]|node()"/>
- </xslt:when>
- <xslt:otherwise>
- <xslt:choose>
- <xslt:when test="self::* and $link/@书社:archived-as">
- <xslt:copy-of select="$link/@书社:archived-as"/>
- </xslt:when>
- <xslt:when test="@书社:archived-as">
- <xslt:copy-of select="@书社:archived-as"/>
- </xslt:when>
- </xslt:choose>
- <xslt:copy-of select="@*[not(namespace-uri()='&书社;' and local-name()='archived-as')]|node()"/>
- </xslt:otherwise>
- </xslt:choose>
- </xslt:copy>
- </xslt:for-each>
- </xslt:for-each>
- </xslt:when>
- <xslt:otherwise>
- <xslt:copy>
- <xslt:apply-templates select="@*|node()" mode="书社:expand"/>
- </xslt:copy>
- </xslt:otherwise>
- </xslt:choose>
- </xslt:template>
- <xslt:template match="/node()" mode="书社:expand" priority="0">
- <xslt:param name="identifier" select="$IDENTIFIER"/>
- <xslt:copy>
- <xslt:if test="self::*">
- <xslt:attribute name="书社:cksum">
- <xslt:value-of select="$书社:about//*[@rdf:about=$identifier]/nfo:hasHash[@nfo:hashAlgorithm='CRC32']/@nfo:hashValue"/>
- </xslt:attribute>
- <xslt:attribute name="书社:identifier">
- <xslt:value-of select="$identifier"/>
- </xslt:attribute>
- <xslt:attribute name="书社:mtime">
- <xslt:value-of select="$书社:about//*[@rdf:about=$identifier]/nfo:fileLastModified"/>
- </xslt:attribute>
- </xslt:if>
- <xslt:choose>
- <xslt:when test="self::html:*">
- <xslt:variable name="existing-types" select="exslstr:tokenize(@itemtype)"/>
- <xslt:attribute name="itemscope">itemscope</xslt:attribute>
- <xslt:attribute name="itemtype">
- <xslt:for-each select="$existing-types/token">
- <xslt:if test="position()!=1">
- <xslt:text>
- <text> </text>
- </xslt:text>
- </xslt:if>
- <xslt:value-of select="."/>
- </xslt:for-each>
- <xslt:if test="not($existing-types/token[string()='&书社;:embed' or string()='&书社;:document'])">
- <xslt:if test="$existing-types/token">
- <xslt:text>
- <text> </text>
- </xslt:text>
- </xslt:if>
- <xslt:text>
- <text>&书社;:document</text>
- </xslt:text>
- </xslt:if>
- </xslt:attribute>
- <xslt:apply-templates select="@*[not(namespace-uri()='' and (local-name()='itemscope' or local-name()='itemtype') or namespace-uri()='&书社;' and (local-name()='cksum' or local-name()='identifier' or local-name()='mtime'))]|node()" mode="书社:expand"/>
- </xslt:when>
- <xslt:otherwise>
- <xslt:apply-templates select="@*[not(namespace-uri()='&书社;' and (local-name()='cksum' or local-name()='identifier' or local-name()='mtime'))]|node()" mode="书社:expand"/>
- </xslt:otherwise>
- </xslt:choose>
- </xslt:copy>
- </xslt:template>
<xslt:template match="@*|node()" mode="书社:expand" priority="-1">
<xslt:copy>
<xslt:apply-templates select="@*|node()" mode="书社:expand"/>
</xslt:copy>
</xslt:template>
- <xslt:template match="text()" mode="书社:header"/>
+ <xslt:template match="text()" mode="书社:header" priority="-1"/>
<xslt:template match="书社:archive" mode="书社:finalize" priority="1">
<xslt:copy>
<xslt:apply-templates select="@*" mode="书社:finalize"/>
<xslt:apply-templates select="@*|node()" mode="书社:finalize"/>
</xslt:copy>
</xslt:template>
- <xslt:template match="text()" mode="书社:footer"/>
- <xslt:template match="text()" mode="书社:metadata"/>
+ <xslt:template match="text()" mode="书社:footer" priority="-1"/>
+ <xslt:template match="text()" mode="书社:metadata" priority="-1"/>
<xslt:output method="xml" encoding="UTF-8" cdata-section-elements="html:script html:style html:textarea 书社:raw-output 书社:raw-text"/>
</xslt:transform>
</template>
<?xml version="1.0"?>
<!--
-SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: MPL-2.0
-->
<!--
⁌ ⛩📰 书社 ∷ lib/expandmetadata.xslt
-© 2023–2024 Lady [@ Ladys Computer].
+© 2023–2025 Lady [@ Ladys Computer].
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
xmlns:exsl="http://exslt.org/common"
+ xmlns:exslstr="http://exslt.org/strings"
xmlns:nie="http://www.semanticdesktop.org/ontologies/2007/01/19/nie#"
xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
xmlns:书社vocab="urn:fdc:ladys.computer:20231231:Shu1She4:vocab:"
- extension-element-prefixes="exsl"
+ extension-element-prefixes="exsl exslstr"
version="1.0"
>
<variable name="builddir" select="//书社vocab:BuildDirectory/@nfo:fileUrl"/>
</otherwise>
</choose>
</template>
+ <template match="nie:interpretedAs/*" priority="1">
+ <copy>
+ <apply-templates select="@*|node()"/>
+ <for-each select="../../书社vocab:hasParsedFileWithMetadata">
+ <copy-of select="document(@nfo:fileUrl)/书社:parsed/书社:metadata/rdf:RDF/rdf:Description/node()"/>
+ </for-each>
+ </copy>
+ </template>
<template match="//书社vocab:SourceFile[not(nie:interpretedAs/nfo:PlainTextDocument)]" priority="1">
<copy>
<apply-templates select="@*"/>
- <attribute name="书社vocab:destination">
- <value-of select="@书社vocab:path"/>
- </attribute>
<apply-templates select="node()"/>
+ <element name="书社vocab:destination">
+ <value-of select="@书社vocab:path"/>
+ </element>
</copy>
</template>
<template match="//书社vocab:SourceFile[nie:interpretedAs/nfo:PlainTextDocument]" priority="1">
<variable name="parsed" select="document(书社vocab:hasParsedFile/@nfo:fileUrl)"/>
- <variable name="destination-delim" select="concat('/', $parsed/*/@书社:destination, '/')"/>
- <variable name="destination">
- <choose>
- <when test="not(contains($destination-delim, '//') or contains($destination-delim, '/./') or contains($destination-delim, '/../'))">
- <value-of select="$parsed/*/@书社:destination"/>
- </when>
- <otherwise>
- <value-of select="@书社vocab:path"/>
- </otherwise>
- </choose>
+ <variable name="provided-destinations" select="normalize-space($parsed/*/@书社:destination)"/>
+ <variable name="destinations-fragment">
+ <if test="$provided-destinations!=''">
+ <for-each select="exslstr:tokenize($provided-destinations)">
+ <element name="书社vocab:destination">
+ <value-of select="."/>
+ </element>
+ </for-each>
+ </if>
</variable>
<variable name="dependencies-fragment">
<apply-templates select="." mode="书社:dependencies"/>
</variable>
<variable name="dependencies" select="exsl:node-set($dependencies-fragment)"/>
+ <variable name="destinations" select="exsl:node-set($destinations-fragment)/node()"/>
+ <variable name="bad-destinations-fragment">
+ <for-each select="$destinations">
+ <variable name="destination-delim" select="concat('/', ., '/')"/>
+ <if test="contains($destination-delim, '//') or contains($destination-delim, '/./') or contains($destination-delim, '/../')">
+ <copy-of select="."/>
+ </if>
+ </for-each>
+ </variable>
+ <variable name="bad-destinations" select="exsl:node-set($bad-destinations-fragment)/node()"/>
<copy>
<apply-templates select="@*"/>
- <attribute name="书社vocab:destination">
- <value-of select="$destination"/>
- </attribute>
<apply-templates select="node()"/>
<for-each select="$dependencies/书社:dependency">
<书社vocab:hasDependencyOn rdf:resource="{.}"/>
<for-each select="$dependencies/书社:recursive-dependency">
<书社vocab:hasRecursiveDependencyOn rdf:resource="{.}"/>
</for-each>
+ <choose>
+ <when test="not($destinations)">
+ <element name="书社vocab:destination">
+ <value-of select="@书社vocab:path"/>
+ </element>
+ </when>
+ <when test="$bad-destinations">
+ <message terminate="no">
+ <text>Bad destinations: </text>
+ <for-each select="$bad-destinations">
+ <if test="position()>1">
+ <text> </text>
+ </if>
+ <text><</text>
+ <value-of select="."/>
+ <text>></text>
+ </for-each>
+ </message>
+ <element name="书社vocab:destination">
+ <value-of select="@书社vocab:path"/>
+ </element>
+ </when>
+ <otherwise>
+ <for-each select="$destinations">
+ <element name="书社vocab:destination">
+ <value-of select="."/>
+ </element>
+ </for-each>
+ </otherwise>
+ </choose>
</copy>
</template>
<template match="//书社vocab:IncludeFile[nie:interpretedAs/nfo:PlainTextDocument]" priority="1">
</for-each>
</copy>
</template>
+ <template match="书社vocab:hasParsedFileWithMetadata" priority="1"/>
<template match="/">
<variable name="result-fragment">
<apply-templates/>
<for-each select="$result//书社vocab:SourceFile">
<value-of select="@rdf:about"/>
<text>|</text>
- <value-of select="@书社vocab:destination"/>
+ <for-each select="书社vocab:destination">
+ <if test="position()>1">
+ <text>;</text>
+ </if>
+ <value-of select="."/>
+ </for-each>
<text>
</text>
</for-each>
</exsl:document>
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
-->
+<!DOCTYPE transform [
+ <!ENTITY xhtml 'http://www.w3.org/1999/xhtml'>
+]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
- xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns:html="&xhtml;"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
version="1.0"
>
<书社:id>urn:fdc:ladys.computer:20231231:Shu1She4:plain.xslt</书社:id>
<template match="html:script[@type='text/plain']">
- <html:pre><value-of select="."/></html:pre>
+ <element name="pre" namespace="&xhtml;">
+ <value-of select="."/>
+ </element>
</template>
</transform>
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
-->
+<!DOCTYPE transform [
+ <!ENTITY xhtml 'http://www.w3.org/1999/xhtml'>
+]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
xmlns:exsl="http://exslt.org/common"
xmlns:exslstr="http://exslt.org/strings"
- xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns:html="&xhtml;"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
extension-element-prefixes="exsl exslstr"
version="1.0"
<书社:id>urn:fdc:ladys.computer:20231231:Shu1She4:record-jar.xslt</书社:id>
<template match="html:script[@type='text/record-jar']">
<variable name="lines" select="exslstr:tokenize(., '
')"/>
- <html:div>
+ <element name="div" namespace="&xhtml;">
<if test="starts-with($lines[1], '%%') and substring-after($lines[1], '%%')!=''">
<comment>
<value-of select="substring-after($lines[1], '%%')"/>
<variable name="start" select="preceding-sibling::*[starts-with(., '%%')][1]"/>
<variable name="fields" select="($start/following-sibling::*|$lines[not($start)])[not(preceding-sibling::*[generate-id()=generate-id($end)]) and not(starts-with(., '%%'))]"/>
<if test="$fields">
- <html:dl>
+ <element name="dl" namespace="&xhtml;">
<for-each select="$fields">
<choose>
<when test="starts-with(., ' ') and $fields[generate-id()=generate-id(current()/preceding-sibling::*[1])]"/>
<otherwise>
<variable name="next" select="following-sibling::*[not(starts-with(., ' '))]"/>
- <html:div>
- <html:dt>
+ <element name="div" namespace="&xhtml;">
+ <element name="dt" namespace="&xhtml;">
<value-of select="normalize-space(substring-before(., ':'))"/>
- </html:dt>
- <html:dd>
+ </element>
+ <element name="dd" namespace="&xhtml;">
<variable name="firstline">
<choose>
<when test="contains(., ':')">
</otherwise>
</choose>
</for-each>
- </html:dd>
- </html:div>
+ </element>
+ </element>
</otherwise>
</choose>
</for-each>
- </html:dl>
+ </element>
</if>
<if test="substring-after(., '%%')!=''">
<comment>
</comment>
</if>
</for-each>
- </html:div>
+ </element>
</template>
</transform>
<?xml version="1.0"?>
<!--
-SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
SPDX-License-Identifier: MPL-2.0
-->
<!--
⁌ ⛩📰 书社 ∷ parsers/tsv.xslt
-© 2023–2024 Lady [@ Ladys Computer].
+© 2023–2025 Lady [@ Ladys Computer].
This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
-->
+<!DOCTYPE transform [
+ <!ENTITY xhtml 'http://www.w3.org/1999/xhtml'>
+]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
xmlns:exsl="http://exslt.org/common"
xmlns:exslstr="http://exslt.org/strings"
- xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns:html="&xhtml;"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
extension-element-prefixes="exsl exslstr"
version="1.0"
<with-param name="separator" select="'	'"/>
</call-template>
</variable>
- <html:table>
+ <element name="table" namespace="&xhtml;">
<for-each select="$lines[starts-with(., '#') and following-sibling::*[generate-id(.)=generate-id($head)]]">
<comment>
<value-of select="substring-after(., '#')"/>
</comment>
</for-each>
- <html:thead>
- <html:tr>
+ <element name="thead" namespace="&xhtml;">
+ <element name="tr" namespace="&xhtml;">
<for-each select="exsl:node-set($headcols)/*">
- <html:th scope="col">
+ <element name="th" namespace="&xhtml;">
+ <attribute name="scope">
+ <text>col</text>
+ </attribute>
<value-of select="."/>
- </html:th>
+ </element>
</for-each>
- </html:tr>
- </html:thead>
- <html:tbody>
+ </element>
+ </element>
+ <element name="tbody" namespace="&xhtml;">
<for-each select="$head/following-sibling::*[normalize-space(.)!='']">
<choose>
<when test="starts-with(., '#')">
<with-param name="separator" select="'	'"/>
</call-template>
</variable>
- <html:tr>
+ <element name="tr" namespace="&xhtml;">
<for-each select="exsl:node-set($cols)/*[count(exsl:node-set($headcols)/*)>=position()]">
- <html:td>
+ <element name="td" namespace="&xhtml;">
<attribute name="data-tsv-header">
<value-of select="exsl:node-set($headcols)/*[count(current()/preceding-sibling::*)+1]"/>
</attribute>
<value-of select="."/>
</for-each>
</if>
- </html:td>
+ </element>
</for-each>
<for-each select="exsl:node-set($headcols)/*[position()>count(exsl:node-set($cols)/*)]">
- <html:td/>
+ <element name="td" namespace="&xhtml;">
+ <attribute name="data-tsv-header">
+ <value-of select="."/>
+ </attribute>
+ </element>
</for-each>
- </html:tr>
+ </element>
</otherwise>
</choose>
</for-each>
- </html:tbody>
- </html:table>
+ </element>
+ </element>
</template>
</transform>
-->
<!DOCTYPE transform [
<!ENTITY wrapped "ancestor::html:html[not(parent::* or @书社:disable-output-wrapping)]">
+ <!ENTITY xhtml "http://www.w3.org/1999/xhtml">
]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
xmlns:exsl="http://exslt.org/common"
- xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns:html="&xhtml;"
xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
extension-element-prefixes="exsl"
version="1.0"
<书社:id>urn:fdc:ladys.computer:20231231:Shu1She4:asset.xslt</书社:id>
<template match="html:style[&wrapped; and not(ancestor::html:head)]|html:object[@type='text/css' and &wrapped;]" mode="书社:finalize" priority="0"/>
<template match="html:object[@type='text/javascript']" mode="书社:finalize" priority="0">
- <html:script type="{@type}" src="{@data}">
+ <element name="script" namespace="&xhtml;">
+ <attribute name="type">
+ <value-of select="@type"/>
+ </attribute>
+ <attribute name="src">
+ <value-of select="@data"/>
+ </attribute>
<copy-of select="@书社:identifier"/>
- </html:script>
+ </element>
</template>
<template match="html:object[starts-with(@type, 'audio/')]" mode="书社:finalize" priority="0">
- <html:audio controls="" src="{@data}">
+ <element name="audio" namespace="&xhtml;">
+ <attribute name="controls"/>
+ <attribute name="src">
+ <value-of select="@data"/>
+ </attribute>
<copy-of select="@书社:identifier"/>
- </html:audio>
+ </element>
</template>
<template match="html:object[starts-with(@type, 'image/') and not(@type='image/svg+xml')]" mode="书社:finalize" priority="0">
- <html:img src="{@data}">
+ <element name="img" namespace="&xhtml;">
+ <attribute name="src">
+ <value-of select="@data"/>
+ </attribute>
<copy-of select="@书社:identifier|@width|@height"/>
- </html:img>
+ </element>
</template>
<template match="html:object[starts-with(@type, 'video/')]" mode="书社:finalize" priority="0">
- <html:video controls="" src="{@data}">
+ <element name="video" namespace="&xhtml;">
+ <attribute name="controls"/>
+ <attribute name="src">
+ <value-of select="@data"/>
+ </attribute>
<copy-of select="@书社:identifier|@width|@height"/>
- </html:video>
+ </element>
</template>
<template match="书社:id[string(.)='urn:fdc:ladys.computer:20231231:Shu1She4:asset.xslt']" mode="书社:metadata">
<for-each select="$书社:expansion//html:object[@type='text/css']">
- <html:link rel="stylesheet" type="text/css" href="{@data}">
+ <element name="link" namespace="&xhtml;">
+ <attribute name="rel">
+ <text>stylesheet</text>
+ </attribute>
+ <attribute name="type">
+ <text>text/css</text>
+ </attribute>
+ <attribute name="href">
+ <value-of select="@data"/>
+ </attribute>
<copy-of select="@书社:identifier"/>
- </html:link>
+ </element>
</for-each>
<for-each select="$书社:expansion//html:style[not(ancestor::html:head)]">
<copy-of select="."/>
--- /dev/null
+<?xml version="1.0"?>
+<!--
+SPDX-FileCopyrightText: 2023, 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
+SPDX-License-Identifier: MPL-2.0
+-->
+<!--
+⁌ ⛩📰 书社 ∷ transforms/expansion.xslt
+
+© 2023–2025 Lady [@ Ladys Computer].
+
+This Source Code Form is subject to the terms of the Mozilla Public License, v 2.0.
+If a copy of the M·P·L was not distributed with this file, You can obtain one at <https://mozilla.org/MPL/2.0/>.
+-->
+<!DOCTYPE transform [
+ <!ENTITY 书社 'urn:fdc:ladys.computer:20231231:Shu1She4'>
+]>
+<transform
+ xmlns="http://www.w3.org/1999/XSL/Transform"
+ xmlns:exsl="http://exslt.org/common"
+ xmlns:exslstr="http://exslt.org/strings"
+ xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns:nfo="http://www.semanticdesktop.org/ontologies/2007/03/22/nfo#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:书社="&书社;"
+ xmlns:书社vocab="urn:fdc:ladys.computer:20231231:Shu1She4:vocab:"
+ exclude-result-prefixes="nfo 书社vocab"
+ extension-element-prefixes="exsl exslstr"
+ version="1.0"
+>
+ <书社:id>urn:fdc:ladys.computer:20231231:Shu1She4:expansion.xslt</书社:id>
+ <template match="书社:link[@xlink:show='embed' and (not(@xlink:actuate) or @xlink:actuate='none')]" mode="书社:expand" priority="1">
+ <variable name="link" select="."/>
+ <variable name="identifier" select="string(@xlink:href)"/>
+ <variable name="is-dir" select="substring($identifier, string-length($identifier))='/'"/>
+ <variable name="included" select="$书社:about//*[@rdf:about=$identifier or $is-dir and starts-with(@rdf:about, $identifier)]"/>
+ <choose>
+ <when test="$included">
+ <for-each select="$included">
+ <sort select="@rdf:about" data-type="text" lang="zxx" case-order="upper-first"/>
+ <variable name="uri" select="书社vocab:hasParsedFile/@nfo:fileUrl"/>
+ <variable name="expanded">
+ <apply-templates select="document($uri)" mode="书社:expand">
+ <with-param name="identifier" select="string(@rdf:about)"/>
+ </apply-templates>
+ </variable>
+ <for-each select="exsl:node-set($expanded)/node()">
+ <copy>
+ <choose>
+ <when test="self::html:*">
+ <variable name="existing-types" select="exslstr:tokenize(@itemtype)"/>
+ <attribute name="itemscope">itemscope</attribute>
+ <attribute name="itemtype">
+ <for-each select="$existing-types/token[string()!='&书社;:document']">
+ <if test="position()!=1">
+ <text> </text>
+ </if>
+ <value-of select="."/>
+ </for-each>
+ <if test="not($existing-types/token[string()='&书社;:embed'])">
+ <if test="$existing-types/token[string()!='&书社;:document']">
+ <text> </text>
+ </if>
+ <text>&书社;:embed</text>
+ </if>
+ </attribute>
+ <choose>
+ <when test="$link/@书社:archived-as">
+ <copy-of select="$link/@书社:archived-as"/>
+ </when>
+ <when test="@书社:archived-as">
+ <copy-of select="@书社:archived-as"/>
+ </when>
+ </choose>
+ <copy-of select="@*[not(namespace-uri()='' and (local-name()='itemscope' or local-name()='itemtype')) and not(namespace-uri()='&书社;' and local-name()='archived-as')]|node()"/>
+ </when>
+ <otherwise>
+ <choose>
+ <when test="self::* and $link/@书社:archived-as">
+ <copy-of select="$link/@书社:archived-as"/>
+ </when>
+ <when test="@书社:archived-as">
+ <copy-of select="@书社:archived-as"/>
+ </when>
+ </choose>
+ <copy-of select="@*[not(namespace-uri()='&书社;' and local-name()='archived-as')]|node()"/>
+ </otherwise>
+ </choose>
+ </copy>
+ </for-each>
+ </for-each>
+ </when>
+ <otherwise>
+ <copy>
+ <apply-templates select="@*|node()" mode="书社:expand"/>
+ </copy>
+ </otherwise>
+ </choose>
+ </template>
+ <template match="/node()" mode="书社:expand" priority="0">
+ <param name="identifier" select="$IDENTIFIER"/>
+ <copy>
+ <if test="self::*">
+ <attribute name="书社:cksum">
+ <value-of select="$书社:about//*[@rdf:about=$identifier]/nfo:hasHash[@nfo:hashAlgorithm='CRC32']/@nfo:hashValue"/>
+ </attribute>
+ <attribute name="书社:identifier">
+ <value-of select="$identifier"/>
+ </attribute>
+ <attribute name="书社:mtime">
+ <value-of select="$书社:about//*[@rdf:about=$identifier]/nfo:fileLastModified"/>
+ </attribute>
+ </if>
+ <choose>
+ <when test="self::html:*">
+ <variable name="existing-types" select="exslstr:tokenize(@itemtype)"/>
+ <attribute name="itemscope">itemscope</attribute>
+ <attribute name="itemtype">
+ <for-each select="$existing-types/token">
+ <if test="position()!=1">
+ <text> </text>
+ </if>
+ <value-of select="."/>
+ </for-each>
+ <if test="not($existing-types/token[string()='&书社;:embed' or string()='&书社;:document'])">
+ <if test="$existing-types/token">
+ <text> </text>
+ </if>
+ <text>&书社;:document</text>
+ </if>
+ </attribute>
+ <apply-templates select="@*[not(namespace-uri()='' and (local-name()='itemscope' or local-name()='itemtype') or namespace-uri()='&书社;' and (local-name()='cksum' or local-name()='identifier' or local-name()='mtime'))]|node()" mode="书社:expand"/>
+ </when>
+ <otherwise>
+ <apply-templates select="@*[not(namespace-uri()='&书社;' and (local-name()='cksum' or local-name()='identifier' or local-name()='mtime'))]|node()" mode="书社:expand"/>
+ </otherwise>
+ </choose>
+ </copy>
+ </template>
+</transform>
-->
<!DOCTYPE transform [
<!ENTITY attoplevel "not(ancestor::html:template) and ancestor::html:*[@itemscope and @itemtype='&书社;:document'] and not(ancestor::html:*[@itemscope]/ancestor::html:*[@itemscope and @itemtype='&书社;:document'] or preceding::html:*[@itemtype='&书社;:document'])">
+ <!ENTITY xhtml "http://www.w3.org/1999/xhtml">
<!ENTITY 书社 "urn:fdc:ladys.computer:20231231:Shu1She4">
]>
<transform
xmlns="http://www.w3.org/1999/XSL/Transform"
- xmlns:html="http://www.w3.org/1999/xhtml"
- xmlns:书社="urn:fdc:ladys.computer:20231231:Shu1She4"
+ xmlns:html="&xhtml;"
+ xmlns:书社="&书社;"
version="1.0"
>
<书社:id>urn:fdc:ladys.computer:20231231:Shu1She4:metadata.xslt</书社:id>
<template match="html:meta[not(@name) and @itemprop='&书社;:title'][&attoplevel;]" mode="书社:metadata">
- <html:title>
+ <element name="title" namespace="&xhtml;">
<value-of select="@content"/>
- </html:title>
+ </element>
</template>
</transform>
Lady’s Gitweb / Shushe / commitdiff