情報 / Info
当サイトは、Typst GmbHの許諾を得て、日本語コミュニティ「Typst Japanese 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 Japanese 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".
翻訳済み

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

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

出力されるPDFに埋め込まれるファイル。

この関数は、PDFに関連する追加のファイルをPDF内に埋め込んで配布するために使用できます。 PDFリーダーはファイルリストにファイルを表示します。

一部の国際規格では、 この仕組みを使用して、 PDFの視覚的な内容を反映した機械可読データ(例:請求書のZUGFeRD/Factur-X)を埋め込んでいます。

#pdf.embed(
  "experiment.csv",
  relationship: "supplement",
  mime-type: "text/csv",
  description: "Raw Oxygen readings from the Arctic experiment",
)

注意

  • この要素はPDF以外の形式にエクスポートする場合は無視されます。
  • PDF/A-2へのエクスポートでは、埋め込みファイルは現在サポートされていません。 たとえ埋め込まれるファイルがPDF/A-1やPDF/A-2に準拠していたとしてもです。

引数
引数
引数は関数への入力値です。関数名の後に括弧で囲んで指定します。

path
必須引数
必須引数
必須引数は、関数を呼び出す際に必ず指定しなければなりません。
位置引数
位置引数
位置引数は順序通りに指定することで、引数名を省略して設定できます。

埋め込まれるファイルのパス

常に指定する必要がありますが、 次の引数でデータが提供されていない場合にのみ読み取られます。

data
必須引数
必須引数
必須引数は、関数を呼び出す際に必ず指定しなければなりません。
位置引数
位置引数
位置引数は順序通りに指定することで、引数名を省略して設定できます。

任意で指定する生のファイルデータ。

この引数が指定されない場合、データは指定されたパスから読み取られます。

relationship
設定可能引数
設定可能引数
設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。

埋め込まれるファイルと文書との関係。

エクスポート対象がPDF/A-3でない場合は無視されます。

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

    PDF文書がそのソースファイルから作成されたことを示す。

  • data

    ファイルがPDFにおける視覚的表現を得るために使われたことを示す。

  • alternative

    文書の代替的な表現であることを示す。

  • supplement

    文書への追加のリソースであることを示す。

デフォルト値:

none

mime-type
設定可能引数
設定可能引数
設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。

埋め込まれるファイルのMIMEタイプ。

デフォルト値:

none

description
設定可能引数
設定可能引数
設定可能引数は、setルールを用いて設定でき、それ以降で使用するデフォルト値を変更できます。

埋め込まれるファイルの説明。

デフォルト値:

none

原文(英語)を開く

検索