X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/e4f65cee884c40d631209b5cbb711de161a2969a..3cf024ba39dd17687e1b66e4aeb2f140342b1993:/README.markdown
diff --git a/README.markdown b/README.markdown
index 51aca8d..681e8c4 100644
--- a/README.markdown
+++ b/README.markdown
@@ -99,7 +99,9 @@ In every case, you may supply your own implementation by overriding the
- `mkdir` (requires support for `-p`)
- `mv`
- `printf`
+- `rm`
- `sed`
+- `sleep`
- `test`
- `touch`
- `tr` (requires support for `-d`)
@@ -226,13 +228,13 @@ For example, the trivial `text/plain` parser is defined as follows :—
```xml
-
-
-
+
+
+
```
@@ -285,15 +287,17 @@ Transforms are used to convert X·M·L files into their final output,
- **`transforms/metadata.xslt`:**
Provides basic `` metadata.
- This metadata is generated from `` descendants of the
- first element with an `@itemscope` attribute (recommended to just
- be the root element).
- Such elements can provide metadata using the following `@itemprop`
- attributes :—
+ This metadata is generated from `` elements with one o.
+ the following `@itemprop` attributes :—
- **`urn:fdc:ladys.computer:20231231:Shu1She4:title`:**
Provides the title of the page.
+ ⛩️📰 书社 automatically encapsulates embeds so that their metadata
+ does not propogate up to the embedding document.
+ To undo this behaviour, remove the `@itemscope` and `@itemtype`
+ attributes from the embed during the transformation phase.
+
The following are recommendations on effective creation of
transforms :—
@@ -311,10 +315,45 @@ The following are recommendations on effective creation of
⛩️📰 书社 will wrap the final output of the transforms in appropriate
`` and `` elements, so it is not necessary for
transforms to do this explicitly.
-The `` of the output will contain the result tree generated
- by matching the root node in the `书社:metadata` mode; the provided
- `transforms/metadata.xslt` transform uses this mode to generate basic
- metadata, but it is possible for other transforms to add their own.
+After performing the initial transform, ⛩️📰 书社 will match the root
+ node of the result in the following modes to fill in areas of the
+ wrapper :—
+
+- **`书社:metadata`:**
+ The result of matching in this mode is inserted into the
+ `` of the output.
+
+In addition to being called with the transform result, each of these
+ modes will additionally be called with a `` element
+ corresponding to each transform.
+If a transform has a `<书社:id>` top‐level element whose value is an
+ i·r·i, its `` element will have a corresponding
+ `@书社:id` attribute.
+This mechanism can be used to allow transforms to insert content
+ without matching any elements in the result; for example, the
+ following transform adds a link to a stylesheet to the ``
+ of every page :—
+
+```xml
+
+
+ <书社:id>example:add-stylesheet-links.xslt书社:id>
+
+
+
+
+```
+
+Output wrapping can be entirely disabled by adding a
+ `@书社:disable-output-wrapping` attribute to the top‐level element in
+ the result tree.
## License