# 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. - [proposal](wiki:vhswiki:deletion) for a deletion process - 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 - [OrphansWanted plugin](https://www.dokuwiki.org/plugin:orphanswanted) - Generates the [orphans](/wiki/vhswiki/orphans) page, which lists orphan pages and wanted pages - [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 Deleted, as the site hosting the 360 tour has shutdown. However an image from someone that was around back then would be a good replacement * 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.