{"route":"/en-US-v0.14.1/reference/pdf/artifact/","title":"Artifact","description":"Documentation for the `artifact` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"parameters","name":"Parameters","children":[{"id":"parameters-kind","name":"kind","children":[]},{"id":"parameters-body","name":"body","children":[]}]}],"body":{"kind":"func","content":{"path":["pdf"],"name":"artifact","title":"Artifact","keywords":[],"oneliner":"Marks content as a PDF artifact.","element":true,"contextual":false,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"<p>Marks content as a PDF artifact.</p>\n<p>Artifacts are parts of the document that are not meant to be read by\nAssistive Technology (AT), such as screen readers. Typical examples include\npurely decorative images that do not contribute to the meaning of the\ndocument, watermarks, or repeated content such as page numbers.</p>\n<p>Typst will automatically mark certain content, such as page headers,\nfooters, backgrounds, and foregrounds, as artifacts. Likewise, paths and\nshapes are automatically marked as artifacts, but their content is not.\nRepetitions of table headers and footers are also marked as artifacts.</p>\n<p>Once something is marked as an artifact, you cannot make any of its\ncontents accessible again. If you need to mark only part of something as an\nartifact, you may need to use this function multiple times.</p>\n<p>If you are unsure what constitutes an artifact, check the <a href=\"/en-US-v0.14.1/guides/accessibility/#artifacts\">Accessibility\nGuide</a>.</p>\n<p>In the future, this function may be moved out of the <code>pdf</code> module, making it\npossible to hide content in HTML export from AT.</p>"}],"self":false,"params":[{"name":"kind","details":[{"kind":"html","content":"<p>The artifact kind.</p>\n<p>This will govern how the PDF reader treats the artifact during reflow\nand content extraction (e.g. copy and paste).</p>"}],"types":["str"],"strings":[{"string":"header","details":"<p>Repeats on the top of each page.</p>"},{"string":"footer","details":"<p>Repeats at the bottom of each page.</p>"},{"string":"page","details":"<p>Not part of the document, but rather the page it is printed on. An\nexample would be cut marks or color bars.</p>"},{"string":"other","details":"<p>Other artifacts, including purely cosmetic content, backgrounds,\nwatermarks, and repeated content.</p>"}],"default":"<code><span class=\"typ-str\">&quot;other&quot;</span></code>","positional":false,"named":true,"required":false,"variadic":false,"settable":true},{"name":"body","details":[{"kind":"html","content":"<p>The content that is an artifact.</p>"}],"types":["content"],"strings":[],"default":null,"positional":true,"named":false,"required":true,"variadic":false,"settable":false}],"returns":["content"],"scope":[]}}}