report changes

Author: lueck

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changes
 
+## 0.4.0
+
+- allows customization of the relation of `resource` and the document
+  location by replacing the `.../resource.xsl` XSLT package via a
+  Saxon configuration file
+- fixes the Oxygen transformation scenarios, which were still behind
+  version 0.1.1
+
 ## 0.3.0
 
 - fixes issue #2 by providing a package for URL templates with query parameters

README.md

@@ -24,14 +24,14 @@ parameters:
 
 | parameter   | [navigation](https://distributed-text-services.github.io/specifications/versions/1.0rc1/#uri-for-navigation-endpoint-requests) | [document](https://distributed-text-services.github.io/specifications/versions/1.0rc1/#query-parameters-2) |
 |-------------|--------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
-| `resource`  | ✅                                                                                                                             | ✅                                                                                                         |
+| `resource`  | ✅ [³](#resource)                                                                                                              | ✅ [³](#resource)                                                                                          |
 | `ref`       | ✅                                                                                                                             | ✅                                                                                                         |
 | `start`     | ✅                                                                                                                             | ✅                                                                                                         |
 | `end`       | ✅                                                                                                                             | ✅                                                                                                         |
 | `down`      | ✅                                                                                                                             | not used                                                                                                   |
 | `tree`      | ✅                                                                                                                             | ✅                                                                                                         |
 | `page`      | ❌                                                                                                                             | not used                                                                                                   |
-| `mediaType` | not used                                                                                                                       | ✅[¹](#mediatype)                                                                                                        |
+| `mediaType` | not used                                                                                                                       | ✅[¹](#mediatype)                                                                                          |
 
 Evaluated TEI elements:
 
@@ -45,6 +45,8 @@ Evaluated TEI elements:
 
 1. see section about [mediaType](#mediatype)
 2. supported, but `dcterms` do not yet come out as a map as shown in the specification's examples
+3. for mapping of the values of `resource` to document URIs see the
+   [`resource`](#resource) section
 
 
 ## XSLT for Endpoints
@@ -177,6 +179,16 @@ soon.
 
 ## Customization
 
+### `resource`
+
+The value coming in via the `resource` parameter must somehow be
+mapped to a document URI (at least when calling the initial
+template). There is a mapping function, that can easily be
+replaced. It's called `dts:resource-uri#1` and defined in
+[`xsl/resource.xsl`](xsl/resource.xsl). This package can be replaced
+with one that suits your needs by the Saxon configuration file.
+
+
 ### Citation Trees
 
 To add custom citation tree constructions not based on