# Frequently asked questions

- [Frequently asked questions](#frequently-asked-questions)
  - [Error: “File 'setup.tex' not found. \\input{setup.tex}”](#error-file-setuptex-not-found-inputsetuptex)
  - [Error: “Unable to find xyz.sty”](#error-unable-to-find-xyzsty)
  - [I accidentally dismissed the prompt asking me to install a missing package.](#i-accidentally-dismissed-the-prompt-asking-me-to-install-a-missing-package)
  - [I want to use my own tools.](#i-want-to-use-my-own-tools)
  - [I need more help.](#i-need-more-help)

## Error: “File 'setup.tex' not found. \input{setup.tex}”

**Windows-specific diagnosis**:
If this error shows up when you compile the script for the first time, you may have opened the $\LaTeX$ file without unzipping the project archive first. To resolve the error, go back to the folder where you store your downloads. Locate the project archive (something like `latex-project-….zip`). Do not double-click it. Instead, right-click and select “Unzip”, “Extract”, or similar. This will extract the ZIP archive to a new folder. Open this folder and proceed with opening the file you were looking for.

**Generic hints**:
The compiler complains that a file called `setup.tex` cannot be found in the same folder as the file you are compiling. Make sure the file exists and there are no typos in your file name.

## Error: “Unable to find xyz.sty”

**Windows-specific diagnosis**:
This error typically relates to packages missing from your $\LaTeX$ installation. On Windows, it can typically be solved like this:

1. Open the Mik$\TeX$ Console, a program that comes with your $\LaTeX$ installation.
2. In there, you will find the “Packages” tab. 
3. Click the button to search for package updates. This should resolve the error.

**Generic hints**:
The compiler complains that a package, particularly the corresponding .sty document, is missing. Typically, there is a `\usepackage{xyz}` command that loads the package xyz. Make sure there are no typos in the package name. If you do not use $\TeX$live-full (Linux), try to install the package via the Mik$\TeX$ Console (Windows) or your $\LaTeX$ distribution's helper tools.

## I accidentally dismissed the prompt asking me to install a missing package.

Try re-opening $\TeX$studio. If this does not help, there is still the option to manually install the required packages from the Mik$\TeX$ Console or similar distribution-specific management software.

## I want to use my own tools.

Sure, feel free. We provide instructions for [CoCalc](./cocalc-instructions.md) and [VS Code/Codium](./vs-code-instructions.md). Any other editor will do if you know your ways around the terminal. In essence, all we do here is this:

```bash
pdflatex main.tex
biber main
pdflatex main.tex
pdflatex main.tex
```

Just run `pdflatex main.tex` twice if you do not have any citations. Or have a look at XeTeX, LuaTeX, … ([numerous other tools available](https://www.tug.org/interest.html#free)).

## I need more help.

Please refer to our various resources:

- the workshop's [presentation](https://wiai.de/latex-weekend)
- the [Moodle course](https://wiai.de/latex)
- the Git project containing the [script](https://git.stuve-bamberg.de/latex/latex-skript)
- the WIAI Student Council's [website](https://www.uni-bamberg.de/wiai/fs)