1

If I could live entirely in Emacs, I would. But... I now have to collaborate with others on a shared wiki and my team requires a web interface to edit pages.

So I need to select a wiki engine. Ideally, while my team can update pages though the web, I would be able to do the same, entirely from within Emacs. The features I am looking for broadly include:

  1. Open source and self-hosted
  2. Git based wiki that I can checkout and archive locally, pulling changes and pushing updates as I go. Bonus points if it works with Magit
  3. Access and edit via Emacs org-mode. If the entire wiki could live on my computer as a single org-mode document, that would be fantastic!
  4. Easily install the wiki engine locally on my mac for config/testing and then easily porting this to the production server for deployment
  5. Bootstrap themes available
  6. Supported with a healthy developer community
  7. Flat file architecture. I don't want to mess with databases

Any ideas?

8
  • 1
    I don't know exactly what features do you want but, in my work we use hugo, it support org mode, and it is easily managed with Magit, it also have really nice themes similar to wikis like themes.gohugo.io/hugo-theme-techdoc Ans it is easy to use, just with gitlab pages or github.
    – Fermin MF
    Commented May 4, 2020 at 15:31
  • 1
    Thanks @f-sasa. I love this! And ideally, I would love to use ox-hugo to manage my entire wiki from within a single org document, with git to push/pull changes. But... I thought Hugo was a blogging engine? Can this be made to work as a wiki?
    – Adam
    Commented May 4, 2020 at 15:35
  • It can, the thing is, the entire team have to know how to use git, but if it is the case, it shouldn't be any problem. With gitlab/github private pages, it can be a powerful wiki and the code would look fantastic out of the box. We use gitlab pages and it is great about.gitlab.com/stages-devops-lifecycle/pages
    – Fermin MF
    Commented May 4, 2020 at 15:44
  • So depending on the project, my team may have varying degrees of technical acumen. I live in Emacs and would like to do everything I can in org-mode, including manage documentation for our company's operating manual. However... I also need this document to be accessible to my team with a web interface, so that they can contribute. Ideally, I would find a git-backed wiki that also has an html editor. Ideally, I would find something with the ease of installation, portability and plugin repository of Dokuwiki but git-backed with native support for org-mode (like Gollum?).
    – Adam
    Commented May 4, 2020 at 16:01
  • 1
    @f-sasa Thanks, I think that will do it! And it looks like I might be able to combine ob-wk with either org-babel-detangle or org-tangle-sync so changes can get round-tripped back into org-mode. Awesome! Hey, you you want to write this up, I'll accept it as the answer.
    – Adam
    Commented May 8, 2020 at 17:21

1 Answer 1

1

Maybe you can use dokuwiki, there is an interesting mode to publish content with it, and you can always use xwidget browser or eww if you need to use the interface, oxk.el is a great package for exporting org mode to wiki format. If you still need more functionality, you can always use the dokuwiki api and create an Emacs package.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.