File yelp-2.14.0-process-suse-manuals.patch of Package yelp

Overview Repositories Revisions Requests Users Attributes Meta

File yelp-2.14.0-process-suse-manuals.patch of Package yelp (Revision 7318b664ac64d07a588be0e2c7eafb3b)

Currently displaying revision 7318b664ac64d07a588be0e2c7eafb3b , Show latest

--- yelp-2.16.1/src/yelp-toc-pager.c
+++ yelp-2.16.1/src/yelp-toc-pager.c
@@ -130,6 +130,7 @@
 static gboolean      toc_process_pending       (YelpTocPager      *pager);
 
 
+static gboolean      process_suse_manuals      (YelpTocPager      *pager);
 static gboolean      process_libmenu           (YelpTocPager      *pager);
 static gboolean      process_libmenu_node      (YelpTocPager      *pager);
 static gboolean      process_xslt              (YelpTocPager      *pager);
@@ -480,6 +481,7 @@
     static ProcessFunction process_funcs[] = {
 	process_libmenu,
         process_libmenu_node,
+	process_suse_manuals,
         process_xslt,
 #ifdef ENABLE_SCROLLKEEPER
 	process_read_menu,
@@ -576,6 +578,236 @@
     priv->libmenu_stack = g_slist_delete_link (priv->libmenu_stack, priv->libmenu_stack);
 }
 
+typedef struct
+{
+    const gchar *meta_path;
+    const gchar *doc_path;
+}
+SuseDocRef;
+
+static const gchar const *common_desktop_entry_group = "Desktop Entry";
+static const gchar const *kde_desktop_entry_group    = "KDE Desktop Entry";
+
+static const SuseDocRef suse_docs [] =
+{
+  { "/usr/share/susehelp/meta/release-notes.desktop",                     NULL },
+  { "/usr/share/susehelp/meta/opensuse-manual_%s/.directory",             "/usr/share/doc/manual/opensuse-manual_%s/manual/index.html" },
+  { "/usr/share/susehelp/meta/opensuse-gnomeuser_%s/.directory",          "/usr/share/doc/manual/opensuse-gnomeuser_%s/manual/index.html" },
+  { "/usr/share/susehelp/meta/sles/admin_%s/.directory",                  "/usr/share/gnome/help/sles-admin/%s/book.sle.reference.html" },
+  { "/usr/share/susehelp/meta/sled/desktop-qs_%s/cha_gnomequick.desktop", "/usr/share/gnome/help/sled-desktop-qs/%s/SLED-gnomequick/index.html" },
+  { "/usr/share/susehelp/meta/sled/deployment_%s/.directory",             "/usr/share/gnome/help/sled-deployment/%s/book.sle.reference.html" },
+  { "/usr/share/susehelp/meta/sled/network-user_%s/.directory",           "/usr/share/gnome/help/sled-network-user/%s/book.connectivity.guide.html" },
+  { "/usr/share/susehelp/meta/sled/gnome-user_%s/.directory",             "/usr/share/gnome/help/sled-gnome-user/%s/index.html" },
+  { "/usr/share/susehelp/meta/sled/gnome-cbt_%s/.directory",              "/usr/share/doc/manual/sled-gnome-cbt_%s/index.html" },
+  { "/usr/share/susehelp/meta/sled/kde-user_%s/.directory",               "/usr/share/gnome/help/sled-kde-user/%s/book.sled.kde_userguide.html" },
+  { "/usr/share/susehelp/meta/release-notes.desktop",                     "/usr/share/doc/release-notes/SUSE_Linux_Enterprise_Desktop_10/RELEASE-NOTES.%s.html" },
+  { "/usr/share/susehelp/meta/apparmoradmin_%s/.directory",               "/usr/share/gnome/help/apparmor-admin/%s/book.apparmor.admin.html" },
+  { NULL, NULL }
+};
+
+static gchar *
+suse_manual_make_meta_path (SuseDocRef *doc_ref, const gchar *language)
+{
+    return g_strdup_printf (doc_ref->meta_path, language);
+}
+
+static gchar *
+suse_manual_make_index_path (SuseDocRef *doc_ref, const gchar *language)
+{
+    if (!doc_ref->doc_path) {
+	GKeyFile    *key_file;
+	gchar       *desktop_path;
+	const gchar *desktop_entry_group;
+	gchar       *doc_path = NULL;
+	gboolean     result;
+
+	/* Use DocPath from desktop file */
+
+	desktop_path = suse_manual_make_meta_path (doc_ref, language);
+
+	key_file = g_key_file_new ();
+	result = g_key_file_load_from_file (key_file, desktop_path, 0, NULL);
+
+	g_free (desktop_path);
+
+	if (!result && !strcmp (language, "en")) {
+	    /* Some docs are inconsistent - the meta file uses "en" and the index
+	     * file uses "C" or vice versa. */
+
+	    g_key_file_free (key_file);
+
+	    desktop_path = suse_manual_make_meta_path (doc_ref, "C");
+
+	    key_file = g_key_file_new ();
+	    result = g_key_file_load_from_file (key_file, desktop_path, 0, NULL);
+
+	    g_free (desktop_path);
+	}
+
+	if (!result)
+	    goto out;
+
+	desktop_entry_group = common_desktop_entry_group;
+
+	if (!g_key_file_has_group (key_file, desktop_entry_group)) {
+	    desktop_entry_group = kde_desktop_entry_group;
+
+	    if (!g_key_file_has_group (key_file, desktop_entry_group))
+		goto out;
+	}
+
+	doc_path = g_key_file_get_locale_string (key_file, desktop_entry_group, "DocPath", NULL, NULL);
+
+    out:
+	g_key_file_free (key_file);
+	return doc_path;
+    }
+
+    return g_strdup_printf (doc_ref->doc_path, language);
+}
+
+static gchar *
+suse_manual_get_title (SuseDocRef *doc_ref, const gchar *language)
+{
+    GKeyFile    *key_file;
+    gchar       *desktop_path;
+    const gchar *desktop_entry_group;
+    gchar       *title = NULL;
+    gboolean     result;
+
+    desktop_path = suse_manual_make_meta_path (doc_ref, language);
+
+    key_file = g_key_file_new ();
+    result = g_key_file_load_from_file (key_file, desktop_path, 0, NULL);
+
+    g_free (desktop_path);
+
+    if (!result && !strcmp (language, "en")) {
+	/* Some docs are inconsistent - the meta file uses "en" and the index
+	 * file uses "C" or vice versa. */
+
+	g_key_file_free (key_file);
+
+	desktop_path = suse_manual_make_meta_path (doc_ref, "C");
+
+	key_file = g_key_file_new ();
+	result = g_key_file_load_from_file (key_file, desktop_path, 0, NULL);
+
+	g_free (desktop_path);
+    }
+
+    if (!result)
+	goto out;
+
+    desktop_entry_group = common_desktop_entry_group;
+
+    if (!g_key_file_has_group (key_file, desktop_entry_group)) {
+	desktop_entry_group = kde_desktop_entry_group;
+
+	if (!g_key_file_has_group (key_file, desktop_entry_group))
+	    goto out;
+    }
+
+    title = g_key_file_get_locale_string (key_file, desktop_entry_group, "Name", NULL, NULL);
+    if (!title) {
+	/* Work around desktop files that don't have a C locale name */
+	title = g_key_file_get_string (key_file, desktop_entry_group, "Name", NULL);
+    }
+
+    if (!title) {
+	/* Same, different approach */
+	title = g_key_file_get_locale_string (key_file, desktop_entry_group, "Name", language, NULL);
+    }
+
+    if (!title) {
+	/* Last ditch, just make something up */
+	title = g_strdup_printf ("SUSE Linux Documentation (%s)", language);
+    }
+
+out:
+    g_key_file_free (key_file);
+    return title;
+}
+
+static xmlNode *
+process_suse_manual (SuseDocRef *doc_ref, const gchar *language)
+{
+    gchar    *title          = NULL;
+    gchar    *path           = NULL;
+    xmlNode  *node           = NULL;
+
+    title = suse_manual_get_title (doc_ref, language);
+    if (!title)
+	goto out;
+
+    path = suse_manual_make_index_path (doc_ref, language);
+    if (!g_file_test (path, G_FILE_TEST_IS_REGULAR) && !strcmp (language, "en")) {
+	/* Some docs are inconsistent - the meta file uses "en" and the index
+	 * file uses "C" or vice versa. */
+
+	g_free (path);
+	path = suse_manual_make_index_path (doc_ref, "C");
+    }
+
+    if (!g_file_test (path, G_FILE_TEST_IS_REGULAR))
+	goto out;
+
+    node = xmlNewNode (NULL, "doc");
+    xmlNewNsProp (node, NULL, "href", path);
+    xmlNewTextChild (node, NULL, "title", title);
+
+out:
+    g_free (title);
+    g_free (path);
+    return node;
+}
+
+static gboolean
+process_suse_manuals (YelpTocPager *pager)
+{
+    YelpTocPagerPriv *priv          = YELP_TOC_PAGER (pager)->priv;
+    xmlNode          *root_element;
+    gboolean          found_manuals = FALSE;
+    gint              i, j;
+
+    static const gchar *language [] =
+    {
+	"cs", "de", "en", "es", "fr", "it", "ja", "pt_BR", "zh_CN", "zh_TW", NULL
+    };
+
+    /* process_libmenu_node () insists on setting this up */
+    g_assert (priv->toc_doc);
+
+    root_element = xmlDocGetRootElement (priv->toc_doc);
+
+    for (i = 0; language [i]; i++) {
+	xmlNode *node;
+
+	for (j = 0; suse_docs [j].meta_path; j++) {
+	    SuseDocRef *doc_ref = (SuseDocRef *) &suse_docs [j];
+
+	    if (!strchr (doc_ref->meta_path, '%') &&
+		strcmp (language [i], "en")) {
+		/* This package doesn't have per-language desktop files.
+		 * Only print its desktop file once. */
+		continue;
+	    }
+
+	    node = process_suse_manual (doc_ref, language [i]);
+	    if (!node)
+		continue;
+
+	    xmlAddChild (root_element, node);
+
+	    /* We don't use this for anything right now, but it could come in handy
+	     * if we want to put manuals in a branch. */
+	    found_manuals = TRUE;
+	}
+    }
+
+    return FALSE;  /* Don't run again */
+}
+
 static GTimer *timer;
 /* iterator points to next node to process and is incremented at the
    end of the function.  NULL means finished with this level.  Parent
@@ -2382,7 +2613,6 @@
 
     return FALSE;
 }
-#endif
 
 static gboolean
 process_cleanup (YelpTocPager *pager)
@@ -2627,7 +2857,6 @@
     if (style)
 	xsltFreeStylesheet (style);
 }
-#endif
 
 static void
 xml_trim_titles (xmlNodePtr node, xmlChar * nodetype)

Places

File yelp-2.14.0-process-suse-manuals.patch of Package yelp (Revision 7318b664ac64d07a588be0e2c7eafb3b)

Places