4 ms·

Dang, I thought this could cover my use case. At my (small but slowly growing) company, we use a git repository with a bunch of org files as our wiki. It works

by fhd2 2y ago

Dang, I thought this could cover my use case. At my (small but slowly growing) company, we use a git repository with a bunch of org files as our wiki. It works OK, but I can't see that grow very much. Also not particularly excited about moving to another tool though, org-mode is neat. If anyone figured out a better way to collaborate on a bunch of org files in a team, I'd love to hear about it!

SoftTalker 2y ago
Git (or a verson control system) actually sounds pretty ideal. That is their main use case: collaborating on a bunch of files in a team. What about it isn't working? Git scales to huge numbers of contributors easily.
- fhd2 2y ago
  Well, for one, it's a bit of a hassle. Constantly thinking of commit messages and stuff, but maybe I'm overly dramatic there. On top of that, it would be nice to at least navigate the contents read-only without Emacs. We use GitLab, it does render org files, but not even links to other files work.
  - setopt 2y ago
    For read-only access, I’ve heard that Hugo can be used with Org. It’s perhaps more used for blogs than wikis, but it should give you a clean and lightweight website of linked HTML files generated from the Org files, which might be sufficient. Presumably, this can be integrated with Gitlab CI to regenerate the website on push. I guess one question though is how this will scale as the company grows, assuming that more non-Emacs users might join the team after a while?
    - fhd2 2y ago
      Yeah exactly, it's a bit like chasing a local maximum. The sibling suggestion, gollum, looks very promising for this, a git backed web based wiki with org support.
paulv 2y ago
I think the web interface for the gollum wiki (which used to power GitHub wikis, but I think they have diverged) supports org mode files. https://github.com/gollum/gollum https://github.com/gollum/gollum
- fhd2 2y ago
  That looks pretty spot on, thank you!

by fhd2 2y ago

SoftTalker 2y ago

Git (or a verson control system) actually sounds pretty ideal. That is their main use case: collaborating on a bunch of files in a team. What about it isn't working? Git scales to huge numbers of contributors easily.

fhd2 2y ago
Well, for one, it's a bit of a hassle. Constantly thinking of commit messages and stuff, but maybe I'm overly dramatic there. On top of that, it would be nice to at least navigate the contents read-only without Emacs. We use GitLab, it does render org files, but not even links to other files work.
- setopt 2y ago
  For read-only access, I’ve heard that Hugo can be used with Org. It’s perhaps more used for blogs than wikis, but it should give you a clean and lightweight website of linked HTML files generated from the Org files, which might be sufficient. Presumably, this can be integrated with Gitlab CI to regenerate the website on push. I guess one question though is how this will scale as the company grows, assuming that more non-Emacs users might join the team after a while?
  - fhd2 2y ago
    Yeah exactly, it's a bit like chasing a local maximum. The sibling suggestion, gollum, looks very promising for this, a git backed web based wiki with org support.

paulv 2y ago

I think the web interface for the gollum wiki (which used to power GitHub wikis, but I think they have diverged) supports org mode files. https://github.com/gollum/gollum https://github.com/gollum/gollum

fhd2 2y ago
That looks pretty spot on, thank you!