Template:PDFlink/doc
表示
これはTemplate:PDFlinkの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
このテンプレートは、出典表記形式1や出典表記形式2のような出典テンプレートに用いるべきではありません。なぜなら、マークアップが含まれており、生成されるCOinSメタデータを書き換えてしまうからです(Wikipedia:COinSも参照)。 |
リンク先がPDF文書であることを示すのに使います。なぜなら閲覧環境によってはPDFは表示できません。利用しやすさに関するウェブアクセシビリティの1999年のガイドラインに適合しません。(W3C勧告の1998年のWeb Content Accessibility Guidelinesの11では、W3Cの技術を利用する)しかし、2008年のガイドライン2版に基づく、2012年の実装方法集(WCAG2.0実装方法集)では、PDFにはアクセシビリティが考慮できる機能が含まれていることが記されています。
このテンプレートは外部リンクアイコンをPDFアイコンに変更しますが、個人設定の「ガジェット」タブでアイコン変更を無効にできます。
使用方法
[編集]以下のように書くと、
{{PDFlink|[https://www.example.org/Link.pdf リンク]}} {{PDFlink|[https://www.example.org/Link.pdf リンク]|32 [[キビバイト|KiB]]}}
以下のようになります。
制限事項
[編集]出典テンプレート内ではCOinSメタデータを正しく生成できないため、使用しないでください。代わりに|format=PDF
のように指定します。
テンプレートは名前なしパラメータを使っているので、=
や|
を含むリンクは全く表示されなくなるでしょう。この制限を回避するには該当の文字をそれぞれ=
と|
のように間接的な文字参照に置き換えるか、=
を含むパラメータの場合番号付きパラメータ(1=
と2=
)にするか、|
を含むパラメータの場合マジックワード {{!}}を使ってください。
例:
{{PDFlink|[https://example.org/bla?a=xy|Link.pdf PDFへのリンク]|32KB}}
- 32KB (PDF)
{{PDFlink|[https://example.org/bla?a=xy|Link.pdf PDFへのリンク]|32KB}}
{{PDFlink|1=[https://example.org/bla?a=xy{{!}}Link.pdf PDFへのリンク]|2=32KB}}
TemplateData
[編集]PDF文書を参照するリンクを強調します。出典テンプレートでは使用しないでください。
パラメーター | 説明 | 型 | 状態 | |
---|---|---|---|---|
URLリンク | 1 | ウィキテキストのリンクの形式で記入します。
| 内容 | 必須 |
ファイルサイズ | 2 | ファイルサイズを表示することができます。
| 内容 | 省略可能 |