Hints for Installing and Running LaTeX

This page collects useful hints for installing and running LaTeX on your laptop or PC. It is intended to supplement your system's documentation and to address frequently encountered issues, but is not meant to be a comprehensive guide for installing and running LaTeX.

Recommended LaTeX tools and configuration for different platforms


We recommend either MiKTeX (https://miktex.org) or Texlive (https://tug.org/texlive/) with MacOS.

There are several guis available. On MacOS we recommend TeXShop. In TeXShop you should use the typesetting command 'pdflatexmk'

You may use TeXWorks instead if you prefer. TeXWorks is included in MikTeX. For instructions on configuring TeXWorks for the PDG LaTeX environment, see the notes below in the Windows section. They also apply on MacOS.


Use MiKTeX (https://miktex.org) to process LaTeX on Windows.

IMPORTANT: Before processing LaTeX reviews with MiKTeX, add directory containing 'pdg.cls' as new 'root' directory in MiKTeX settings (figure 1) and refresh program's database of files (figure 2) or restart MiKTeX.

figure 1:


figure 2:


MikTeX comes with a GUI editing/processing programs called TeXWorks.

To use TeXWorks with the PDG LaTeX environment you will need to make one small configuration change.

1) Start TeXWorks and choose "Edit"->"Preferences"


2) Click on the "Typesetting" tab.


3) To the right of the box that says "Processing Tools", push the "+" button.


4) Name the new tool "PDG-BibTeX" and specify the program "miktex-bibtex.exe"


5) Next to the box that says "Arguments", push the "+" button. Type "$basename.1" on the line that appears.


6) Click OK

To compile a PDG review, open the tex file in texworks, then execute these commands





This should properly compile the review, with all references and labels.


The standard LaTeX distribution on Linux is TeXLive. How you obtain it depends on what distribution of Linux you use.

On Fedora Linux the TeXLive distribution is broken up into many packages. You will find that "dnf install texlive" will only install the basic packages, and you will not have everything you need. It will probably be easiest to use "dnf install texlive*" if you have plenty of disk space. This will install all available texlive packages.

On Ubuntu, go to the software center and search for texlive.

On OpenSuSE use YaST to install texlive and any additional required packages.


If you have a Docker installation, rather than installing LaTeX directly on your system, you can use image juergberinger/pdglatex . This docker image has a TeXLive 2018 installation with all the packages needed for PDG reviews.

See this github page for instructions.

Required LaTeX packages

The following LaTeX packages may need to be installed if they're not already included in your installation. Please refer to the documentation for your LateX installation on how to install additional packages.

  • ifthen
  • color
  • float
  • amsmath
  • amssymb
  • graphicx
  • xspace
  • titling
  • fancyhdr
  • titlesec
  • geometry
  • import
  • lineno
  • showlabels
  • bibunit (TBC)
  • cite
  • mciteplus
  • morefloats
  • fontenc
  • lmodern
  • utf8
  • xcite
  • hyperref
  • multirow
  • isomath

-- No permission to view TWiki.UserReports

Topic attachments
ISorted descending Attachment History Action Size Date Who Comment
PNGpng Screenshot_from_2018-11-07_16-25-49.png r1 manage 34.2 K 2018-11-08 - 00:27 Kirill  
PNGpng Screenshot_from_2018-11-07_16-26-00.png r1 manage 46.6 K 2018-11-08 - 00:28 Kirill  
JPEGjpg TexWorks-1.jpg r1 manage 29.0 K 2019-05-02 - 20:34 Jdanderson  
JPEGjpg TexWorks-2.jpg r1 manage 37.4 K 2019-05-02 - 20:34 Jdanderson  
JPEGjpg TexWorks-3.jpg r1 manage 65.0 K 2019-05-02 - 20:35 Jdanderson  
JPEGjpg TexWorks-4.jpg r1 manage 71.0 K 2019-05-02 - 20:35 Jdanderson  
JPEGjpg TexWorks-5.jpg r1 manage 71.0 K 2019-05-02 - 20:35 Jdanderson  
JPEGjpg TexWorks-6.jpg r1 manage 71.4 K 2019-05-02 - 20:35 Jdanderson  
Edit | Attach | Watch | Print version | History: r11 < r10 < r9 < r8 < r7 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r11 - 2019-05-28 - Beringer
This site is powered by the TWiki collaboration platform Powered by PerlCopyright Information: This page and all following are copyrighted by the Regents of the University of California