Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a5e40be5da | ||
|
|
a4ad98c7c0 | ||
| f99adf1020 |
1
Makefile
1
Makefile
@ -12,6 +12,7 @@ clean:
|
|||||||
@rm -rf temp/*
|
@rm -rf temp/*
|
||||||
@rm -f main-{script,exercises,solutions}.{aux,loc,log,out,pdf,soc,toc,synctex.gz}
|
@rm -f main-{script,exercises,solutions}.{aux,loc,log,out,pdf,soc,toc,synctex.gz}
|
||||||
@rm -f exercises/*/*.{aux,loc,log,out,pdf,soc,toc,synctex.gz}
|
@rm -f exercises/*/*.{aux,loc,log,out,pdf,soc,toc,synctex.gz}
|
||||||
|
@rm -f install-verification/*.{aux,loc,log,out,pdf,soc,toc,synctex.gz}
|
||||||
|
|
||||||
# Compile listings (only needed when listings have changed)
|
# Compile listings (only needed when listings have changed)
|
||||||
listings: listings/**/*
|
listings: listings/**/*
|
||||||
|
|||||||
13
docs/faq.md
13
docs/faq.md
@ -5,6 +5,7 @@
|
|||||||
- [Error: “File \`latex-logo.png' not found: using draft setting.”](#error-file-latex-logopng-not-found-using-draft-setting)
|
- [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)
|
- [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 accidentally dismissed the prompt asking me to install a missing package.](#i-accidentally-dismissed-the-prompt-asking-me-to-install-a-missing-package)
|
||||||
|
- [MikTeX Console is already running](#miktex-console-is-already-running)
|
||||||
- [I want to use my own tools.](#i-want-to-use-my-own-tools)
|
- [I want to use my own tools.](#i-want-to-use-my-own-tools)
|
||||||
- [I need more help.](#i-need-more-help)
|
- [I need more help.](#i-need-more-help)
|
||||||
|
|
||||||
@ -36,18 +37,22 @@ The compiler complains that a package, particularly the corresponding .sty docum
|
|||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
## MikTeX Console is already running
|
||||||
|
|
||||||
|
If this error occurs while opening the MikTeX Console, open the Task Manager, search for “MikTeX Console”, select the entry in the table, and terminate the task by a click on the respective button. Then, open MikTeX Console again.
|
||||||
|
|
||||||
## I want to use my own tools.
|
## 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:
|
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
|
```bash
|
||||||
pdflatex main.tex
|
lualatex main.tex
|
||||||
biber main
|
biber main
|
||||||
pdflatex main.tex
|
lualatex main.tex
|
||||||
pdflatex main.tex
|
lualatex 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)).
|
Just run `pdflatex main.tex` twice if you do not have any citations. Or have a look at XeTeX, … ([numerous other tools available](https://www.tug.org/interest.html#free)).
|
||||||
|
|
||||||
## I need more help.
|
## I need more help.
|
||||||
|
|
||||||
|
|||||||
@ -13,7 +13,7 @@ LaTeX Workshop uses so-called recipes to compile documents. A recipe refers to a
|
|||||||
|
|
||||||
1. Launch the VS Code settings and search for “recipes.”
|
1. Launch the VS Code settings and search for “recipes.”
|
||||||
2. In the “Latex-workshop > LaTeX: Recipes” section, click on “Edit in settings.json.”
|
2. In the “Latex-workshop > LaTeX: Recipes” section, click on “Edit in settings.json.”
|
||||||
3. Go ahead and add the following two entries to the list. The first one just uses the `pdflatex` compiler twice to build our document, whereas the second one adds an intermediate round of `biber` compilation.
|
3. Go ahead and add the following two entries to the list. The first one just uses the `pdflatex` compiler twice to build our document, whereas the second one adds an intermediate round of `biber` compilation and changes the LaTeX compiler to `lualatex`.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"latex-workshop.latex.recipes": [
|
"latex-workshop.latex.recipes": [
|
||||||
@ -25,12 +25,12 @@ LaTeX Workshop uses so-called recipes to compile documents. A recipe refers to a
|
|||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "pdflatex -> biber -> pdflatex × 2",
|
"name": "lualatex -> biber -> lualatex × 2",
|
||||||
"tools": [
|
"tools": [
|
||||||
"pdflatex",
|
"lualatex",
|
||||||
"biber",
|
"biber",
|
||||||
"pdflatex",
|
"lualatex",
|
||||||
"pdflatex"
|
"lualatex"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
// EXISTING ENTRIES GO HERE
|
// EXISTING ENTRIES GO HERE
|
||||||
@ -51,6 +51,17 @@ LaTeX Workshop uses so-called recipes to compile documents. A recipe refers to a
|
|||||||
],
|
],
|
||||||
"env": {}
|
"env": {}
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"name": "lualatex",
|
||||||
|
"command": "lualatex",
|
||||||
|
"args": [
|
||||||
|
"-synctex=1",
|
||||||
|
"-interaction=nonstopmode",
|
||||||
|
"-file-line-error",
|
||||||
|
"%DOC%"
|
||||||
|
],
|
||||||
|
"env": {}
|
||||||
|
},
|
||||||
// EXISTING ENTRIES GO HERE
|
// EXISTING ENTRIES GO HERE
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
@ -67,13 +78,15 @@ LaTeX Workshop uses so-called recipes to compile documents. A recipe refers to a
|
|||||||
|
|
||||||
## Some useful notes
|
## Some useful notes
|
||||||
|
|
||||||
+ LaTeX Workshop will always try to compile the file your cursor is currently in. If you are working in sub-files, then this will result in errors. You can **specify the document root** by adding a magic TeX root comment. Press `Ctrl + Shift + P` and select “Insert !TeX magic root command.” Then simply select your root document and compile again. We provided these comments for you in all exercise files:
|
+ LaTeX Workshop has a [process of deciding which file to compile](https://github.com/James-Yu/LaTeX-Workshop/wiki/Compile#latex-workshoplatexbuildforceRecipeUsage). Unfortunately, our project archive tends to confuse the plugin, resulting in compiler errors. You can **specify the document root** by adding a magic TeX root comment. We provided these comments for you in all exercise files:
|
||||||
|
|
||||||
```tex
|
```
|
||||||
% !TeX root = ../../main-exercises.tex
|
% !TeX root = ../../main-exercises.tex
|
||||||
```
|
```
|
||||||
|
|
||||||
This plugin offers a couple of other handy features:
|
+ However, by default, **LaTeX Workshop ignores them** because they may pose a security threat if you cannot trust the project you are compiling. See [this issue](https://github.com/James-Yu/LaTeX-Workshop/issues/3027) for more details. To enable them anyway, go to your settings and deactivate the “Force Recipe Usage” checkbox.
|
||||||
|
|
||||||
|
The **LaTeX Workshop** plugin offers a couple of other handy features:
|
||||||
|
|
||||||
+ Sometimes, it is helpful to kill all compiler processes and **clean up the auxiliary files** afterwards.
|
+ Sometimes, it is helpful to kill all compiler processes and **clean up the auxiliary files** afterwards.
|
||||||
+ If you need to **find a certain section** in the PDF or in the source document, you can use the “Navigate, select and edit” menu.
|
+ If you need to **find a certain section** in the PDF or in the source document, you can use the “Navigate, select and edit” menu.
|
||||||
|
|||||||
@ -1,3 +1,4 @@
|
|||||||
|
% !TeX root = ./main-exercises.tex
|
||||||
\documentclass[a4paper,english]{report}
|
\documentclass[a4paper,english]{report}
|
||||||
|
|
||||||
% Language and font encoding
|
% Language and font encoding
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user