Forum OpenACS Q&A: xowiki backlinks

Collapse
Posted by Jeff Rogers on
Is there a way to automatically generate a list of backlinks to an xowiki page? That is, something like the mediawiki "Special:WhatLinksHere" special page.
Collapse
2: Re: xowiki backlinks (response to 1)
Posted by Gustaf Neumann on
XoWiki has a package parameter named "show_page_references" which can be turned on (via admin), then back-links are displayed at the bottom of the rendered page content (see e.g. https://openacs.org/xowiki/naviserver-openacs).

In case one wants the listing of the referencing pages on an arbitrary place inside a wiki, one can use the includelet {{my-references}}.

Collapse
3: Re: xowiki backlinks (response to 2)
Posted by Jeff Rogers on
Ah, that's exactly what I was looking for.

Two things - 1, I missed it in the docs, in part because it's only listed in the includelet list as "my-references" with no description. Could the {{available-includelets}} feature include the documentation summary about the available items, and/or links to the specific docs on them?

2 - the page references don't get updated when a page is first created. That is, if I include a link to a non-existent page on "Foo_Page" it gets rendered in red as expected on that page; if I click on the red link I get taken to a form to create that page, as expected, and then I go back to Foo_Page the link is now active; however the reference does not exist until I edit and re-save Foo_Page again. This has the effect of the easiest way to create new pages leading to apparently orphaned pages.

Collapse
4: Re: xowiki backlinks (response to 3)
Posted by Gustaf Neumann on
Jeff, many thanks, are right on both items.

Concerning 1) I've updated most of the includelets to contain some comments.. These comments are included in {{available-includelets}} (scroll down on https://openacs.org/xowiki/xowiki) and these are included in the object browser (see https://openacs.org/xotcl/show-object?object=::xowiki::includelet::my-references). Some of the includelets are end-user-friendly, some are more useful for developers, some are just used for sub-classing.

Concerning 2) This looks like a bug to me. I've added an entry to the issue tracker
https://openacs.org/bugtracker/openacs/bug?bug_number=3426

all the best

Collapse
5: Re: xowiki backlinks (response to 1)
Posted by Gustaf Neumann on
Jeff, when possible, check the solution just committed to oacs-5-10 branch (commented on the issue tracker).

all the best
-g

Collapse
6: Re: xowiki backlinks (response to 1)
Posted by Gustaf Neumann on
Some more news on this topic

* Now, the includelet {{unresolved-references}} is based on the new table. This is much faster than the previous approach.
* There is a new includelet {{references-graph}}, showing the link structure of a page, including broken links (Example: https://openacs.org/xowiki/references-graph-test)

all the best