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!
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).
curbstickle@anarchist.nexus 4 days ago
Forgejo has a built in wiki capability.
I just use that, with configs in the repo.
ikidd@lemmy.world 2 days ago
Any idea if it will render Mermaid diagrams correctly?
curbstickle@anarchist.nexus 2 days ago
As well as any other mermaid renderers I’ve seen:
ArchAengelus@lemmy.dbzer0.com 4 days ago
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 days ago
I’ve had this in my homelab for months and had no idea. Thanks.
scrubbles@poptalk.scrubbles.tech 4 days ago
Interesting, had no idea!