Esiste una documentazione API dettagliata sull'associazione python per appindicator?


18

Sto diventando serio con un mio progetto e ho bisogno di una buona documentazione sul modulo appindicator per Python. Quello che ho trovato finora:

  1. Documentazione API su dev.ubuntu.com
  2. Voce wiki della community
  3. Documentazione API sul codice C.
  4. Bel post sul blog

cosa c'è di sbagliato in loro:

  1. Solo un elenco senza spiegazioni sugli argomenti, i ritorni e su cosa fanno i metodi
  2. Solo considerazioni di progettazione e sfondi - poco che aiuterebbe con la programmazione effettiva
  3. Roba mancante nel modulo python (ad es. Create_menu_from_desktop)
  4. Molte informazioni utili compresse ma non complete

Quindi sostanzialmente ho bisogno di qualcosa di dettagliato come 3. ma per il modulo python.

Esempio sul mio problema:

void build_menu_from_desktop (desktop_file, desktop_profile)

Quali sono gli argomenti che dovrebbero essere e cosa fa il metodo? Suppongo che il metodo crei voci di menu da un file '* .desktop'. Ma se è così, perché ha bisogno di più argomenti oltre a quel solo file? Da quali voci del file prende le voci di menu? Sono domande come questa per cui sto facendo fatica a trovare una risposta.


2
I collegamenti 1 e 3 non funzionano.
Matt Joiner,

2
... più ...
con-f-use

Risposte:


7

Sì, ci rendiamo conto che abbiamo bisogno della documentazione di Python con il livello appropriato di dettagli. Questo è l'obiettivo del progetto Giraffe . Funzionerà con i collegamenti GObject Introspection, che è il modo in cui le nuove applicazioni Python dovrebbero essere scritte per utilizzare gli indicatori dell'applicazione.

Fino ad allora, la scommessa migliore è la documentazione API che hai notato. Dovrebbe essere più o meno lo stesso anche se "python-ified".

Build_menu_from_desktop è una funzione di convenienza utilizza le voci che sarebbero altrimenti in una lista rapida in Unity . Quindi per ottenere quelle voci che build_menu_from_desktop("/my/path/myfile.desktop", "Unity")useresti per specificare TargetEnvironment.

Ciò ti consente di avere voci diverse nel file desktop e di avere alcune sovrapposizioni e altre no.


Quello su risponde. Grazie per aver dedicato del tempo. Perché non dotstrings o doxygen in primo luogo?
con-f-use

1
Stiamo usando gtk-doc. Praticamente la stessa cosa. Ma non si trasferisce ancora agli attacchi.
Ted Gould,

1
Potresti ottenere il menu e modificarli lì, ma non lo consiglierei. Se hanno bisogno di essere diversi, creerei semplicemente il menu nel modo normale ... In realtà la funzione è pensata solo per essere un aiuto nel caso tu voglia che siano uguali.
Ted Gould,

1
Volevo solo verificare se ci sono aggiornamenti su Giraffe e liste di ricerca ...
con-f-use

1
Qual è lo stato di questo? Perché tutti i collegamenti doc dell'API di AppIndicator su Google sono interrotti? Ce n'è uno vivo?
Ulidtko,
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.