X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/d6d23cafc104581a82e6818585fcdaa3e3a820a1..587bd5a36e079e0509296ced479488a923663a8e:/README.markdown diff --git a/README.markdown b/README.markdown index bed7a11..013e3ed 100644 --- a/README.markdown +++ b/README.markdown @@ -625,11 +625,17 @@ The following params are only available in transforms :⁠— ## Output Wrapping -⛩📰 书社 will wrap the final output of the transforms in appropriate - `` and `` elements, so it is not necessary for - transforms to do this explicitly. -After performing the initial transform, ⛩📰 书社 will match the root - node of the result in the following modes to fill in areas of the +Provided at least one toplevel result element belongs to the H·T·M·L + namespace, ⛩📰 书社 will wrap the final output of the transforms in + appropriate `` and `` elements, so it is not + necessary for transforms to do this explicitly. +If a toplevel result element _is_ a `` and `` + element, it will be merged with the one that ⛩📰 书社 creates. +Consequently, wrapping the result in a `` element can be + used to enable wrapping for non‐H·T·M·L content, when desired. + +As a part of this process, after performing the initial transform + ⛩📰 书社 will match in the following modes to fill in areas of the wrapper :⁠— - **`书社:header`:** @@ -644,16 +650,14 @@ After performing the initial transform, ⛩📰 书社 will match the root 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 :⁠— +The document being matched will contain the full transform result + prior to wrapping as well as an `` element (with an + `@书社:id` attribute) for each transform which has a valid + `<书社:id>`. +The latter elements can be matched to enable transforms to provide + 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 @@ -677,7 +681,8 @@ Output wrapping can be entirely disabled by adding a the result tree. It will not be performed on outputs whose root elements are `<书社:archive>`, `<书社:base64-binary>`, or `<书社:raw-text>` - (described below). + (described below), or on result trees which do not contain a toplevel + element in the H·T·M·L namespace. ## Applying Attributes