J'ai écrit quelques pages Yelp en utilisant Mallard . Maintenant, je voudrais savoir où les enregistrer correctement dans le système de fichiers (packaging). Les fichiers Yelp enregistrés doivent s'afficher lors de l'ouverture de Yelp -> Go -> All Documents
aussi.
Une addition:
Il est difficile de trouver des informations sur ce genre de choses. Connaissez-vous un bon endroit où trouver de telles informations?
Pour que Yelp trouve les pages d'aide de votre application, elles doivent être installées sous:
/usr/share/gnome/help/$app_name/$locale/
Quant à savoir où trouver ces informations ... Eh bien, vous avez raison. Je ne vois cela clairement documenté nulle part. GNOME Handbook of Writing Software Documentation comprend un section qui inclut des informations sur la façon de l'incorporer dans le système de construction, mais il suppose que vous utilisez des outils automatiques.
Je regarde généralement des exemples que j'ai installés sur mon système. Par exemple, je peux voir que Totem apparaît dans Yelp -> Go -> All Documents
. Voyons donc où il installe sa documentation:
$ dpkg -L totem-common | grep "help"
/usr/share/gnome/help
/usr/share/gnome/help/totem
/usr/share/gnome/help/totem/cs
/usr/share/gnome/help/totem/cs/figures
/usr/share/gnome/help/totem/gl
/usr/share/gnome/help/totem/gl/figures
/usr/share/gnome/help/totem/pa
/usr/share/gnome/help/totem/pa/figures
/usr/share/gnome/help/totem/fi
/usr/share/gnome/help/totem/fi/figures
/usr/share/gnome/help/totem/pl
/usr/share/gnome/help/totem/pl/figures
/usr/share/gnome/help/totem/zh_CN
/usr/share/gnome/help/totem/zh_CN/figures
/usr/share/gnome/help/totem/uk
/usr/share/gnome/help/totem/uk/figures
/usr/share/gnome/help/totem/pt_BR
/usr/share/gnome/help/totem/pt_BR/figures
/usr/share/gnome/help/totem/zh_HK
/usr/share/gnome/help/totem/zh_HK/figures
/usr/share/gnome/help/totem/eu
/usr/share/gnome/help/totem/eu/figures
/usr/share/gnome/help/totem/C
/usr/share/gnome/help/totem/C/totem.xml
/usr/share/gnome/help/totem/C/figures
/usr/share/gnome/help/totem/C/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/C/figures/totem_next_button.png
/usr/share/gnome/help/totem/C/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/C/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/C/figures/totem_previous_button.png
/usr/share/gnome/help/totem/C/figures/totem_start_window.png
/usr/share/gnome/help/totem/C/figures/totem_play_button.png
/usr/share/gnome/help/totem/C/figures/totem_pause_button.png
/usr/share/gnome/help/totem/C/legal.xml
/usr/share/gnome/help/totem/ca
/usr/share/gnome/help/totem/ca/figures
/usr/share/gnome/help/totem/sl
/usr/share/gnome/help/totem/sl/figures
/usr/share/gnome/help/totem/it
/usr/share/gnome/help/totem/it/figures
/usr/share/gnome/help/totem/zh_TW
/usr/share/gnome/help/totem/zh_TW/figures
/usr/share/gnome/help/totem/te
/usr/share/gnome/help/totem/te/figures
/usr/share/gnome/help/totem/ja
/usr/share/gnome/help/totem/ja/figures
/usr/share/gnome/help/totem/de
/usr/share/gnome/help/totem/de/figures
/usr/share/gnome/help/totem/bg
/usr/share/gnome/help/totem/bg/figures
/usr/share/gnome/help/totem/el
/usr/share/gnome/help/totem/el/figures
/usr/share/gnome/help/totem/ru
/usr/share/gnome/help/totem/ru/figures
/usr/share/gnome/help/totem/oc
/usr/share/gnome/help/totem/oc/figures
/usr/share/gnome/help/totem/fr
/usr/share/gnome/help/totem/fr/figures
/usr/share/gnome/help/totem/en_GB
/usr/share/gnome/help/totem/en_GB/figures
/usr/share/gnome/help/totem/es
/usr/share/gnome/help/totem/es/figures
/usr/share/gnome/help/totem/sv
/usr/share/gnome/help/totem/sv/figures
/usr/share/gnome/help/totem/ro
/usr/share/gnome/help/totem/ro/figures
/usr/share/gnome/help/totem/da
/usr/share/gnome/help/totem/da/figures
/usr/share/gtk-doc/html/totem/totem.devhelp2
/usr/share/gnome/help/totem/cs/totem.xml
/usr/share/gnome/help/totem/cs/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/cs/figures/totem_next_button.png
/usr/share/gnome/help/totem/cs/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/cs/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/cs/figures/totem_previous_button.png
/usr/share/gnome/help/totem/cs/figures/totem_start_window.png
/usr/share/gnome/help/totem/cs/figures/totem_play_button.png
/usr/share/gnome/help/totem/cs/figures/totem_pause_button.png
/usr/share/gnome/help/totem/gl/totem.xml
/usr/share/gnome/help/totem/gl/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/gl/figures/totem_next_button.png
/usr/share/gnome/help/totem/gl/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/gl/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/gl/figures/totem_previous_button.png
/usr/share/gnome/help/totem/gl/figures/totem_start_window.png
/usr/share/gnome/help/totem/gl/figures/totem_play_button.png
/usr/share/gnome/help/totem/gl/figures/totem_pause_button.png
/usr/share/gnome/help/totem/pa/totem.xml
/usr/share/gnome/help/totem/pa/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/pa/figures/totem_next_button.png
/usr/share/gnome/help/totem/pa/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/pa/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/pa/figures/totem_previous_button.png
/usr/share/gnome/help/totem/pa/figures/totem_start_window.png
/usr/share/gnome/help/totem/pa/figures/totem_play_button.png
/usr/share/gnome/help/totem/pa/figures/totem_pause_button.png
/usr/share/gnome/help/totem/fi/totem.xml
/usr/share/gnome/help/totem/fi/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/fi/figures/totem_next_button.png
/usr/share/gnome/help/totem/fi/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/fi/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/fi/figures/totem_previous_button.png
/usr/share/gnome/help/totem/fi/figures/totem_start_window.png
/usr/share/gnome/help/totem/fi/figures/totem_play_button.png
/usr/share/gnome/help/totem/fi/figures/totem_pause_button.png
/usr/share/gnome/help/totem/pl/totem.xml
/usr/share/gnome/help/totem/pl/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/pl/figures/totem_next_button.png
/usr/share/gnome/help/totem/pl/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/pl/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/pl/figures/totem_previous_button.png
/usr/share/gnome/help/totem/pl/figures/totem_start_window.png
/usr/share/gnome/help/totem/pl/figures/totem_play_button.png
/usr/share/gnome/help/totem/pl/figures/totem_pause_button.png
/usr/share/gnome/help/totem/zh_CN/totem.xml
/usr/share/gnome/help/totem/zh_CN/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_next_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_previous_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_start_window.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_play_button.png
/usr/share/gnome/help/totem/zh_CN/figures/totem_pause_button.png
/usr/share/gnome/help/totem/uk/totem.xml
/usr/share/gnome/help/totem/uk/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/uk/figures/totem_next_button.png
/usr/share/gnome/help/totem/uk/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/uk/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/uk/figures/totem_previous_button.png
/usr/share/gnome/help/totem/uk/figures/totem_start_window.png
/usr/share/gnome/help/totem/uk/figures/totem_play_button.png
/usr/share/gnome/help/totem/uk/figures/totem_pause_button.png
/usr/share/gnome/help/totem/pt_BR/totem.xml
/usr/share/gnome/help/totem/pt_BR/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_next_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_previous_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_start_window.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_play_button.png
/usr/share/gnome/help/totem/pt_BR/figures/totem_pause_button.png
/usr/share/gnome/help/totem/zh_HK/totem.xml
/usr/share/gnome/help/totem/zh_HK/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_next_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_previous_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_start_window.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_play_button.png
/usr/share/gnome/help/totem/zh_HK/figures/totem_pause_button.png
/usr/share/gnome/help/totem/eu/totem.xml
/usr/share/gnome/help/totem/eu/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/eu/figures/totem_next_button.png
/usr/share/gnome/help/totem/eu/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/eu/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/eu/figures/totem_previous_button.png
/usr/share/gnome/help/totem/eu/figures/totem_start_window.png
/usr/share/gnome/help/totem/eu/figures/totem_play_button.png
/usr/share/gnome/help/totem/eu/figures/totem_pause_button.png
/usr/share/gnome/help/totem/ca/totem.xml
/usr/share/gnome/help/totem/ca/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/ca/figures/totem_next_button.png
/usr/share/gnome/help/totem/ca/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/ca/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/ca/figures/totem_previous_button.png
/usr/share/gnome/help/totem/ca/figures/totem_start_window.png
/usr/share/gnome/help/totem/ca/figures/totem_play_button.png
/usr/share/gnome/help/totem/ca/figures/totem_pause_button.png
/usr/share/gnome/help/totem/sl/totem.xml
/usr/share/gnome/help/totem/sl/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/sl/figures/totem_next_button.png
/usr/share/gnome/help/totem/sl/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/sl/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/sl/figures/totem_previous_button.png
/usr/share/gnome/help/totem/sl/figures/totem_start_window.png
/usr/share/gnome/help/totem/sl/figures/totem_play_button.png
/usr/share/gnome/help/totem/sl/figures/totem_pause_button.png
/usr/share/gnome/help/totem/it/totem.xml
/usr/share/gnome/help/totem/it/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/it/figures/totem_next_button.png
/usr/share/gnome/help/totem/it/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/it/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/it/figures/totem_previous_button.png
/usr/share/gnome/help/totem/it/figures/totem_start_window.png
/usr/share/gnome/help/totem/it/figures/totem_play_button.png
/usr/share/gnome/help/totem/it/figures/totem_pause_button.png
/usr/share/gnome/help/totem/zh_TW/totem.xml
/usr/share/gnome/help/totem/zh_TW/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_next_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_previous_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_start_window.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_play_button.png
/usr/share/gnome/help/totem/zh_TW/figures/totem_pause_button.png
/usr/share/gnome/help/totem/te/totem.xml
/usr/share/gnome/help/totem/te/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/te/figures/totem_next_button.png
/usr/share/gnome/help/totem/te/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/te/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/te/figures/totem_previous_button.png
/usr/share/gnome/help/totem/te/figures/totem_start_window.png
/usr/share/gnome/help/totem/te/figures/totem_play_button.png
/usr/share/gnome/help/totem/te/figures/totem_pause_button.png
/usr/share/gnome/help/totem/ja/totem.xml
/usr/share/gnome/help/totem/ja/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/ja/figures/totem_next_button.png
/usr/share/gnome/help/totem/ja/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/ja/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/ja/figures/totem_previous_button.png
/usr/share/gnome/help/totem/ja/figures/totem_start_window.png
/usr/share/gnome/help/totem/ja/figures/totem_play_button.png
/usr/share/gnome/help/totem/ja/figures/totem_pause_button.png
/usr/share/gnome/help/totem/de/totem.xml
/usr/share/gnome/help/totem/de/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/de/figures/totem_next_button.png
/usr/share/gnome/help/totem/de/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/de/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/de/figures/totem_previous_button.png
/usr/share/gnome/help/totem/de/figures/totem_start_window.png
/usr/share/gnome/help/totem/de/figures/totem_play_button.png
/usr/share/gnome/help/totem/de/figures/totem_pause_button.png
/usr/share/gnome/help/totem/bg/totem.xml
/usr/share/gnome/help/totem/bg/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/bg/figures/totem_next_button.png
/usr/share/gnome/help/totem/bg/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/bg/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/bg/figures/totem_previous_button.png
/usr/share/gnome/help/totem/bg/figures/totem_start_window.png
/usr/share/gnome/help/totem/bg/figures/totem_play_button.png
/usr/share/gnome/help/totem/bg/figures/totem_pause_button.png
/usr/share/gnome/help/totem/el/totem.xml
/usr/share/gnome/help/totem/el/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/el/figures/totem_next_button.png
/usr/share/gnome/help/totem/el/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/el/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/el/figures/totem_previous_button.png
/usr/share/gnome/help/totem/el/figures/totem_start_window.png
/usr/share/gnome/help/totem/el/figures/totem_play_button.png
/usr/share/gnome/help/totem/el/figures/totem_pause_button.png
/usr/share/gnome/help/totem/ru/totem.xml
/usr/share/gnome/help/totem/ru/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/ru/figures/totem_next_button.png
/usr/share/gnome/help/totem/ru/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/ru/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/ru/figures/totem_previous_button.png
/usr/share/gnome/help/totem/ru/figures/totem_start_window.png
/usr/share/gnome/help/totem/ru/figures/totem_play_button.png
/usr/share/gnome/help/totem/ru/figures/totem_pause_button.png
/usr/share/gnome/help/totem/oc/totem.xml
/usr/share/gnome/help/totem/oc/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/oc/figures/totem_next_button.png
/usr/share/gnome/help/totem/oc/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/oc/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/oc/figures/totem_previous_button.png
/usr/share/gnome/help/totem/oc/figures/totem_start_window.png
/usr/share/gnome/help/totem/oc/figures/totem_play_button.png
/usr/share/gnome/help/totem/oc/figures/totem_pause_button.png
/usr/share/gnome/help/totem/fr/totem.xml
/usr/share/gnome/help/totem/fr/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/fr/figures/totem_next_button.png
/usr/share/gnome/help/totem/fr/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/fr/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/fr/figures/totem_previous_button.png
/usr/share/gnome/help/totem/fr/figures/totem_start_window.png
/usr/share/gnome/help/totem/fr/figures/totem_play_button.png
/usr/share/gnome/help/totem/fr/figures/totem_pause_button.png
/usr/share/gnome/help/totem/en_GB/totem.xml
/usr/share/gnome/help/totem/en_GB/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_next_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_previous_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_start_window.png
/usr/share/gnome/help/totem/en_GB/figures/totem_play_button.png
/usr/share/gnome/help/totem/en_GB/figures/totem_pause_button.png
/usr/share/gnome/help/totem/es/totem.xml
/usr/share/gnome/help/totem/es/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/es/figures/totem_next_button.png
/usr/share/gnome/help/totem/es/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/es/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/es/figures/totem_previous_button.png
/usr/share/gnome/help/totem/es/figures/totem_start_window.png
/usr/share/gnome/help/totem/es/figures/totem_play_button.png
/usr/share/gnome/help/totem/es/figures/totem_pause_button.png
/usr/share/gnome/help/totem/sv/totem.xml
/usr/share/gnome/help/totem/sv/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/sv/figures/totem_next_button.png
/usr/share/gnome/help/totem/sv/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/sv/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/sv/figures/totem_previous_button.png
/usr/share/gnome/help/totem/sv/figures/totem_start_window.png
/usr/share/gnome/help/totem/sv/figures/totem_play_button.png
/usr/share/gnome/help/totem/sv/figures/totem_pause_button.png
/usr/share/gnome/help/totem/ro/totem.xml
/usr/share/gnome/help/totem/ro/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/ro/figures/totem_next_button.png
/usr/share/gnome/help/totem/ro/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/ro/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/ro/figures/totem_previous_button.png
/usr/share/gnome/help/totem/ro/figures/totem_start_window.png
/usr/share/gnome/help/totem/ro/figures/totem_play_button.png
/usr/share/gnome/help/totem/ro/figures/totem_pause_button.png
/usr/share/gnome/help/totem/da/totem.xml
/usr/share/gnome/help/totem/da/figures/totem_show_playlist_button.png
/usr/share/gnome/help/totem/da/figures/totem_next_button.png
/usr/share/gnome/help/totem/da/figures/totem_volume_mute_button.png
/usr/share/gnome/help/totem/da/figures/totem_volume_maximum_button.png
/usr/share/gnome/help/totem/da/figures/totem_previous_button.png
/usr/share/gnome/help/totem/da/figures/totem_start_window.png
/usr/share/gnome/help/totem/da/figures/totem_play_button.png
/usr/share/gnome/help/totem/da/figures/totem_pause_button.png