Perhaps so but it seems like it’d be hard… wiki.js is a little finnicky (it needs postgresql, and the files are only a “sync” method which means that wiki.js has some internal store and the files are used to update it/be updated by it. I wouldn’t count on it
it needs postgresql, and the files are only a “sync” method which means that wiki.js has some internal store and the files are used to update it/be updated by it
Oh that’s a bummer. I was hoping it could be managed entirely off of a Git repo, like Netlify CMS
Just a side question, but why is it hosted on a .org domain whereas this forum is on the . computer domain ?
We recently renamed from just Aux to Auxolotl so as to not reintroduce difficulty in finding resources like nix has, auxolotl.org will be the new domain for things going forward.
where was this rename decided?
A domain hack would even be possible since there is a .TL TLD.
I just finished creating the Wiki Quickstart | Auxolotl Wiki page, which I think is a good start. Please help improving it or correcting any mistake.
I’ve also enjoyed working with the wiki, which was fairly easy to use and learn. The only thing I missed was vim keybindings , but I guess I can always work with the repo locally if I want.
I also found a project wikijs-customization, which does CSS/JS injection to accomplish this, among other things.
I love your page so much! This is a fantastic idea and you’ve executed on it well
I’ve added it to the sidebar so hopefully it’s easier for people who want to contribute to find
Thanks for letting me know! I’ve looked at, installed and configured it
Anyone know if it is possible to display more detailed diffs as an embed within the wiki? A bit more like difftastic / --word-diff
wiki.js had a plugin system last I worked with it. For example we used it to generate node & flow graphs via in-markdown text syntax. I would imagine something for diffs would be available in a similar flow?
Fully agree!
Luckily a PR adding a wiki link was merged ~6h ago ,
although I’m not sure how/when the website updates with the git repo.
I believe it’s fully manual at the moment - @jakehamilton I figure you’ve got the hosting stuff, would it be possible to get some CD going on that repo?
Thank you for using a modern wiki! Things are so dynamic around here. It took nixos multiple years to make the nixos wiki official and y’all have an official one in under a week! Well done!
Infra repo is still in the works. I have it running the new auxolotl site, but there are still some quirks we need to take care of for hosting. Once that is done I will be pushing it up and adding a deploy key on GitHub so we can have it push updates via actions
Thanks for the work!
Small nitpick after browsing the wiki for a few minutes:
The sidebar disappears a few seconds after the last click, even if it’s under the mouse cursor.
It’s kinda annoying since I only got so much time looking at the nav menu…
Some settings for the plugin definitely need to be tweaked. I’m currently updating Project Standards to include commit message format but I’ll see if I can change that afterwards.
The plugin isn’t super configurable, so fixing the settings is likely editing their JavaScript to get it to work… however, I’m struggling to reproduce the issue, are you able to provide me with some debugging details (e.g. browser, etc.) and possibly a short screen recording showing me what you mean? Hopefully that would help me fix it…
In the meantime, you can workaround this by pinning the sidebar. Heading over to the top right corner of the navigation menu and clicking on the pin icon, which looks like this, should keep the sidebar on the screen at all times
Once you’ve pinned it, the icon will change to a crossed out pin icon and your sidebar will stay even if you mouse off it