Both sides previous revisionPrevious revisionNext revision | Previous revision |
blog:2019-08-11:linking_and_viewing_pdfs [2019/08/11 15:28] – ve7hzf | howto:linking_and_viewing_pdfs [2020/08/07 13:03] (current) – external edit 127.0.0.1 |
---|
| ~~NOTOC~~ |
====== Linking and Viewing PDFs ====== | ====== Linking and Viewing PDFs ====== |
There are many ways to link, view, or create PDF in Dokuwiki. | There are many ways to link, view, or create PDFs in Dokuwiki. |
| |
===== External Links ===== | ===== External Links ===== |
The first way to link to an external pdf is to use ''%%[[ ]]%%'' brackets as one would for links: | The first way to link to an external pdf is to use ''%%[[ ]]%%'' brackets as one would for links: |
| |
|Code |Result| | ^Code ^Result^ |
|''%%[[https://bcarcc.org/twometre.pdf]]%%'' |[[https://bcarcc.org/twometre.pdf]]| | |''%%[[https://bcarcc.org/twometre.pdf]]%%'' |[[https://bcarcc.org/twometre.pdf]]| |
|''%%[[https://bcarcc.org/twometre.pdf|Two Metre Repeaters]]%%'' |[[https://bcarcc.org/twometre.pdf|Two Metre Repeaters]]| | |''%%[[https://bcarcc.org/twometre.pdf|Two Metre Repeaters]]%%'' |[[https://bcarcc.org/twometre.pdf|Two Metre Repeaters]]| |
| |
This works, but notice the "Earth" icon on the left of the link, identifying that it's a link to an external webpage. We can change this identifying icon to a PDF by using the ''%%{{ }}%%'' brackets instead, which are also used for images: | This works, but notice the "Earth" icon on the left of the link, identifying that it's a link to an external webpage. We can change this identifying icon to a PDF by using the ''%%{{ }}%%'' brackets instead, which are also used for images: |
|Code |Result| | ^Code ^Result^ |
|''%%{{https://bcarcc.org/twometre.pdf}}%%'' |{{https://bcarcc.org/twometre.pdf}}| | |''%%{{https://bcarcc.org/twometre.pdf}}%%'' |{{https://bcarcc.org/twometre.pdf}}| |
|''%%{{https://bcarcc.org/twometre.pdf|Two Metre Repeaters}}%%'' |{{https://bcarcc.org/twometre.pdf|Two Metre Repeaters}}| | |''%%{{https://bcarcc.org/twometre.pdf|Two Metre Repeaters}}%%'' |{{https://bcarcc.org/twometre.pdf|Two Metre Repeaters}}| |
===== Internal Links ===== | ===== Internal Links ===== |
These brackets also work for internal files that are stored on our server (like images): | These brackets also work for internal files that are stored on our server (like images): |
|Code |Result| | ^Code ^Result^ |
|''%%{{:blog:2019-08-11:twometre.pdf |}}%%'' |{{:blog:2019-08-11:twometre.pdf |}}| | |''%%{{/howto/twometre.pdf |}}%%'' |{{/howto/twometre.pdf |}}| |
|''%%{{:blog:2019-08-11:twometre.pdf |Two Metre Repeaters}}%%'' |{{:blog:2019-08-11:twometre.pdf |Two Meter Repeaters}}| | |''%%{{/howto/twometre.pdf |Two Metre Repeaters}}%%'' |{{/howto/twometre.pdf |Two Meter Repeaters}}| |
| |
| Using the [[https://www.dokuwiki.org/plugin:pdfjs |PDF.js Plugin]], it's also possible to display a local pdf in a window. For example, |
| |
{{pdfjs 600px,300px>:blog:2019-08-11:twometre.pdf}} | {{pdfjs 600px,300px>/howto/twometre.pdf}} |
| |
[[/blog/2019-08-11/linking_and_viewing_pdfs?do=export_pdf |Export This Page to PDF]] | gives: |
| |
[[mpdf>/blog/2019-08-11/linking_and_viewing_pdfs |Export This Page to PDF]] | {{pdfjs 600px,300px>/howto/twometre.pdf}} |
| |
| Note, that the width (''600px'') and length (''300px'') parameters are optional. Also, this doesn't work with external links. |
| |
| |
| ===== Export Page To PDF ===== |
| {{ /howto/exporttopdf.png}}Finally, thanks to the [[https://www.dokuwiki.org/plugin:dw2pdf |DW2PDF Plugin]], Dokuwiki pages can be easily exported as PDFs using the PDF icon on the right hand side of the page. |
| |
| Sometimes, it is useful to add an Export link in the text. This can be done by adding ''?do=export_pdf'' at the end of a URL. Quick caveat: counter intuitively, this time, the ''%%[[ ]]%%'' brackets must be used: |
| |
| ^Code ^Result ^ |
| |''%%[[/howto/linking_and_viewing_pdfs?do=export_pdf |Export This Page to PDF]]%%'' |[[/howto/linking_and_viewing_pdfs?do=export_pdf|Export This Page to PDF]]| |
| |
| But to simplify this process further and add the fancy PDF icon, I manually added ''mpdf'' -> ''%%{NAME}?do=export_pdf%%'' to the InterWiki Links configuration file with the PDF icon so that this can be used instead: |
| ^Code ^Result ^ |
| |''%%[[mpdf>/howto/linking_and_viewing_pdfs |Export This Page to PDF]]%%'' |[[mpdf>/howto/linking_and_viewing_pdfs |Export This Page to PDF]]| |
| |
| Or, if the page to export is the one containing the link, this works too: |
| ^Code ^Result ^ |
| |''%%[[mpdf>|Export This Page to PDF]]%%'' |[[mpdf>|Export This Page to PDF]]| |
| |
| When writing a page that will likely get exported, it's useful to be able to manually start a new page. The [[https://www.dokuwiki.org/plugin:pagebreak |Pagebreak Plugin]] allows this using ''%%<pagebreak>%%''. |
| |
| The best example of this is the [[/ecomm/scec |Sunshine Coast Emergency Communications]] page, which was created to be printed. |
| |
| ===== Plugins ===== |
| A full list of all installed plugins can be found at the end of the [[howto:syntax#syntax_plugins|Syntax]] page. |
| |
[[mpdf>|Export This Page to PDF]] | |