feat: adopt community convention for XQuery files

extend community convention for XQuery modules to all files in Jinks

Author: joewiz

README.md

@@ -32,9 +32,9 @@ The extension process works as follows:
 1. jinks creates a merged configuration, assembled from the configurations of all profiles in the extension hierarchy
 2. it calls the *write action* on every profile in sequence
 
-### `setup.xql`
+### `setup.xqm`
 
-The profile may also include an XQuery module called `setup.xql`. If present, jinks will inspect the functions defined in this module, searching for functions with the annotations `%generator:prepare` and `%generator:write`. They represent different stages in the generation process:
+The profile may also include an XQuery module called `setup.xqm`. If present, jinks will inspect the functions defined in this module, searching for functions with the annotations `%generator:prepare` and `%generator:write`. They represent different stages in the generation process:
 
 * `%generator:prepare`: receives the merged configuration map - including all changes applied by previous calls to prepare - and may return a modified map. Use this to compute and set custom properties needed by your profile
 * `%generator:write`: performs the actual installation
@@ -44,7 +44,7 @@ The profile may also include an XQuery module called `setup.xql`. If present, ji
 
 `%generator:after-write` receives the target collection in which the application is installed as first parameter, the current context as second.  
 
-If no `setup.xql` is present or no `%generator:write` function is defined, the default action is to call
+If no `setup.xqm` is present or no `%generator:write` function is defined, the default action is to call
 
 ```xquery
 cpy:copy-collection($context)
@@ -66,7 +66,7 @@ Convenient configuration forms will be added later once the basic profiles reach
 
 After installing the jinks application package via the dashboard, open http://localhost:8080/exist/apps/tei-publisher-jinks/api.html in your browser. The `/api/generator/{profile}` provides the main API entry point.
 
-The main entry point into jinks is provided by the module [`modules/generator.xql`](modules/generator.xql), which exposes the function:
+The main entry point into jinks is provided by the module [`modules/generator.xqm`](modules/generator.xqm), which exposes the function:
 
 ```xquery
 declare function generator:process($profile as xs:string, $settings as map(*)?, $config as map(*)?)

controller.xq

@@ -14,7 +14,7 @@ if ($exist:path eq '') then
     </dispatch>
 
 else if ($exist:path eq "/") then
-    (: forward root path to index.xql :)
+    (: forward root path to index.html :)
     <dispatch xmlns="http://exist.sourceforge.net/NS/exist">
         <redirect url="index.html"/>
     </dispatch>

pages/demo/footer.html

@@ -1,5 +1,5 @@
 <footer style="border-top: 1px solid #a0a0a0; margin-top: 1rem;">
-    [% import "https://tei-publisher.com/generator/xquery/config" as "config" at "modules/config.xql" %]
+    [% import "https://tei-publisher.com/generator/xquery/config" as "config" at "modules/config.xqm" %]
     <p>Generated by [[$context?app]] running on [[system:get-product-name()]] v[[system:get-version()]].
     Context path: [[$config:context-path]].</p>
     [% block copyright %][% endblock %]

pages/demo/sample-templates.json

@@ -66,7 +66,7 @@
     },
     {
         "description": "Using imported module functions",
-        "template": "[% import \"https://tei-publisher.com/jinks/xquery/demo\" as \"demo\" at \"modules/demo.xql\" %]\n\n[# call function in imported demo module #]\n<section>[[demo:sysinfo($title)]]</section>",
+        "template": "[% import \"https://tei-publisher.com/jinks/xquery/demo\" as \"demo\" at \"modules/demo.xqm\" %]\n\n[# call function in imported demo module #]\n<section>[[demo:sysinfo($title)]]</section>",
         "params": {
             "title": "My great new application"
         },
@@ -88,7 +88,7 @@
     },
     {
         "description": "Other templating parameters in frontmatter",
-        "template": "---json\n{\n  \"templating\": {\n    \"extends\": \"pages/demo/base.html\",\n    \"namespaces\": {\n      \"tei\": \"http://www.tei-c.org/ns/1.0\"\n    },\n    \"modules\": {\n      \"https://tei-publisher.com/jinks/xquery/demo\": {\n        \"prefix\": \"demo\",\n        \"at\": \"modules/demo.xql\"\n      }\n    }\n  },\n  \"author\": \"Heinz\"\n}\n---\n\n[% let $data = demo:tei() %]\n<h1>[[ $data//tei:title/text() ]]</h1>\n\n<p>[[ $data//tei:body/tei:p/text() ]]</p>\n\n<footer>Published [[format-date(current-dateTime(), \"[MNn] [D], [Y]\", \"en\", (), ())]] by [[$author]].</footer>\n[% endlet %]",
+        "template": "---json\n{\n  \"templating\": {\n    \"extends\": \"pages/demo/base.html\",\n    \"namespaces\": {\n      \"tei\": \"http://www.tei-c.org/ns/1.0\"\n    },\n    \"modules\": {\n      \"https://tei-publisher.com/jinks/xquery/demo\": {\n        \"prefix\": \"demo\",\n        \"at\": \"modules/demo.xqm\"\n      }\n    }\n  },\n  \"author\": \"Heinz\"\n}\n---\n\n[% let $data = demo:tei() %]\n<h1>[[ $data//tei:title/text() ]]</h1>\n\n<p>[[ $data//tei:body/tei:p/text() ]]</p>\n\n<footer>Published [[format-date(current-dateTime(), \"[MNn] [D], [Y]\", \"en\", (), ())]] by [[$author]].</footer>\n[% endlet %]",
         "params": {
             "author": "Rudi"
         },

pages/profile-documentation.html

@@ -147,7 +147,7 @@ <h3>Open API endpoint definitions</h3>
     </article>
     [% endif %]
 
-    [% let $files = tu:scan-collection($path || "/modules", "^.*\.xql$") %]
+    [% let $files = tu:scan-collection($path || "/modules", "^.*\.xqm?$") %]
     [% if exists($files) %]
     <article>
         <h3>XQuery Modules</h3>

profiles/annotate/config.json

@@ -26,7 +26,7 @@
         {
             "prefix": "anno",
             "id": "http://teipublisher.com/api/annotations",
-            "path": "annotations/annotations.xql",
+            "path": "annotations/annotations.xqm",
             "spec": "annotations/api.json"
         }
     ]

profiles/annotate/modules/annotations/annotations.xql renamed to profiles/annotate/modules/annotations/annotations.xqm

@@ -2,7 +2,7 @@
     <index xmlns:tei="http://www.tei-c.org/ns/1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:dbk="http://docbook.org/ns/docbook">
         <fulltext default="none" attributes="false"/>
         <lucene>
-            <module uri="http://teipublisher.com/index" prefix="nav" at="index.xql"/>
+            <module uri="http://teipublisher.com/index" prefix="nav" at="index.xqm"/>
             <analyzer class="org.exist.indexing.lucene.analyzers.NoDiacriticsStandardAnalyzer">
                 <param name="stopwords" type="org.apache.lucene.analysis.util.CharArraySet"/>
             </analyzer>

profiles/base10/collection.tpl.xconf

@@ -37,7 +37,7 @@ if ($exist:path eq '') then
     </dispatch>
 
 else if ($exist:path eq "/") then
-    (: forward root path to index.xql :)
+    (: forward root path to landing page :)
     <dispatch xmlns="http://exist.sourceforge.net/NS/exist">
         <redirect url="{$landingPage}"/>
     </dispatch>
@@ -79,11 +79,11 @@ else if (matches($exist:resource, "\.(png|jpg|jpeg|gif|tif|tiff|txt|mei)$", "s")
 else
     let $main :=
         if (matches($exist:path, "^/+api/+(?:odd|lint)")) then 
-            "api-odd.xql" 
+            "api-odd.xq" 
         else if (matches($exist:path, "/+tex$") or matches($exist:path, "/+api/+(?:actions/reindex)$")) then
-            "api-dba.xql"
+            "api-dba.xq"
         else 
-            "api.xql"
+            "api.xq"
     return
         <dispatch xmlns="http://exist.sourceforge.net/NS/exist">
             <forward url="{$exist:controller}/modules/lib/{$main}">