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).
Selfhosted
A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.
Rules:
-
Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.
-
No spam posting.
-
Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it's not obvious why your post topic revolves around selfhosting, please include details to make it clear.
-
Don't duplicate the full text of your blog or github here. Just post the link for folks to click.
-
Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).
-
No trolling.
Resources:
- selfh.st Newsletter and index of selfhosted software and apps
- awesome-selfhosted software
- awesome-sysadmin resources
- Self-Hosted Podcast from Jupiter Broadcasting
Any issues on the community? Report it using the report flag.
Questions? DM the mods!
Forgejo has a built in wiki capability.
I just use that, with configs in the repo.
Any idea if it will render Mermaid diagrams correctly?
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.
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.
I've had this in my homelab for months and had no idea. Thanks.
Interesting, had no idea!
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
apt install gitit