Как реализовать помощь (используя крякву) для приложения gtk3?

Question

Я пытаюсь создать свое собственное приложение gtk3. Мне нравится использовать крякву для отображения справки о том, как использовать мое приложение. Однако я не знаю, как кодировать так, чтобы при нажатии на пункт меню справки отображалась справка (кряква). У меня есть файлы.page уже готовы.

Обратите внимание, я не спрашиваю, как создавать файлы справки, используя крякву. Скорее, как интегрировать крякву в мою помощь 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_INIT в configure.ac.)

Затем, когда пользователь нажимает кнопку Справка / Содержание, он открывает URI. help:gedit или же help:gedit/link_id с gtk_show_uri() (см. здесь, в функции gedit_app_show_help_impl() а также gedit_app_help_link_id_impl() Затем файлы, по-видимому, автоматически выбираются справочной системой рабочего стола, переводятся на нужный язык и отображаются в Yelp.