5. [DEPRECATED] UI dependencies and requirements for Genomaps & KnetMaps

DEPRECATED: this page needs some revision:

• For a few of the mentioned tools, we have upgraded the version we use
• The text describes the building of libraries like knetmaps.js and genomaps.js, which have local copies in the Knetminer codebase. This is poor code organisation and we're moving towards having those libraries managed and built in their respective repositories, with Knteminer linking them as dependencies and pulling their distribution files.

To build/test locally:

• Install Node.js (https://nodejs.org/en/download/) & NPM
• Install Git (https://git-scm.com/)
• Install bower: npm install -g bower@1.8.8 (optional)
• Install gulp: npm install -g gulp@3.9.1
• To build: gulp optimise
• Also, downgrade npm (if errors arise): npm install -g npm@6.1.0
• Note: Make sure you use Node v10.21.0 as new versions fail with gulp 3 (need gulp 4 which KnetMaps does not support)
• Note: Our test environment uses node 10.21.0, npm 6.1.0 , bower 1.8.8, gulp 3.9.1.

Note: As of last check, Node.js 10.7.0 can be downloaded with npm 6.1.0 , which works well with KnetMaps/KnetMiner.

Install Node & npm from a previous release i.e. Node.js 10.7.0

Linux & MacOS

To install node & npm from the tarball in Linux distros, perform the following:

tar -xf node-v10.7.0-linux-x64.tar.gz --directory /usr/local --strip-components 1

This will put the ./bin directory in /usr/local/bin, which can be verified by executing the following:

node --version

npm --version

The same can be performed for Mac OS using the Darwin tarball.

Windows

On Windows, simply unzip the zipped file and add node.exe to your system path. This can be done by opening Run with Win + R, and then entering:

rundll32 sysdm.cpl,EditEnvironmentVariables

Where, under User variables for $USER, you can add the path to your unzipped node download and then verify that they've correctly been added to your system path on the command line (Win + X) by typing:

node -v

npm -v