.

Template:PDF/doc

Wikicars, a place to share your automotive knowledge
< Template:PDF
Revision as of 08:34, 20 March 2007 by Mac (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Template:Template doc page viewed directly


Purpose

Highlighting 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;[[KiB]]}}

yield:

Template:PDFlink
Template:PDFlink

Note: It was previously possible to add the icon with {{PDFlink}} by itself, but the functionality has been 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.

Robot

PDFbot will come around once a month and attempt to add or update the filesize information for all instances of this template.

Limitations

As the template uses unnamed parameters, links containing = or | will cause the link to not display at all. The workarounds to this limitation are to replace the entity with an indirect character reference as &#61; and &#124;, respectively, or to use the numbered parameter (1= and 2=) for each parameter to take care of =, or to use Template:! to take care of |.

Examples:

  • {{PDFlink|[http://example.org/bla?a=xy|Link.pdf Link to a PDF]|32KB}}
  • {{PDFlink|[http://example.org/bla?a&#61;xy&#124;Link.pdf Link to a PDF]|32KB}}
  • {{PDFlink|1=[http://example.org/bla?a=xy{{!}}Link.pdf Link to a PDF]|2=32KB}}

See also