web-dev-qa-db-ja.com

appindicatorのpythonバインディングに関する詳細なAPIドキュメントはありますか?

私は自分のプロジェクトに真剣に取り組んでおり、Pythonのappindicatorモジュールに関する優れたドキュメントが必要です。私がこれまでに見つけたもの:

  1. dev.ubuntu.comのAPIドキュメント
  2. コミュニティwikiエントリ
  3. CコードのAPIドキュメント
  4. 素敵なブログ投稿

それらの何が問題なのか:

  1. 引数、戻り値、およびメソッドの動作に関する説明のない単なるリスト
  2. 設計上の考慮事項と背景のみ-実際のプログラミングに役立つことはほとんどありません
  3. pythonモジュールがないもの(例:create_menu_from_desktop)
  4. 多くの有用な情報は圧縮されているが完全ではない

したがって、基本的には3ほど詳細なものが必要ですが、pythonモジュール用です。

私の問題の例:

void build_menu_from_desktop(desktop_file、desktop_profile)

想定される引数は何で、メソッドは何をしますか?私の推測では、このメソッドは「* .desktop」ファイルからメニューエントリを作成します。しかし、もしそうなら、なぜそのファイルよりも多くの引数が必要なのでしょうか?ファイルのどのエントリからメニュー項目を取得しますか?このような質問です。答えを見つけるのに少し苦労しています。

18
con-f-use

はい、適切な詳細レベルのPythonドキュメントが必要であることに気付きました。それが Giraffeプロジェクト の目標です。 GObject Introspectionバインディングで動作します。これは、新しいPythonアプリケーションを作成してアプリケーションインジケーターを使用する方法です。

それまでは、あなたが書き留めたAPIドキュメントが最善策です。 「python-ified」とはいえ、ほぼ同じです。

Build_menu_from_desktopは、そうでなければ nityのクイックリスト のようなものになるエントリをロードする便利な関数です。これらのエントリを取得するには、build_menu_from_desktop("/my/path/myfile.desktop", "Unity")を使用してTargetEnvironmentを指定します。

これにより、デスクトップファイルに異なるエントリを追加し、一部を重複させたり、重複させないことができます。

7
Ted Gould