Update Editing documentation for @as

[Wiki] / Sources / Meta / Editing.djot

diff --git a/Sources/Meta/Editing.djot b/Sources/Meta/Editing.djot
index 6bfffecfe02a6b5172ba7951ffab916016d6f42e..dc66327f5ff3b272b86ff1e12cc5ada7a601c74e 100644 (file)
--- a/Sources/Meta/Editing.djot
+++ b/Sources/Meta/Editing.djot
@@ -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.
@@ -98,16 +98,7 @@ Typically, you should not include link text and just let it be
     [][Special:ToDo].
   *The latter isn’t implemented yet.*
 
-- The `@as` attribute can be used on emphasized text to change what
-    H·T·M·L element is used.
-  The following values are supported:8--:
-
-  - `_b_{as=b}`
-  - `_cite_{as=cite}`
-  - `_i_{as=i}`
-  - `_u_{as=u}`
-
-{id="djot.links-external"}
+{id="djot.links-external" v-full="djot external links"}
 ### external links
 
 For the most part these work exactly as expected.
@@ -121,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
 
@@ -128,12 +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.
-  There are symbols defined for most spaces and invisible characters.
-  You can also escape any special character using the following
-    syntax:8--: `:U+NNNN:` (where `NNNN`:mathsp:=:mathsp: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.
 
@@ -181,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