link

要素関数

要素関数

要素関数はsetルールやshowルールでカスタマイズできます。

URLや文書中の位置へのリンク。

デフォルトでは、リンクの外見は通常のテキストと変わりません。 しかし、showルールを使うことで、簡単に任意のスタイルを適用できます。

例

#show link: underline

https://example.com \

#link("https://example.com") \
#link("https://example.com")[
  See example.com
]

構文

この関数には専用の構文もあります。 http://やhttps://で始まるテキストは、自動的にリンクに変換されます。

ハイフネーション

ハイフネーションや両端揃えを有効にしていても、意図しないURL中のハイフネーションを防ぐため、 デフォルトではリンクには適用されません。 これを無効化するには、show link: set text(hyphenate: true)を使用します。

Accessibility

The destination of a link should be clear from the link text itself, or at least from the text immediately surrounding it. In PDF export, Typst will automatically generate a tooltip description for links based on their destination. For links to URLs, the URL itself will be used as the tooltip.

Links in HTML export

In HTML export, a link to a label or location will be turned into a fragment link to a named anchor point. To support this, targets without an existing ID will automatically receive an ID in the DOM. How this works varies by which kind of HTML node(s) the link target turned into:

• If the link target turned into a single HTML element, that element will receive the ID. This is, for instance, typically the case when linking to a top-level heading (which turns into a single <h2> element).

• If the link target turned into a single text node, the node will be wrapped in a <span>, which will then receive the ID.

• If the link target turned into multiple nodes, the first node will receive the ID.

• If the link target turned into no nodes at all, an empty span will be generated to serve as a link target.

If you rely on a specific DOM structure, you should ensure that the link target turns into one or multiple elements, as the compiler makes no guarantees on the precise segmentation of text into text nodes.

If present, the automatic ID generation tries to reuse the link target's label to create a human-readable ID. A label can be reused if:

• All characters are alphabetic or numeric according to Unicode, or a hyphen, or an underscore.

• The label does not start with a digit or hyphen.

These rules ensure that the label is both a valid CSS identifier and a valid URL fragment for linking.

As IDs must be unique in the DOM, duplicate labels might need disambiguation when reusing them as IDs. The precise rules for this are as follows:

• If a label can be reused and is unique in the document, it will directly be used as the ID.

• If it's reusable, but not unique, a suffix consisting of a hyphen and an integer will be added. For instance, if the label <mylabel> exists twice, it would turn into mylabel-1 and mylabel-2.

• Otherwise, a unique ID of the form loc- followed by an integer will be generated.