X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/795e986a74f14006d2ae4d09198e65e195712b5c..d64d93fe12371f87cc42d72e7e874115b28fb252:/README.markdown diff --git a/README.markdown b/README.markdown index e0a143e..6b4f06e 100644 --- a/README.markdown +++ b/README.markdown @@ -214,11 +214,8 @@ The following additional variables can be used to control the behaviour A white·space‐separated list of media types to consider X·M·L (default: `application/xml text/xml`). -- **`GENERATOR`:** - The name of the generator program (default: `⛩️📰 书社`). - -- **`VERSION`:** - The current version of `GENERATOR` (default: derived from the current +- **`THISREV`:** + The current version of ⛩️📰 书社 (default: derived from the current git tag/branch/commit). - **`SRCREV`:** @@ -272,16 +269,15 @@ Parsers are used to convert plaintext files into X·M·L trees, as well ⛩️📰 书社 comes with some parsers; namely :⁠— - **`parsers/plain.xslt`:** - Wraps `text/plain` contents in a `` element. + Wraps `text/plain` contents in a `` element. - **`parsers/record-jar.xslt`:** - Converts `text/record-jar` contents into a - `` of `` elements (one for - each record). + Converts `text/record-jar` contents into a `` of + `` elements (one for each record). - **`parsers/tsv.xslt`:** - Converts `text/tab-separated-values` contents into an - `` element. + Converts `text/tab-separated-values` contents into an `` + element. New ⛩️📰 书社 parsers which target plaintext formats should have an `` element with no `@name` or `@mode` and whose @@ -347,6 +343,26 @@ It is **strongly recommended** that auxillary templates in parsers be namespaced (by `@name` or `@mode`) whenever possible, to avoid conflicts between parsers. +### Attributes added during parsing + +⛩️📰 书社 will add a few attributes to the output of the parsing step, + namely :⁠— + +- A `@书社:cksum` attribute on toplevel result elements, giving the + `cksum` checksum of the corresponding source file. + +- For the elements which result from parsing plaintext `` + elements :⁠— + + - A `@书社:parsed-by` attribute, giving a space‐separated list of + parsers which parsed the node. + (Generally, this will be a list of one, but it is possible for the + result of a parse to be another plaintext node, which may be + parsed by a different parser.) + + - A `@书社:media-type` attribute, giving the identified media type of + the plaintext node. + ## Embedding Documents can be embedded in other documents using a `<书社:link>` @@ -435,17 +451,14 @@ The following params are made available globally in parsers and - **`CKSUM`:** The checksum of the source file (⅌ `cksum`). -- **`GENERATOR`:** - The value of the `GENERATOR` variable (if present). - - **`SRCREV`:** The value of the `SRCREV` variable (if present). - **`SRCTIME`:** The time at which the source file was last modified. -- **`VERSION`:** - The value of the `VERSION` variable (if present). +- **`THISREV`:** + The value of the `THISREV` variable (if present). The following params are only available in transforms :⁠—