情報アイコン
情報 / Info
当サイトは、Typst GmbHの許諾を得て、日本語コミュニティ「Typst Japan Community」がTypst v0.13.1の公式ドキュメントを翻訳したものです。誤訳や古い情報が含まれている可能性があるため、公式ドキュメントとの併用を推奨します。翻訳の改善やサイトの機能向上について、GitHubでのIssueやPull Requestを歓迎します。コミュニティにご興味のある方はDiscordサーバー「くみはんクラブ」にぜひご参加ください。
This site provides a Japanese translation of the Typst v0.13.1 documentation maintained by the "Typst Japan Community" with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our Discord server "Kumihan Club".
言語アイコン
翻訳済み

このページは日本語に翻訳済みです。

ref
Element
ヘルプアイコン

ラベルや参考文献への参照。

ラベルを指定して、その参照を生成します。 参照のformには"normal""page"の2種類があります。

デフォルトの"normal"参照では、ラベルに対するテキスト形式の参照が作られます。 たとえば見出しへの参照なら、"Section 1"などのような適切な文字列が表示されます。 この参照は、該当する要素へのリンクとしても機能します。 また、参照の構文は文献リストからの引用を行うciteにも使用できます。

このデフォルト形式では補足語と番号が必要なため、ラベルは 参照可能な要素 に付けなくてはなりません。 参照可能な要素としては、 headingsfiguresequationsfootnotes などがあります。 定理(theorem)などのカスタム参照可能要素を作成したい場合は、カスタムkindの図表として作成し、それに対応するshowルールを書くことで作成可能です。 将来的には、カスタム参照可能要素をもっと直接的に定義する方法が導入されるかもしれません。

#set page(numbering: "1")
#set heading(numbering: "1.")
#set math.equation(numbering: "(1)")

= Introduction <intro>
Recent developments in
typesetting software have
rekindled hope in previously
frustrated researchers. @distress
As shown in @results (see
#ref(<results>, form: "page")),
we ...

= Results <results>
We discuss our approach in
comparison with others.

== Performance <perf>
@slow demonstrates what slow
software looks like.
$ T(n) = O(2^n) $ <slow>

#bibliography("works.bib")
Preview

Syntax

この機能には専用の記法も用意されています。 "normal" の参照を作成するためには@に続けてラベル名を入力します。 (たとえば= Introduction <intro>というラベルを参照するには@introと入力します)

補足語をカスタマイズするには、 @intro[Chapter]のように、参照の後に角括弧でコンテンツを追加します。

カスタム

参照のshowルールを書く場合、 参照のelementフィールドを通じて参照先の要素にアクセスできます。 ただし、Typstがまだそれを発見していない場合、elementは存在していてもnoneになる可能性があるため、 常にコード内でそのケースを処理する必要があります。

#set heading(numbering: "1.")
#set math.equation(numbering: "(1)")

#show ref: it => {
  let eq = math.equation
  let el = it.element
  if el != none and el.func() == eq {
    // Override equation references.
    link(el.location(),numbering(
      el.numbering,
      ..counter(eq).at(el.location())
    ))
  } else {
    // Other references as usual.
    it
  }
}

= Beginnings <beginning>
In @beginning we prove @pythagoras.
$ a^2 + b^2 = c^2 $ <pythagoras>
Preview

引数
ヘルプアイコン

target
Required
ヘルプアイコン
Positional
ヘルプアイコン

参照されるべき対象ラベル。

これは、ドキュメント内で定義されたラベルや、 参考文献リストの参照キーである場合があります。

supplement
Settable
ヘルプアイコン

参照の補足語。

form"normal"で設定されている場合は以下のとおりです。

  • 見出しや図への参照では、この値が参照番号の前に追加されます。
  • 文献引用の場合は、ページ番号などを追記するのに使えます。

もしform"page"に設定されている場合には、 参照先ラベルのページ番号の前にこの値が追加されます。

また、関数が指定されている場合は、それに参照先の要素が渡され、戻り値のコンテンツが補足語となります。

デフォルト値:

auto

右矢印アイコン
例を表示
#set heading(numbering: "1.")
#show ref.where(
  form: "normal"
): set ref(supplement: it => {
  if it.func() == heading {
    "Chapter"
  } else {
    "Thing"
  }
})

= Introduction <intro>
In @intro, we see how to turn
Sections into Chapters. And
in @intro[Part], it is done
manually.
Preview

form
Settable
ヘルプアイコン

生成する参照の種類

使用可能な文字列値:
  • normal

    ラベルに対して文字列での参照を生成します。

  • page

    ラベルに対してページ番号での参照を生成します。

デフォルト値:

"normal"

右矢印アイコン
例を表示
#set page(numbering: "1")

Here <here> we are on
#ref(<here>, form: "page").
Preview

検索