Phabricator のプロジェクト名 #Electron-PDFs
Extension:ElectronPdfService
Jump to navigation
Jump to search
 リリースの状態: ベータ | |
|---|---|
| |
| 実装 | User interface |
| 説明 | ブラウザベースの PDF レンダリング機能エレクトロン・サービスにアクセスを提供 |
| 作者 | Wikimedia Germany (WMDE) – Roadmap |
| 最新バージョン | continuous updates |
| 互換性ポリシー | リリースブランチ |
| MediaWiki | 1.25+ |
| データベースの変更 | いいえ |
| ライセンス | GNU General Public License 2.0 or later |
| ダウンロード | |
|
translatewiki.net で翻訳を利用できる場合は、ElectronPdfService 拡張機能の翻訳にご協力ください | |
| 使用状況とバージョン マトリクスを確認してください。 | |
| 未解決のタスク · バグを報告 | |
ElectronPdfService 拡張機能はブラウザベースの PDF レンダリング機能エレクトロン・サービスにアクセスを提供します（ エレクトロン・サービスを別途インストールする必要があります）。
説明
この拡張機能は RESTBase APIの接続ポイントを通じてエレクトロン・サービスにアクセスするための便利な方法を提供します。エレクトロン・サービスはウィキページの内容をPDFファイルに変換する新たな手法で、既存の OCG/LaTeXを使った変換に代わるものです。生成されたPDFファイルには情報ボックスやその他のテンプレートだけでなくすべてのテーブルまでを含むことができるのが、エレクトロン・サービスを使う大きな利点です。より詳しくは この拡張機能とサービスを開発する動機付けとなった背景をご覧ください。
事例を紹介します。「Berlin」の記事から生成した PDF。
インストール
- RESTBase 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/';
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
使用法
- 拡張機能のインストールが完了すると MediaWiki のサイドバーにできた「PDF としてダウンロード」のリンクから、新しい窓が開きます。
- PDF の出力にエレクトロンを利用するか (「1段組」) もしくは旧来のレンダリング機能 OCG/LaTeX (「2段組」) を使うか選択します。
- 使いたい方式を選んだら「ダウンロード」ボタンを押して PDF を出力します。
- 注：ウィキにレンダリング方式の選択肢がない場合は「PDF としてダウンロード」ボタンを押すと出力書式の選択画面を表示せず、エレクトロンで PDF を生成します。
リンク
 | この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。 これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。 この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。 特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。 |
