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)を使用します。

アクセシビリティ

リンクの遷移先は、リンクテキスト自体、または少なくともその前後のテキストから明確であるべきです。 PDFエクスポートでは、Typstはリンクの遷移先に基づいてツールチップの説明を自動的に生成します。 URLへのリンクの場合は、URL自体がツールチップとして使われます。

HTMLエクスポートにおけるリンク

HTMLエクスポートでは、ラベルやロケーションへのリンクは、フラグメント識別子を用いたアンカーリンクに変換されます。 これに対応するため、既存のIDを持たないターゲットはDOM上で自動的にIDを受け取ります。 この仕組みは、リンクターゲットが変換されるHTMLノードの種類によって異なります。

• リンクターゲットが単一のHTML要素に変換される場合、その要素がIDを受け取ります。 例としては、（単一の<h2>要素に変換される）トップレベルの見出しにリンクする場合が典型的です。

• リンクターゲットが単一のテキストノードに変換される場合、そのノードは<span>でラップされ、その<span>がIDを受け取ります。

• リンクターゲットが複数のノードに変換される場合、最初のノードがIDを受け取ります。

• リンクターゲットが全くノードに変換されない場合、リンクターゲットとして機能する空の<span>が生成されます。

特定のDOM構造に依存する場合は、コンパイラーがテキストのテキストノードへの正確な分割を保証しないため、リンクターゲットが1つまたは複数の要素に変換されることを保証する必要があります。

自動的なID生成では、リンクターゲットのラベルが存在する場合、人間が読めるIDを作成するためにラベルの再利用を試みます。 ラベルは以下の条件を満たす場合に再利用できます。

• 全ての文字が、Unicode上で英字もしくは数字に分類されるか、あるいはハイフンかアンダースコアであること。

• ラベルが数字またはハイフンで始まらないこと。

これらのルールは、ラベルがCSS識別子としても、リンク用のURLフラグメントとしても有効であることを保証します。

IDはDOM内で一意でなければならないため、重複するラベルをIDとして再利用する際には、それらを区別する必要があるかもしれません。 正確なルールは以下の通りです。

• ラベルが再利用可能で文書内で一意であれば、そのままIDとして使用されます。

• ラベルが再利用可能だが一意ではない場合、ハイフンと整数からなるサフィックスが追加されます。 例えば、<mylabel>というラベルが2つ存在すると、mylabel-1とmylabel-2に変換されます。

• それ以外の場合は、loc-に続けて整数を付けた一意なIDが生成されます。