1
- name: pdfa
2
  schema:
3
    anyOf:
4
      - boolean
5
      - string
6
  tags:
7
    formats: [context]
8
  description:
9
    short: Adds the necessary setup to the document preamble to generate PDF/A of the type specified.
10
    long: |
11
      Adds the necessary setup to the document preamble to generate PDF/A of the type specified.
12

13
      If the value is set to `true`, `1b:2005` will be used as default.
14

15
      To successfully generate PDF/A the required
16
      ICC color profiles have to be available and the content and all
17
      included files (such as images) have to be standard conforming.
18
      The ICC profiles and output intent may be specified using the
19
      variables `pdfaiccprofile` and `pdfaintent`.  See also [ConTeXt
20
      PDFA](https://wiki.contextgarden.net/PDF/A) for more details.
21

22
- name: pdfaiccprofile
23
  schema:
24
    maybeArrayOf: string
25
  tags:
26
    formats: [context]
27
  description:
28
    short: |
29
      When used in conjunction with `pdfa`, specifies the ICC profile to use 
30
      in the PDF, e.g. `default.cmyk`.
31
    long: |
32
      When used in conjunction with `pdfa`, specifies the ICC profile to use 
33
      in the PDF, e.g. `default.cmyk`.
34

35
      If left unspecified, `sRGB.icc` is used as default. May be repeated to 
36
      include multiple profiles. Note that the profiles have to be available 
37
      on the system. They can be obtained from 
38
      [ConTeXt ICC Profiles](https://wiki.contextgarden.net/PDFX#ICC_profiles).
39

40
- name: pdfaintent
41
  schema: string
42
  tags:
43
    formats: [context]
44
  description:
45
    short: When used in conjunction with `pdfa`, specifies the output intent for the colors.
46
    long: |
47
      When used in conjunction with `pdfa`, specifies the output intent for
48
      the colors, for example `ISO coated v2 300\letterpercent\space (ECI)`
49

50
      If left unspecified, `sRGB IEC61966-2.1` is used as default.
51

52
- name: pdf-standard
53
  schema:
54
    maybeArrayOf:
55
      enum:
56
        # PDF versions
57
        - "1.4"
58
        - "1.5"
59
        - "1.6"
60
        - "1.7"
61
        - "2.0"
62
        # PDF/A standards (supported by both Typst and LaTeX)
63
        - a-1b
64
        - a-2a
65
        - a-2b
66
        - a-2u
67
        - a-3a
68
        - a-3b
69
        - a-3u
70
        - a-4
71
        - a-4f
72
        # PDF/A standards (Typst only)
73
        - a-1a
74
        - a-4e
75
        # PDF/UA standards
76
        - ua-1
77
        - ua-2
78
        # PDF/X standards (LaTeX only)
79
        - x-4
80
        - x-4p
81
        - x-5g
82
        - x-5n
83
        - x-5pg
84
        - x-6
85
        - x-6n
86
        - x-6p
87
  tags:
88
    formats: [$pdf-all, typst]
89
  description:
90
    short: PDF conformance standard (e.g., ua-2, a-2b,  1.7)
91
    long: |
92
      Specifies PDF conformance standards and/or version for the output.
93

94
      Accepts a single value or array of values:
95

96
      **PDF versions** (both Typst and LaTeX):
97
      `1.4`, `1.5`, `1.6`, `1.7`, `2.0`
98

99
      **PDF/A standards** (both engines):
100
      `a-1b`, `a-2a`, `a-2b`, `a-2u`, `a-3a`, `a-3b`, `a-3u`, `a-4`, `a-4f`
101

102
      **PDF/A standards** (Typst only):
103
      `a-1a`, `a-4e`
104

105
      **PDF/UA standards**:
106
      `ua-1` (Typst), `ua-2` (LaTeX)
107

108
      **PDF/X standards** (LaTeX only):
109
      `x-4`, `x-4p`, `x-5g`, `x-5n`, `x-5pg`, `x-6`, `x-6n`, `x-6p`
110

111
      Example: `pdf-standard: [a-2b, ua-2]` for accessible archival PDF.
112

113