X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/e7c797ffb120c0dac9be13b28d533d49d164b6d0..af8b42c720c6aaa54199b556a656d40e8b8951a6:/README.markdown?ds=sidebyside diff --git a/README.markdown b/README.markdown index 2dd0eff..84c3206 100644 --- a/README.markdown +++ b/README.markdown @@ -313,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