Add FAQ

docs/faq.md

@@ -0,0 +1,56 @@
+# 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)
+
+