Zaczynam mieć problemy z własnym projektem i potrzebuję dobrej dokumentacji na temat modułu appindicator dla Pythona. Co znalazłem do tej pory:
- Dokumentacja API na dev.ubuntu.com
- Wpis wiki społeczności
- Dokumentacja API dotycząca kodu C.
- Niezły post na blogu
co jest z nimi nie tak:
- Tylko lista bez wyjaśnień na temat argumentów, zwrotów i działania metod
- Tylko względy projektowe i tła - niewiele, które pomogłyby w rzeczywistym programowaniu
- Rzeczy brakuje modułu Pythona (np. Create_menu_from_desktop)
- Wiele użytecznych informacji jest skompresowanych, ale niekompletnych
Tak więc w zasadzie potrzebuję czegoś tak szczegółowego jak 3., ale dla modułu python.
Przykład mojego problemu:
void build_menu_from_desktop (plik_ desktop, profil_ desktop)
Jakie powinny być argumenty i co robi metoda? Domyślam się, że metoda tworzy pozycje menu z pliku „* .desktop”. Ale jeśli tak, to dlaczego potrzebuje więcej argumentów niż tylko ten plik? Z jakich pozycji w pliku pobiera elementy menu? To takie pytania, na które trudno mi znaleźć odpowiedź.
indicator
python
application-development
documentation
dezorientować
źródło
źródło
Odpowiedzi:
Tak, zdajemy sobie sprawę, że potrzebujemy dokumentacji w języku Python o odpowiednim poziomie szczegółowości. Taki jest cel projektu Giraffe . Będzie działał z powiązaniami introspekcji GObject, w taki sposób należy pisać nowe aplikacje w języku Python, aby korzystać ze wskaźników aplikacji.
Do tego czasu najlepszym rozwiązaniem jest zanotowana dokumentacja API. Powinno być mniej więcej takie samo, choć „python-ified”.
Build_menu_from_desktop to funkcja wygodna w użyciu, wczytaj wpisy, które w innym przypadku znajdowałyby się na szybkiej liście w Unity . Aby uzyskać te wpisy, których
build_menu_from_desktop("/my/path/myfile.desktop", "Unity")użyłbyś do określenia TargetEnvironment.Dzięki temu możesz mieć różne wpisy w pliku na pulpicie, niektóre nakładają się, a inne nie.
źródło