157 lines
4.2 KiB
C
157 lines
4.2 KiB
C
/* PIKA - Photo and Image Kooker Application
|
|
* a rebranding of The GNU Image Manipulation Program (created with heckimp)
|
|
* A derived work which may be trivial. However, any changes may be (C)2023 by Aldercone Studio
|
|
*
|
|
* Original copyright, applying to most contents (license remains unchanged):
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* The PIKA Help plug-in
|
|
* Copyright (C) 1999-2008 Sven Neumann <sven@gimp.org>
|
|
* Michael Natterer <mitch@gimp.org>
|
|
* Henrik Brix Andersen <brix@gimp.org>
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/* This code is written so that it can also be compiled standalone.
|
|
* It shouldn't depend on libpika.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <string.h>
|
|
|
|
#include "libpika/pika.h"
|
|
|
|
#include "pikahelp.h"
|
|
|
|
#ifdef DISABLE_NLS
|
|
#define _(String) (String)
|
|
#else
|
|
#include "libpika/stdplugins-intl.h"
|
|
#endif
|
|
|
|
|
|
/* private variables */
|
|
|
|
static GHashTable *domain_hash = NULL;
|
|
|
|
|
|
/* public functions */
|
|
|
|
gboolean
|
|
pika_help_init (const gchar **domain_names,
|
|
const gchar **domain_uris)
|
|
{
|
|
gint i;
|
|
guint num_domain_names, num_domain_uris;
|
|
|
|
num_domain_names = domain_names? g_strv_length ((gchar **) domain_names) : 0;
|
|
num_domain_uris = domain_uris? g_strv_length ((gchar **) domain_uris) : 0;
|
|
if (num_domain_names != num_domain_uris)
|
|
{
|
|
g_printerr ("help: number of names doesn't match number of URIs.\n");
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
for (i = 0; i < num_domain_names; i++)
|
|
pika_help_register_domain (domain_names[i], domain_uris[i]);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
void
|
|
pika_help_exit (void)
|
|
{
|
|
if (domain_hash)
|
|
{
|
|
g_hash_table_destroy (domain_hash);
|
|
domain_hash = NULL;
|
|
}
|
|
}
|
|
|
|
void
|
|
pika_help_register_domain (const gchar *domain_name,
|
|
const gchar *domain_uri)
|
|
{
|
|
g_return_if_fail (domain_name != NULL);
|
|
g_return_if_fail (domain_uri != NULL);
|
|
|
|
#ifdef PIKA_HELP_DEBUG
|
|
g_printerr ("help: registering help domain \"%s\" with base uri \"%s\"\n",
|
|
domain_name, domain_uri);
|
|
#endif
|
|
|
|
if (! domain_hash)
|
|
domain_hash = g_hash_table_new_full (g_str_hash, g_str_equal,
|
|
g_free,
|
|
(GDestroyNotify) pika_help_domain_free);
|
|
|
|
g_hash_table_insert (domain_hash,
|
|
g_strdup (domain_name),
|
|
pika_help_domain_new (domain_name, domain_uri));
|
|
}
|
|
|
|
PikaHelpDomain *
|
|
pika_help_lookup_domain (const gchar *domain_name)
|
|
{
|
|
g_return_val_if_fail (domain_name, NULL);
|
|
|
|
if (domain_hash)
|
|
return g_hash_table_lookup (domain_hash, domain_name);
|
|
|
|
return NULL;
|
|
}
|
|
|
|
GList *
|
|
pika_help_parse_locales (const gchar *help_locales)
|
|
{
|
|
GList *locales = NULL;
|
|
GList *list;
|
|
const gchar *s;
|
|
const gchar *p;
|
|
|
|
g_return_val_if_fail (help_locales != NULL, NULL);
|
|
|
|
/* split the string at colons, building a list */
|
|
s = help_locales;
|
|
for (p = strchr (s, ':'); p; p = strchr (s, ':'))
|
|
{
|
|
gchar *new = g_strndup (s, p - s);
|
|
locales = g_list_append (locales, new);
|
|
s = p + 1;
|
|
}
|
|
|
|
if (*s)
|
|
locales = g_list_append (locales, g_strdup (s));
|
|
|
|
/* if the list doesn't contain the default locale yet, append it */
|
|
for (list = locales; list; list = list->next)
|
|
if (strcmp ((const gchar *) list->data, PIKA_HELP_DEFAULT_LOCALE) == 0)
|
|
break;
|
|
|
|
if (! list)
|
|
locales = g_list_append (locales, g_strdup (PIKA_HELP_DEFAULT_LOCALE));
|
|
|
|
#ifdef PIKA_HELP_DEBUG
|
|
g_printerr ("help: locales: ");
|
|
for (list = locales; list; list = list->next)
|
|
g_printerr ("%s ", (const gchar *) list->data);
|
|
g_printerr ("\n");
|
|
#endif
|
|
|
|
return locales;
|
|
}
|
