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

Question

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

请注意，我不是在问如何使用 mallard 创建帮助文件。而是如何将 mallard 集成到我的 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。）

然后，当用户单击帮助/内容时，他们打开 URIhelp:gedit或help:gedit/link_id使用gtk_show_uri()（参见此处，在功能gedit_app_show_help_impl()和gedit_app_help_link_id_impl()中）然后，大概，桌面帮助系统会自动获取文件，翻译成适当的语言，并在 Yelp 中显示.