Skip to content

Latest commit

 

History

History
315 lines (209 loc) · 11.9 KB

install-uninstall.md

File metadata and controls

315 lines (209 loc) · 11.9 KB
title weight type
Install or Update
201
essay

{{< q-class "box warning" >}}

macOS Installation

Open your your Terminal {{< q-glossary "command-line shell" >}} (found in your Applications/Utilities folder) and follow the steps below. First to install support software for Quire, and then Quire itself. If you are new to the command line, read our tutorial on “Working in a Command-line Shell”.

  1. Install Apple’s Xcode by copying and pasting the following command and pressing enter. If Xcode is not already installed, an additional alert notification will pop up. Click “Install” and follow the prompts.

    xcode-select --install

  2. Visit the Node.js site, and download and install the current LTS (long-term support) version: https://nodejs.org.

  3. Visit the Pandoc repository on GitHub, and download the macOS .pkg file of the latest release: https://github.com/jgm/pandoc/releases/. Install by double clicking the icon and following the prompts.

  4. Visit the PrinceXML site, download the Mac OS version, and uncompress the folder: http://www.princexml.com/download/.

    Copy and paste the following two lines in your Terminal at once and press enter. Note that this assumes the file downloaded into your Downloads folder (the Mac default) and that the version you downloaded was 12.2, you can update the command if either of these is not the case.

    cd Downloads/prince-12.2-macosx
sudo ./install.sh

    The Terminal will ask for your computer password. After entering it another message will appear in the Terminal shell to confirm that PrinceXML should be installed in the /usr/local directory. Press enter.

    When complete, type cd into the Terminal to return to your home/user directory.

    cd

  5. Copy and paste the following line into your Terminal to download the Quire CLI ({{< q-glossary "command-line interface" >}}) to your computer from GitHub.

    git clone https://github.com/gettypubs/quire-cli.git

    You may asked to enter your GitHub username and password. When complete, install the CLI by copying and pasting the following commands into your Terminal and pressing enter. The first resets user permissions for your local directory, the second installs Quire.

    sudo chown -R $USER /usr/local

    cd quire-cli
npm install -g

When complete, type quire --version to confirm proper installation. It should return a version number, otherwise, if it says command not found, the Quire CLI has not been properly installed. Refer to the “Troubleshooting” section below.

Windows Installation

  1. Download Git for Windows by clicking on "Download" at https://gitforwindows.org/. An exe file will be downloaded, click on it and hit "run", you should see a setup wizard screen that will install Git for Windows. During the installation, use the default settings.

  2. Download and install Node.js and npm at https://nodejs.org/en/download/. Make sure you get the LTS version of Node.js, npm will be installed during the same process. The Windows installer will be downloaded, just open it and a setup wizard screen will guide you through the process.

  3. Download Prince for Windows. You would download either the 32-bit installer or the 64-bit installer depending on your operating system. To install Prince you can follow the instructions at their site: https://www.princexml.com/doc-install/#windows

  4. Download Pandoc for Windows. You would download either the 32-bit installer or the 64-bit installer depending on your operating system. To install Pandoc you can either download the .msi or download the .zip file and run the .exe file in the directory. Either way works and will install Pandoc on your system.

  5. Open PowerShell (that should be installed by default in your Windows computer) and run it as administrator. To do so, right click on the icon and select "run as administrator" from the context menu.

    Then once you get the administrator PowerShell window, type the following command:

    npm install --g --production windows-build-tools

    This command installs c++ 2015 build tools and python 2 required for node-gyp. The process will take some time and you'll see the prompt with your the name of your computer and your username once it's complete.

  6. Continue using PowerShell, but this time it's not required to run it as administrator (you can close the administrator window and open a new one) and type the following command to download Quire CLI to your computer from GitHub:

    git clone https://github.com/gettypubs/quire-cli

    A pop up window may emerge and ask you to type your GitHub username and password, then the download starts.

    Change directory to the quire-cli folder:

    cd quire-cli

    and type:

    git checkout pc-dev

    The following command will install dependencies:

    npm install -g

    Installing the dependencies takes some time and you'll notice multiple text strings being generated on the screen during the process. Wait until the prompt with your username shows up and then, to verify that quire-cli has been installed correctly, type:

    quire -V

    If version number is returned, means that the install is correct.

  7. Lastly, to navigate to your home directory and create a new project or publication type:

    cd ~

Linux Installation

  1. Open terminal

  2. Download and install Prince:

cd ~

Run these commands to download and install PrinceXML

wget https://www.princexml.com/download/prince_12-1_ubuntu18.04_amd64.deb

sudo gdebi prince_10r2-1_debian8.0_amd64.deb

If you chose a different distribution of Linux there are more instructions here -> https://www.princexml.com/doc-install/#linux

  1. Install node js and npm through nvm

Detailed information about this installation can be found in this link https://github.com/creationix/nvm#install-script

To install or update nvm, you can use the install script using cURL:

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

or Wget:

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

The script clones the nvm repository to ~/.nvm and adds the source line to your profile (~/.bash_profile, ~/.zshrc, ~/.profile, or ~/.bashrc).

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

Note: You can add --no-use to the end of the above script (...nvm.sh --no-use) to postpone using nvm until you manually use it.

You can customize the install source, directory, profile, and version using the NVM_SOURCE, NVM_DIR, PROFILE, and NODE_VERSION variables. Eg: curl ... | NVM_DIR="path/to/nvm". Ensure that the NVM_DIR does not contain a trailing slash.

NB. The installer can use git, curl, or wget to download nvm, whatever is available.

Note: On Linux, after running the install script, if you get nvm: command not found or see no feedback from your terminal after you type:

command -v nvm

simply close your current terminal, open a new terminal, and try verifying again.

If the above doesn't fix the problem, open your .bash_profile and add the following line of code:

source ~/.bashrc

For more information about this issue and possible workarounds, please refer here To verify that nvm has been installed, do:

command -v nvm

which should output 'nvm' if the installation was successful. Please note that which nvm will not work, since nvm is a sourced shell function, not an executable binary. To download, compile, and install the latest release of node, do this:

nvm install --lts

And then in any new shell just use the installed version:

nvm use --lts
  1. Install Pandoc for EPUB and MOBI output
cd ~

Visit https://github.com/jgm/pandoc/releases and download the latest .deb file

wget https://github.com/jgm/pandoc/releases/download/2.2.3.2/pandoc-2.2.3.2-1-amd64.deb

Install the .deb file

sudo dpkg -i pandoc-2.2.3.2-1-amd64.deb

This will install the pandoc and pandoc-citeproc executables and man pages.

Verify pandoc was installed

pandoc -v

If Pandoc version information is returned then Pandoc was successfully installed on your system.

  1. Install Quire-CLI
git clone https://github.com/gettypubs/quire-cli
cd quire-cli
git checkout pc-dev

Install Dependencies

npm install -g

Verify

quire -V

If version number is returned quire-cli was installed correctly, you can now leave the directory.

cd ~

Updating the Quire CLI

As we develop, you may also want/need to update your Quire CLI. The CLI is pegged to a particular version of the Quire Starter Theme (at least for now), so if you’re using an older CLI, any new projects you start will have the corresponding older version of the theme.

  1. In your User/Home directory where you initially installed Quire, look for the quire-cli folder and delete it.

  2. In your command line shell, enter the following three commands in order:

    git clone https://github.com/gettypubs/quire-cli.git

    cd quire-cli

    npm install -g

You now have the latest Quire CLI and any new projects you start will also have the newest theme. Your previously-started projects will keep their original version of theme unless you update the theme separately.

You may in some cases see errors or issues when running Quire commands with a newer version of the CLI, in older projects. These can be fixed manually, or, you can also re-install your original version of the CLI to run those older projects if necessary.

Updating the Theme

To update the version of a theme you have:

  1. In the themes directory of your project, delete the current theme directory. It’s quire-starter-theme by default.
  2. Copy in your new theme directory ensuring that it has the same name as the original.
  3. Open your command-line shell and navigate to the project directory using the cd (change directory) command. For example, if your project directory was called my-project and it was in your main user directory, you’d enter cd my-project.
  4. Still in the command-line shell, type quire install and press enter to install the theme dependencies for your project. (This is done automatically when running quire new, but needs to be done manually when adding a new or replacement theme.)

{{< q-class "box warning" >}}

  • Be sure to save any customizations you’ve made inside your theme. (Typically style changes to the variables.scss file.) You’ll have to copy these over into the new theme manually once it is installed. {{< /q-class >}}

Installing a New Theme

TK

Uninstalling Quire

To uninstall Quire:

  1. From a new window in your command-line shell (you should be in your home/user directory where you initially installed Quire) type the following two commands:

    cd quire-cli

    npm uninstall -g

  2. In the folder/finder view, go to your user/home directory where you initially installed Quire, look for the quire-cli folder and delete it.

Troubleshooting

TK