{"route":"/en-US-v0.14.1/reference/foundations/target/","title":"Target","description":"Documentation for the `target` function.","part":null,"outline":[{"id":"summary","name":"Summary","children":[]},{"id":"when-to-use-it","name":"When to use it","children":[]},{"id":"varying-targets","name":"Varying targets","children":[]},{"id":"example","name":"Example","children":[]}],"body":{"kind":"func","content":{"path":[],"name":"target","title":"Target","keywords":[],"oneliner":"Returns the current export target.","element":false,"contextual":true,"deprecationMessage":null,"deprecationUntil":null,"details":[{"kind":"html","content":"

Returns the current export target.

\n

This function returns either

\n\n

The design of this function is not yet finalized and for this reason it is\nguarded behind the html feature. Visit the HTML documentation\npage for more details.

\n

When to use it

\n

This function allows you to format your document properly across both HTML\nand paged export targets. It should primarily be used in templates and show\nrules, rather than directly in content. This way, the document's contents\ncan be fully agnostic to the export target and content can be shared between\nPDF and HTML export.

\n

Varying targets

\n

This function is contextual as the target can vary within a\nsingle compilation: When exporting to HTML, the target will be "paged"\nwhile within an html.frame.

\n

Example

\n
#let kbd(it) = context {\n  if target() == "html" {\n    html.elem("kbd", it)\n  } else {\n    set text(fill: rgb("#1f2328"))\n    let r = 3pt\n    box(\n      fill: rgb("#f6f8fa"),\n      stroke: rgb("#d1d9e0b3"),\n      outset: (y: r),\n      inset: (x: r),\n      radius: r,\n      raw(it)\n    )\n  }\n}\n\nPress #kbd("F1") for help.\n
\"Preview\"
"}],"self":false,"params":[],"returns":["str"],"scope":[]}}}