Fossil User Forum

How to use backlinks?
Login

How to use backlinks?

How to use backlinks?

(1) By matt w. (maphew) on 2021-07-15 05:49:44 [link] [source]

I see two references for backlinks in the docs, one in a changelog mentioning fixing the backlink feature "so that it works for wiki pages". (ref).

How is this feature used? For instance can I ask Fossil to "show all the wiki pages that link to {here}"? What about embedded documentation?

Thanks!

(2) By Richard Hipp (drh) on 2021-07-15 15:17:01 in reply to 1 [link] [source]

For example, the check-in f74f7014c2271beb is mentioned in the check-in comments of two other check-ins. Those other two check-ins are hence shown in the "References" section of the check-in page. This is accomplished using the backlink table.

Another example: check-in b2dacfcd735d4b1c is mentioned by the To Do List wiki page, so it has an entry in its "References" section that points back to the To Do List.

(3) By matt w. (maphew) on 2021-07-16 06:30:55 in reply to 2 [link] [source]

ok, let me see if I have this straight: The backlinks feature looks for mentions of commit hashes* and then creates links between those references. This is automatic and there's no mechanism at present to invoke it without specifically adding the hash number to a page or checkin comment (and presumably forum posts and tickets(?)). In fossil the term backlinks is not used in quite the same way traditional wiki software might.

*(Do the phrases 'commit hash' and 'artifact id' mean the same thing?)

(4) By Stephan Beal (stephan) on 2021-07-16 07:00:56 in reply to 3 [link] [source]

The backlinks feature looks for mentions of commit hashes and then creates links between those references. This is automatic and there's no mechanism at present to invoke it without specifically adding the hash number to a page or checkin comment (and presumably forum posts and tickets(?)).

Correct.

In fossil the term backlinks is not used in quite the same way traditional wiki software might.

If you mean references to external blogs or wiki articles, definitely not. If you mean something else, then i've no clue what that might be ;).

(Do the phrases 'commit hash' and 'artifact id' mean the same thing?)

Yes, as does "artifact hash." They were also commonly called UUIDs at some point, but that term fell out of favor because many felt that it's best reserved for the standardized(?) UUID format(s). In the db schema they're still called UUIDs.

(5.1) By matt w. (maphew) on 2021-09-07 22:20:58 edited from 5.0 in reply to 4 [source]

If you mean references to external blogs or wiki articles, definitely not. If you mean something else, then i've no clue what that might be ;).

No not external, I mean "what other wiki pages link to this wiki page" within same site. For instance: https://wiki.c2.com/?BackLink.

Thanks for the other clarifications.

(6) By Stephan Beal (stephan) on 2021-09-07 22:31:57 in reply to 5.1 [link] [source]

No not external, I mean "what other wiki pages link to this wiki page" within same site.

There's no mechanism for making active use of those. They're automatically calculated when content is updated in the db and then various views make use of them.