Installing Sysquake for LaTeX consists in three steps:
LaTeX must also be able to execute external programs with \write18. Depending on the platform, this may require to add an option argument to pdflatex, such as -shell-escape or --enable-write18.
Caution: enabling external programs can be dangerous if you typeset tex files from dubious origin. Depending on your needs, you may prefer a separate configuration to typeset tex files which use Sysquake for LaTeX, keeping the standard, more secure configuration for other files. Sysquake for LaTeX should be used only with tex files you trust.
Install the latest release of MiKTeX (e.g. MiKTeX 2.9.6161). Then run the installer of Sysquake for LaTeX and follow the instructions.
The last steps, as explained in the installer, are manual:
In the Start menu, submenu MiKTeX 2.9 (or equivalent), MiKTeX Settings (or MiKTeX Settings (Admin)) and select the Roots tab. Click the Add button, select directory TexFiles of Sysquake for LaTeX, and confirm, clicking the main OK button of the MiKTeX Options window.
Install the latest release of TeX Live (e.g. TeX Live 2016), then run Sysquake for LaTeX installer and follow the instructions.
The last steps are manual:
C:\Program Files\SysquakeForLaTeX\bin\Win32;...
TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local,C:\Program Files\SysquakeForLaTeX\TexFiles
For other TeX distributions, please read their documentation. Sysquake for LaTeX installer is totally independent from any other software; you should just configure TeX so that it finds the file sysquake.sty and can run sysquakelatextool.exe.
On macOS, Sysquake for LaTeX is distributed as a package. To install it, just double-click its icon and accept everything. You will need an administrator password. An alias of the documentation entry file is put on the Desktop.
The macOS package stores the distribution in /opt/SysquakeLx and creates the following symbolic links, also creating directories if they do not already exist:
ln -s /opt/SysquakeLx/bin/i386-darwin/sysquakelatextool \ /usr/bin ln -s /opt/SysquakeLx/TexFiles/tex/latex/sysquake.sty \ ~/Library/texmf/tex/latex ln -s /opt/SysquakeLx/TexFiles/tex/latex/sq-example.tex \ ~/Library/texmf/tex/latex ln -s /opt/SysquakeLx/TexFiles/doc/latex/sysquake/index.html \ ~/Desktop/SQ-LaTeX.html
You should make sure to enable the execution of external programs with \write18. In TeXShop, for instance, open TeXShop preferences (menu TeXShop>Preferences), display the Engine tab, then in pdfTeX/Latex field, replace pdflatex --file-line-error --synctex=1 with pdflatex --file-line-error --synctex=1 -shell-escape.
Sysquake for LaTeX is available as a deb package, with a dependency on the texlive package which will also be installed if it isn't already done. Double-clicking its icon should open the default package management utility for your system. You can then read its description and install it.
Alternatively, in a terminal window, you can type the following command (replace the star and specify the exact filename if you have several versions):
sudo dpkg -i sysquakelx-*.deb
Should you want to remove Sysquake for LaTeX, you can type the following command:
sudo dpkg -r sysquakelx
Sysquake for LaTeX is also available as a tgz archive, which can run on other Linux distributions and gives you total flexibility for file location. The steps below give you general directions.
sudo yum install texlive tex-live-latex
On a Linux distribution using deb packages like Debian, Ubuntu or Linux Mint, you can install TeX Live with the package manager:
sudo apt-get install -y texlive-latex-base
tar xfz sysquakelx-*.tgz sudo mkdir -p /opt sudo cp -R SysquakeLx /opt
sudo mkdir -p /usr/local/bin sudo ln -s /opt/SysquakeLx/bin/i386-linux/sysquakelatextool /usr/local/bin
or add /opt/SysquakeLx/SysquakeLx/bin/i386-linux to your environment variable PATH.
kpsewhich -var-value=TEXMFLOCAL
ln -s /opt/SysquakeLx/TexFiles /usr/local/share/texmf/SysquakeLx
texhash