Add <书社:apply-attributes> transformation

[Shushe] / README.markdown

diff --git a/README.markdown b/README.markdown
index 13cb1d66fbc34cdaed3e28bd2e20a77b92a41cf9..cafda3aa533ebb233f4538f78ddba6e4b21f22a2 100644 (file)
--- a/README.markdown
+++ b/README.markdown
@@ -283,6 +283,14 @@ Transforms are used to convert X·M·L files into their final output,
   after all necessary parsing and embedding has taken place.
 ⛩️📰 书社 comes with some transforms; namely :⁠—
 
+- **`transforms/attributes.xslt`:**
+  Applies transforms to the children of any `<书社:apply-attributes>`
+    elements, and then applies the attributes of the
+    `<书社:apply-attributes>` to each result child, replacing the
+    element with the result.
+  This is useful in combination with image embeds to apply alt‐text to
+    the resulting `<html:img>`.
+
 - **`transforms/asset.xslt`:**
   Converts `<html:object>` elements which correspond to recognized
     media types into the appropriate H·T·M·L elements, and deletes