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


18

私は自分のプロジェクトに真剣に取り組んでおり、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」ファイルからメニューエントリを作成します。しかし、もしそうなら、なぜそのファイルよりも多くの引数が必要なのでしょうか?ファイルのどのエントリからメニュー項目を取得しますか?このような質問です。答えを見つけるのに少し苦労しています。


2
リンク1と3は機能しません。
マットジョイナー

2
...もう...
CON-F-使用

回答:


7

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

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

build_menu_from_desktopは、Unityのクイックリストのようなものになるエントリをロードする便利な関数です。したがってbuild_menu_from_desktop("/my/path/myfile.desktop", "Unity")、TargetEnvironmentを指定するために使用するエントリを取得するには。

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


それについての答え。お時間をいただきありがとうございます。そもそもdocstringsやdoxygenを使わないのですか?
con-f-use

1
gtk-docを使用しています。基本的に同じこと。ただし、バインディングにまだ転送されていません。
テッドグールド

1
メニューを取得してそこで変更することもできますが、お勧めしません。それらを異なるものにする必要がある場合は、通常の方法でメニューを作成するだけです。実際、関数は、同じものにする場合にのみヘルパーになることを目的としています。
テッドグールド

1
ただ、キリンとqucklists上の任意の更新がそこにいるかどうかを確認したかった...
CON-F-使用

1
この状態はどうですか?グーグル可能なAppIndicator APIのドキュメントリンクがすべて壊れているのはなぜですか?生きているものは1つありますか?
ウリトコ
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.