Update instructies voor 23-24

docs/hogent-huisstijl.md

@@ -14,11 +14,27 @@ Daarnaast gebruiken de LaTeX-sjablonen ook nog:
 - Fira Code (monogespatieerd lettertype voor broncode, met ligaturen)
 - Fira Math
 
-Je kan de fonts downloaden vanuit de Github-repo voor een Beamer-presentatie: <https://github.com/HoGentTIN/latex-hogent-beamer/tree/main/fonts>.
+Je kan de fonts downloaden vanuit de Github-repo voor de bachelorproef: <https://github.com/HoGentTIN/latex-hogent-bachproef/tree/main/fonts>.
 
-### Installatie
+Na downloaden kan je de lettertypes als volgt installeren:
 
-N.B. Lettertypes installeren kan je op zowel Windows, macOS als Linux door te dubbelklikken op het .otf-bestand en op de knop "Installeren" te klikken in het preview-venster. Je kan de bestanden ook kopiëren naar de directory met lettertypes: `C:\Windows\Fonts` voor Windows, `/Library/Fonts` of `~/Library/Fonts` op macOS, `/usr/share/fonts` of `~/.local/share/fonts` op Linux.
+=== "Windows"
+
+    In bestandsbeheer Shift+rechtsklikken op het lettertypebestand (.otf) en kiezen voor "Installeer voor alle gebruikers"
+
+    Je kan de bestanden ook kopiëren naar `C:\Windows\Fonts`
+
+=== "macOS"
+
+    In Finder dubbelklikken op het lettertypebestand (.otf) en in het preview-venster op de knop "Installeren" klikken.
+
+    Je kan de bestanden ook kopiëren naar `/Library/Fonts` (systeembreed) of `~/Library/Fonts` (enkel voor huidige gebruiker).
+
+=== "Debian/Ubuntu"
+
+    In bestandsbeheer dubbelklikken op het lettertypebestand (.otf) en in het preview-venster op de knop "Installeren" klikken.
+
+    Je kan de bestanden ook kopiëren naar `/usr/share/fonts` (systeembreed) of `~/.local/share/fonts` (enkel voor huidige gebruiker).
 
 ## Sjablonen in de HOGENT huisstijl
 

docs/index.md

@@ -8,12 +8,13 @@ Vind je onduidelijkheden, fouten of heb je andere suggesties? Aarzel niet om dez
 
 Om LaTeX te kunnen gebruiken heb je het volgende nodig:
 
-- Een LaTeX-distributie met de nodige tools om te compileren:
+- Een LaTeX-distributie met de nodige tools om te compileren. Kies afhankelijk van je besturingssysteem een van deze drie mogelijkheden:
     - [MikTeX](installatie-miktex.md): Windows
     - [TeX live](installatie-texlive.md): Linux, Windows
     - [macTex](installatie-mactex.md): macOS
 - Een LaTeX IDE of teksteditor met LaTeX-ondersteuning, bv.:
-    - [TeXstudio](installatie-texstudio.md)
-    - [VS Code](installatie-vscode.md) met de LaTeX Workshop plugin
-    - [JabRef](installatie-jabref.md), een reference manager voor het bijhouden van bibliografische gegevens
+    - [TeXstudio](installatie-texstudio.md): IDE specifiek voor LaTeX
+    - [VS Code](installatie-vscode.md) met de LaTeX Workshop plugin: vraagt iets meer werk om goed te configureren
+- Een reference manager voor het bijhouden van bibliografische gegevens
+    - [JabRef](installatie-jabref.md)
 - De lettertypes en sjablonen conform de [HOGENT-huisstijl](hogent-huisstijl.md)

docs/installatie-jabref.md

@@ -1,15 +1,19 @@
 # JabRef
 
-JabRef is een gratis en open-source reference manager. Het is een Java applicatie die je kan gebruiken om je bibliografische gegevens te beheren.
+[JabRef](http://www.jabref.org/) is een gratis en open-source reference manager. Het is een Java applicatie die je kan gebruiken om de bibliografische gegevens van bronnen uit de wetenschappelijke of vakliteratuur te beheren.
+
+JabRef is specifiek ontworpen voor LaTeX en gebruikt dan ook het standaard bestandsformaat voor bibliografische gegevens, nl. BibTeX/BibLaTeX (bestandsextensie .bib).
+
+De interface en instellingen veranderen nogal eens tussen versies, dus het is mogelijk dat oudere screenshots niet meer overeen komen met de huidige versie en dat instructies niet meer exact werken.
 
 ## Installatie
 
-We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Chocolatey](https://chocolatey.org)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://www.jabref.org/#download>.
+We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://www.jabref.org/#download>.
 
 === "Windows"
 
     ```console
-    choco install jabref
+    winget install JabRef.JabRef
     ```
 
 === "macOS"
@@ -34,12 +38,16 @@ We raden aan om een package manager te gebruiken voor de installatie van softwar
 
 ## Configuratie
 
+Binnen de LaTeX-wereld is er een apart subsysteem voor het correct opmaken van een referentielijst of bibliografie. Het "oude" systeem heet BibTeX en is vaak de standaard in LaTeX-editors. Het sjabloon voor de paper en ook dat voor de bachelorproef zijn echter gebaseerd op een modernere vervanger, BibLaTeX/biber. Pas Jabref aan om standaard het laatste te gebruiken.
+
 Open in het menu Options > Preferences en stel volgende instellingen in:
 
 - General:
-    - Default library mode: biblatex
+    - Default library mode: **biblatex**
 - Entry Preview
     - Zorg er voor dat rechts onder "Selected" ook "American Psychological Association 7th edition" staat.
     - Andere geselecteerde stijlen kan je verwijderen (die hebben wij toch niet nodig), op "Custiomized preview Style" na.
 - Linked Files
-    - File directory, Main file directory: hier kan je het pad naar de directory opgeven waar je alle PDF-versies van de artikels en andere bronnen bewaart. Dit hoort trouwens niet in je Github-repository thuis! Als je zorgt dat alle bestanden in deze directory dezelfde naam hebben als de Bibtex-key van de bron in je bibliografische databank, dan kan JabRef dit terugvinden en kan je het openen vanuit JabRef zelf.
+    - **File directory**, Main file directory: hier kan je het pad naar de *Main file directory* opgeven waar je alle PDF-versies van de artikels en andere bronnen bewaart.
+        - Als je zorgt dat alle bestanden in deze directory dezelfde naam hebben als de Bibtex-key van de bron in je bibliografische databank (typisch naam van de eerste auteur + jaartal, bv. Knuth1998.pdf), dan kan JabRef dit automatisch terugvinden en kan je het openen vanuit JabRef zelf.
+        - Tip: deze directory hoort in principe niet thuis in je Github-repository! 

docs/installatie-miktex.md

@@ -4,10 +4,10 @@
 
 ## Installatie
 
-We raden aan om een package manager te gebruiken om software te installeren op Windows ([Chocolatey](https://chocolatey.org/)). Indien je dit toch niet wenst te doen, dan kan je het downloaden via de website: <https://miktex.org/download>.
+We raden aan om een package manager te gebruiken om software te installeren op Windows ([Winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)). Indien je dit toch niet wenst te doen, dan kan je het downloaden via de website: <https://miktex.org/download>.
 
 ```console
-choco install miktex
+winget install  MiKTeX.MiKTeX
 ```
 
 ## Configuratie

docs/installatie-texlive.md

@@ -8,9 +8,11 @@ Op Linux zijn de te installeren packages in principe beschikbaar via de reposito
 
 === "Windows"
 
-    ```console
-    choco install texlive --params="'/collections:fontsrecommended,latex,latexrecommended,langeuropean,pictures,xetex'"
-    ```
+    Volg de instructies op <https://www.tug.org/texlive/windows.html>
+
+    - Download de [installer van de website](https://mirror.ctan.org/systems/texlive/tlnet/install-tl-windows.exe)
+    - Start deze op als Administrator en kies voor "Install"
+    - Onder "Geavanceerd" kan je in detail bepalen welke LaTeX packages je al dan niet installeert. Als je voldoende vrije schijfruimte hebt (8 a 9 GB), kan je ook gewoon alles installeren. De TeXworks frontend hoef je niet te installeren, voor deze cursus heb je die niet nodig.
 
 === "Debian/Ubuntu"
 
@@ -23,3 +25,9 @@ Op Linux zijn de te installeren packages in principe beschikbaar via de reposito
     ```console
     sudo dnf install texlive-collection-latex texlive-babel-dutch
     ```
+
+## Gebruik onder Windows
+
+- Je kan een lijst van geïnstalleerde en beschikbare pakketten bekijken en beheren via de *TeX Live Shell*. Deze moet met Administrator-rechten draaien, dus je krijgt bij opstarten de vraag of de app wijzigingen mag aanbrengen aan je systeem. Dit is nodig om de packages te installeren vanaf een CTAN (Comprehensive TeX Archive Network) repository.
+    - In het menu Opties > Informatiebronnen... kan je een CTAN mirror kiezen die dicht bij je locatie ligt.
+- Je kan een package installeren in een Administrator-terminal met `tlmgr install <package>`.

docs/installatie-texstudio.md

@@ -4,12 +4,12 @@ TeXstudio is een LaTeX-IDE die goed werkt op alle gangbare desktop-besturingssys
 
 ## Installatie
 
-We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Chocolatey](https://chocolatey.org)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://www.texstudio.org/#download>.
+We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://www.texstudio.org/#download>.
 
 === "Windows"
 
     ```console
-    choco install texstudio
+    winget install TeXstudio.TeXstudio
     ```
 
 === "macOS"
@@ -32,25 +32,31 @@ We raden aan om een package manager te gebruiken voor de installatie van softwar
 
 ## Configuratie
 
+Oorspronkelijk kon LaTeX enkel om met ASCII-tekst, maar nu wordt ook Unicode (UTF-8) ondersteund. Dat vraagt wel enkele aanpassingen van de basisinstellingen.
+
 Kies in het menu voor Options > Configure TeXstudio en pas volgende instellingen aan:
 
-- Build:
-    - Default compiler: "XeLaTeX"
-    - Default Bibliography Tool: "Biber"
-- Commands:
-    - xelatex: `xelatex -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error %`
-- Editor:
-    - Indentation mode: Indent and Unindent Automatically
-    - Replace Indentation Tab by Spaces: Aanvinken
-    - Replace Tab in Text by spaces: Aanvinken
-    - Replace Double Quotes: English Quotes: ‘‘’’
-- Language Checking:
-    – Default language: selecteer "nl_NL-Dutch", "nl-BE" of een gelijkaardige optie voor Nederlands zodat je gebruik kan maken van spellingcontrole. Is deze optie toch niet beschikbaar? Je kan een woordenboekbestand voor OpenOffice of LibreOffice downloaden en installeren. Het dialoogvenster heeft links die je meteen naar de juiste pagina leiden.
+- **Build**:
+    - Default compiler: **XeLaTeX** (UTF-8 compatibel, mogelijkheid om TTF-lettertypes te gebruiken, enz.) in plaats van PDFLaTeX (enkel ASCII, PostScript lettertypes, enz.)
+    - Default Bibliography Tool: **Biber** (UTF-8 compatibel, ondersteuning voor APA-referenties, ...) in plaats van `bibtex` (enkel ASCII, geep APA-referenties, ...)
+- **Commands**:
+    - xelatex: `xelatex -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error %` (voeg de optie `-shell-escape` toe)
+- **Editor**:
+    - Indentation mode: *Indent and Unindent Automatically*
+    - Replace Indentation Tab by Spaces: *Aanvinken*
+    - Replace Tab in Text by spaces: *Aanvinken*
+    - Replace Double Quotes: *English Quotes: ‘‘’’*
+- **Language Checking**:
+    - Default language: selecteer "nl_NL-Dutch", "nl-BE" of een gelijkaardige optie voor Nederlands zodat je gebruik kan maken van spellingcontrole. Is deze optie toch niet beschikbaar? Je kan een woordenboekbestand voor OpenOffice of LibreOffice downloaden en installeren. Het dialoogvenster heeft links die je meteen naar de juiste pagina leiden.
 
 ## Algemeen gebruik
 
 - Om een LaTeX-document (extensie .tex) te compileren, druk F5 (of kies in het menu voor Tools > Build & View)
     - De eerste keer dat je dit doet kan het compilatieproces lang duren. Er zal je op Windows wellicht gevraagd worden of MikTeX wijzigingen mag aanbrengen aan je systeem. Laat dit toe, want wellicht moeten er nog extra packages geïnstalleerd worden. Dit is eenmalig (per document), dus de volgende keer dat je compileert moet dit een stuk sneller gaan.
+    - MiKTeX op Windows zal een pop-up tonen om je toestemming te vragen, bevestig dit. De eerste keer compileren kan enkele minuten duren zonder dat je feedback krijgt over wat er gebeurt. Even geduld, dus.
+    - Op Linux werkt dit misschien niet en moet je opzoeken welke extra packages `texlive` je nog moet installeren voor de gewenste functionaliteit.
 - Als je een document met een bibliografie wilt compileren, maar die is niet zichtbaar (en verwijzingen zijn in het vet gedrukt, bv. (**Knuth1977**)), dan moet je de bibliografie apart compileren met F8 (of Tools > Bibliography) en daarna opnieuw F5. Nu zou de bibliografie wel toegevoegd moeten zijn!
 
 Indien er zich fouten voordoen bij de compilatie, kan je onderaan in het tabblad Log een overzicht krijgen van de foutboodschappen. LaTeX foutboodschappen interpreteren vraagt wel wat gewenning. De beste methode is om niet teveel code ineens te schrijven en vaak te compileren. Op die manier weet je dat de fout in je laatste toevoegingen moet zitten!
+
+Wanneer je bij je lector hulp vraagt, is het belangrijk om de **exacte foutboodschap** mee te geven. Dat kan het makkelijkst door het tabblad *Logbestand* te selecteren en de gehele inhoud te kopiëren.

docs/installatie-vscode.md

@@ -1,15 +1,15 @@
 # Visual Studio Code
 
-VS Code is een veelzijdige editor met ondersteuning voor allerlei documenttypen, waaronder LaTeX.
+VS Code is een veelzijdige teksteditor met zeer goede ondersteuning voor tientallen programmeer- en scriptingtalen en gestructureerde tekstformaten als HTML, Markdown, enz. Ook voor LaTeX zijn er goede plugins. Als je al gewend bent om VS Code te gebruiken, dan kan je het even goed ook gebruiken voor LaTeX. Het nadeel is misschien wel dat het wat complexer is om Code goed te configureren.
 
 ## Installatie
 
-We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Chocolatey](https://chocolatey.org)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://code.visualstudio.com/download>.
+We raden aan om een package manager te gebruiken voor de installatie van software, ook op Windows ([Winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)) of macOS ([Homebrew](https://brew.sh/)). Als je toch verkiest dat niet te doen, dan kan je het downloaden via de website: <https://code.visualstudio.com/download>.
 
 === "Windows"
 
     ```console
-    choco install vscode
+    winget install Microsoft.VisualStudioCode
     ```
 
 === "macOS"
@@ -39,7 +39,7 @@ We raden aan om een package manager te gebruiken voor de installatie van softwar
 
 Installeer eerst en vooral de [LaTeX Workshop-extensie](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop) van James-Yu.
 
-Plak de inhoud van dit bestand (zonder accolades) onderaan de User Settings (JSON) in Visual Studio Code. Je vindt de user settings door via F1 te zoeken naar "user settings".
+Plak de inhoud van het codeblok hieronder (zonder de buitenste accolades) onderaan de User Settings (JSON) in Visual Studio Code. Typ Ctrl+Shift+P in om het "command palette" te openen, en zoek "Preferences: open user settings (JSON)".
 
 ```json
 {
@@ -147,3 +147,8 @@ Plak de inhoud van dit bestand (zonder accolades) onderaan de User Settings (JSO
   ]
 }
 ```
+
+## Meer info
+
+- Maithripala, A. (2020) *How to create and compile LateX documents on Visual Studio Code.* Opgehaald 2024-02-10 van <https://dev.to/ucscmozilla/how-to-create-and-compile-latex-documents-on-visual-studio-code-3jbk>.
+- Van Vreckem, B. (2023) *Visual Studio Code settings - settings.json.* Opgehaald 2024-02-10 van <https://github.com/bertvv/dotfiles/blob/main/.config/Code/User/settings.json>