X-Git-Url: https://git.ladys.computer/Wiki/blobdiff_plain/f883cc22adbae48c4acf9112e49c926d34367777..12fdcd3ceb83712368c68543b70beede61c4a964:/Sources/Meta/Editing.djot?ds=sidebyside diff --git a/Sources/Meta/Editing.djot b/Sources/Meta/Editing.djot index 6bfffec..dc66327 100644 --- 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