Looking for a good wiki based off of a git repo
from scrubbles@poptalk.scrubbles.tech to selfhosted@lemmy.world on 25 Nov 00:12
https://poptalk.scrubbles.tech/post/3375243

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!

#selfhosted

threaded - newest

curbstickle@anarchist.nexus on 25 Nov 00:49 next collapse

Forgejo has a built in wiki capability.

I just use that, with configs in the repo.

scrubbles@poptalk.scrubbles.tech on 25 Nov 01:19 next collapse

Interesting, had no idea!

ArchAengelus@lemmy.dbzer0.com on 25 Nov 06:19 next collapse

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 on 25 Nov 06:48 next collapse

I’ve had this in my homelab for months and had no idea. Thanks.

ikidd@lemmy.world on 26 Nov 19:36 collapse

Any idea if it will render Mermaid diagrams correctly?

curbstickle@anarchist.nexus on 26 Nov 19:45 collapse

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.

solrize@lemmy.ml on 25 Nov 02:08 next collapse

apt install gitit

november@piefed.blahaj.zone on 25 Nov 02:22 next collapse

Otterwiki is great for that.

scrubbles@poptalk.scrubbles.tech on 25 Nov 03:10 collapse

This looks great! Thank you for the recommendation!

lorentz@feddit.it on 25 Nov 11:08 next collapse

I use 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 on 26 Nov 09:47 collapse

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).