Installation DAQ

Here we list issues and errors encountered while trying to install plugins for Fedwiki:

Github references can fail to install active plugins. It is easier and more robust to use npm should your custom package be available as an npm package.

After that try to load the server again. Another way to achieve the same is to edit the package.json directly and use the following:

then run npm install and load the server. The problem with the approach you tried is that if you use the plugins sources directly, some of the files needed by the wiki client and server are not yet generated, you would need to cd to the plugins folders and run something like grunt build to generate them. This is not needed if you use the published npm packages because those files are already generated and included the in the npm packages.

A good quick hack for when things go wrong is to remove the offending package with npm uninstall -g <packageName> and start again. For instance with my customised version of wiki I get good results when I mess up with:

You can run into permission errors:

In which case - you need to check the ssh keys on your server: see help.github.com

https://help.github.com/articles/error-permission-denied-publickey/

The node package manager (npm) has commands that will install plugins and update the package.json at the same time. You can add plugins and decide later if you want to keep them through other updates.

You can also run into errors with missing dependencies. I'm not sure (yet) how to fix these - but it would appear that a simple npm install -g <packageName> for the missign deps would fix things?