<<O>>  Difference Topic EmbedPDFPlugin (r1.5 - 11 Oct 2005 - BruceDawson)

EmbedPDFPlugin

Many browsers can show PDF documents embedded just like pictures within HTML documents using the <embed> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.

Line: 39 to 39
    • Set SHORTDESCRIPTION = embed PDF document in TWiki page

  • Debug plugin: (See output in data/debug.txt)
Changed:
<
<
    • Set DEBUG = 1
>
>
    • Set DEBUG = 0

  • Create a link under every embedded PDF file with the specified link text if set (useful for browser that don't know how to embed PDF):
    • Set LINKTEXT = (click here to display this PDF file by itself)
Line: 62 to 62
    • Edit this page on your local TWiki installation and change the &lt; and &gt; three lines down to < and > to enable the <EMBED /> tag.
    • The following two pictures should then look the same (assuming you have a PDF plugin installed in your browser)
Changed:
<
<
      • hard coded embed tag
        <embed SRC="http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf" width="216" height="31" />
>
>
      • hard coded embed tag

 <<O>>  Difference Topic EmbedPDFPlugin (r1.4 - 25 Mar 2003 - JohannesMartin?)

EmbedPDFPlugin

Many browsers can show PDF documents embedded just like pictures within HTML documents using the <embed> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.

Line: 62 to 62
    • Edit this page on your local TWiki installation and change the &lt; and &gt; three lines down to < and > to enable the <EMBED /> tag.
    • The following two pictures should then look the same (assuming you have a PDF plugin installed in your browser)
Changed:
<
<
      • hard coded embed tag
        <EMBED SRC="http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf" WIDTH="216" HEIGHT="31" />
>
>
      • hard coded embed tag
        <embed SRC="http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf" width="216" height="31" />

Line: 81 to 81
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/EmbedPDFPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/EmbedPDFPluginDev
Changed:
<
<		 Related Topics: TWikiPreferences, TWikiPlugins
>
>		 Related Topics: TWiki:Plugins.EmbedPDFPluginDev, TWikiPreferences, TWikiPlugins

META FILEATTACHMENT pdf.pdf attr="" comment="" date="1046959644" path="pdf.pdf" size="6019" user="JohannesMartin" version="1.2"
META FILEATTACHMENT pdf-prerendered.jpg attr="" comment="" date="1048518399" path="pdf-prerendered.jpg" size="3727" user="JohannesMartin" version="1.1"
 <<O>>  Difference Topic EmbedPDFPlugin (r1.3 - 24 Mar 2003 - JohannesMartin?)

EmbedPDFPlugin

Many browsers can show PDF documents embedded just like pictures within HTML documents using the <embed> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.

Line: 44 to 44
  • Create a link under every embedded PDF file with the specified link text if set (useful for browser that don't know how to embed PDF):
    • Set LINKTEXT = (click here to display this PDF file by itself)
Added:
>
>
  • Check whether a prerendered image of the PDF file with the specified extension is available, and if so, embed the image rather than the PDF file itself:
    • Set PRERENDERED = jpg

Plugin Installation Instructions

Note: You do not need to have a PDF plugin installed in your browser for this plugin to be useful.install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

Line: 62 to 65
Added:
>
>

Plugin Info

Line: 80 to 84

 Related Topics: TWikiPreferences, TWikiPlugins

META FILEATTACHMENT pdf.pdf attr="" comment="" date="1046959644" path="pdf.pdf" size="6019" user="JohannesMartin" version="1.2"
Added:
>
>
META FILEATTACHMENT pdf-prerendered.jpg attr="" comment="" date="1048518399" path="pdf-prerendered.jpg" size="3727" user="JohannesMartin" version="1.1"

META TOPICMOVED JohannesMartin? date="1046961697" from="TWiki.PDFSizePlugin" to="TWiki.EmbedPDFPlugin"
 <<O>>  Difference Topic EmbedPDFPlugin (r1.2 - 07 Mar 2003 - JohannesMartin?)

EmbedPDFPlugin

Changed:
<
<		 Many browsers can show PDF documents embedded just like pictures within HTML documents using the <EMBED> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.
>
>		 Many browsers can show PDF documents embedded just like pictures within HTML documents using the <embed> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.

Changed:
<
<		 This plugin adds %EMBEDPDF{...}% and %EMBEDPDFSIZE{...}% variables. These variables are helpful for embedding PDF documents in TWiki webs. %EMBEDPDF{...}% will create an <EMBED> HTML tag to show the specified PDF file in a reasonable size (as specified within that PDF file). %EMBEDPDFSIZE{...}% will expand to the width and height of the file.
>
>		 This plugin adds %EMBEDPDF{...}% and %EMBEDPDFSIZE{...}% variables. These variables are helpful for embedding PDF documents in TWiki webs. %EMBEDPDF{...}% will create an <embed> HTML tag to show the specified PDF file in a reasonable size (as specified within that PDF file). %EMBEDPDFSIZE{...}% will expand to the width and height of the file.

Caution

Line: 23 to 23

Assume that test.pdf has a height of 40 points and a width of 100 points. Then:

  • %EMBEDPDF{ test }% expands to
Changed:
<
<		 <EMBED SRC="%ATTACHURL%/test" WIDTH="100" HEIGHT="40">, and
>
>		 <embed src="%ATTACHURL%/test" width="100" height="40">, and

  • %EMBEDPDFSIZE{ test }% expands to
Changed:
<
<		 WIDTH="100" HEIGHT="40"
>
>		 width="100" height="40"

Note that the .pdf extension is automatically added to the attachment name.
Added:
>
>		 The plugin checks the user agent setting reported by your browser to detect IE. For IE, the width and height will be enlarged since IE displays the PDF viewer controls within the HTML document along with the PDF document itself.

EmbedPDFPlugin Global Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%

Line: 38 to 41
  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 1
Added:
>
>
  • Create a link under every embedded PDF file with the specified link text if set (useful for browser that don't know how to embed PDF):
    • Set LINKTEXT = (click here to display this PDF file by itself)

Plugin Installation Instructions

Note: You do not need to have a PDF plugin installed in your browser for this plugin to be useful.install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

Line: 53 to 59
    • Edit this page on your local TWiki installation and change the &lt; and &gt; three lines down to < and > to enable the <EMBED /> tag.
    • The following two pictures should then look the same (assuming you have a PDF plugin installed in your browser)
Changed:
<
<
      • hard coded embed tag
        <EMBEDX SRC="http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf" WIDTH="216" HEIGHT="31" />
>
>
      • hard coded embed tag
        <EMBED SRC="http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf" WIDTH="216" HEIGHT="31" />

Line: 61 to 67

Plugin Info

Plugin Author: TWiki:Main/JohannesMartin
Changed:
<
<
Plugin Version: 06 Mar 2003 (V1.000)
>
>
Plugin Version: 06 Mar 2003 (V1.001)

Change History: <!-- versions below in reverse order --> 
Added:
>
>
07 Mar 2003: added support for IE and link text

06 Mar 2003: Initial version
CPAN Dependencies: none
Other Dependencies: none
 <<O>>  Difference Topic EmbedPDFPlugin (r1.1 - 06 Mar 2003 - JohannesMartin?)
Line: 1 to 1
Added:
>
>

EmbedPDFPlugin

Many browsers can show PDF documents embedded just like pictures within HTML documents using the <EMBED> HTML tag. Unfortunately, they are usually unable to detect the preferred (screen) size and aspect ratio of the PDF document and display only a little unreadable thumbnail version of the PDF file.

This plugin adds %EMBEDPDF{...}% and %EMBEDPDFSIZE{...}% variables. These variables are helpful for embedding PDF documents in TWiki webs. %EMBEDPDF{...}% will create an <EMBED> HTML tag to show the specified PDF file in a reasonable size (as specified within that PDF file). %EMBEDPDFSIZE{...}% will expand to the width and height of the file.

Caution

  1. This plugin read files from your disk using TWiki::Func::readFile(). It may be possible for an attacker to gain access to arbitrary files on your disk. I have taken some simple precautions to prevent this, but I'm not sure whether they are sufficient.
  2. TWiki may run out of memory if the PDF file referenced is very large. It is mainly intended for small single-page PDF files.

You might want to restrict write access to your Web to prevent intruders from exploiting possible vulnerabilities. I do not think exploits are possible through read-only access. Use at your own risk.

Syntax Rules

  • %EMBEDPDF{ <filename> }%
  • %EMBEDPDFSIZE{ <filename> }%
    • <filename> is the file name of an attachment of the current topic.

Examples

Assume that test.pdf has a height of 40 points and a width of 100 points. Then:

  • %EMBEDPDF{ test }% expands to
    <EMBED SRC="%ATTACHURL%/test" WIDTH="100" HEIGHT="40">, and
  • %EMBEDPDFSIZE{ test }% expands to
    WIDTH="100" HEIGHT="40"
Note that the .pdf extension is automatically added to the attachment name.

EmbedPDFPlugin Global Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = embed PDF document in TWiki page

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 1

Plugin Installation Instructions

Note: You do not need to have a PDF plugin installed in your browser for this plugin to be useful.install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.

  • Download the ZIP file from the Plugin web (see below)
  • Unzip EmbedPDFPlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/EmbedPDFPlugin.txt Plugin topic
    data/TWiki/EmbedPDFPlugin.txt,v Plugin topic repository
    data/TWiki/EmbedPDFPlugin/pdf.pdf Sample pdf file
    lib/TWiki/Plugins/EmbedPDFPlugin.pm Plugin Perl module
  • Test if the installation was successful:
    • Edit this page on your local TWiki installation and change the &lt; and &gt; three lines down to < and > to enable the <EMBED /> tag.
    • The following two pictures should then look the same (assuming you have a PDF plugin installed in your browser)
    • The width and height of http://wiki.gnhlug.org/twiki2/pub/TWiki/EmbedPDFPlugin/pdf.pdf as determined by %EMBEDPDFSIZE{ pdf }% are as follows:
      • width="216" height="31"

Plugin Info

Plugin Author: TWiki:Main/JohannesMartin
Plugin Version: 06 Mar 2003 (V1.000)
Change History: <!-- versions below in reverse order --> 
06 Mar 2003: Initial version
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.080
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/EmbedPDFPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/EmbedPDFPluginDev

Related Topics: TWikiPreferences, TWikiPlugins

META FILEATTACHMENT pdf.pdf attr="" comment="" date="1046959644" path="pdf.pdf" size="6019" user="JohannesMartin" version="1.2"
META TOPICMOVED JohannesMartin? date="1046961697" from="TWiki.PDFSizePlugin" to="TWiki.EmbedPDFPlugin"
View topic | Diffs | r1.5 | > | r1.4 | > | r1.3 | More
Revision r1.1 - 06 Mar 2003 - 09:00 - JohannesMartin?
Revision r1.5 - 11 Oct 2005 - 13:24 - BruceDawson