X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/e4f65cee884c40d631209b5cbb711de161a2969a..af8b42c720c6aaa54199b556a656d40e8b8951a6:/README.markdown diff --git a/README.markdown b/README.markdown index 51aca8d..84c3206 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`) @@ -311,10 +313,41 @@ 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 + + +``` ## License