You can install and run Qgoda in a couple of ways.
Install Homebrew and tap the
gflohr-homebrew formula
repository before you install the formular qgoda:
$ 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 .
Node.js is an interpreter for JavaScript that runs outside of the browser. It is not a strict requirement for Qgoda but most Qgoda sites will make use of it.
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.
NPM is the Node Package Manager and is used to install packages and their dependencies for Node.js. Yarn is an alternative to NPM and does essentially the same.
The official Qgoda themes all use Yarn but you can easily change that. First, exchange yarn with 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 _qgoda.yaml.
As 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
the command $ 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 "docker"
if you get an error like "permission denied".
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 ~/.bash_profile, ~/.bashrc, ~/.alias, ~/.zshrc
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.