是否有关于appindicator的python绑定的详细API文档?


18

我对自己的项目很认真,并且需要有关python的appindicator模块的良好文档。到目前为止,我发现了什么:

  1. dev.ubuntu.com上的API文档
  2. 社区Wiki条目
  3. 有关C代码的API文档
  4. 不错的博客文章

他们怎么了:

  1. 只是一个列表,没有对参数,返回值以及方法的作用进行解释
  2. 仅设计注意事项和背景-对实际编程无济于事
  3. 缺少python模块的东西(例如create_menu_from_desktop)
  4. 许多有用的信息已压缩但不完整

因此,基本上,我需要像3.一样详细的内容,但需要使用python模块。

我的问题的例子:

无效build_menu_from_desktop(desktop_file,desktop_profile)

参数应该是什么,该方法做什么?我的猜测是,该方法从“ * .desktop”文件创建菜单项。但是,如果是这样,为什么它不仅仅需要那个文件就需要更多的参数?文件中从菜单项中提取哪些条目?像这样的问题,我很难找到答案。


2
链接1和3不起作用。
马特·乔纳

2
...不再...
混淆使用

Answers:


7

是的,我们意识到我们需要具有适当详细程度的Python文档。这是长颈鹿项目的目标。它将与GObject Introspection绑定一起使用,这是应编写新的Python应用程序以使用应用程序指示符的方式。

在此之前,最好的办法是您已经注意到的API文档。通过“ python-ified”应该大致相同。

build_menu_from_desktop是一个便捷功能,可以使用加载条目,否则这些条目将出现在Unity的快捷列表。因此,要获取这些条目,您将用于build_menu_from_desktop("/my/path/myfile.desktop", "Unity")指定TargetEnvironment。

这使您可以在桌面文件中具有不同的条目,并且可以有一些重叠,而有些则没有。


关于答案。感谢您抽出宝贵的时间。为什么不首先使用文档字符串或doxygen?
con-f-use

1
我们正在使用gtk-doc。基本上是一样的。但是它还没有传递到绑定。
泰德·古尔德

1
您可以获取菜单并在那里进行更改,但是我不建议您这样做。如果它们需要不同,我将以正常方式构建菜单...实际上,该功能仅在您希望它们相同的情况下用作帮助器。
Ted Gould

1
只是想检查是否有关于长颈鹿和qucklists的更新...
con-f-use

1
这是什么状态?为什么所有可搜索的AppIndicator API文档链接都中断了?有一个还活着吗?
ulidtko
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.