> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/nl/vragen-en-antwoorden/58-i-have-a-custom-font-i-d-like-to-load-to-my-document.-how-can-i-do-this.md).

# Ik heb een aangepast lettertype dat ik in mijn document wil laden. Hoe kan ik dat doen?

## Inleiding

Dit artikel laat zien hoe u aangepaste lettertypen installeert voor het zetten van de tekst van uw document—het behandelt geen lettertypen voor het zetten van wiskunde. Met “aangepast lettertype” bedoelen we een lettertype dat niet beschikbaar is op de servers van Overleaf, waaronder commerciële lettertypen waarvoor een licentie vereist is of gratis te gebruiken lettertypen die niet met TeX Live worden meegeleverd of in onze Linux-installatie zijn opgenomen.

* **Opmerking**: Dit artikel behandelt gangbare lettertypetechnologieën, maar bespreekt geen gespecialiseerde op TeX gebaseerde oplossingen zoals [Metafont](https://en.wikipedia.org/wiki/Metafont) en [virtuele lettertypen](https://texfaq.org/FAQ-virtualfonts).

## Waar begin ik?

Op LaTeX gebaseerde zetoplossingen werken binnen een legacy-omgeving. In meer dan vier decennia heeft de ontwikkeling van LaTeX-compilers en lettertypeformaten een ecosysteem voortgebracht dat een mix van oudere en nieuwe technologieën omvat. Daardoor hangt het daadwerkelijke proces van het installeren en configureren van aangepaste lettertypen voor gebruik met LaTeX af van deze twee factoren:

1. Het type (formaat) van de lettertypen die u wilt installeren:

* verouderde [PostScript Type 1](https://en.wikipedia.org/wiki/PostScript_fonts#Type_1) of [TrueType](https://en.wikipedia.org/wiki/TrueType) lettertypen, of
* moderne [OpenType](https://en.wikipedia.org/wiki/OpenType) lettertypen.

3. Welke LaTeX-compiler wordt gebruikt om uw Overleaf-project(en) te compileren:
   * pdfLaTeX, of
   * XeLaTeX of LuaLaTeX

Ga naar de sectie die uw voorkeurscompiler behandelt:

* [Aangepaste lettertypen gebruiken met pdfLaTeX](#using-custom-fonts-with-pdflatex)
* [Aangepaste lettertypen gebruiken met XeLaTeX en LuaLaTeX](#using-custom-fonts-with-xelatex-and-lualatex)

## Aangepaste lettertypen gebruiken met pdfLaTeX

Hier volgt een samenvatting van wat u moet doen—afhankelijk van de complexiteit van uw aangepaste lettertype-instelling:

1. Voor elk lettertypebestand (`.ttf`, `.otf` of `.pfb`), moet u een geschikte TeX-lettertypemetriek (`.tfm`) en mogelijk een coderingsbestand (`.enc`).
2. pdfLaTeX moet weten hoe documentlettertypen in het uiteindelijke PDF-bestand moeten worden ingebed. Daarvoor leest het een font-mapbestand (`pdftex.map`), dat u moet bijwerken met de details van uw aangepaste lettertype. Op Overleaf doet u dat met een van deze opdrachten:

* `\pdfmapfile{...}`
* `\pdfmapline{...}`

4. U hebt een fontdefinitiebestand (`.fd`nodig dat LaTeX vertelt hoe de nieuwe lettertypebestanden moeten worden gebruikt.

Dit zijn de belangrijkste bestandstypen die u nodig zult hebben:

* **`.tfm`** (TeX-lettertypemetriek): deze compacte binaire bestanden bevatten geen gegevens die de visuele vorm van tekenvormen beschrijven, alleen tekenafmetingen en lettertype-“metadata” die TeX-engines kunnen gebruiken om hun kernzetwerkzaamheden uit te voeren. TeX-lettertypemetriek voor wiskundige lettertypen bevat extra gegevens die niet nodig zijn voor alleen-tekst-lettertypen; in het bijzonder hebben ze verschillende “afstand”-parameters die worden gebruikt voor het zetten van wiskunde.
* **`.fd`** (fontdefinitie): deze bestanden bevatten LaTeX-opdrachten die nodig zijn om uw lettertype te configureren en voor gebruik met LaTeX voor te bereiden. Opdrachten die zijn toegestaan binnen `.fd` bestanden, en de `.fd` bestandsnaamconventie, worden beschreven in het document [LaTeX2ε lettertypeselectie](https://texdoc.org/serve/fntguide/1).
* **`.map`** (fontmap): mapbestanden koppelen de naam van TeX-lettertypemetriekbestanden aan het fysieke lettertypebestand met de gegevens die nodig zijn om tekenvormen (glyphs) te tekenen. Elk lettertype dat bekend is bij pdfTeX wordt beschreven op één regel van het mapbestand, met behulp van een goed gedefinieerde syntaxis. Voor volledige details, zie Sectie 5 van [De gebruikershandleiding van pdfTeX](http://mirrors.ctan.org/systems/doc/pdftex/manual/pdftex-a.pdf).
* **`.enc`** (codering): indien nodig definieert dit bestandstype de koppeling tussen tekencodes binnen uw LaTeX-tekst en de bijbehorende tekenvormen (glyphs) die in het lettertypebestand zijn opgenomen.

### Voorbeeld van een aangepast TrueType-lettertype

De Overleaf Galley bevat een project dat [het installeren van een aangepast TrueType-lettertype demonstreert](https://www.overleaf.com/latex/examples/example-using-a-custom-truetype-font/yndxyzgbhpjv)—een PostScript Type 1-lettertype zou een vergelijkbare opzet gebruiken. Het compileert met pdfLaTeX, XeLaTeX en LuaLaTeX en levert de volgende output op:

![Afbeelding die Overleaf-zetwerk toont met een aangepast lettertype](/files/c2adafc3b4cb92e6ca7eaff6b71a797a6214aae2)

#### Opmerkingen bij het voorbeeldproject

* Het gebruikt de volgende `\pdfmapline` commando:

```latex
\pdfmapline{+delphine < Delphine.ttf <T1-WGL4.enc}
```

die een TeX-lettertypemetriekbestand koppelt met de naam `delphine` aan het fysieke lettertypebestand met de naam `Delphine.ttf`.

* Het eerste `<` teken instrueert pdfTeX om een subset van het TrueType-lettertype te maken; dat wil zeggen, *gedeeltelijk* dit lettertype in het uiteindelijke PDF-bestand in te bedden. Het maken van een subset van een lettertype levert kleinere PDF-bestanden op, omdat die alleen de gegevens over tekenvormen bevatten die nodig zijn om de tekens in het document weer te geven.
* Het tweede `<` teken gaat vooraf aan de naam van een coderingsvectorbestand, `T1-WGL4.enc`, dat wordt gebruikt om tekencodes in uw tekst te koppelen aan tekenvormgegevens (glyphs) binnen het lettertypebestand—tekenvormgegevens zijn nodig om het teken weer te geven (te tekenen).
* LuaLaTeX vereist een extra configuratiestap omdat `\pdfmapline` een **Ongedefinieerde besturingsreeks** fout genereert als gevolg van wijzigingen in de manier waarop LuaTeX bepaalde backend-opdrachten afhandelt—Sectie 3 van de [LuaTeX Reference Manual](http://mirrors.ctan.org/systems/doc/luatex/luatex.pdf)zijn gegenereerd. Het `\ifLuaTeX` opdracht, geleverd door het `iftex` pakket, wordt gebruikt om LuaTeX te testen; als dit wordt gedetecteerd, `\pdfmapline` is gedefinieerd:

```latex
\ifLuaTeX
\protected\def\pdfmapline {\pdfextension mapline }
\fi
```

### Meerdere lettertypen of commerciële lettertypen gebruiken

Om bestanden van commerciële lettertypeleveranciers en collecties van gratis te gebruiken lettertypen te beheren, kunt u mappen maken in uw Overleaf-project om lettertypebestanden te organiseren op basis van hun type (`.tfm`, `.pfb`, `.ttf` enz.). Een goed model voor het benoemen en organiseren van uw mappen is de [TeX Directory Structure (TDS)](https://www.tug.org/tds/tds.pdf), die is ontworpen als een best-practice-“blauwdruk” voor het beheren van een verzameling TeX-gerelateerde bestanden.

Zodra de projectmappen zijn aangemaakt, moet u vervolgens een zogenoemde [`latexmcrc` bestand](/latex/nl/diepgaande-artikelen/28-how-to-use-latexmkrc-with-overleaf.md) maken met instructies die de LaTeX-compiler vertellen in die mappen naar bestanden te zoeken. Standaard weten de compilers niet dat die mappen bestaan en zullen ze de bestanden daarin niet vinden.

#### Voorbeeld van een Overleaf-project

Het Overleaf Gallery-voorbeeld [Mappen gebruiken om aangepaste lettertypebestanden te beheren](https://www.overleaf.com/latex/templates/example-using-folders-to-manage-custom-font-files/qvqgnpjxvqzd) gebruikt mappen en een `latexmkrc` bestand om een aangepast TrueType-lettertype te installeren. Het bevat een mappenstructuur die in deze afbeelding wordt getoond:

![Projectmappen organiseren in Overleaf](/files/aafb87aec6d9dc38926b5af61f763e7063f9c375)

en een `latexmkrc` bestand met de volgende regels, die runtime [omgevingsvariabelen](https://en.wikipedia.org/wiki/Environment_variable) instellen en de LaTeX-compiler vertellen in onze projectmappen naar bestanden te zoeken:

```perl
$ENV{'TEXINPUTS'}='myfonts/tex//:' . $ENV{'TEXINPUTS'};
$ENV{'T1FONTS'}='myfonts/fonts/type1//:' . $ENV{'T1FONTS'};
$ENV{'AFMFONTS'}='myfonts/fonts/afm//:' . $ENV{'AFMFONTS'};
$ENV{'TEXFONTMAPS'}='myfonts/fonts/map//:' . $ENV{'TEXFONTMAPS'};
$ENV{'TFMFONTS'}='myfonts/fonts/tfm//:' . $ENV{'TFMFONTS'};
$ENV{'TTFONTS'}='myfonts/fonts/ttf//:' . $ENV{'TTFONTS'};
$ENV{'VFFONTS'}='myfonts/fonts/vf//:' . $ENV{'VFFONTS'};
$ENV{'ENCFONTS'}='myfonts/fonts/enc//:' . $ENV{'ENCFONTS'};
```

Als u zich afvraagt welke bestanden doorgaans in welke map terechtkomen, kijk dan eens naar [dit artikel](/latex/nl/diepgaande-artikelen/06-an-introduction-to-kpathsea-and-how-tex-engines-search-for-files.md#table-listing-kpathsea-config-variables).

## Aangepaste lettertypen gebruiken met XeLaTeX en LuaLaTeX

### PostScript Type 1-lettertypen gebruiken

Om verouderde PostScript Type 1-lettertypen met XeLaTeX en LuaLaTeX te gebruiken, kunt u de [richtlijnen voor pdfLaTeX](#using-custom-fonts-with-pdflatex)volgen, dus we herhalen die details hier niet.

### OpenType-lettertypen gebruiken

XeLaTeX en LuaLaTeX bieden uitgebreide ondersteuning voor geavanceerd zetten met OpenType-lettertypen—TrueType- en PostScript-varianten—omdat hun onderliggende TeX-engines, XeTeX en LuaHBTeX, native (ingebouwde) mogelijkheden hebben om OpenType-lettertypetechnologieën te verwerken, wat pdfTeX niet heeft.

* **Opmerking**: LuaLaTeX heeft via zijn onderliggende TeX-engine (LuaHBTeX) de meest geavanceerde mogelijkheden voor lettertypeverwerking van alle TeX-engines; het bespreken daarvan valt echter buiten het bestek van dit artikel—voor meer informatie, zie secties 6 en 12 van de [LuaTeX Reference Manual](https://ctan.org/pkg/luatex?lang=en).

Om OpenType-lettertypen met XeLaTeX en LuaLaTeX te gebruiken, moet u [`fontspec`](https://ctan.org/pkg/fontspec?lang=en)laden, een krachtig en uitgebreid pakket dat een interface biedt voor de geavanceerde zetmogelijkheden van OpenType-lettertypen.

* **Opmerking**: U hoeft `\usepackage[T1]{fontenc}` (of `\usepackage[utf8]{inputenc}`niet te gebruiken) wanneer u OpenType-lettertypen met XeLaTeX of LuaLaTeX gebruikt.

### Voorbeeld: fontspec introduceren

Het proces is eenvoudig omdat er geen installatie van lettertypen nodig is—geen nood aan `.tfm`, `enc` of `.map` bestanden en het schrijven van lettertype-definities (`.fd`) behoort tot het verleden! Het is zo eenvoudig als dit:

1. Voeg de volgende regel toe aan de preambule van uw document:

```latex
\usepackage{fontspec}
```

3. Selecteer het pictogram voor het uploaden van bestanden (![UploadIcon.png](/files/bf3e984ea6efa407725ac98d39cd57afe7aac2e7)), dat boven de bestandenlijst staat.
4. Sleep het/de lettertypebestand(en) naar het uploadvenster, of selecteer ze op uw computer, om de lettertype(s) aan uw Overleaf-project toe te voegen.
5. Gebruik een van de `fontspec` pakket `\set*xxx*font` opdrachten om het/de lettertype(s) te configureren en te activeren.

De uitstekende `fontspec` pakketdocumentatie bevat een schat aan voorbeelden die u kunt verkennen, dus hier houden we het eenvoudig om u op weg te helpen. Stel bijvoorbeeld dat u een lettertypebestand uploadt met de naam `CrimsonText-Regular.ttf`; nadat u `fontspec` hebt geladen, kunt u het hoofdlettertype van de documenttekst instellen door

```latex
\setmainfont{CrimsonText-Regular.ttf}
```

te schrijven. U kunt ook syntaxis schrijven zoals

```latex
\setmainfont{CrimsonText}[
Extension = .ttf,
UprightFont = *-Regular,
...]
```

U kunt ook een nieuwe lettertypefamilie declareren voor gebruik in willekeurige situaties:

```latex
\newfontfamily{\crimson}{CrimsonText}
[Extension = .ttf, UprightFont = *-Regular, ...]
{\crimson Deze tekst gebruikt het CrimsonText-lettertype}
```

#### Bronnen

* De [`fontspec` pakkettendocumentatie](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) is een must-read—het biedt niet alleen talrijke nuttige voorbeelden, maar bevat ook veel nuttige achtergrondinformatie over OpenType-lettertypen.
* De Overleaf-hulppagina over [XeLaTeX](/latex/nl/lettertypen/03-xelatex.md) bevat een [gedetailleerd voorbeeld](/latex/nl/lettertypen/03-xelatex.md#using-fonts-not-installed-on-overleaf27s-servers-google-fonts-example) dat laat zien hoe OpenType-lettertypen van Google kunnen worden gedownload en geconfigureerd met `fontspec`.

**Voorbeeldprojecten**

De Overleaf Galley heeft voorbeeldprojecten die laten zien hoe OpenType-lettertypen met XeLaTeX of LuaLaTeX worden gebruikt—u kunt deze openen en de compiler wisselen tussen LuaLaTeX en XeLaTeX:

* [Google-lettertypen gebruiken met XeLaTeX](https://www.overleaf.com/latex/templates/using-google-fonts-with-xelatex/xxkpcgfttjvd)
* [De STIX2 OpenType-lettertypen gebruiken met LuaLaTeX of XeLaTeX](https://www.overleaf.com/latex/templates/using-the-stix2-opentype-fonts-with-lualatex-or-xelatex/hdfvhzqmhnpx)

De volgende afbeelding combineert de output die door deze projecten wordt geproduceerd:

![Voorbeeld-Overleaf-projecten met OpenType-lettertypen](/files/5e662603c19ceb035a1026e8f64f397e4fd40d42)

## Basis van lettertypen en LaTeX-compilers

### Bestandsextensies van lettertypen

De onderstaande tabel geeft de bestandsextensies weer die worden gebruikt om verschillende typen (formaten) lettertypebestanden aan te duiden:

|                                                                                                                  |                  |
| ---------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Lettertypetype**                                                                                               | **Extensie**     |
| [PostScript Type 1](https://en.wikipedia.org/wiki/PostScript_fonts#Type_1)$$\displaystyle{}^{\mathbf\*}$$        | `.pfb`           |
| [TrueType](https://en.wikipedia.org/wiki/TrueType)                                                               | `.ttf`           |
| [TrueType-collecties](https://learn.microsoft.com/en-us/typography/opentype/otspec150/otff#truetype-collections) | `.ttc`           |
| [OpenType](https://learn.microsoft.com/en-us/typography/opentype/)                                               | `.otf` of `.ttf` |

$$\displaystyle{}^{\mathbf\*}$$ In januari 2023 hebben alle Adobe-toepassingen voor het maken van content [de ondersteuning voor het verouderde Type 1-lettertypeformaat beëindigd](https://helpx.adobe.com/uk/fonts/kb/postscript-type-1-fonts-end-of-support.html).

OpenType-lettertypen bestaan in twee “varianten”, vaak “flavours” genoemd: de PostScript-variant en de TrueType-variant, namen die de gegevens en mechanismen weerspiegelen die worden gebruikt om de tekenvormen (glyphs) die ze bevatten weer te geven. Daarom hebben OpenType-lettertypen twee bestandsextensies: `.otf` of `.ttf` die, volgens *conventie*, het volgende impliceren:

* `*bestandsnaam*.otf` is een OpenType-lettertype in PostScript-variant
* `*bestandsnaam*.ttf` is een OpenType-lettertype in TrueType-variant

Bijvoorbeeld, pdfTeX gaat ervan uit dat de extensie `.otf` een OpenType-lettertype in PostScript-variant aanduidt.

* **Opmerking**: de `.ttc` extensie wordt alleen gebruikt voor TrueType Font Collections.

### Over de bestandsextensie .ttf

Als een lettertypebestand een `.ttf` extensie heeft, kan het ofwel zijn:

* een ouder (niet-OpenType) TrueType-lettertype, of
* een OpenType-lettertype dat TrueType-gegevens bevat plus de extra functies die door OpenType worden geboden.

Vaststellen of een bepaald `.ttf` lettertypebestand OpenType of gewoon TrueType is, kan lastig zijn en vereist dat toepassingen de interne datastructuren van het lettertype onderzoeken/controleren. Zie voor meer details [deze discussie (thread)](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format) of dit [Microsoft-artikel](https://learn.microsoft.com/en-us/typography/opentype/#why-is-my-opentype-font-listed-as-a-truetype-font-by-my-application).

### Lettertypeformaten en LaTeX-compilers

De volgende tabel vat de (gangbare) lettertypeformaten samen die door drie LaTeX-compilers worden ondersteund (strikt genomen: door de onderliggende TeX-engines):

|              |                         |                                                            |                                                        |                                            |
| ------------ | ----------------------- | ---------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------ |
| **Compiler** | **PostScript (Type 1)** | **TrueType (eenvoudig**$$\displaystyle{}^{\mathbf†}$$**)** | **OpenType (TrueType)**$$\displaystyle{}^{\mathbf\*}$$ | **OpenType (PostScript)**                  |
| pdfLaTeX     | Ja                      | Ja                                                         | Beperkt$$\displaystyle{}^{\mathbf{\*\*}}$$             | Beperkt$$\displaystyle{}^{\mathbf{\*\*}}$$ |
| XeLaTeX      | Ja                      | Ja                                                         | Ja                                                     | Ja                                         |
| LuaLaTeX     | Ja                      | Ja                                                         | Ja                                                     | Ja                                         |

$$\displaystyle{}^{\mathbf†}$$Met “eenvoudig” bedoelen we een TrueType-lettertype dat niet de aanvullende gegevens (tabellen) bevat die door de OpenType-specificatie worden gedefinieerd, en dus niet de meer geavanceerde zetfuncties van OpenType-lettertypen in TrueType-variant heeft.

$$\displaystyle{}^{\mathbf\*}$$pdfTeX biedt beperkte ondersteuning voor [TrueType-collecties](https://learn.microsoft.com/en-us/typography/opentype/otspec150/otff#truetype-collections) (extensie `.ttc`)—het leest alleen gegevens voor het eerste lettertype in de collectie.

$$\displaystyle{}^{\mathbf{\*\*}}$$Met de “Beperkte” OpenType-ondersteuning van pdfTeX wordt bedoeld:

* het ondersteunt niet de geavanceerde zetfuncties die in OpenType-lettertypen zijn opgenomen;
* het zal OpenType-lettertypen in TrueType-variant subsetten, maar niet OpenType-lettertypen in PostScript-variant, die volledig moeten worden ingebed. Het ontbreken van het maken van subsets levert grotere PDF-bestanden op en veroorzaakt licentieproblemen met commerciële lettertypen, die doorgaans volledig inbedden verbieden;
* het kan niet meer dan 256 tekens per lettertype gebruiken, terwijl afzonderlijke OpenType-lettertypen tienduizenden tekens ondersteunen;
* het vereist het produceren van TeX-lettertypemetriek en andere aanvullende bestanden (vereist door LaTeX)—processen die buiten het bestek van dit artikel vallen (zie [Verder lezen](#further-reading) voor links naar beschrijvingen van die processen).

## Verder lezen

* [Hoe OpenType werkt](https://simoncozens.github.io/fonts-and-layout/opentype.html) (door Simon Cozens).
* [Bepalen of een lettertypebestand een OpenType-formaat of TrueType-formaat is](https://typedrawers.com/discussion/2945/determine-whether-a-font-file-is-opentype-format-or-truetype-format)—een bespreking van de moeilijkheid om vast te stellen of een bepaald `.ttf` gewoon TrueType is of OpenType in TrueType-variant.
* [Een nadere blik op TrueType-lettertypen en pdfTeX](https://tug.org/TUGboat/tb30-1/tb94thanh.pdf)—een TUGboat-artikel geschreven door [Hàn Thế Thành](https://tug.org/interviews/thanh.html), de maker van [pdfTeX](https://www.tug.org/applications/pdftex/).
* [A Directory Structure for TeX Files](https://tug.org/tds/tds.html), een standaard mappen-/directoryhiërarchie voor het organiseren van TeX-gerelateerde bestanden.
* [De installatie en het gebruik van OpenType-lettertypen in LaTeX](https://www.tug.org/TUGboat/tb27-2/tb87owens.pdf)—een TUGboat-artikel dat uitlegt hoe OpenType-lettertypen moeten worden voorbereid voor gebruik met pdfLaTeX.
* [Hoe gebruik ik TrueType-lettertypen met PdfTeX met behulp van otftotfm?](https://tex.stackexchange.com/questions/52819/how-do-i-use-truetype-fonts-with-pdftex-using-otftotfm/52902#52902)—een tex.stackexchange-thread met een gedetailleerd voorbeeld.

### Een opmerking over de “fontoorlogen”...

De jaren 1980 en 1990 zagen de zogenaamde “fontoorlogen” terwijl twee concurrerende lettertypeformaten, PostScript Type 1 (van Adobe) en TrueType (gemaakt door Apple, in licentie gegeven aan Microsoft), vochten om de hegemonie—om de harten en geesten van alle gebruikers te winnen, vooral ontwerpers en typografen. Uiteindelijk verscheen het [OpenType-lettertypeformaat](https://learn.microsoft.com/en-us/typography/opentype) (in 1997) als een hybride oplossing, die de lettertypetechnologieën van Adobe en Apple omvatte en uitbreidde. OpenType bouwt voort op het oorspronkelijke TrueType-bestandsformaat om geavanceerde zetmogelijkheden en betere Unicode-ondersteuning mogelijk te maken via lettertypen met meer dan 65.000 tekenvormen (glyphs).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/nl/vragen-en-antwoorden/58-i-have-a-custom-font-i-d-like-to-load-to-my-document.-how-can-i-do-this.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.