3 ms·

That's not a git-based wiki. That's a GitHub-based wiki. gitit is a git-based wiki. https://github.com/jgm/gitit https://github.com/jgm/gitit It's written in

by dsr_ 6y ago

That's not a git-based wiki. That's a GitHub-based wiki. gitit is a git-based wiki. https://github.com/jgm/gitit https://github.com/jgm/gitit It's written in Haskell, which will thrill some people and annoy some people and make most people shrug. We used gitit for more than a year, but realized that it just wasn't enough fun to use. Transitioning to Dokuwiki was fast, and it turns out to hold our interest pretty well.

fouc 6y ago
A static site generator isn't really the same thing as a git-based wiki.
- mbreese 6y ago
  Isn’t the difference really when the static site generator program runs? You can either run it yourself or in a post-commit/push hook (or a CI action, etc). But aside from that, what do you see as the difference? Automatically adding in the navigation links?
smichel17 6y ago
https://wiki.snowdrift.coop https://wiki.snowdrift.coop uses gitit.. But, a patched version that has bidirectional sync with https://gitlab.com/snowdrift/wiki https://gitlab.com/snowdrift/wiki (pushes after commits, pulls when promoted by the gitlab webhook). Works pretty well.
chrismorgan 6y ago
Sure it’s a Git-based wiki. It’s a flat-file content system with full linking and all; it’s not using any special GitHub functionality at all. You can browse this wiki in a text editor (some will let you easily jump between files, e.g. `gf` in Vim, and some won’t), or see it rendered to HTML on any mainstream Git hosting service.
- chrisfinazzo 6y ago
  This was my thought as well. What do people disagree about re the definition of 'git-based' wiki? Do the purists who object to this (in a "Linus Torvalds' definition of git kind of way") fundamentally believe that there should be no central "origin" of any kind in a repo? Sure, the main attraction in a DVCS is that everyone has a complete copy of the code and can pull branches or integrate changes from anyone else into their work, but eventually these changes have to 'land' somewhere and for most things, that's GitHub/GitLab/whatever other hosting service with git support. ^ This is - for practical purposes - my definition of origin.
- pacoverdi 6y ago
  It is using GitHub's markdown renderer so that links are clickable.
- Galanwe 6y ago
  With your definition of wiki, any versioned text file is one... To me a wiki should have an UI on top of editable/versioned files, otherwise there is not point. I agree with the parent poster that in this case, the UI is github, thus it's more a github wiki than a git wiki.
- bbeonx 6y ago
  Meh, it's usable w/out github but you'll be reading raw markdown files (unless you get your own markdown renderer which isn't that big of a deal). But yeah, it's either an incomplete git-based wiki or a complete github based wiki.
RichardCA 6y ago
It always goes this way. Some people really want to edit their wiki markup in a plain text editor, others want that superior UI/UX that a system like Dokuwiki offers. So if you have to optimize for an entire team you end up moving away from plain-text editing. No one has been able to solve effectively for both use cases. When Confluence dropped support for plain-text markup editing there was a huge storm about it. Some people are still angry at Atlassian. https://community.atlassian.com/t5/Confluence-questions/Wiki-Markup-in-Confluence-4-again/qaq-p/220665 https://community.atlassian.com/t5/Confluence-questions/Wiki...
- Fellshard 6y ago
  It's a lock-in nightmare to migrate, and it really needs to be accounted for as a deep cost in choosing Confluence.
- slim 6y ago
  dokuwiki is plain text too
deleted 6y ago
[deleted]
deleted 6y ago
[deleted]
johnisgood 6y ago
> By default, GHC's runtime will repeatedly attempt to collect garbage when an executable like Gitit is idle. This means that gitit will, after the first page request, never use 0% CPU time and sleep, but will use ~1%. This can be bad for battery life, among other things. Well, that is good to know at least.
goerz 6y ago
And Github already has Wikis built in (https://docs.github.com/en/github/building-a-strong-community/about-wikis https://docs.github.com/en/github/building-a-strong-communit...). It's basically the same as what the OP is proposing, but with more explicit support (history/sidebar rendered in the Github UI)
- TAForObvReasons 6y ago
  Private GH wikis are not available on the free tier

by dsr_ 6y ago

fouc 6y ago

A static site generator isn't really the same thing as a git-based wiki.

mbreese 6y ago
Isn’t the difference really when the static site generator program runs? You can either run it yourself or in a post-commit/push hook (or a CI action, etc). But aside from that, what do you see as the difference? Automatically adding in the navigation links?

smichel17 6y ago

https://wiki.snowdrift.coop https://wiki.snowdrift.coop uses gitit.. But, a patched version that has bidirectional sync with https://gitlab.com/snowdrift/wiki https://gitlab.com/snowdrift/wiki (pushes after commits, pulls when promoted by the gitlab webhook). Works pretty well.

chrismorgan 6y ago

Sure it’s a Git-based wiki. It’s a flat-file content system with full linking and all; it’s not using any special GitHub functionality at all. You can browse this wiki in a text editor (some will let you easily jump between files, e.g. `gf` in Vim, and some won’t), or see it rendered to HTML on any mainstream Git hosting service.

chrisfinazzo 6y ago
This was my thought as well. What do people disagree about re the definition of 'git-based' wiki? Do the purists who object to this (in a "Linus Torvalds' definition of git kind of way") fundamentally believe that there should be no central "origin" of any kind in a repo? Sure, the main attraction in a DVCS is that everyone has a complete copy of the code and can pull branches or integrate changes from anyone else into their work, but eventually these changes have to 'land' somewhere and for most things, that's GitHub/GitLab/whatever other hosting service with git support. ^ This is - for practical purposes - my definition of origin.
pacoverdi 6y ago
It is using GitHub's markdown renderer so that links are clickable.
Galanwe 6y ago
With your definition of wiki, any versioned text file is one... To me a wiki should have an UI on top of editable/versioned files, otherwise there is not point. I agree with the parent poster that in this case, the UI is github, thus it's more a github wiki than a git wiki.
bbeonx 6y ago
Meh, it's usable w/out github but you'll be reading raw markdown files (unless you get your own markdown renderer which isn't that big of a deal). But yeah, it's either an incomplete git-based wiki or a complete github based wiki.

RichardCA 6y ago

It always goes this way. Some people really want to edit their wiki markup in a plain text editor, others want that superior UI/UX that a system like Dokuwiki offers. So if you have to optimize for an entire team you end up moving away from plain-text editing. No one has been able to solve effectively for both use cases. When Confluence dropped support for plain-text markup editing there was a huge storm about it. Some people are still angry at Atlassian. https://community.atlassian.com/t5/Confluence-questions/Wiki-Markup-in-Confluence-4-again/qaq-p/220665 https://community.atlassian.com/t5/Confluence-questions/Wiki...

Fellshard 6y ago
It's a lock-in nightmare to migrate, and it really needs to be accounted for as a deep cost in choosing Confluence.
slim 6y ago
dokuwiki is plain text too

deleted 6y ago

[deleted]

deleted 6y ago

[deleted]

johnisgood 6y ago

> By default, GHC's runtime will repeatedly attempt to collect garbage when an executable like Gitit is idle. This means that gitit will, after the first page request, never use 0% CPU time and sleep, but will use ~1%. This can be bad for battery life, among other things. Well, that is good to know at least.

goerz 6y ago

And Github already has Wikis built in (https://docs.github.com/en/github/building-a-strong-community/about-wikis https://docs.github.com/en/github/building-a-strong-communit...). It's basically the same as what the OP is proposing, but with more explicit support (history/sidebar rendered in the Github UI)

TAForObvReasons 6y ago
Private GH wikis are not available on the free tier