From: Lady Date: Fri, 28 Jul 2023 09:37:28 +0000 (-0700) Subject: Better arrange some content in Meta:Editing X-Git-Url: https://git.ladys.computer/Wiki/commitdiff_plain/9163a51802fbcdac4035a16fcc0bdb2bc82a1241 Better arrange some content in Meta:Editing --- diff --git a/Sources/Meta/Editing.djot b/Sources/Meta/Editing.djot index 6bfffec..9aec79e 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,25 @@ 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 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}` + +- 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 +138,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 +185,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