틀:PDFlink/설명문서

이 문서는 틀:PDFlink에 대한 설명입니다.
여기에는 틀 사용법, 분류 등 원래의 틀 문서에는 포함되지 않는 내용을 담고 있습니다.

This template highlights that a link points to a PDF document (on some systems PDF files may take time to download and display within the browser, and their use on many websites is not compliant with the Web Content Accessibility Guidelines).

Usage

The following lines:

{{PDFlink|[http://www.example.org/Link.pdf Link]}}
{{PDFlink|[http://www.example.org/Link.pdf Link]|32&nbsp;KB}}
{{PDFlink|[http://www.example.org/Link.pdf Link]|32&nbsp;[[KiB]]}}

yield:

Link (PDF)

Link (PDF, 32 KB)

Link (PDF, 32 KiB)

Note: It was previously possible to add the icon with {{PDFlink}} by itself, but the functionality has changed, making this no longer work in Internet Explorer. You must surround it with the template as shown above to work correctly in Internet Explorer.

PDFbot

An unassisted bot (User:PDFbot) has been created to add and keep file size information current. In addition, it will fix many mistakes and the limitation as described in the section below.

Note: the bot will replace the contents of the second parameter when updating the file size.

Limitations

As this template uses unnamed parameters links containing = or | will cause the link to not display at all. The workaround is to either replace the entity with an indirect character reference as = and |, respectively, or to use the numbered parameter (1= and 2=) for each parameter to take care of =, or to use {{!}} to take care of |.

Examples:

{{PDFlink|[http://example.org/bla?a=xy|Link.pdf Link to a PDF]|32KB}}
- 32KB (PDF)

{{PDFlink|[http://example.org/bla?a=xy|Link.pdf Link to a PDF]|32KB}}
- Link to a PDF (PDF, 32KB)

{{PDFlink|1=[http://example.org/bla?a=xy{{!}}Link.pdf Link to a PDF]|2=32KB}}
- Link to a PDF (PDF, 32KB)