我对自己的项目很苛刻,需要一个关于python的appindicator模块的好文档.到目前为止我发现了什么:
> API documentation on dev.ubuntu.com
> Community wiki entry
> API documentation on the C code
> Nice blog post
他们怎么了:
>只是一个列表,没有关于参数,返回和方法的解释
>只有设计考虑因素和背景 – 很少有助于实际编程
>缺少python模块的东西(例如create_menu_from_desktop)
>压缩但未完成的大量有用信息
所以基本上我需要像3.一样详细的东西,但对于python模块.
关于我的问题的例子:
void build_menu_from_desktop (desktop_file, desktop_profile)
应该是什么参数以及该方法的作用是什么?我的猜测是,该方法从’* .desktop’文件创建菜单条目.但如果是这样,为什么它需要更多的参数而不仅仅是那个文件?文件中的哪些条目从菜单项中获取?像这样的问题我有点难以找到答案.
解决方法:
是的,我们意识到我们需要具有适当详细程度的Python文档.这就是Giraffe project的目标.它将与GObject Introspection绑定一起使用,这是编写新的Python应用程序以使用应用程序指示器的方式.
在此之前,最好的选择是您注意到的API文档.虽然“python-ified”应该大致相同.
build_menu_from_desktop是一个便利函数,用于加载条目,否则这些条目将类似于quicklist in Unity.因此,要获取这些条目,您需要使用build_menu_from_desktop(“/ my / path / myfile.desktop”,“Unity”)来指定TargetEnvironment .
这允许您在桌面文件中具有不同的条目并且具有一些重叠而其他条目不重叠.