From: Lady <redacted>
Date: Sat, 20 Sep 2025 17:53:02 +0000 (-0400)
Subject: Enable manual ordering
X-Git-Tag: 0.3.1^0
X-Git-Url: https://git.ladys.computer/Caudex/commitdiff_plain/0ad7eaa34fa2533489f9b3f4ed7cda455243a398?ds=inline;hp=cf6053a61ae55de5f3e8f593df94df614618a23f

Enable manual ordering
---

diff --git a/README.markdown b/README.markdown
index af420df..14b1424 100644
--- a/README.markdown
+++ b/README.markdown
@@ -162,6 +162,12 @@ The following metadata fields are recognized by default :⁠—
 - **`TITLE`:**
   Gives the title of the thing being described.
 
+- **`ORDER`:**
+  Provides a manual ordering of the category or entry.
+  This must be an integer.
+  When multiple categories or entries have the same order, they are
+    then arranged by title.
+
 If the `~` file is missing from a category directory, none of the
   entries in the category will be recognized.
 However, a minimal `~` file will be created for you when you create an
diff --git a/parser.xslt b/parser.xslt
index d20da12..61d385d 100644
--- a/parser.xslt
+++ b/parser.xslt
@@ -22,6 +22,7 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 	xmlns:exslstr="http://exslt.org/strings"
 	xmlns:foaf="http://xmlns.com/foaf/0.1/"
 	xmlns:html="&xhtml;"
+	xmlns:ladys="https://vocab.ladys.computer/terms/"
 	xmlns:ore="http://www.openarchives.org/ore/terms/"
 	xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 	xmlns:skos="http://www.w3.org/2004/02/skos/core#"
@@ -50,6 +51,7 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 		<variable name="identifier" select="exslstr:tokenize($IDENTIFIER, '/')[last()-1]"/>
 		<for-each select="html:article">
 			<variable name="title" select="html:footer[@class='head']//html:dt[normalize-space()='TITLE']/following-sibling::html:dd"/>
+			<variable name="order" select="number(html:footer[@class='head']//html:dt[normalize-space()='ORDER']/following-sibling::html:dd)"/>
 			<element name="awol:Category">
 				<apply-templates select="@lang|@xml:lang"/>
 				<attribute name="rdf:nodeID">
@@ -70,12 +72,21 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 						<value-of select="$title"/>
 					</attribute>
 				</if>
+				<if test="$order!=number('NaN')">
+					<element name="ladys:order">
+						<attribute name="rdf:datatype">
+							<text>&xsd;integer</text>
+						</attribute>
+						<value-of select="$order"/>
+					</element>
+				</if>
 			</element>
 		</for-each>
 	</template>
 	<template match="html:div[html:article/@data-lesml-profile='urn:fdc:ladys.computer:20240204:Caudex:pf:entry']">
 		<for-each select="html:article">
 			<variable name="title" select="html:footer[@class='head']//html:dt[normalize-space()='TITLE']/following-sibling::html:dd"/>
+			<variable name="order" select="number(html:footer[@class='head']//html:dt[normalize-space()='ORDER']/following-sibling::html:dd)"/>
 			<variable name="idstring" select="string(exslstr:tokenize($IDENTIFIER, '/')[last()])"/>
 			<element name="ore:Proxy">
 				<if test="$title">
@@ -88,6 +99,14 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 						<value-of select="exslstr:tokenize($IDENTIFIER, '/')[last()-1]"/>
 					</attribute>
 				</element>
+				<if test="$order!=number('NaN')">
+					<element name="ladys:order">
+						<attribute name="rdf:datatype">
+							<text>&xsd;integer</text>
+						</attribute>
+						<value-of select="$order"/>
+					</element>
+				</if>
 				<element name="skos:notation">
 					<attribute name="rdf:datatype">
 						<text>&xsd;string</text>
diff --git a/transform.xslt b/transform.xslt
index a614363..9495900 100644
--- a/transform.xslt
+++ b/transform.xslt
@@ -23,6 +23,7 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 	xmlns:exsl="http://exslt.org/common"
 	xmlns:exslstr="http://exslt.org/strings"
 	xmlns:html="&xhtml;"
+	xmlns:ladys="https://vocab.ladys.computer/terms/"
 	xmlns:ore="http://www.openarchives.org/ore/terms/"
 	xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 	xmlns:skos="http://www.w3.org/2004/02/skos/core#"
@@ -76,6 +77,8 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 					<element name="nav" namespace="&xhtml;">
 						<element name="ul" namespace="&xhtml;">
 							<for-each select="$codex//awol:Category">
+								<sort select="ladys:order" data-type="number"/>
+								<sort select="@awol:term"/>
 								<variable name="category-id" select="string(@rdf:nodeID)"/>
 								<element name="li" namespace="&xhtml;">
 									<element name="strong" namespace="&xhtml;">
@@ -83,6 +86,7 @@ If a copy of the M·P·L was not distributed with this file, You can obtain one
 									</element>
 									<element name="ul" namespace="&xhtml;">
 										<for-each select="$codex//ore:Proxy[ore:proxyIn/@rdf:nodeID='codex' and awol:category/@rdf:nodeID=$category-id]">
+											<sort select="ladys:order" data-type="number"/>
 											<sort select="@dcterms:title"/>
 											<sort select="skos:notation"/>
 											<element name="li" namespace="&xhtml;">