Currently I have random docs/how-tos for my network stored in a forgejo repo, just a bunch of READMEs. I'd like to somehow make that a bit more official, I like writing it in markdown/git and having source control, but was wondering if anyone has a good wiki tool they like that can consume that and make it more hostable? Thanks!
11 Comments
curbstickle@anarchist.nexus · 14 pts · 266d
Forgejo has a built in wiki capability.
I just use that, with configs in the repo.
ArchAengelus@lemmy.dbzer0.com · 6 pts · 266d
Also, if you do it right, I’m pretty sure you can cross-link your git repo’s markdown files without using the built in wiki.
This makes it a lot more portable if you want to update the wiki in your favorite text editor.
cheeseburger@piefed.ca · 4 pts · 266d
I've had this in my homelab for months and had no idea. Thanks.
scrubbles@poptalk.scrubbles.tech · 3 pts · 266d
Interesting, had no idea!
ikidd@lemmy.world · 3 pts · 264d
Any idea if it will render Mermaid diagrams correctly?
curbstickle@anarchist.nexus · 3 pts · 264d
As well as any other mermaid renderers I've seen. Which is to say it works, but has the same drawbacks for diagrams I've seen everywhere else with mermaid.
november@piefed.blahaj.zone · 5 pts · 266d
Otterwiki is great for that.
scrubbles@poptalk.scrubbles.tech · 2 pts · 266d
This looks great! Thank you for the recommendation!
lorentz@feddit.it · 4 pts · 266d
I use https://mycorrhiza.wiki/. It is really lightweight and stores data in a git repo. So it is terribly easy to export and backup it. the only drawback is that it uses its own markdown dialect
Zenlix@lemmy.ml · 3 pts · 265d
I have markdown files in a git repo and run mdbook via cicd so I get a nice html build. Localy I can build it too or just use the markdown files (except for mdbook specific features such as preprocessors).
solrize@lemmy.ml · 2 pts · 266d
apt install gitit