Set up DOCUMENTATION

diff --git a/.gitignore b/.gitignore
index 95b5ee1c35abb9981b0c0efbe6f3448ae1eacd1d..fe4adeff5ca11da7c669b613d513dcebd257b269 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
 # SPDX-License-Identifier: CC0-1.0
+
 /build
 /public

diff --git a/.gitmodules b/.gitmodules
new file mode 100644 (file)
index 0000000..ed80105
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,6 @@
+# SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+# SPDX-License-Identifier: CC0-1.0
+
+[submodule "Yseme"]
+       path = DOCUMENTATION/.👥📤
+       url = https://git.ladys.computer/Yseme.git

diff --git a/DOCUMENTATION/.gitignore b/DOCUMENTATION/.gitignore
new file mode 100644 (file)
index 0000000..b7b1c4b
--- /dev/null
+++ b/DOCUMENTATION/.gitignore
@@ -0,0 +1,6 @@
+# SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+# SPDX-License-Identifier: CC0-1.0
+
+/.grass
+/.build
+/>WWW

diff --git a/DOCUMENTATION/.ð\9f\91¥ð\9f\93¤ b/DOCUMENTATION/.ð\9f\91¥ð\9f\93¤
new file mode 160000 (submodule)
index 0000000..f6ab022
--- /dev/null
+++ b/DOCUMENTATION/.ð\9f\91¥ð\9f\93¤
@@ -0,0 +1 @@
+Subproject commit f6ab0225fdd5a404fbd592b0d5c051f0cbea4135

diff --git a/DOCUMENTATION/GNUmakefile b/DOCUMENTATION/GNUmakefile
new file mode 100644 (file)
index 0000000..64da058
--- /dev/null
+++ b/DOCUMENTATION/GNUmakefile
@@ -0,0 +1,50 @@
+# SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+# SPDX-License-Identifier: MPL-2.0
+
+SHELL = /bin/sh
+
+# Copyright © 2024 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/>.
+
+# Using the current directory as `SRCDIR´ is generally not advisable, but it does help to keep things a bit cleaner for a documentation directory nested in another repository.
+#
+# Since `find´ will be searching this entire directory for files, it’s necessary to give anything which isn’t a source an inelligible name or else manually exclude it with `EXTRAFINDRULES´.
+SRCDIR := .
+INCLUDEDIR :=
+BUILDDIR := .build
+DESTDIR := >WWW
+
+SHUSHE := ..
+SHUSHEOPTS := SRCDIR='$(SRCDIR)' INCLUDEDIR='$(INCLUDEDIR)' BUILDDIR='$(BUILDDIR)' DESTDIR='$(DESTDIR)' EXTRATRANSFORMS="$(wildcard .transforms/*.xslt)" EXTRAFINDRULES="! '(' -name 'GNUmakefile' -o -name '$(DESTDIR)' -a -prune ')'"
+
+YSEME := .👥📤
+YSEMEOPTS := DESTDIR='$(DESTDIR)' SERVERPATH='/srv/git/.DOCUMENTATION'
+
+build : $(SHUSHE)/GNUmakefile prebuild
+       @for publicfile in $(patsubst %,"%",$(wildcard $(DESTDIR)/*)); do if git check-ignore -q "$$publicfile"; then rm -rf "$$publicfile"; fi; done
+       @$(MAKE) -f '$<' install $(SHUSHEOPTS)
+       touch .grass
+
+prebuild : $(SHUSHE)/GNUmakefile
+       @$(MAKE) -f '$<' $(SHUSHEOPTS)
+
+list : $(SHUSHE)/GNUmakefile
+       @$(MAKE) -f '$<' $@ $(SHUSHEOPTS)
+
+$(BUILDDIR)/% $(DESTDIR)/% : $(SHUSHE)/GNUmakefile
+       @$(MAKE) -f '$<' $@ $(SHUSHEOPTS)
+
+$(YSEME)/GNUmakefile : %/GNUmakefile : FORCE
+       git submodule update --init '$*'
+
+dry-sync sync : $(YSEME)/GNUmakefile
+       $(MAKE) -f '$<' $@ $(YSEMEOPTS)
+
+gone :
+       @for publicfile in $(patsubst %,"%",$(wildcard $(DESTDIR)/*)); do if git check-ignore -q "$$publicfile"; then rm -rf "$$publicfile"; fi; done
+
+FORCE : ;
+
+.PHONY : FORCE build dry-sync gone list prebuild sync ;