[tracker/sam/ontology-docs: 21/25] docs: Fix references to resources in libtracker-sparql docs



commit 36bcb7b5e1033019091a8d1de4a54acf27a301a7
Author: Sam Thursfield <sam afuera me uk>
Date:   Mon Apr 13 01:56:17 2020 +0200

    docs: Fix references to resources in libtracker-sparql docs
    
    This requires adding 'role' attributes to the links we want
    gtk-doc to process. It doesn't seem to matter what the value
    of the 'role' attribute is, just that it's there.

 docs/reference/ontology/meson.build | 1 +
 docs/tools/ttlresource2xml.c        | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)
---
diff --git a/docs/reference/ontology/meson.build b/docs/reference/ontology/meson.build
index b3ab93d79..acb353c24 100644
--- a/docs/reference/ontology/meson.build
+++ b/docs/reference/ontology/meson.build
@@ -16,5 +16,6 @@ generated = custom_target('ontology-doc-generated',
 gnome.gtkdoc('ontology',
     src_dir: include_directories('.'),
     main_xml: 'ontology-docs.xml',
+    fixxref_args: fixxref_args,
     install_dir: 'tracker@0@-nepomuk'.format(tracker_api_major),
     install: true)
diff --git a/docs/tools/ttlresource2xml.c b/docs/tools/ttlresource2xml.c
index 02ce115aa..7669174a8 100644
--- a/docs/tools/ttlresource2xml.c
+++ b/docs/tools/ttlresource2xml.c
@@ -593,7 +593,7 @@ print_property_table (FILE          *f,
                g_fprintf (f, "<indexterm zone='%s.%s'><primary sortas='%s'>%s</primary></indexterm>",
                           id, prop_id, shortname, shortname);
                /* This anchor is globally unique and can be used for internal links */
-               g_fprintf (f, "<anchor id='%s.property.%s' />", id, basename);
+               g_fprintf (f, "<anchor role='rdf-property' id='%s.property.%s' />", id, basename);
                /* This anchor is unique within the refentry and can be used for external links */
                g_fprintf (f, "<anchor id='%s' />", basename);
                g_fprintf (f, "%s", basename);
@@ -691,7 +691,7 @@ print_ontology_class (Ontology      *ontology,
        /* Anchor for external links. */
        g_fprintf (f, "<anchor id='%s' />\n", name);
 
-       g_fprintf (f, "<refsect2 id='%s'>\n", id);
+       g_fprintf (f, "<refsect2 role='rdf-class' id='%s'>\n", id);
        g_fprintf (f, "<title>%s</title>\n", name);
 
        g_fprintf (f, "<refsect3 id='%s.description'>\n", id);


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]