You can install and run Qgoda in a couple of ways.
$ brew tap gflohr/homebrew $ brew install qgoda
You can update with:
$ brew update $ brew upgrade qgoda
$ brew uninstall qgoda $ brew untap gflohr/homebrew
Please check the section Pre-Requisites below for additional software necessary to run Qgoda on your system.
The Qgoda version on CPAN is currently outdated and should not be used!
If you are happy with version 0.9.8, then you can:
$ cpanm Qgoda
Clone the Qgoda git repository and follow the usual way of installing Perl modules:
$ git clone https://github.com/gflohr/qgoda.git $ cd qgoda $ cpanm .
The Node.js website usually offers a download link for the software but if you are using a package manager, you should rather install Node.js with that.
The official Qgoda themes all use Yarn but you can easily change that. First, exchange
npm in the section
scripts of the theme's
package.json and then do the same for the configuration variable
helpers in Qgoda's main configuration file
npm ships with Node.js you normally don't have to install it. If you have installed Node.js with your package manager, it is possible that you explicitely have to install
npm. An example for such a package manager is MacPorts.
See https://yarnpkg.com/en/docs/install for instructions.
An easy method of installing Qgoda is to use Docker:
Install Docker. On Linux/Unix systems, Docker will be available from your package manager. On Mac OS X you can install Docker with Mac Ports or Homebrew, or - like on Windows - get a pre-compiled binary from https://www.docker.com/products/docker-desktop/.
Start Docker. You may want to start the docker daemon automatically. Check your vendor's documentation for that!
In a shell, run
$ docker run --name qgoda -p 3000:3000 --rm -it -v $(pwd):/data gflohr/qgoda watch.
You may have to add the user that runs the command to the group
if you get an error like
You can create an alias, so that you do not have to type in
the Docker command-line options all the time. Depending on your operating system,
you have to open
or similar and add this line:
alias qgoda='docker run --name qgoda -p 3000:3000 --rm -it -v $(pwd):/data gflohr/qgoda'
With this alias, you can now run all qgoda commands like the native version described in this documentation.