Saya mendapatkan serous dengan proyek saya sendiri dan memerlukan dokumentasi yang baik pada modul appindicator untuk python. Apa yang saya temukan sejauh ini:
- Dokumentasi API di dev.ubuntu.com
- Entri wiki komunitas
- Dokumentasi API pada kode C.
- Posting blog yang bagus
apa yang salah dengan mereka:
- Hanya daftar tanpa penjelasan tentang argumen, pengembalian dan apa metode yang dilakukan
- Hanya pertimbangan desain dan latar belakang - sedikit yang akan membantu pemrograman yang sebenarnya
- Hal-hal yang hilang dari modul python (mis. Create_menu_from_desktop)
- 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.
indicator
python
application-development
documentation
membingungkan
sumber
sumber
Jawaban:
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.
sumber