X-Git-Url: https://git.ladys.computer/Wiki/blobdiff_plain/8048beec7d5f0977f1f680df616e26dca54e7fe0..refs/heads/live:/Sources/Meta/Editing.djot?ds=inline diff --git a/Sources/Meta/Editing.djot b/Sources/Meta/Editing.djot index c9bde40..dc66327 100644 --- 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