如何爲gtk3應用程序實現幫助（使用mallard）？

Question

我想創建我自己的gtk3應用程序。我喜歡使用野鴨來顯示一些關於如何使用我的應用程序的幫助。但是，我不知道如何編寫代碼，以便在單擊幫助菜單項時顯示幫助（mallard）。我已經準備好了.page文件。

請注意，我不問如何使用野鴨創建幫助文件。 而是如何將野鴨集成到我的gtk3幫助中。

Answer 1

好問題。在這種情況下，我總是在git.gnome.org上查看Gedit如何執行此操作。這是一個很好的「示例」應用程序。

首先，看here他們如何安排自己的幫助文件：

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

在help/Makefile.am，他們使用@YELP_HELP_RULES@安裝文件

然後，（在configure.ac設立YELP_HELP_INIT。）當用戶單擊幫助/內容時，他們打開URI help:gedit或help:gedit/link_id與gtk_show_uri()（請參見here，功能gedit_app_show_help_impl()和gedit_app_help_link_id_impl()）fi然後，大概是由桌面幫助系統自動獲取，翻譯成適當的語言，並顯示在Yelp中。