Macros/Python Guide/Introduction/ja

目次に戻る

= はじめに =

PyUNOとは
LibreOfficeでは、マクロをいくつかのスクリプト言語で記述できますが、その中の1つがPythonです. PyUNOは、Pythonを使ってLibreOfficeのAPI(Application Programming Interface)にアクセスするためのコンポーネントです.

インストール
Ubuntu 18.04 LTSなどのOSでは、追加のパッケージをインストールの必要があります. Ubuntuでパッケージは、libreoffice-script-provider-pythonと呼ばれ、scriptproviderforpython.rdb (XMLメタデータ) や pythonscript.py (Pythonインフラストラクチャ) などのファイルが含まれています.


 * Ubuntu 18.04以上の場合

Pythonマクロが利用可能かをテストする
Writerで新規に文書を作成します. メニューから を選択すると「マクロセレクタ−」ダイアログが開きます. セクションからを選択し、セクションからを選択して、ボタンをクリックします.

この結果が表示されれば、お使いのシステムでPythonマクロが実行できます.



マクロはどこに保存されますか?
LibreOfficeには、Pythonスクリプト編集用の内蔵エディタがないのでエディタを用意する必要があります. マクロを置ける場所は3つあります.

ユーザープロファイルフォルダー/ユーザーのみが利用できるマクロ

 * GNU/Linux: /home/USER/.config/libreoffice/4/user/Scripts/python
 * Windows: %APPDATA%\LibreOffice\4\user\Scripts\python
 * macOS: ~/Library/Application Support/LibreOffice/4/user/Scripts/python/

LibreOfficeのディレクトリ/すべてのユーザーが利用できるマクロ
/usr/lib/libreoffice/share/Scripts/python/
 * GNU/Linux

上のパスはデフォルトです. カスタムインストールでは、これらと異なる場合があります. フォルダが存在しない場合は、大文字と小文字を区別して作成の必要があります.

ドキュメント組み込みマクロ

 * ODFファイルの実態はZIPファイルなので、ZIPファイルの展開と同じようにODFファイルを展開できます. ルートには Scripts/python/ フォルダを作成します. そしてその中に mymacros.py のようなpythonファイルをコピーします.
 * こちらも見てください

myfile |  ...  ├── META-INF │  └── manifest.xml ├── Scripts │  └── python │      └── mymacros.py  ...


 * META-INFフォルダにあるmanifest.xmlファイルを編集して、の直前に以下の行を追加します.


 * 最終的にファイルは以下のようになります.


 * 再度、zipでフォルダーを圧縮してください. 注意: フォルダーをzip圧縮するのではなく、フォルダーの中身をzip圧縮してください.

目次に戻る