gtk3 - 您如何为 gtk3 应用程序实现帮助(使用 mallard)？

Question

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

请注意，我不是在问如何使用 mallard 创建帮助文件。 而是如何将 mallard 集成到我的 gtk3 帮助中。

Answer 1

好问题。在这种情况下，我总是在 git.gnome.org 上查看 Gedit 是如何做到的。这是一个出色的“示例”应用程序。

一、看here他们如何组织帮助文件:

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

在 help/Makefile.am ，他们使用 @YELP_HELP_RULES@安装文件(由 YELP_HELP_INIT 中的 configure.ac 设置。)

然后，当用户单击帮助/内容时，他们会打开 URI help:gedit或 help:gedit/link_id与 gtk_show_uri() (见 here ，函数 gedit_app_show_help_impl() 和 gedit_app_help_link_id_impl() )然后，这些文件可能会被桌面帮助系统自动获取，翻译成适当的语言，并显示在 Yelp 中。