It’s been a while, since we talked about #wikis, so I thought I’d make it a topic, again, with an update on the state of development of NIP-54.
fiatjaf (npub180c…h6w6) has identified the #Asciidoc rendering issue with special characters, so those weird “&bnsp” and similar errors should eventually disappear. 😊
I’ve been using Asciidoc, for a while, now, and it’s definitely a superior markup. Markdown is alright for plain articles (like this one), but a catastrophe, with anything even slightly more complex or professional.
I’ve found that the wiki events are excellent for project #documentation because they’re collaborative. Feels like using Confluence. We each fork from and deferr to, each others’ version, so it’s a similar experience to using git patches for documentation. (I store major changes as .adoc in git, tho, for versioning and backup.)
The current wiki clients are just missing a diff, kind 1111 comments, and highlights. Some of the formatting styles need to be tidied up, regarding fonts and spacing, and whatnot, and they need some more QC. I might do that for Wikistr, if I can find a lull in my GitCitadel tickets.
We have some ideas, for improving internal references (for example, footnotes), by making them into separate events, but that will be listed in the #NKBIP-03 page, that I’m about to write. (I will add a link to it, from here, later.) For now, I just use the Asciidoc syntax and it is rendered directly. I think this new event will take a long time, to structure properly, and we’ll pilot it in a later version of Alexandria.
If you have any factual/nonfiction information, that you think will be important to find, later, I would suggest you write it into a wiki page, not Kind 01. Not only does that improve its discoverability, it reduces the chance that relays will delete it.
We, at GitCitadel (npub1s3h…75wz) have decided that wiki functionality makes sense, to integrate into #Alexandria v0.2.0, so that has been added to the work breakdown structure. I don’t expect us to have as much functionality, as a dedicated wiki app, such as Wikistr, but it will render the pages and the internal links will work.