你如何为gtk3应用程序实现帮助(使用野鸭)？

Question

我正在尝试创建自己的gtk3应用程序.我喜欢使用野鸭来展示如何使用我的应用程序的一些帮助.但是我不知道如何编码,以便在单击帮助菜单项时显示帮助(野鸭).我已经准备好.page文件了.

请注意,我不是在问如何使用野鸭创建帮助文件.而是如何将野鸭整合到我的gtk3帮助中.

Answer 1

好问题.在这种情况下,我总是在git.gnome.org上查看Gedit是如何做到的.这是一个很好的'示例'应用程序.

首先,看看在这里他们如何安排自己的帮助文件:

help
  \--C
  |  \--*.page
  \--Makefile.am
  \--ar
  \--bg
  \--ca
  \--...other languages...

在help/Makefile.am,他们@YELP_HELP_RULES@用来安装文件(由YELP_HELP_INITin configure.ac.设置).

然后,当用户点击帮助/目录,他们打开了URI help:gedit或help:gedit/link_id用gtk_show_uri()(见这里,在功能gedit_app_show_help_impl()和gedit_app_help_link_id_impl())的文件的话,估计主要由桌面帮助系统,翻译成适当的语言自动获取,并在Yelp的显示.