62 lines
3.6 KiB
Markdown
62 lines
3.6 KiB
Markdown
# 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: “File \`latex-logo.png' not found: using draft setting.”](#error-file-latex-logopng-not-found-using-draft-setting)
|
|
- [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: “File `latex-logo.png' not found: using draft setting.”
|
|
|
|
This is a common error when including any images or other media. Remember to specify the path to the image relative to your root document (i. e., your `main.tex`).
|
|
|
|
## 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)
|
|
|
|
|