# You're here, at the VHS wiki Get involved - [Edit this wiki](/wiki/vhswiki/editing) ## Things to do on the site: - make the file structure match the new organizational structure. - e.g. currently there are a bunch of documents in `/wiki/tools/laser_cutter/`, those should be moved to `/wiki/groups/lasercutter/`, links adjusted, and a redirect set up. - a million other examples of this - get rid of the compendium of champions, it's not valid anymore - clean up links - figure out what if anything should replace that (i.e. something that explains committees?) - delete stuff - there is lots of stuff that can be deleted. - style the form on [contact-us](/contact-us) page. # Tech details about this website This website is an instance of dokuwiki. We're using the Mikio theme, unmodified, with a custom ["subtheme"](/lib/tpl/mikio/themes/vhsresponsive/style.css) (just a css file) that defines a few extra styles to tighten up things on mobile. ### Outstanding PRs/issues related to the mikio theme: - show the toolbar when user is not admin or manager or page creator - [PR](https://github.com/nomadjimbob/mikio/pull/121) / [issue](https://github.com/nomadjimbob/mikio/issues/120) - MERGED - add ability to customize title format - [PR](https://github.com/nomadjimbob/mikio/pull/119) / [issue](https://github.com/nomadjimbob/mikio/issues/118) - MERGED - Accessibility scanners point out a missing alt attribute on logo image - [PR](https://github.com/nomadjimbob/mikio/pull/122) - MERGED ## Plugins we're using, and why: - [Advanced DokuWiki](https://www.dokuwiki.org/plugin:advanced) - Installed to allow editing config files not otherwise available in the UI - may not be needed. - [Bureaucracy Plugin](https://www.dokuwiki.org/plugin:bureaucracy) - enables the [contact form](/contact-us). - [Commonmark Plugin](https://www.dokuwiki.org/plugin:commonmark) - put `` at the top of a page to enable [markdown syntax](https://commonmark.org/help/) - [indexmenu plugin](https://www.dokuwiki.org/plugin:indexmenu) - list the contents of a wiki namespace. see [this page](/wiki/groups/) for an example. - [Meta plugin](https://www.dokuwiki.org/plugin:meta) - used to set the page title, when we want it to be something other than the first heading on the page. used on the [Home page](/start). - [Mikio plugin](https://github.com/nomadjimbob/mikioplugin) - complements our theme (mikio) by adding a bunch of bootstrap ui layout things. Used on the [membership page](/membership) to make the payment options section - [Redirect Manager](https://github.com/ssahara/dw-plugin-redirect2) plugin - used to redirect old pages to new pages, e.g. [tool](/tool) to [tools](/tools) - [Semantic Plugin](http://www.dokuwiki.org/plugin:semantic) - puts meta description and opengraph tags in the html header - We are currently running a modified version that makes the page image fall back to the wiki logo - hoping to get this change adopted upstream [PR](https://github.com/giterlizzi/dokuwiki-plugin-semantic/pull/26) - [smtp plugin](https://www.dokuwiki.org/plugin:smtp) - used by the [contact](/contact-us) page - [Video Sharing Site Plugin](https://www.dokuwiki.org/plugin:vshare) enables the youtube video on the home page. - [VHS Tags](https://github.com/vhs/dokuwiki-vhstags) - an in-house plugin to add some custom HTML here and there around the site. Used for google calendar embeds, google maps embeds, stripe and paypal buttons, etc. Currently deployed via git checkout - go to `/var/containers/website/var/storage/lib/plugins/vhstags/` and `git pull origin main` to update. Planning to deploy this via the dokuwiki plugin index when the rate of change slows down and I've had some time to generalize more of the code. ## Bugs: * ublock origins with `EasyList – Social Widgets` turned on, the youtube widget doesn't show up - but it DOES show up on the current site * put a search bar in the submenu (blue bar) - ideally it's a magnifying glass that when clicked reveals the search bar * merge VHS Stripe Buttons and VHS Tags plugins into one plugin, store it in GIT * Change the VHS plugin to be deployed via the dokuwiki plugin directory * broken embed on https://vanhack.ca/wiki/history for 360 tour * delete all the dead pages in `/wiki/area` that have been merged into the flat single page `/wiki/area` - warning: there are a couple pages in the /wiki/area/ directory that are un-merged, like the laser materials storage page. * images larger than 1MB are being rejected, probably a webserver setting, e.g. https://www.dokuwiki.org/faq:uploadsize * $75/month [stripe button](/membership) is broken * delete the `kb` directory, it's functionally empty and i've removed the main link to it. * sometimes a blank page is rendered. It can be fixed with `?purge=true` fixed * /tool page should redirect automatically to /tools, look into redirect plugins redirect plugin added * design should be a little more responsive. - It falls apart on mid-sized screens - on very small screens the hamburger menu appears, but mid-size screens it's messy - ESPECIALLY when logged in because of all the extra buttons - stuff is cropped a little on mobile * Stripe buttons are online, but haven't been confirmed to work! Switch my subscription over to stripe to make sure it's all good! * redirects to add to the web server for this: - `/wp/*` -> `/*` - `/doku.php?id=$1:$2` -> `/wiki/$1/$2` * over on the membership page, there is an un-formatted link in the first FAQ question dokuwiki doesn't allow links in headers. blanket rule.