X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/edacd9742b9feb3d3d6e10f41b6b077cb51e8002..da72aa41f740ae068399b41d02985da8f0698020:/README.markdown diff --git a/README.markdown b/README.markdown index f2cfdd9..cafda3a 100644 --- a/README.markdown +++ b/README.markdown @@ -93,6 +93,7 @@ In every case, you may supply your own implementation by overriding the - `cat` - `cp` +- `date` - `echo` - `file` - `find` @@ -102,6 +103,7 @@ In every case, you may supply your own implementation by overriding the - `rm` - `sed` - `sleep` +- `stat` - `test` - `touch` - `tr` (requires support for `-d`) @@ -244,6 +246,9 @@ For example, the trivial `text/plain` parser is defined as follows :⁠— the set of allowed plaintext file types. Multiple such `` elements may be provided in a single parser, for example if the parser supports multiple media types. +Alternatively, you can set the `@书社:supported-media-types` attribute + on the root element of the parser to override media type support + detection. It is **strongly recommended** that all templates in parsers other than those described above be namespaced (by `@name` or `@mode`), to avoid @@ -278,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 ``. + - **`transforms/asset.xslt`:** Converts `` elements which correspond to recognized media types into the appropriate H·T·M·L elements, and deletes @@ -309,6 +322,11 @@ The following are recommendations on effective creation of - Set `@exclude-result-prefixes` on the root `xslt:transform` element to reduce the number of declared namespaces in the final result. +The params `$buildtime`, `$srctime`, and `$path` are available within + transforms and are initialized to the current time, the time that the + source file was last modified, and the path of the output file within + $(DESTDIR). + ## Output Wrapping ⛩️📰 书社 will wrap the final output of the transforms in appropriate