I have a bookstack instance self-hosted and I quick like the program and workflow. I like having ‘books’ of information to separate/organize my information. It feels very much like folder heirarchy to me, and while that has its issues, I prefer it. Being able to add tags to pages helps alleviate some of those issues and helps with a broad search for an idea when I don’t know where it is stored down the line. Here is a quick view of my bookstack. It’s nothing fancy, but a visual to see what I’m talking about.
It’s great software. But I am very fond of software designed to be readable in 100 years. Meaning that the file does not require the program to be read. Text files (.txt, .rtf, .odt) are formats that are designed to be read in the future without MS Word, or Notepad; .doc, .docx, etc without microsoft might not be readable in 100 years without having MS software. That is why I like taking notes with markdown and why I like software like QownNotes, obsidian, and logsec which produce files that are readable without the program. So if they crash and burn, I don’t lose my data. With Bookstack, I cannot view that data without bookstack. And if I wanted to move my documents to a different software, I cannot export everything. I can export page-by-page but that’s only reasonble on a small scale. So, while I like the program, I would like to move to another program for my wiki/personal knowledge base.
For those wondering why I am worried about this: I’ve run into many walls with software problems in my life:
- software I use being abandoned
- new terms of service I don not agree with blocking me from using the program I like
- price hikes for software I use that are not worth it but I’m vendor locked and so I have to either pay or go the tedious route of moving my data slowly over because there is no export possibilities. 4)I am using a new device and I can’t access or view my data because the software doesn’t work on the device, hasn’t been ported over, or isn’t usable on the novel form factor of the device.
My worries with bookstack flow from there. It may be a good program, but what if my needs change, can I move my data easily?
In my search, Tiddlywiki was a standout in this view because it is a quine. It contains all its code to run/display itself (it’s a quine). So in 100 years, you should be able to open a tiddlywiki and it will contain be able to be read. However, I am having a hard time adapting to tiddlywiki’s way of doing things. Far less user friendly than Bookstack in ease of use. Thus I am writing this post to see if anyone else has ideas. Is there a way to make tiddlywiki look/work more like Bookstack in the book→pages (or folder→files) workflow? Or do you know of another piece of software for a knowledge base that meets the ideas above?
Obsidian. It can backup to GitHub or anywhere really. All the files are markdown and easily readable on their own. They don’t need to be opened with obsidian.
Obsidian is great. I use my iCloud storage to store the vault and access it from any of my Apple devices. There’s also some really neat plugins.
DokuWiki. Everything is a text file that can just be copied to a web server. It doesn’t even require a database. And since all the wiki pages are plaintext markdown files, they can still be easily accessed and read even when the server is down.
I started out in Ikiwiki and migrated to DokuWiki. Growing pains aside, it was good but only because I had a decent bit of software running the server for me.
I would definitely prefer something that didn’t need a server though
OP mentioned TiddlyWiki, which I think is a good option if you’re wanting to keep everything together and in a pretty longlasting format, plus there’s a small but creative community that’s made all kinds of interesting plugins for it.
However, if you’re looking for something very small and similarly flexible, there’s also Feather Wiki. Outside of these two, another person already mentioned it but there’s Zim, which may feel a little more comfortable to use as it’s separate desktop software from your browser.
I’ve not made anything with Feather Wiki, but I’ve dabbled with TiddlyWiki and Zim and liked both for different reasons. TW for possibility of sharing/publishing in a nice looking format, and Zim for linking together different offline notes and files (it can also export to bare html which you may then make look nicer with some CSS).
Lastly there’s also Zettlr that I’ve only just started playing around with. I think it may work a little better than Zim in terms of handling offline note sorting and linking files, but I’m not sure yet.
when I was starting Tiddlywiki I think I was bouncing between which one to try, Dokuwiki or Tiddlywiki. I decided on TW since it didn’t need a server to run. Considering how it was a race between those two, this suggestion hits the nail on the head. Like the other commenter, I would prefer something that doesn’t require a server, but since it just uses text files, even if I don’t have access to the server I can view the text file and edit them on the go as long as i have them sync to the device when it is active. Since my sever is LAN only, I just need to learn how to setup a vpn connection to my server when I’m away from the office and this program would be even more convenient. Maybe I should get on that sooner. Always something to learn and do! Now what to prioritize first~
They’re in wiki markup by default. Markdown is a separate plugin IIRC.
One giant text file and grep.
I’m impressed by this suggestion. It accomplishes most of what I asked and is elegant in its simplicity. It also shifted my perspective to look at the very basic needs and consider what I need on top of that. Which was actually very helpful for me. I will not be going this route, but your suggestion is greatly appreciated.
This is essentially what org-mode files are, plain text files with a bit of markup so they can be organised or rendered to other formats.
Not sure if it’s exactly what you’re after or not but I use Logseq for knowledge management. It’s mostly just markdown files under the hood so use your own preferred way to host/sync them.
Logseq is my preferred personal knowledge “second brain” tool, but Obsidian might be better in this use-case, as it follows a folder approach.
Both use markdown files under the hood, and op can use something like syncthing or freefilesync to backup the markdown files to other places.
I’ve been using Zim as a local desktop wiki for generic document organization. Mostly to keep track of roleplaying campaigns I run, but it’s good for all sorts of things. It stores its data as plain Markdown text files and each page can have a subfolder containing images “attached” to the page. There are several plugins to extend its functionality.
It’s not fancy, but it gets the job done that I want it to do. And if every copy of the program evaporated tomorrow the pages would be simple to make use of with other software, it’s all just Markdown.
I set up a wiki.js docker container for myself, mainly for keeping track of video game achievement lists in things I’m playing, but I’m probably gonna plop all my docs into it at some stage. It does basically use folder hierarchy, and I have it set to backup to a self-hosted Gitea git repo every 24hrs as well, so I have somewhere to pull all the markdown docs (and their edit history) from if needed, too.
wiki.js looks really great. I have to put this on my list of things to try out. One worry I have is how lightweight it is on tiny computers. I use are older devices, like a raspberry pi 2, so I’m always wary if programs like this will be smooth. When I started organizing my notes, I tried Joplin because it seems so universally loved. It was a good program but it was nigh unusable on my raspberry pi 2. So that worry is always in the back of my head now when I’m looking for software longterm (and why I will never use an electron app again as it is not a framework that cares about older devices). Since this is on a server, maybe it will be lightweight on devices. I don’t know how much fancy web features it uses and I guess I’ll have to test it to see how it goes. thank you!
While Jellyfin does movies, music, and photos, it can also do books.
Despite its name, Bookstack isn’t an ebook organizer or ebook organizing server software, it’s more in line with a wiki or personal knowledge organizer software.
I inadvertently found myself coming across software you might sorta like @[email protected] in the form of Zettlr. It’s FOSS, uses Markdown formatting, and is able to export to a variety of different formats.
Downsides are that there’s currently no mobile app, nor plugin/extension support, so the base software is what you get. Nevertheless, it’s a very fully featured piece of software from what I can tell and has pretty good documentation to help learn your way around it. Bonus as well is that it’s cross-platform, so you can run it across different OSes on desktop.
Edit:
Also OP, if you’re really fond of TiddlyWiki but want more guidance on making it more structured, you might look through these notes. TiddlyWiki is really cool, however it certainly takes some getting used to with its style.Thank you for the suggestion. I’m taking notes on the suggestions everyone has put forward to try out in the future. But thanks to a comment by @[email protected], I realized I was thinking wrong in how I tried to use tiddlywiki. I was trying to get it to act like another program, which was more straightforward in workflow, but after sqaud’s suggestion, I considered starting from a text file of my data and thinking about what I’d need on top of that to work. I’ve got some ideas now and it makes Tiddlywiki look less intimidating and confusing than prior. It won’t make use of all the fancy features TW has, but it will work for me I think. And I can always go back and add fancy features later when I’m used to TW. Those notes you linked will definitely be useful so thank you.
Oof I gave up in this search. Closest thing I found was MkDocs and Docusaurus which are static site generators of markdown content. I wanted an editor too, but they don’t have one.
Regarding wiki.js, I liked it, but the way it manages folder hierarchies is messed up.
Well I hesitate to recommend it for use by others, but what I use is my home-grown zknotes. Markdown notes that you can link together, so any note can be a tag. There’s a query syntax that allows searching note titles or content or tags. Notes live in a sqlite database. You can upload binary files like movies or images. Currently working on synchronization between instances, that will enable a phone app that syncs with a home server. If you run a server with it you can make documents public as a blog.
Downsides: the interface is a bit kludgy, and probably won’t improve until I’m done with sync and the app. No cli interface for searching or export. No code highlighting yet. Not many users so the multi user capabilities are mostly untested.
I just took a look at the docs on zknotes, which show off how zknotes work. I really love the links at the bottom of each document! Do the links break if you change the title of the other note? I had that happen in QOwnNotes and it was a very annoying realization after I’d renamed a bunch of notes to standardize things.
The links are by numeric id, but displayed by title. You can’t change a note’s id, but you can change the title all you like.
Future versions will transition to uuids which are unique across multiple instances, so no ID collision if you create a note on your phone and also on your home server.
If you have some development experience and know markdown, vitepress is what we use at work for our KB.
That’s pretty cool. Thais for sharing. Does it handle search by chance? For the end user to find a kb document?
Yes, when it builds it indexes everything. I’m pretty happy with it. If you have any questions about it feel free to ask.
deleted by creator
Probably not exactly what you’re looking for, but for my personal use I just set up a repo in my git forge (gitea in my case) with a bunch of markdown files in various folders and a Hugo theme.
Every time I want to update a document I can click the link at the bottom of the “Wiki” page and edit it in Gitea’s WYSIWYG editor. Similar process if I want to make a new document. When I save the changes I have a CI job (native to Gitea/Github) that uses Hugo to build the markdown docs into a full website and sync it to a folder on one of my servers where it’s picked up by a web server.
Sounds complicated when I type it all out, but the only thing that I can reasonably expect to be a deal breaker is the Hugo software, of which there are archived versions, and even if there wasn’t Hugo’s input is just markdown, so I can repurpose however I see fit.
You could probably do something similar with other SSG’s or even use Github’s pages feature, though that does add a failure point if/when they decide to sunset or monetize the feature.
DokuWiki is fantastic!
Bookstack has a pretty robust API for things like adding/exporting content even if the UI doesn’t always have a way to do things.
Might be worth looking at this ready-made script and see if it serves your purpose (at the very least just to make your shift from BS a bit easier): https://gist.github.com/ssddanbrown/45acb913a7b873240b2d89781e74a7a4
I wound up with gollum. Git based with a wiki format. Works well enough for my limited use.
