Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
quarto-dev
GitHub Repository: quarto-dev/quarto-cli
 Path: blob/main/src/resources/schema/document-language.yml
12921 views
1
- name: lang

2
  schema: string

3
  description:

4
    short: Identifies the main language of the document (e.g. `en` or `en-GB`).

5
    long: |

6
      Identifies the main language of the document using IETF language tags 

7
      (following the [BCP 47](https://www.rfc-editor.org/info/bcp47) standard), 

8
      such as `en` or `en-GB`. The [Language subtag lookup](https://r12a.github.io/app-subtags/) 

9
      tool can look up or verify these tags. 

10


11
      This affects most formats, and controls hyphenation 

12
      in PDF output when using LaTeX (through [`babel`](https://ctan.org/pkg/babel) 

13
      and [`polyglossia`](https://ctan.org/pkg/polyglossia)) or ConTeXt.

14


15
- name: language

16
  schema:

17
    anyOf:

18
      - path

19
      - object

20
  description: YAML file containing custom language translations

21


22
- name: shorthands

23
  tags:

24
    formats: [pdf, beamer]

25
  schema: boolean

26
  default: false

27
  description:

28
    short: Enable babel language-specific shorthands in LaTeX output.

29
    long: |

30
      Enable babel language-specific shorthands in LaTeX output. When `true`,

31
      babel's language shortcuts are enabled (e.g., French `<<`/`>>` for guillemets,

32
      German `"` shortcuts, proper spacing around French punctuation).

33


34
      Default is `false` because language shorthands can interfere with code blocks

35
      and other content. Only enable if you need specific typographic features

36
      for your language.

37


38
- name: dir

39
  schema:

40
    enum: [rtl, ltr]

41
  description:

42
    short: The base script direction for the document (`rtl` or `ltr`).

43
    long: |

44
      The base script direction for the document (`rtl` or `ltr`).

45


46
      For bidirectional documents, native pandoc `span`s and

47
      `div`s with the `dir` attribute can

48
      be used to override the base direction in some output

49
      formats.  This may not always be necessary if the final

50
      renderer (e.g. the browser, when generating HTML) supports

51
      the [Unicode Bidirectional Algorithm].

52


53
      When using LaTeX for bidirectional documents, only the

54
      `xelatex` engine is fully supported (use

55
      `--pdf-engine=xelatex`).

56


57