X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/c00fbad125caaac8be191801ca47a6971007fbad..8f60c082aa14e189db3de44d460b76967fa6dd1b:/README.markdown
diff --git a/README.markdown b/README.markdown
index f6a0864..7c663be 100644
--- a/README.markdown
+++ b/README.markdown
@@ -1,3 +1,7 @@
+
# ⛩️📰 书社
A make·file for X·M·L.
@@ -69,9 +73,13 @@ Compilation involves the following steps :—
5. ⛩️📰 书社 uses the dependency tree to establish prerequisites for
each output file.
-6. ⛩️📰 书社 compiles each output file to `build/public`.
+6. ⛩️📰 书社 compiles each output file to `build/result`.
-7. ⛩️📰 书社 copies the output files to `public`.
+7. ⛩️📰 书社 symlinks most output files from `build/result` to
+ `build/public`, but it does some additional processing instead on
+ those which indicate a non‐X·M·L desired final output form.
+
+8. ⛩️📰 书社 copies the final resulting files to `public`.
You can use `make list` to list each identified source file or include
alongside its computed type and dependencies.
@@ -122,6 +130,7 @@ In every case, you may supply your own implementation by overriding the
- `touch`
- `tr` (requires support for `-d`)
- `uuencode` (requires support for `-m` and `-r`)
+- `uudecode` (requires support for `-m` and `-r`)
- `xargs` (requires support for `-0`)
- `xmlcatalog` (provided by `libxml2`)
- `xmllint` (provided by `libxml2`)
@@ -518,8 +527,8 @@ This mechanism can be used to allow transforms to insert content
Output wrapping can be entirely disabled by adding a
`@书社:disable-output-wrapping` attribute to the top‐level element in
the result tree.
-This attribute will also prevent wrapping non‐H·T·M·L embeds with an
- ``.
+It will not be performed on outputs whose root elements are
+ `<书社:raw-text>` or `<书社:base64-binary>` (described below).
## Applying Attributes
@@ -542,10 +551,28 @@ Both elements ignore attributes in the `xml:` namespace, except for
On H·T·M·L and S·V·G elements, `@lang` has the same behaviour as
`@xml:lang`.
+## Other Kinds of Output
+
+There are a few special elements in the `书社:` namespace which, if
+ they appear as the toplevel element in a transformation result, cause
+ ⛩️📰 书社 to produce something other than an X·M·L file.
+They are :—
+
+- **`<书社:raw-text>`:**
+ A plaintext (U·T·F‐8) file will be produced from the text nodes in
+ the transformation result.
+
+- **`<书社:base64-binary>`:**
+ The text nodes in the transformation result will, after removing all
+ Ascii whitespace, be treated as a Base·64 string, which is then
+ decoded.
+
## License
-Source files are licensed under the terms of the Mozilla Public
- License, version 2.0.
-For more information, see [LICENSE](./LICENSE).
+This repository conforms to [REUSE][].
+
+Most source files are licensed under the terms of the Mozilla
+ Public License, version 2.0.
+[REUSE]:
[draft-phillips-record-jar-01]: