Yak Shaving is described as “any seemingly pointless activity which is actually necessary to solve a problem which solves a problem which, several levels of recursion later, solves the real problem you’re working on” or something like that.

I’m not 100% sure this would be considered yak shaving, but I’m working on something that requires random pages to be served from DokuWiki, just like the built-in function that MediaWiki has. (I used to use MediaWiki, but switched to DokuWiki, and like it much better. We also use it for the Milwaukee Makerspace wiki.)

There is a random page plugin for DokuWiki, which did not work. So I took the existing code, poked at it a bit, mainly by comparing to other plugins that did work and making simple edits, and got it working. (YMMV obviously.)

Because I’m a believer in “doing the right thing” and helping other people in their quest to not reinvent the wheel and stay DRY, I figured there was more to do…

So I emailed the original author of the plugin. I’ve not gotten an email back yet. Also, he (or she) appears to be French, and I’m a stupid American who can’t read French. (I’m not even sure why I mentioned that part.)

Anyway, I was happy that I fixed something so I figured I’d toss it on the old GitHub in case someone else was looking for a random page plugin for DokuWiki that (seems to) work.

Oh, and not content to not mention something I did, I posted the link on Google+, which was picked up by Nils Hitze who mentioned it to Andreas Gohr, who happens to be the author of DokuWiki (who I follow anyway, because he’s a RepRapper too) and he suggested I adopt the (possibly orphaned) plugin.

tl;dr → I fixed the Random Page plugin for DokuWiki. You can grab it from GitHub.

Also, this is how the f’ing Internet works!

Comments are closed.

« | »

buy the button:

Buy The Button