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

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

Обратите внимание, я не спрашиваю, как создавать файлы справки с помощью кряквы. А как интегрировать крякву в мою справку по gtk3.


person Nik    schedule 13.05.2012    source источник


Ответы (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.

person ptomato    schedule 15.05.2012