Apakah ada dokumentasi API terperinci tentang pengikat python untuk appindicator?

18

Saya mendapatkan serous dengan proyek saya sendiri dan memerlukan dokumentasi yang baik pada modul appindicator untuk python. Apa yang saya temukan sejauh ini:

  1. Dokumentasi API di dev.ubuntu.com
  2. Entri wiki komunitas
  3. Dokumentasi API pada kode C.
  4. Posting blog yang bagus

apa yang salah dengan mereka:

  1. Hanya daftar tanpa penjelasan tentang argumen, pengembalian dan apa metode yang dilakukan
  2. Hanya pertimbangan desain dan latar belakang - sedikit yang akan membantu pemrograman yang sebenarnya
  3. Hal-hal yang hilang dari modul python (mis. Create_menu_from_desktop)
  4. Banyak informasi bermanfaat yang dikompres tetapi tidak lengkap

Jadi pada dasarnya saya membutuhkan sesuatu yang sedetail 3. tetapi untuk modul python.

Contoh tentang masalah saya:

membatalkan build_menu_from_desktop (desktop_file, desktop_profile)

Apa argumen yang seharusnya dan apa yang dilakukan metode ini? Dugaan saya adalah, metode ini membuat entri menu dari file '* .desktop'. Tetapi jika demikian, mengapa perlu lebih banyak argumen daripada hanya file itu? Entri mana dalam file yang mengambil item menu? Ini pertanyaan seperti ini. Saya mengalami sedikit kesulitan untuk menemukan jawaban.

membingungkan
sumber
2
Tautan 1 dan 3 tidak berfungsi.
Matt Joiner
2
... lagi ...
con-f-use

Jawaban:

7

Ya, kami menyadari bahwa kami membutuhkan dokumentasi Python dengan tingkat detail yang sesuai. Itulah tujuan dari proyek Giraffe . Ini akan bekerja dengan binding Introspeksi GObject yang merupakan cara aplikasi Python baru harus ditulis untuk menggunakan indikator aplikasi.

Sampai saat itu, taruhan terbaik adalah dokumentasi API yang telah Anda catat. Seharusnya kira-kira sama meskipun "python-ified".

Build_menu_from_desktop adalah fungsi kenyamanan menggunakan memuat entri yang seharusnya ada dalam sesuatu seperti quicklist di Unity . Jadi untuk mendapatkan entri yang akan Anda gunakan build_menu_from_desktop("/my/path/myfile.desktop", "Unity")untuk menentukan TargetEnvironment.

Ini memungkinkan Anda untuk memiliki entri berbeda di file desktop dan memiliki beberapa tumpang tindih dan yang lainnya tidak.

Ted Gould
sumber
Itu tentang jawaban itu. Terima kasih telah meluangkan waktu. Mengapa tidak mendokumentasikan atau melakukan oksigen?
con-f-use
1
Kami menggunakan gtk-doc. Pada dasarnya hal yang sama. Tapi itu belum ditransfer ke binding.
Ted Gould
1
Anda bisa mendapatkan menu dan mengubahnya di sana, tetapi saya tidak akan merekomendasikan itu. Jika mereka harus berbeda, saya hanya akan membangun menu dengan cara normal ... Sungguh fungsi ini hanya dimaksudkan untuk menjadi penolong jika Anda ingin mereka sama.
Ted Gould
1
Hanya ingin memeriksa apakah ada pembaruan tentang Giraffe dan qucklists ...
gunakan con
1
Apa keadaannya ini? Mengapa semua tautan dokumen API AppIndicator googleable rusak? Apakah ada yang hidup?
ulidtko