Come implementare l'aiuto (usando il germano reale) per un'app gtk3?

Question

Sto provando a creare la mia applicazione gtk3. Mi piace usare il germano reale per mostrare qualche aiuto su come usare la mia applicazione. Tuttavia non so come codificare in modo tale che quando viene cliccata la voce del menu di aiuto viene mostrato l'aiuto (germano reale). Ho i file .page già pronti.

Si prega di notare, non sto chiedendo come creare file di aiuto utilizzando il germano reale. Ma piuttosto come integrare mallard nella mia guida gtk3.

Answer 1

Buona domanda. In casi come questo, guardo sempre su git.gnome.org per vedere come Gedit lo fa. Questa è un'ottima applicazione "esempio".

primo luogo, guardare here a come organizzare i propri file di aiuto:

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

In help/Makefile.am, usano @YELP_HELP_RULES@ per installare i file

Poi, (che è impostato da YELP_HELP_INIT in configure.ac.) quando l'utente fa clic su Guida/Contenuti, apre l'URI help:gedit o help:gedit/link_id con gtk_show_uri() (vedere here, nelle funzioni gedit_app_show_help_impl() e gedit_app_help_link_id_impl()). presumibilmente, i file vengono automaticamente recuperati dal sistema di guida del desktop, tradotti nella lingua corretta e visualizzati in Yelp.