Wie implementieren Sie Hilfe (mit Mallard) für eine GTK3-App?

Question

Ich versuche meine eigene gtk3-Anwendung zu erstellen. Ich verwende gerne Stockente, um Hilfe zur Verwendung meiner Anwendung anzuzeigen. Wie auch immer, ich weiß nicht, wie ich das programmieren soll, wenn der Hilfe-Menüpunkt angeklickt wird, wird die Hilfe (Mallard) angezeigt. Ich habe die .page-Dateien bereits fertig.

Bitte beachten Sie, ich frage nicht, wie man Hilfe-Dateien mit Mallard erstellen. Aber eher wie man Stockente in meine gtk3-Hilfe integrieren kann.

Answer 1

Gute Frage. In Fällen wie diesem schaue ich immer auf git.gnome.org nach, um zu sehen, wie Gedit es macht. Das ist eine hervorragende Beispielanwendung.

Zuerst schauen here, wie sie ihre Hilfedateien organisieren:

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

In help/Makefile.am verwenden sie @YELP_HELP_RULES@ die Dateien installieren

Dann (die durch YELP_HELP_INIT in configure.ac eingerichtet ist.) Wenn der Benutzer auf Hilfe/Inhalt klickt, öffnet er die URI help:gedit oder help:gedit/link_id mit gtk_show_uri() (siehe here, in den Funktionen und gedit_app_help_link_id_impl()) Die fi Die Dateien werden dann vermutlich automatisch vom Desktop-Hilfesystem abgerufen, in die richtige Sprache übersetzt und in Yelp angezeigt.