Update Editing documentation for @as

[Wiki] / Sources / Meta / Editing.djot

diff --git a/Sources/Meta/Editing.djot b/Sources/Meta/Editing.djot
index c9bde4076249b9fbf22a7a7e05274d51c471fa2f..dc66327f5ff3b272b86ff1e12cc5ada7a601c74e 100644 (file)
--- a/Sources/Meta/Editing.djot
+++ b/Sources/Meta/Editing.djot
@@ -22,7 +22,7 @@ Obviously, only people who have s·s·h keys registered with the `wiki`
   user to be able to edit.
 Registration is by invitation only.
 
-The file structure of the wiki is as follows :`⁠`{=html}—
+The file structure of the wiki is as follows:8--:
 
 ```
 Sources/
@@ -59,7 +59,7 @@ Contact me ([][@:Lady]{.sig}) if things go horribly wrong.
 {#djot-ext}
 ## extensions to the Djot syntax
 
-{id="djot.links-internal"}
+{id="djot.links-internal" v-full="djot internal links"}
 ### internal links
 
 A reference link which contains a colon is an internal link.
@@ -68,7 +68,7 @@ Typically, you should not include link text and just let it be
 
 - For any page, its full reference is `[][NamespaceName:FileName]`.
 
-- Some namespaces have an abbreviated syntax :`⁠`{=html}—
+- Some namespaces have an abbreviated syntax:8--:
 
   - Pages in the `Page` namespace can be referred to as just
       `[][:FileName]`.
@@ -98,7 +98,7 @@ Typically, you should not include link text and just let it be
     [][Special:ToDo].
   *The latter isn’t implemented yet.*
 
-{id="djot.links-external"}
+{id="djot.links-external" v-full="djot external links"}
 ### external links
 
 For the most part these work exactly as expected.
@@ -112,6 +112,29 @@ If the title matches the link text, you can leave the link text blank,
   as in `[](https://example.com){title="Example Page"}`:
   [](https://example.com){title="Example Page"}.
 
+{id="djot.other" v-full="other djot extensions"}
+### other stuff
+
+- The `@as` attribute can be used on any element with children to
+    change what H·T·M·L element is used.
+  For example, the following is a citation: _My Citation_{as=cite}.
+  Here is a disclosure widget:8--:
+
+  {as=details}
+  ::::::::::::
+  {as=summary}
+  My Summary
+
+  My details for this widget.
+  ::::::::::::
+
+- There are symbols defined for spaces, invisible characters, and a
+    couple of other conveniences.
+  You can view the full list [here][GitWikiWeb/config.yaml].
+  You can also escape any special character using the following
+    syntax:8--: `:U+####:` (where `####`:mathsp:=:mathsp:the
+    codepoint in hexadecimal).
+
 {#bcp}
 ## best practices
 
@@ -119,11 +142,6 @@ If the title matches the link text, you can leave the link text blank,
 ### while {writing ∣ editing}
 
 - *Use Unicode* to the best of your ability.
-  You can escape special characters using the following
-    syntax :`⁠`{=html}— `` `&#xNN;`{=html}`` (where `NN` = the
-    codepoint in hexadecimal).
-  However, it is generally best to just input the characters directly
-    if you are able.
 
 - *Wrap lines* to (at most) 71 characters.
 
@@ -171,11 +189,14 @@ If the title matches the link text, you can leave the link text blank,
     but *branching is discouraged* and it’s better to just work messily
     on `live`.
 
+[Atom feed]:
+  https://git.ladys.computer/Wiki/atom
 [Djot]:
   https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/maste
   r/doc/syntax.html
-[Atom feed]:
-  https://git.ladys.computer/Wiki/atom
+[GitWikiWeb/config.yaml]:
+  https://git.ladys.computer/GitWikiWeb/blob/refs/heads/ladys:/config.y
+  aml
 [git push --force-with-lease]:
   https://git-scm.com/docs/git-push#Documentation/git-push.txt---no-for
   ce-with-lease