Extension:ElectronPdfService

MediaWiki 拡張機能マニュアルManual:Extensions

Extension:ElectronPdfService リリースの状態:Extension status ベータ
実装Template:Extension#type	User interface
説明Template:Extension#description	ブラウザベースの PDF レンダリング機能エレクトロン・サービスにアクセスを提供
作者Template:Extension#username	Wikimedia Germany (WMDE) – Roadmap
最新バージョンTemplate:Extension#version	continuous updates
互換性ポリシーCompatibility#mediawiki_extensions	リリースブランチ
MediaWikiTemplate:Extension#mediawiki	1.25+
データベースの変更Template:Extension#needs-updatephp	いいえ
ライセンスTemplate:Extension#license	GNU General Public License 2.0 or later
ダウンロード	スナップショットをダウンロード (Git master) Git [?]: リポジトリの要約 (Phabricator) ファイル ツリーの参照 (GitHub) コミット履歴 コード レビュー
translatewiki.net で翻訳を利用できる場合は、ElectronPdfService 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
問題点Phabricator	未解決のタスク · バグを報告

ElectronPdfService 拡張機能はブラウザベースの PDF レンダリング機能エレクトロン・サービスにアクセスを提供します（ エレクトロン・サービスを別途インストールする必要があります）。

説明

この拡張機能は RESTBase APIの接続ポイントを通じてエレクトロン・サービスにアクセスするための便利な方法を提供します。エレクトロン・サービスはウィキページの内容をPDFファイルに変換する新たな手法で、既存の OCG/LaTeXを使った変換に代わるものです。生成されたPDFファイルには情報ボックスやその他のテンプレートだけでなくすべてのテーブルまでを含むことができるのが、エレクトロン・サービスを使う大きな利点です。より詳しくは この拡張機能とサービスを開発する動機付けとなった背景をご覧ください。

事例を紹介します。「Berlin」の記事から生成した PDF。

インストール

• RESTBaseRESTBase APIの接続ポイントで公開されているエレクトロン・サービスをインストールし、設定する。
  • Follow the service install instructions & verify correct functioning with http://yourhost:port/pdf?accessKey=yourkey&url=https://de.wikipedia.org/wiki/Berlin
  • Install https://github.com/wikimedia/restbase, and set up a config similar to config.example.wikimedia.yaml. Adjust the pdf server URL to reflect your host & port.
• ダウンロードして、ファイルを extensions/ フォルダー内の ElectronPdfService という名前のディレクトリ内に配置します。

• 以下のコードを LocalSettings.php の末尾に追加します:

  wfLoadExtension( 'ElectronPdfService' );
  $wgElectronPdfServiceRESTbaseURL = '/api/rest_v1/page/pdf/';
  

• Y 完了 - ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

使用法

• 拡張機能のインストールが完了すると MediaWiki のサイドバーにできた「PDF としてダウンロード」のリンクから、新しい窓が開きます。
• PDF の出力にエレクトロンを利用するか (「1段組」) もしくは旧来のレンダリング機能 OCG/LaTeX (「2段組」) を使うか選択します。
• 使いたい方式を選んだら「ダウンロード」ボタンを押して PDF を出力します。
• 注：ウィキにレンダリング方式の選択肢がない場合は「PDF としてダウンロード」ボタンを押すと出力書式の選択画面を表示せず、エレクトロンで PDF を生成します。

リンク

• エレクトロン・サービスの説明文書
• RESTBase API 説明文書
• OCG 説明文書
• PDF の事例「Berlin」