Existe uma documentação detalhada da API sobre a ligação do python para o appindicator?

Question

Estou ficando seroso com um projeto próprio e preciso de uma boa documentação sobre o módulo appindicator para python. O que eu encontrei até agora:

1. documentação da API em dev.ubuntu.com
2. Entrada na wiki da comunidade
3. documentação da API no código C
4. Agradável post no blog

o que há de errado com eles:

1. Apenas uma lista sem explicações sobre os argumentos, retornos e sobre o que os métodos fazem
2. Apenas considerações de design e planos de fundo - pouco que ajudaria na programação real
3. Coisas que faltam no módulo python (por exemplo, create_menu_from_desktop)
4. Muita informação útil compactada, mas não completa

Então, basicamente, eu preciso de algo tão detalhado quanto 3. mas para o módulo python.

Exemplo do meu problema:

  

void build_menu_from_desktop (desktop_file, desktop_profile)

Quais são os argumentos que devem ser e o que o método faz? Meu palpite é que o método cria entradas de menu a partir de um arquivo '* .desktop'. Mas se sim, por que precisa de mais argumentos do que apenas esse arquivo? Em quais entradas do arquivo são retirados os itens de menu? São perguntas como essas que estou tendo dificuldade em encontrar uma resposta.

    

Answer 1

Sim, percebemos que precisamos da documentação do Python com o nível de detalhe apropriado. Esse é o objetivo do projeto Girafa . Ele funcionará com as ligações do GObject Introspection, que é a maneira que os novos aplicativos do Python devem ser escritos para usar os indicadores do aplicativo.

Até lá, a melhor aposta é a documentação da API que você anotou. Deve ser mais ou menos o mesmo que "python-ified".

O build_menu_from_desktop é uma função de conveniência. use as entradas que, de outra forma, estariam em algo como uma lista rápida na Unity . Então, para obter essas entradas, você usaria build_menu_from_desktop("/my/path/myfile.desktop", "Unity") para especificar o TargetEnvironment.

Isso permite que você tenha entradas diferentes no arquivo da área de trabalho e tenha algumas sobreposições e outras não.