翻訳済み
このページは日本語に翻訳済みです。
embed
要素関数要素関数要素関数はset
ルールやshow
ルールでカスタマイズできます。
要素関数
要素関数は
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
埋め込まれるファイルと文書との関係。
エクスポート対象がPDF/A-3でない場合は無視されます。
使用可能な文字列値:
source
PDF文書がそのソースファイルから作成されたことを示す。
data
ファイルがPDFにおける視覚的表現を得るために使われたことを示す。
alternative
文書の代替的な表現であることを示す。
supplement
文書への追加のリソースであることを示す。
デフォルト値: none
mime-type
埋め込まれるファイルのMIMEタイプ。
デフォルト値: none