1 # SPDX-FileCopyrightText: 2023, 2024 Lady <https://www.ladys.computer/about/#lady>
2 # SPDX-License-Identifier: MPL-2.0
6 # โ ยง BASIC INFORMATION โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
7 override define makefileinfo
8 โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
9 โโก โ โฉ๏ธ๐ฐ ไนฆ็คพ โท GNUmakefile โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
10 โโฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ โ
11 โโฌ ยถ Prerequisites โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโข
13 โโ Requires GยทNยทU Make, at least version 3.81, a version of โโ
14 โโ uuencode with base64 support, and the various programs โโ
15 โโ offered by libxml2 and libxslt. Beyond this, only programs โโ
16 โโ required by Posix are required, altho there is a chance of โโ
17 โโ version incompatibilities. The full list of program โโ
18 โโ requirements is as follows :โ โโ
22 โโ โข cksum โโ
24 โโ โข date โโ
25 โโ โข echo โโ
26 โโ โข file โโ
27 โโ โข find โโ
28 โโ โข git (optional) โโ
30 โโ โข mkdir (requires support for `-pยด) โโ
32 โโ โข od (requires support for `-t x1ยด) โโ
33 โโ โข printf โโ
36 โโ โข sleep โโ
37 โโ โข stat โโ
38 โโ โข test โโ
39 โโ โข touch โโ
40 โโ โข tr (requires support for `-dยด) โโ
41 โโ โข uuencode (requires support for `-mยด and `-rยด) โโ
42 โโ โข uudecode (requires support for `-mยด and `-rยด) โโ
43 โโ โข xargs (requires support for `-0ยด) โโ
44 โโ โข xmlcatalog (provided by libxml2) โโ
45 โโ โข xmllint (provided by libxml2) โโ
46 โโ โข xsltproc (provided by libxslt) โโ
48 โโ In all cases, you can supply your own version of any โโ
49 โโ program `programยด by overriding the corresponding variable โโ
50 โโ `PROGRAMยด when calling Make. โโ
51 โโฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏโ
52 โโฌ ยถ Usage โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโข
54 โโ โข `make allยด (default): Compile, but do not install, all โโ
57 โโ โข `make cleanยด: Remove `BUILDDIRยด. โโ
59 โโ โข `make goneยด: Remove `BUILDDIRยด and installed files. โโ
61 โโ โข `make helpยด: Print this message. โโ
63 โโ โข `make installยด: Compile all files and install in โโ
64 โโ `DESTDIRยด. โโ
66 โโ โข `make listยด: List all recognized source files and their โโ
67 โโ classification (including media type and dependencies). โโ
69 โโ โข `make uninstallยด: Remove installed files, but not โโ
70 โโ `BUILDDIRยด. โโ
72 โโ Set `VERBOSE=1ยด to see the text of commands as they are โโ
73 โโ executed. โโ
75 โโ See `README.markdownยด for a more involved description of โโ
76 โโ the capabilities and configuration of this program. โโ
77 โโฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏโ
78 โโฌ ยถ Copyright & License โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโข
80 โโ Copyright ยฉ 2023โ2024 Lady [@ Ladyโs Computer]. โโ
82 โโ This Source Code Form is subject to the terms of the โโ
83 โโ Mozilla Public License, v 2.0. If a copy of the MยทPยทL was โโ
84 โโ not distributed with this file, You can obtain one at โโ
85 โโ <http://mozilla.org/MPL/2.0/>. โโ
86 โโฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏโ
87 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
90 # โ ยง MAKEยทFILE SETUP โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
92 # Programs needed to run this makeยทfile.
94 # If these are not installed on your computer, or you need to use a different implementation, you can override the appropriate variable.
119 XMLCATALOG := xmlcatalog
123 # The directory which contains the source files.
125 # Multiple directories can be given so long as files with the same name do not exist in each.
128 # The directory which contains โincludesโ:
129 # Files which may be included in other files but for which no final output will be generated.
131 # Multiple directories can be given so long as files with the same name do not exist in each.
133 # These can be inside of `SRCDIRยด directories if desired.
134 INCLUDEDIR := sources/includes
136 # The directory in which to generate temporary buildfiles.
139 # The directory into which to output files on `make installยด.
142 # The location of this Makefile (and related โฉ๏ธ๐ฐ ไนฆ็คพ files), relative to the current working directory.
144 # By default, this is inferred from the variable `MAKEFILE_LISTยด.
145 THISDIR := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST))))
147 # Configuration of `findยด.
149 # By default, `findยด will ignore files which begin with a period and those which are likely to cause problems for `makeยด.
151 EXTRAFINDINCLUDERULES :=
152 FINDRULES := ! '(' '(' -name '[.-]*' -o -name '*[][*?:|$$%\#\\; ]*' -o -name '*[)]' ')' -a -prune ')'$(if $(EXTRAFINDRULES), -a $(EXTRAFINDRULES),)
153 FINDINCLUDERULES := $(FINDRULES)$(if $(EXTRAFINDINCLUDERULES), -a $(EXTRAFINDINCLUDERULES),)
155 # The list of magic files to use when determining media types.
157 # Some are provided as part of this repository, but you can add more if you need different media type detection.
159 # Your computer probably has several already installed at `/usr/share/file/magicยด.
161 MAGIC := $(sort $(patsubst ./%,%,$(wildcard $(THISDIR)/magic/*)) $(EXTRAMAGIC))
163 # The list of parsers for plaintext file types.
165 # Which parsers are provided will influence which kinds of files are recognized as plaintext.
167 PARSERS := $(sort $(patsubst ./%,%,$(wildcard $(THISDIR)/parsers/*.xslt)) $(EXTRAPARSERS))
169 # The list of transforms.
171 TRANSFORMS := $(sort $(patsubst ./%,%,$(wildcard $(THISDIR)/transforms/*.xslt)) $(EXTRATRANSFORMS))
173 # List of types which should be treated as XยทMยทL.
174 XMLTYPES := application/xml text/xml
177 ifneq ($(wildcard $(THISDIR)/.git),)
178 # A description of the current git revision of โฉ๏ธ๐ฐ ไนฆ็คพ.
179 THISREV := $(shell cd $(THISDIR); $(GIT) describe 2> /dev/null || $(GIT) rev-parse HEAD 2> /dev/null || true)
182 ifneq ($(wildcard .git),)
183 # A description of the current git revision of the working directory.
184 SRCREV := $(shell $(GIT) describe 2> /dev/null || $(GIT) rev-parse HEAD 2> /dev/null || true)
188 # Set to a nonยทempty value to print all commands as they run.
191 # The default target for this makefile.
194 # โ ยง BEGIN MAKEยทFILE โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
196 # โ ยถ NonโRecipe Variable Definitions โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
198 # A variable with no value, usable when assigning values which contain whitespace.
201 # A variable which contains a newline, to allow the generation of multiline strings in function calls.
202 override define newline
207 # A variable which contains a single space.
208 override space := $(empty) $(empty)
210 # A variable which contains a single comma.
213 # (callable) Quote the given string for use within shell calls.
214 override quote = '$(subst ','"'"',$1)'
216 # Outputs an `@ยด to silence rules, unless `VERBOSEยด is nonempty.
217 override silent := $(if $(VERBOSE),,@)
219 # (callable) Test to see if the prerequisites provided by the second argument matches the value in the file corresponding to the first argument in `$(BUILDDIR)/lastprereqsยด.
220 # If not, save the new value and then add FORCE.
221 # Return them regardless.
223 # Calling this variable is useful when a given target should be updated whenever its list of prerequisites changes in addition to whenever there is a change to one of its prerequisites.
225 # โก This variable creates at least one subshell every time it is computed.
226 override diffprereqs = $(if $(subst $(shell $(CAT) $(call quote,$(BUILDDIR)/lastprereqs/$1) 2> /dev/null || true),,$2),$2 FORCE$(and $(shell $(call ensuredirectory,$(BUILDDIR)/lastprereqs) && $(PRINTF) '%s\n' $(call quote,$2) > $(BUILDDIR)/lastprereqs/$1),),$2)
228 # (callable) Escape special characters for use in sed regular expressions.
229 override sedesc = $(subst /,[/],$(subst $$,\$$,$(subst *,\*,$(subst .,\.,$(subst [,\[,$(subst ^,\^,$(subst \,\\,$1)))))))
231 # The command to use for percentโdecoding.
232 override perdeccmd := $(SED) 's/|/%7C/g;s/[\]/%5C/g;s/%[0-9A-Fa-f]\{2\}/|&|/g' | $(TR) '|' '\n' | $(SED) '/^%[0-9A-Fa-f]\{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}' | $(XARGS) -0 $(PRINTF) '%b'
234 # (callable) Percentโdecode the given strings.
236 # โก This variable creates a subshell every time it is computed.
237 override perdec = $(shell $(PRINTF) '%s\0450A' $(foreach encoded,$1,$(call quote,$(encoded))) | $(perdeccmd))
239 # (callable) Percentโencode the given strings.
241 # This singlyโencodes uยทrยทi characters and doublyโencodes other characters, then calls `perdecยด to decode back to a single encoding.
242 # The encoding assumes the input is a โuยทrยทi componentโ; eยทg that the resulting string should only contain `pcharยด (but can contain any `sub-delimยด).
244 # It is assumed that the given strings do not contain newlines.
246 # โก This variable creates a subshell every time it is computed.
247 override perenc = $(shell $(PRINTF) '%s\n' $(foreach unencoded,$1,$(call quote,$(unencoded))) | $(OD) -t x1 | $(SED) 's/^[0-9]*//;s/0[Aa]/%&/g;s/2[146-9A-Ea-e]/%&/g;s/3[0-9AaBbDd]/%&/g;s/40/%&/g;s/[46][1-9A-Fa-f]/%&/g;s/[57][0-9Aa]/%&/g;s/5[Ff]/%&/g;s/7[Ee]/%&/g;s/[ ][0-9A-Fa-f]\{2\}/%25&/g' | $(TR) -d ' \n' | $(TR) 'abcdef' 'ABCDEF' | $(perdeccmd))
249 # (callable) Percentโencode each component in the given paths.
251 # โก This variable creates a subshell every time it is computed.
252 override pathenc = $(subst %2F,/,$(call perenc,$1))
254 # (overridable) Collect all of the applicable includes from the includes directory.
255 sourceincludes := $(shell $(FIND) $(foreach dir,$(INCLUDEDIR),$(call quote,$(dir))) '(' $(FINDRULES) ')' -a -type f)
257 # (overridable) Collect all of the applicable source files from the source directory, removing any which are also includes.
258 sourcefiles := $(filter-out $(sourceincludes),$(shell $(FIND) $(foreach dir,$(SRCDIR),$(call quote,$(dir))) '(' $(FINDRULES) ')' -a -type f))
260 # Figure out the file type of each source file and source include.
261 ifneq ($(wildcard $(BUILDDIR)/magic.mgc),)
262 override types := $(shell $(SED) 's/^ *//;s/ *$$//;s/ {2,}/ /g' <<< $(call quote,$(sourcefiles) $(sourceincludes)) | $(TR) ' ' '\n' | $(FILE) -m $(call quote,$(BUILDDIR)/magic.mgc) --mime-type --separator '|' --files-from - | $(SED) 's/| */|/g')
265 # Get the list of supported plaintext file types from the parser.
266 ifneq ($(wildcard $(BUILDDIR)/parser.xslt),)
267 override plaintexttypes := $(filter-out $(XMLTYPES),$(shell $(XMLLINT) --xpath '/*/*[@name="ไนฆ็คพ:parsers"]//*[namespace-uri()="http://www.w3.org/1999/xhtml" and local-name()="dd"]/text()' $(call quote,$(BUILDDIR)/parser.xslt)))
270 # (callable) Get all of the files (source and includes) which have the given types.
271 override filesoftype = $(foreach type,$1,$(patsubst %|$(type),%,$(filter %|$(type),$(types))))
273 # Build up collections of various file types.
274 override xmlfiles := $(call filesoftype,$(XMLTYPES))
275 override plaintextfiles := $(filter-out $(xmlfiles),$(call filesoftype,$(plaintexttypes)))
276 override assetfiles := $(filter-out $(xmlfiles) $(plaintextfiles),$(sourcefiles) $(sourceincludes))
278 # (callable) Get the types of the given files.
279 override typeoffile = $(patsubst $(foreach file,$1,$(file)|%),%,$(filter $(foreach file,$1,$(file)|%),$(types)))
281 # Pair each source magic file with its location in the build directory.
282 override magicpair := $(foreach magicfile,$(MAGIC),$(magicfile)|$(BUILDDIR)/magic/$(notdir $(magicfile)))
284 # (callable) Get the source file for the given magic files.
285 override magicsource = $(foreach magicpath,$1,$(patsubst %|$(magicpath),%,$(firstword $(filter %|$(magicpath),$(magicpair)))))
287 # (callable) Get the build file for the given magic files.
288 override magicfile = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(magicpair))))
290 # (callable) Get the local path for the given source file.
291 override sourcepath = $(firstword $(foreach directory,$(SRCDIR),$(if $(filter $(directory)/%,$1),$(patsubst $(directory)/%,%,$1),)))
293 # (callable) Get the local path for the given include.
294 override includepath = $(firstword $(foreach directory,$(INCLUDEDIR),$(if $(filter $(directory)/%,$1),$(patsubst $(directory)/%,%,$1),)))
296 # (callable) Get base64 data uยทrยทiโs for the given files.
298 # โก This variable creates a subshell every time it is computed.
299 override datauri = $(foreach file,$1,data:$(call typeoffile,$(file));base64,$(shell $(UUENCODE) -m -r $(call quote,$(file)) _ | tr -d ' \n'))
301 # Pair each source file and include with its local uยทrยทi.
302 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)))))
304 # (callable) Get local uris for the given files.
305 override localuri = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcelocalpair))))
307 # (callable) Get the source files for the given local uris.
308 override sourcefile = $(foreach local,$1,$(patsubst %|$(local),%,$(filter %|$(local),$(sourcelocalpair))))
310 # Adds a requirement on `$(BUILDDIR)/.update-typesยด if the file is present.
312 # This file is created after a reload due to type changes, and is removed after.
313 # Requiring it ensures that file classifications are upยทtoยทdate immediately after the reload.
314 override typeupdates := $(wildcard $(BUILDDIR)/.update-types)
316 # Pair each source file and include with its parsed location.
317 override sourceparsedpair := $(foreach file,$(sourcefiles) $(sourceincludes),$(file)|$(BUILDDIR)/$(if $(filter $(file),$(sourceincludes)),includes/$(call includepath,$(file)),sources/$(call sourcepath,$(file))))
319 # (callable) Get the location of the transformed XยทMยทL files for the given source files.
320 override parsed = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourceparsedpair))))
322 # (callable) Get the source files for the given parsed file.
323 override unparsed = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(sourceparsedpair))))
325 # Pair each parser, transform, or parsed file with its file uยทrยทi.
326 override fileuripairs := $(join $(patsubst %,%|,$(PARSERS) $(TRANSFORMS) $(call parsed,$(sourcefiles) $(sourceincludes))),$(call pathenc,$(foreach uriable,$(PARSERS) $(TRANSFORMS) $(call parsed,$(sourcefiles) $(sourceincludes)),file://$(abspath $(uriable)))))
328 # (callable) Get the file uยทrยทis for the given parsers, transforms, or parsed files.
329 override fileuri = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(fileuripairs))))
331 ifneq ($(wildcard $(BUILDDIR)/dependencies),)
332 # Pair each file with a list of dependencies for it.
333 override dependenciesforfile := $(foreach file,$(filter-out $(assetfiles),$(sourcefiles) $(sourceincludes)),$(file)|$(subst $(space),|,$(shell $(CAT) $(call quote,$(BUILDDIR)/dependencies) | $(SED) $(call quote,/^$(call sedesc,$(call localuri,$(file)))$$/$(comma)/^[^ ]/!d;/^ /!d;s/^ //))))
335 # (callable) Get the list of dependency leiris for the given source files.
337 # Recursive dependencies are marked with a leading `-ยด.
338 override dependencyuris = $(foreach file,$1,$(subst |, ,$(patsubst $(file)|%,%,$(filter $(file)|%,$(dependenciesforfile)))))
340 # (callable) Get the list of recursive dependencies for the given source files.
341 override recursives = $(foreach uri,$(filter -%,$(call dependencyuris,$1)),$(call sourcefile,$(patsubst -%,%,$(uri))))
343 # (callable) Get the list of (nonrecursive) dependencies for the given source files.
344 override dependencies = $(foreach uri,$(filter-out -%,$(call dependencyuris,$1)),$(call sourcefile,$(uri)))
347 # Collect all files with recursive dependencies.
348 override recursivefiles := $(foreach file,$(filter-out $(assetfiles),$(sourcefiles)),$(if $(call recursives,$(file)),$(file),))
350 # Collect all files which should be compiled.
352 # This is all of the nonยทasset, nonrecursive files.
353 override compilablefiles := $(filter-out $(assetfiles) $(recursivefiles),$(sourcefiles))
355 # Collect all files which can be installed.
357 # This is all of the comilable files and all asset sources.
358 override installablefiles := $(compilablefiles) $(filter $(assetfiles),$(sourcefiles))
360 ifneq ($(wildcard $(BUILDDIR)/destinations),)
361 # Get the output of the destination transform.
362 override destinations := $(shell $(CAT) $(BUILDDIR)/destinations)
364 # Pair source files and their destinations.
365 override sourcedestinationpair := $(foreach destination,$(destinations),$(call sourcefile,$(firstword $(subst |, ,$(destination))))|$(call perdec,$(subst $(space),|,$(wordlist 2,$(words $(subst |, ,$(destination))),$(subst |, ,$(destination))))))
367 # (callable) Get the destination for the given source files.
368 override destination = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcedestinationpair))))
370 # Pair each source file with its compiled location.
371 override sourcecompiledpair := $(foreach file,$(sourcefiles),$(file)|$(BUILDDIR)/results/$(call destination,$(file)))
373 # (callable) Get the location of the transformed XยทMยทL files for the given source files.
374 override compiled = $(foreach file,$1,$(patsubst $(file)|%,%,$(filter $(file)|%,$(sourcecompiledpair))))
376 # (callable) Get the source files for the given compiled file.
377 override uncompiled = $(foreach file,$1,$(patsubst %|$(file),%,$(filter %|$(file),$(sourcecompiledpair))))
379 # (callable) Get the location of the final built file for the given source files.
380 override built = $(foreach file,$1,$(patsubst $(BUILDDIR)/results/%,$(BUILDDIR)/public/%,$(call compiled,$(file))))
382 # (callable) Get the installed locations for the given source files.
383 override installed = $(foreach file,$1,$(DESTDIR)/$(call destination,$(file)))
386 # โ ยถ Recipe Variable Definitions โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
388 # (callable) Check to see if the given directory exists and create it if not.
389 override ensuredirectory = if $(TEST) ! -d $(call quote,$1); then $(MKDIR) -p $(call quote,$1); fi
391 # (callable) Get the identifier for the given parser or transform.
392 override id = $(XMLLINT) --xpath '/*/*[local-name()="id" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"]/text()[1]' $(call quote,$1) 2> /dev/null || $(PRINTF) '%s\n' $(call quote,about:shushe?$(or $2,unknown)=$(call pathenc,$(basename $(notdir $1))))
394 # (callable) Sanitize and wrap the provided plaintext file in XยทMยทL, printing to `stdoutยด.
395 override wrapplaintext = $(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;s/\0342\0200\0250/\\n/g;s/[\0001-\0010]/๏ฟฝ/g;s/[\0016-\0037]/๏ฟฝ/g')" | $(XARGS) -0 -J %% $(PRINTF) '%b%s%s\n' '<?xml version=\042\061.0\042?>\n<script xmlns=\042http://www.w3.org/1999/xhtml\042 type=\042$(call typeoffile,$1)\042><![CDATA[' %% ']]></script>'
397 # (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ยด.
399 # 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).
401 # 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.
402 override serializexml = $(SED) "$$($(PRINTF) '%b' '/<?xml[ \t]\\{1,\\}version=[\0042\0047]1.1/,$${ s/<?xml[^>]*?>/<!--<?xml version=\00421.1\0042?>-->/\n s/&\0043x0*[1-8BCEFbcef];/\0302\0221/g\n s/&\0043x0*1[0-9A-Fa-f];/\0302\0221/g\n s/&\00430*[1-8];/\0302\0221/g\n s/&\00430*1[124-9];/\0302\0221/g\n s/&\00430*2[0-9];/\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}')"
404 # (callable) Test if the provided xpath expression matches the provided document.
405 override xpath = $(XMLLINT) --xpath $(call quote,$1) $(call quote,$2) > /dev/null 2> /dev/null
407 # (callable) Extract the value of the text nodes in the provided XยทMยทL document and print them to `stdoutยด.
408 override extracttext = $(PRINTF) '%s' '<transform xmlns="http://www.w3.org/1999/XSL/Transform" version="1.0"><output method="text" encoding="UTF-8"/></transform>' | $(XSLTPROC) - $(call quote,$1)
410 # โ ยถ Phony Targets โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
412 # Compile all files, or error if any are recursive.
413 all : $(call built,$(recursivefiles) $(compilablefiles)) ;
415 # Destroy buildfiles.
417 $(if $(BUILDDIR),$(silent)$(RM) -rf $(call quote,$(BUILDDIR)/),)
419 # Destroy build directory and installed files.
420 gone : clean uninstall ;
424 @$(PRINTF) '%b' '$(subst $(newline),\n,$(makefileinfo))'
426 # Install the compiled files into `DESTDIRยด, or error if any are recursive.
427 install : $(call installed,$(recursivefiles) $(installablefiles)) ;
429 # List all source files and includes and their computed types.
431 @$(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 '
433 # Destroy installed files.
435 $(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),))
437 # Raise an error when attempting to build any files with recursive dependencies.
438 $(call compiled,$(recursivefiles)) :
439 @$(PRINTF) '%b\n' $(call quote,\0033[93;41mError:\0033[39;49m `$(call uncompiled,$@)ยด has recursive dependencies:\n$(subst |, ,$(subst $(space),$(newline),$(foreach recursive,$(call recursives,$(call uncompiled,$@)),โข|$(recursive))))) && false
441 # Add as a prerequisite to treat the target as tho it were phony.
444 # โ ยถ Special Targets โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
446 # Perform secondary expansion; this enables pattern rules to determine their prerequisites based on the matched pattern.
449 # Donโt use any implicit rules.
452 # Phony rules; always consider these outยทofยทdate.
453 .PHONY : FORCE all default clean gone info install list uninstall $(call compiled,$(recursivefiles)) ;
455 ifneq ($(typeupdates)$(wildcard $(BUILDDIR)/dependencies)$(wildcard $(BUILDDIR)/destinations),)
456 # Reload this makeยทfile if the dependency graph or output destinations have changed.
458 # The dependency graph and output destinations are used to set the values of variables in this makeยทfile, so itโs important to ensure that they are actually upยทtoยทdate prior to executing any later rules.
460 # This recipe only exists after types have been updated or when the dependency graph or destinations file already exists.
462 # โป There is a chance that generating the dependencies will also update the parsers.
463 $(THISDIR)/GNUmakefile :: $(BUILDDIR)/dependencies $(BUILDDIR)/destinations
464 $(silent)$(TOUCH) $(THISDIR)/GNUmakefile
465 ifeq ($(typeupdates),)
466 @if $(TEST) ! -f $(call quote,$(BUILDDIR)/.update-types); then $(PRINTF) '%b\n' '\0033[1mDependency graph and output destinations updated. Restartingโฆ\0033[22m'; fi
468 $(silent)$(RM) $(BUILDDIR)/.update-types
469 @$(PRINTF) '%b\n' '\0033[1mDependency graph and output destinations updated. Restartingโฆ\0033[22m'
473 ifeq ($(typeupdates),)
474 # Reload this makeยทfile if any of the magic files or parsers have changed.
476 # These are used to classify source files, so if they have changed then the makeยทfile must be reloaded.
478 # This recipe sleeps for one second to ensure that files built after the restart have a more current timeยทstamp.
479 $(THISDIR)/GNUmakefile :: $(BUILDDIR)/magic.mgc $(BUILDDIR)/parser.xslt
480 $(silent)$(TOUCH) $(THISDIR)/GNUmakefile
481 $(silent)$(RM) -f $(call quote,$(BUILDDIR)/dependencies) $(call quote,$(BUILDDIR)/destinations)
482 @$(PRINTF) '%b\n' '\0033[1mMagic file or parsers have updated. Restartingโฆ\0033[22m'
484 $(silent)$(TOUCH) $(call quote,$(BUILDDIR)/.update-types)
487 # โ ยถ Build Targets โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
489 # Create symbolic links from the build directoryโs store of magic files to their corresponding sources.
490 $(call magicfile,$(MAGIC)) : $(BUILDDIR)/magic/% : $$(call magicsource,$$@)
491 $(silent)$(call ensuredirectory,$(dir $@))
492 $(silent)$(LN) -sf $(call quote,$(realpath $<)) $(call quote,$@)
494 # Generate the compiled magic file from its sources.
496 # It must be updated if any of the files in the magic directory change.
497 $(BUILDDIR)/magic.mgc : $(call diffprereqs,magic,$(sort $(call magicfile,$(MAGIC))))
498 $(foreach outdated,$(filter-out $^,$(wildcard $(BUILDDIR)/magic/*)),$(silent)$(RM) $(call quote,$(outdated))$(newline))
499 @$(ECHO) "Compiling new magicโฆ"
500 $(silent)$(call ensuredirectory,$(dir $@))
501 $(silent)cd $(call quote,$(BUILDDIR)) && $(FILE) -C -m $(call quote,$(realpath $(BUILDDIR)/magic))
502 $(silent)$(TOUCH) $(call quote,$(BUILDDIR)/.update-types)
504 # Generate the main parser.
505 $(BUILDDIR)/parser.catalog : $(call diffprereqs,parsers,$(sort $(PARSERS)))
506 @$(ECHO) "Generating catalog of parsersโฆ"
507 $(silent)$(XMLCATALOG) --create --noout $(call quote,$@)
508 $(foreach parser,$(PARSERS),$(silent)( $(call id,$(parser)) ) | $(XARGS) -I %% $(XMLCATALOG) --add uri %% $(call quote,$(call fileuri,$(parser))) --noout $(call quote,$@)$(newline))
509 $(BUILDDIR)/parser.xslt : $(BUILDDIR)/parser.catalog $(THISDIR)/lib/catalog2parser.xslt
510 @$(ECHO) "Generating main parserโฆ"
511 $(silent)$(XSLTPROC) -o $(call quote,$@) $(call quote,$(THISDIR)/lib/catalog2parser.xslt) $(call quote,$<)
512 $(silent)$(TOUCH) $(call quote,$(BUILDDIR)/.update-types)
516 # 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.
517 # Asset files are turned into HยทTยทMยทL embeds pointing to `data:ยด UยทRยทIโs.
518 $(call parsed,$(sourcefiles) $(sourceincludes)) : % : $$(call unparsed,$$@) $(BUILDDIR)/parser.xslt $(typeupdates)
519 @$(PRINTF) '%s\n' $(call quote,Processing `$<ยดโฆ)
520 $(silent)$(call ensuredirectory,$(dir $@))
521 $(silent)$(if $(filter $<,$(assetfiles)),$(PRINTF) '%s\n' $(call quote,<object xmlns="http://www.w3.org/1999/xhtml" type="$(call typeoffile,$<)" data="$(call datauri,$<)"/>) > $(call quote,$@),$(if $(filter $<,$(plaintextfiles)),$(call wrapplaintext,$<),$(call serializexml,$<)) | $(XSLTPROC) -o $(call quote,$@) --stringparam BUILDTIME $$(TZ= $(DATE) '+%Y-%m-%dT%H:%M:%SZ') --stringparam IDENTIFIER $(call quote,$(call localuri,$<)) --stringparam SRCTIME $$(TZ= $(STAT) -f '%Sm' -t '%Y-%m-%dT%H:%M:%SZ' $(call quote,$<)) --stringparam CKSUM $$($(CKSUM) $(call quote,$<) | $(SED) 's/[ ].*//')$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) $(call quote,$(BUILDDIR)/parser.xslt) -)
523 # Generate a catalog of all parsed files, for use when processing includes.
525 # This does not depend on actually transforming the files.
526 $(BUILDDIR)/catalog : $(call diffprereqs,sources,$(sort $(sourcefiles) $(sourceincludes))) $(typeupdates)
527 @$(ECHO) "Generating catalog of parsed filesโฆ"
528 $(silent)$(XMLCATALOG) --create --noout $(call quote,$@)
529 $(foreach source,$(sourcefiles) $(sourceincludes),$(silent)$(XMLCATALOG) --add uri $(call quote,$(call localuri,$(source))) $(call quote,$(call fileuri,$(call parsed,$(source)))#$(if $(filter $(source),$(assetfiles)),asset,xml)) --noout $(call quote,$@)$(newline))
531 # Build a list of dependencies for each parsed file.
532 $(BUILDDIR)/dependencies : $(BUILDDIR)/catalog $(call parsed,$(plaintextfiles) $(xmlfiles)) $(THISDIR)/lib/catalog2dependencies.xslt
533 @$(ECHO) "Identifying dependenciesโฆ"
534 $(silent)$(XSLTPROC) -o $(call quote,$@) $(call quote,$(THISDIR)/lib/catalog2dependencies.xslt) $(call quote,$<)
536 # Generate a catalog of destinations for files.
538 # This depends on parsing nonยทasset source files, but not assets or includes.
539 # It does not require knowing the dependencies.
540 $(BUILDDIR)/destinations : $(BUILDDIR)/catalog $(call parsed,$(filter-out $(assetfiles),$(sourcefiles))) $(THISDIR)/lib/catalog2destinations.xslt
541 @$(ECHO) "Identifying output destinationsโฆ"
542 $(silent)$(XSLTPROC) -o $(call quote,$@) $(call quote,$(THISDIR)/lib/catalog2destinations.xslt) $(call quote,$<)
544 # Generate the main transform.
545 $(BUILDDIR)/transform.catalog : $(call diffprereqs,transforms,$(sort $(TRANSFORMS)))
546 @$(ECHO) "Generating catalog of transformsโฆ"
547 $(silent)$(XMLCATALOG) --create --noout $(call quote,$@)
548 $(foreach transform,$(TRANSFORMS),$(silent)( $(call id,$(transform)) ) | $(XARGS) -I %% $(XMLCATALOG) --add uri %% $(call quote,$(call fileuri,$(transform))) --noout $(call quote,$@)$(newline))
549 $(BUILDDIR)/transform.xslt : $(BUILDDIR)/transform.catalog $(THISDIR)/lib/catalog2transform.xslt
550 @$(ECHO) "Generating main transformโฆ"
551 $(silent)$(XSLTPROC) -o $(call quote,$@) $(call quote,$(THISDIR)/lib/catalog2transform.xslt) $(call quote,$<)
553 # Compile the result files using the dependencies as necessary.
554 $(call compiled,$(compilablefiles)) : $(BUILDDIR)/results/% : $$(call parsed,$$(call uncompiled,$$@)) $(BUILDDIR)/transform.xslt $$(call parsed,$$(call dependencies,$$(call uncompiled,$$@)))
555 @$(PRINTF) '%s\n' $(call quote,Compiling </$*>โฆ)
556 $(silent)$(call ensuredirectory,$(dir $@))
557 $(silent)$(XSLTPROC) -o $(call quote,$@) --stringparam CATALOG 'catalog' --stringparam BUILDTIME $$(TZ= $(DATE) '+%Y-%m-%dT%H:%M:%SZ') --stringparam SRCTIME $$(TZ= $(STAT) -f '%Sm' -t '%Y-%m-%dT%H:%M:%SZ' $(call quote,$(call uncompiled,$@))) --stringparam IDENTIFIER $(call quote,$(call localuri,$(call uncompiled,$@))) --stringparam PATH $(call quote,/$*) --stringparam CKSUM $$($(CKSUM) $(call quote,$(call uncompiled,$@)) | $(SED) 's/[ ].*//')$(if $(THISREV), --stringparam THISREV $(call quote,$(THISREV)),)$(if $(SRCREV), --stringparam SRCREV $(call quote,$(SRCREV)),) $(call quote,$(BUILDDIR)/transform.xslt) $(call quote,$<)
558 $(call compiled,$(filter $(assetfiles),$(sourcefiles))) : $(BUILDDIR)/results/% : $$(call uncompiled,$$@)
559 @$(PRINTF) '%s\n' $(call quote,Compiling </$*>โฆ)
560 $(silent)$(call ensuredirectory,$(dir $@))
561 $(silent)$(CP) $(call quote,$<) $(call quote,$@)
563 # Create the final files from the compiled results (or error in the case of recursive ones).
564 $(call built,$(compilablefiles)) : $(BUILDDIR)/public/% : $(BUILDDIR)/results/%
565 @$(PRINTF) '%s\n' $(call quote,Building </$*>โฆ)
566 $(silent)$(call ensuredirectory,$(dir $@))
567 $(silent)if $(call xpath,/*[local-name()="raw-text" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$<); then $(RM) -f $(call quote,$@); $(call extracttext,$<) > $(call quote,$@); elif $(call xpath,/*[local-name()="base64-binary" and namespace-uri()="urn:fdc:ladys.computer:20231231:Shu1She4"],$<); then $(RM) -f $(call quote,$@); $(call extracttext,$<) | $(TR) -d '\t\n\f\r ' | $(UUDECODE) -m -r > $(call quote,$@); else $(LN) -s -f $(call quote,$(subst $(space),,$(foreach component,$(subst /, ,$*),../))results/$*) $(call quote,$@); fi
568 $(call built,$(filter $(assetfiles),$(sourcefiles)) $(recursivefiles)) : $(BUILDDIR)/public/% : $(BUILDDIR)/results/%
569 @$(PRINTF) '%s\n' $(call quote,Building </$*>โฆ)
570 $(silent)$(call ensuredirectory,$(dir $@))
571 $(silent)$(LN) -s -f $(call quote,../results/$*) $(call quote,$@)
573 # Install compiled files (or error in the case of recursive ones).
574 $(call installed,$(filter $(assetfiles),$(sourcefiles)) $(recursivefiles) $(compilablefiles)) : $(DESTDIR)/% : $(BUILDDIR)/public/%
575 @$(PRINTF) '%s\n' $(call quote,Installing </$*>โฆ)
576 $(silent)$(call ensuredirectory,$(dir $@))
577 $(silent)$(CP) $(call quote,$<) $(call quote,$@)