5 ms·
Otter Wiki: A minimalistic wiki powered by Python, Markdown and git
- Terretta 2y agoNot many wiki site engines based on Markdown work directly from git as cleanly as this. There's a few of them though, such as this old Ruby lang standby with a decade's worth of features that a decade ago was a way to host your same GitHub Pages site locally, supporting SSO: https://github.com/gollum/gollum https://github.com/gollum/gollum https://github.com/gollum/gollum/wiki/Gollum-via-Rack-and-CAS-SSO https://github.com/gollum/gollum/wiki/Gollum-via-Rack-and-CA...
- oarsinsync 2y agoWikmd is another git / markdown / plain text file storage wiki. https://github.com/Linbreux/wikmd https://github.com/Linbreux/wikmd I can’t remember why I switched from gollum to wikmd. I suspect installed size might be why.
- jauntywundrkind 2y agohttps://tina.io/ https://tina.io/ tinacms is very modern & well built, git markdown typescript. and headless or with template components. it's such an epic feat, how programmers have grown up to manage source over time & changes. i very much hope this richness cam extend beyond code some day, stop being arbitrary UI we craft & become good data structures that transcend each application.
- AlphaWeaver 2y agoWe actually switched from Gollum to OtterWiki!
- gglitch 2y agoI really enjoyed Gollum for awhile, but I'm not a Rubyist, and past a certain point, every time I tried to run it or Jekyll I got dependency problems that I'd eventually solve, but without understanding. It was undoubtedly user error; I should definitely have learned and used rvm or something.
- dijksterhuis 2y agogitlab wikis — separate repos to the main project repo that folks can clone/edit/push just like any repo. personally i prefer confluence though. just find it faster to dump things out.
- c0balt 2y agoIt should be noted that goolum is AFAIK still the backend behind GitLabs Wikis. It works quite well Ime and was easy to setup/use for basic Markdown Documents.
- ptman 2y agoIkiwiki is nice. It's also a static wiki compiler and tries very hard to minimize the amount of rebuilding for each edit.
- fiddlosopher 2y agoAn even older one is my gitit, started in 2008! https://hackage.haskell.org/package/gitit-0.15.1.2 https://hackage.haskell.org/package/gitit-0.15.1.2 It doesn't limit itself to markdown, nor to git (you can use darcs, hg, or even sqlite). A bit long in the tooth, though -- I stopped working on it once spam started to make self-hosted public wikis untenable.
- az09mugen 2y agoThe "Edit an Example!" link goes to Forbidden.
- babyoil 2y agoIf you login, you can edit
- apricot13 2y agoI've been playing around with dokuwiki recently but this looks promising. The irony I'm having is that I store some single file html documents alongside my notes and none of these engines (or obsidian) will render them!
- al_borland 2y agoWe use Confluence at work. It has the option to render HTML embedded in the page. I haven’t tried to render a whole file attached to a page, but there might be a way to do that. I’ve used it a bit to add my own forms into pages to create little tools for people in docs. In the past we used Jive, and I had a rather involved HTML paged embedded there. I had to be careful with my CSS, as using any generic attribute level CSS would break the platform. I hope Confluence has protections against that, but haven’t tested it, as I got in the habit of avoiding that issue all together.
- Tallain 2y agoEvery new wiki / knowledge management system I always compare against Confluence. I get the advantage of keeping your content in plaintext for portability but when I look back on how many times I've actually ported wiki content it's... maybe once? Most systems these days are handily capable of this, in any case. Anyway, Confluence for all its flaw has so much power, is so much more pleasant to use, your business folks won't balk at it. As often as not, we have people from all parts of the company in there, reading and writing both, and it needs to be usable to people of all technical levels. Markdown wikis and their editors don't often meet this criterion, or they're missing on some key features (tables!!). To me, Confluence's only real down side is that it's an Atlassian product. I wish I could find something to scratch the itch without feeling the need to buy into that whole ecosystem.
- oarsinsync 2y ago> I get the advantage of keeping your content in plaintext for portability Portability is secondary for me. For me, the primary reason for keeping content in plain text is disaster recovery. When my systems are down, when my applications aren’t working, if my documentation is also inaccessible, this makes things a lot harder. If my documentation is primarily in plain text / markdown, it’s really easy to be able to read those docs again, even when everything else has fallen over.
- vaseko 2y agodo you know a wiki where one can add metadata to the pages? I used https://foswiki.org https://foswiki.org and it was great for combining structured and non structured information
- SpecialistK 2y agoI use Dokuwiki with the Struct plugin.
- prmoustache 2y agoIsn't "poweredy by python" kind of defeating the purpose of using markdown and git? Well I don't mean python as a language, but python as running as a web service/app. Usually when your website is hosted on git as markdown files, that is because you'd rather have the website generation separated from serving the actual content to the public, i.e. having a secure and dead simple static website. If you start having to run a service/container, that generate the content on the fly and plan to edit the website using the browser, I don't really see the advantage of hosting the content on git vs a database. That database can be as simple and easy to host/backup/manage as a simple sqlite3 file and would still be more efficient than a git repo as a storage backend.
- suprjami 2y agoNo, this isn't always true. I have hated every WYSIWYG intranet my employer has used. I just want to write Markdown. Luckily, we also had access to a file server with ~/public_html and httpd with PHP. So I just threw PHP Markdown Extra and a htaccess file up, now I can write in Markdown and it magically works. If that was done with Python I wouldn't care either. (that old webserver has since been retired and the new one doesn't have PHP, so now I render locally with Pandoc and rsync my HTML files directly, sigh)
- emj 2y agoI agree, there are two things I miss with markdown: import/export of text + media, multi user editing. This is always an extra step when you do not have and editing builtin in the Wiki that handles that. The "paste" image into document feature is one of the most useful features of a wiki if you want to write a fast bare bones tutorial.
- Tepix 2y ago> That database can be as simple and easy to host/backup/manage as a simple sqlite3 file and would still be more efficient than a git repo as a storage backend. With git you will have the latest version of the file in the filesystem, that must be more efficient than retrieving it from sqlite3, mustn't it?
- Twisell 2y agoIt's minimalist until you read the installation part... As a backend SQL guy I always feel overwhelmed by "minimalist" software that actually depend on me knowing ho to deploy safely on docker or mastering N dependencies before actually having something to try. Long are gone the lamp days... they had their own set of problems (wrong versions!) but it was a simpler time where you felt a little bit more in control. Old man yell at the clouds I guess...
- castlec 2y agoIts comprehensive. It is not complex. They just show all of the typical ways one would want to deploy.
- al_borland 2y agoI often feel the same way. I had someone ask me to make a microservice on some platform she built. I was told it would take 10 minutes. In reality, it took a couple weeks, and then every week for a year I was getting told something was changing and I had to mess with this or that, and also attend daily meetings about the project. 10 minutes turned into 30% of my whole year. The whole platform she built lasted maybe 2 years before it was decided we needed to move on from it. It was a total waste of time. Meanwhile, I have a little LAMP project that is used significantly more than the micro service, that I’ve run for 15 years that I only have to touch when it needs feature updates. The platform itself just works. Occasionally I’ll need to move to a newer OS, which takes a few hours to get the new server built, run the job to configure it (doing it manually doesn’t take too much longer), then submit a request to change the load balancer to point to the new servers. Granted, some of this comes down to experience. However, needing to know all the tools involved for the microservice was much more annoying and they broke half the time.
- klaussilveira 2y agoBoring technology just works. That's why it is boring and not appealing to younger developers. https://boringtechnology.club/ https://boringtechnology.club/
- tripple6 2y agoIs there anything git-based like this having semantic web stuff support similar to Semantic MediaWiki?
- rcarmo 2y agoI like it. My site (taoofmac.com) is also git/python-backed, although not live editable.
- joedevon 2y agoI ran https://wave.webaim.org/ https://wave.webaim.org/ against the homepage, saw 11 errors right off the bat, and decided not to look at further. Particularly for this kind of project, though as an accessibility person I'd argue every project, accessibility is table stakes.
- rcarmo 2y agoYou could, perhaps, consider filing an issue or fixing some low-hanging fruit.
- diggan 2y agoIs there something similar but instead of being minimalistic mediwiki alternative, it's a minimalistic wikibase alternative?
- emanuele-em 2y agoquite sure that is my limit but what is the difference between this and other "md compiler" projects (or ssr) like <https://github.com/rust-lang/mdBook https://github.com/rust-lang/mdBook>? Anyway this seems to work very well, so congrats!
- strunz 2y agoI love this, but so many of these are missing or have a half baked Annotations feature. I've been looking for something that that for years and none of them work well for this purpose. Mediawiki, Dokuwiki, Xwiki, etc.
- com 2y agoCan you explain what you need in annotations that doesn’t exist in these wikis?
- atebyagrue 2y agoI was literally building my own version of this with madness this morning to go from Obsidian to web in my workflow. Thanks for speeding things up for me. Great work!
- bityard 2y agoHuh! This is really nice! If I had run across this sooner, I might not have wrote my own very similar wiki. (https://github.com/cu/silicon https://github.com/cu/silicon) Otter is much nicer, though.
- Tepix 2y agoLooks good. I like the small memory footprint a lot! It would be nice to have a WYSIWYG text editor for the markdown or to have a live preview next to the markdown.
- Workaccount2 2y agoI have a hard time using the word "minimalisitc" to describe any site that requires javascript to function.
- regisso 2y agoI've been using it for while, recommended.
- zhynn 2y agoOr you could just use fossil...
- neves 2y agoHere's why I didn't access the link: I'm never interested in any product that the main feature is the technology it uses. Which problem does it solve? Not how it is made.
- nine_k 2y agoWhy, how it's made is also its interface, and its operational requirements. Both are important. - Markdown: widely used, readable, well-supported by other tools. - Git: ubiquitous, well-supported, likely already present and set up. - Python: ubiquitous, well-supported, easy to read and hack on; sometimes a pain to deploy. If the above is not relevant for you, well, you'd be better served with opaque one-click-installable apps from App Store. Not bad, just different.
- simonw 2y agoThe title here was an editorial choice by the person who submitted this link to Hacker News.
- INTPenis 2y agoMy definition of minimalistic is a SSG where you use Github's WYSIWYG editor and push changes to trigger a pipeline that rebuilds the page and uploads it to a cloud service with S3 support.
- nine_k 2y agoInvolving GitHub and setting up its actions is only minimalist from a very particular point of view.
- INTPenis 2y agoWell, in real life this setup uses Gitlab but I referenced Github because I assumed they have better WYSIWYG options than Gitlab. And why that matters is because I can run the pipeline from my own laptop with gitlab-runner. But we all have our own view of minimalistic and mine is "the less code is running, the more minimalistic it is". To be abundantly clear, the less code is running that I have to operate or maintain. Obviously Github, S3 and a SSG generator is a lot of code.
- ElectricalUnion 2y agoIf you're really going for "minimalistic", why not ignore the whole build/SSG and just directly link to a markdown file inside a github repository?
- candleknight 2y ago> First of all, there are no otters here. I'm utterly sorry about that. incredibly important suggestion: replace "utterly" with "otterly"
- 1oooqooq 2y agodid you miss the part there are no otter?
- monacobolid 2y agoI see no backlinks, no "what links to here" section.