Tom's Lemmy
  • Communities
  • Support Lemmy
  • Search
  • Login
  • Sign Up
Selfhosted@lemmy.worldbyScrubbles@poptalk.scrubbles.tech
4 months

Looking for a good wiki based off of a git repo

English

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
    You must log in or register to comment.
    • curbstickle@anarchist.nexusEnglish
      4 months

      Forgejo has a built in wiki capability.

      I just use that, with configs in the repo.

        • ArchAengelus@lemmy.dbzer0.comEnglish
          4 months

          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.caEnglish
            4 months

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

            • ikidd@lemmy.worldEnglish
              4 months

              Any idea if it will render Mermaid diagrams correctly?

                • curbstickle@anarchist.nexusEnglish
                  4 months

                  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.

                • Scrubbles@poptalk.scrubbles.techEnglish
                  4 months

                  Interesting, had no idea!

                • november@piefed.blahaj.zoneEnglish
                  4 months

                  Otterwiki is great for that.

                    • Scrubbles@poptalk.scrubbles.techEnglish
                      4 months

                      This looks great! Thank you for the recommendation!

                    • lorentz@feddit.itEnglish
                      4 months

                      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.mlEnglish
                        4 months

                        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.mlEnglish
                          4 months

                          apt install gitit

                          Selfhosted@lemmy.world

                          selfhosted@lemmy.world

                          Subscribe from Remote Instance

                          Create a post
                          You are not logged in. However you can subscribe from another Fediverse account, for example Lemmy or Mastodon. To do this, paste the following into the search field of your instance: [email protected]

                          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:

                          1. Be civil: we’re here to support and learn from one another. Insults won’t be tolerated. Flame wars are frowned upon.

                          2. No spam posting.

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

                          4. Don’t duplicate the full text of your blog or github here. Just post the link for folks to click.

                          5. Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).

                          6. No trolling.

                          7. No low-effort posts. This is subjective and will largely be determined by the community member reports.

                          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!

                          Visibility: Public

                          This community is visible to everyone.

                          • 1.26K users / Day
                          • 2 users / Week
                          • 5.38K users / Month
                          • 15.6K users / 6 months
                          • 1 local subscriber
                          • 57K subscribers
                          • 2.92K Posts
                          • 50.2K Comments
                          • Modlog
                          • UI: 1.0.0-alpha.12
                          • BE: 1.0.0-alpha.15
                          • Modlog
                          • Instances
                          • Docs
                          • Code
                          • join-lemmy.org