タグ:PukiWiki, SEの良心, PukiWiki改造計画, レスポンシブデザイン対応, スマホ対応, PDF.js, Mozilla Firefox, PDFビューア, プラグイン, 表示幅指定, アライメント指定, 左寄せ, 中央寄せ, 右寄せ, アスペクト比自動調整, サンプル, 参照記事
2025/02/25 (火) 更新
PukiWiki用PDFビューアプラグイン
概要
- 正式公開版です(PukiWiki1.5.3で動作確認済)
- 本プラグインは、Adobe Acrobat Readerがインストールされていないパソコン・タブレット・スマホでPDFファイルの閲覧とダウンロードを可能にし、特にスマホユーザの利便性とユーザビリティを向上させます
- PDFビューア部分はMozillaが開発元となってブラウザのFirefoxに内蔵しているPDF.jsの最新版(v4.10.38:2025年01月01日リリース)を採用し、独自に構成してプラグイン化しています
- プラグインはブロック型とインライン型に対応しており、自ページ表示(「page」オプション指定時)の場合はビューアを任意の幅とアライメント(左寄せ・中央寄せ・右寄せ)指定で表示させることが可能で、ビューアの高さは縦表示(デフォルト「tate」指定)と横表示(オプション「yoko」指定)により、プラグイン設定のアスペクト比で自動調整し、レスポンシブ表示します
- 全画面表示(デフォルト「full」指定)の場合は別タブでPDFファイルを表示しますが、全画面表示させるウィンドウはプラグインの設定で変更することも可能です
- ダウンロード禁止(オプション「nodl」指定)により、PDFファイルのダウンロードと印刷による実質的なダウンロードを禁止できます(デフォルト値をプラグインの設定で指定可能)
- 本プラグインの導入には、次のモジュールの導入が前提となります
- 設置と設定に関しては、メインサイトの記事「PukiWikiにPDFビューアをブチ込んでスマホユーザに優しくしてやる!」(仮称・執筆予定)を参照して下さい
- 本バージョンはオンラインサロン会員(PukiWiki開発基本会員以上)向けですが、オンラインストアでも販売しています
- 本アーカイブのライセンスはGPL version 2またはそれ以降で、ライセンスが定める諸条件の範囲において個人・法人内部で自由に利用・改変が可能ですが、著作権者の不利益に該当するあらゆる行為はライセンスに関係なく禁止とします
変更履歴
- 2025/02/25 Ver1.2.0
- PDFファイルのダウンロード禁止設定追加
- PDF.js v4.10.38対応
- 2022/10/02 Ver1.1.1
- 2022/09/01 Ver1.1.0
- 2022/01/26 Ver1.0.0
ブロック型
自ページ表示 デフォルト指定(表示幅720px・左寄せ・縦表示)
#pdf_viewer(2021_日本ウイグル協会チラシ.pdf,page)
自ページ表示 表示幅70%・中央寄せ・横表示指定
#pdf_viewer(./2015_御坂峠天下茶屋リーフレット.pdf,page,width=70%,center,yoko)
全画面表示(「full」省略可)
#pdf_viewer(2021_日本ウイグル協会チラシ.pdf,2021年 日本ウイグル協会チラシ)
refプラグイン(PDFビューアプラグイン対応拡張)
#ref(./2021_日本ウイグル協会チラシ.pdf,2021年 日本ウイグル協会チラシ)
インライン型
全画面表示(デフォルトで別タブ表示)
- &pdf_viewer(2021_日本ウイグル協会チラシ.pdf){2021年 日本ウイグル協会チラシ};
- &pdf_viewer(./2015_御坂峠天下茶屋リーフレット.pdf){2015年 御坂峠天下茶屋リーフレット};
refプラグイン(PDFビューアプラグイン対応拡張)
- &ref(./2021_日本ウイグル協会チラシ.pdf,2021年 日本ウイグル協会チラシ);
refプラグイン+PDFビューアプラグイン(表示幅720px・左寄せ・横表示)
- &ref(./2015_御坂峠天下茶屋リーフレット.pdf){2015 御坂峠天下茶屋リーフレット};&br;&pdf_viewer(./2015_御坂峠天下茶屋リーフレット.pdf,page,yoko);
ダウンロード(印刷)禁止
オプション「nodl=true」(単に「nodl」と省略可)を指定すると、ダウンロードボタンと印刷ボタンを非表示にします(印刷からPDFを保存することが可能なため印刷も禁止)。
ダウンロード禁止設定のデフォルトはPukiWikiダジャレンジャー版設定ファイル(PukiWikiダジャレンジャー版共通ファイルに同梱)で設定が可能なため、いちいち「nodl」と指定しなくても良いように設計してあります。
- PLUGIN_PDF_VIEWER_NODL = false
- ダウンロードさせたくないPDFにのみ「nodl」指定をする
- PLUGIN_PDF_VIEWER_NODL = true
- ダウンロードさせたくないPDFに「nodl」指定が不要
- ダウンロードを許可するPDFにだけ「nodl=false」指定をする
ダンロード禁止設定の有無に関係なく、PDFを全画面表示させた場合のダウンロード(Ctrl+S)と印刷(Ctrl+P)のショートカットキーをプログラム側で無効にしています。
しかしながら、保存(Ctrl+S)と印刷(Ctrl+P)はブラウザ側でキーフックしているため、本プラグインでは手が出せません。
ブラウザごとの動作は次の表を参照して下さい。
ショートカットキー | Chrome | Edge | Firefox | Opera | Brave | Vivaldi | 備考 |
Ctrl+S | ◯ | ◯ | ◯ | ◯ | ◯ | - | 「名前を付けて保存」ダイアログは出るがPDFとして保存は出来ない(HTMLとしてページ保存になる) |
Ctrl+P | △ | △ | △ | △ | △ | - | プリンター(出力先)に「PDFとして保存」を選択すると画面のキャプチャのみPDFとして保存が出来る |
※ブラウザ「Vivaldi」はそもそも本プラグインが動作しない
なお、本プラグインはページに添付されているPDFファイルを表示するPukiWiki専用ビューアのため、WordPressその他のようにURLを直打ちしてもPDFのダウンロードは出来ません。
ゆえに会社等でPDFを共有する場合、本プラグインを使わず単にPDFファイルを添付しただけだとダウンロードが可能で、情報漏えいの危険性があります。
ブロック型:自ページ表示 デフォルト指定(表示幅720px・左寄せ・縦表示)
#pdf_viewer(2021_日本ウイグル協会チラシ.pdf,page,nodl)
ブロック型:自ページ表示 表示幅70%・中央寄せ・横表示指定
#pdf_viewer(./2015_御坂峠天下茶屋リーフレット.pdf,page,width=70%,center,yoko,nodl)
ブロック型:全画面表示(「full」省略可)
#pdf_viewer(2021_日本ウイグル協会チラシ.pdf,2021年 日本ウイグル協会チラシ,nodl)
インライン型:全画面表示(デフォルトで別タブ表示)
- &pdf_viewer(2021_日本ウイグル協会チラシ.pdf,nodl){2021年 日本ウイグル協会チラシ};
参照記事
- ダウンロード
- PukiWikiにPDFビューアをブチ込んでスマホユーザに優しくしてやる!(仮称・執筆予定)

内部リンクであっても、別窓(target="_blank")でリンクを表示する場合に外部リンクマーク「
」を表示する(従来はpukiwiki.skin.php内のjQueryコードで外部サイトへの外部リンクマークの表示を無差別に処理していたが、仕様として正式に取り入れた)。
これにより、リンクが自窓で表示されるのか、別窓で表示されるのかを統一仕様としてサイト訪問者に明示する。
人気上位6ページ
今日の人気上位6ページ