Both sides previous revisionPrevious revisionNext revision | Previous revision |
blog:2019-08-11:linking_and_viewing_pdfs [2019/08/11 15:01] – 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 PDFs in Dokuwiki. |
| |
| ===== External Links ===== |
| The first way to link to an external pdf is to use ''%%[[ ]]%%'' brackets as one would for links: |
| |
| ^Code ^Result^ |
| |''%%[[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]] | 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^ |
| |''%%{{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]] | ===== Internal Links ===== |
| These brackets also work for internal files that are stored on our server (like images): |
| ^Code ^Result^ |
| |''%%{{/howto/twometre.pdf |}}%%'' |{{/howto/twometre.pdf |}}| |
| |''%%{{/howto/twometre.pdf |Two Metre Repeaters}}%%'' |{{/howto/twometre.pdf |Two Meter Repeaters}}| |
| |
{{https://bcarcc.org/twometre.pdf}} | 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, |
| |
{{https://bcarcc.org/twometre.pdf|Two Metre Repeaters}} | {{pdfjs 600px,300px>/howto/twometre.pdf}} |
| |
| gives: |
| |
| {{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. |
| |