search

OleVik / grav-theme-scholar

Scholar is an academic-focused theme, for publishing papers, articles, books, documentation, your blog, and even your resumé, with Grav.
https://olevik.net/staging/grav-skeleton-scholar
MIT License
15 stars 2 forks source link

Feature: List of backlinks #14

Closed andjar closed 4 years ago

andjar commented 4 years ago

Hi Ole,

Having a list of backlinks is a quite hot feature at the moment, as it allows you to see new connections between ideas and content, and it can be easily integrated into this theme as well (eg. http://ewy.no/blog/tiddlywiki, the modified code can be found here: http://ewy.no/blog/en-begynnelse-grav)

Maybe it's worth considering?

OleVik commented 4 years ago

Which plugin are you using for getting the backlinks, Perlkonig's? Looking at the code, are backlinks all internal within the site? That is, are they then distinct from "pingbacks"? Both would be a useful feature, the former easier to integrate of course.

Scholar's architecture is very flexible and extensible, so adding in features in subservient plugins is quite a lot easier than with other plugins, so it may well be a viable extension.

andjar commented 4 years ago

Yeah, it is using Perlkonig's backlink plugin and list those linking to the current page. A reddit search shows that it is a popular feature request, especially for note taking applications. I agree with you that scholar semms very flexible and is structured in a very logical manner, well done!

OleVik commented 4 years ago

The most apt manner of integration would be to utilize Perlkonig's plugins (backlinks and webmentions), which I know to be excellently written, and use the data if the plugins are exposing it. There are some varied conventions for where to render backlinks and pingbacks, though I would favor below the related Page(s) links but above the footer. Eg. above "Made with the Scholar Theme, powered by Grav" on https://olevik.me/staging/grav-skeleton-scholar/blog/overcast.

In the Scholar theme this would just be a default for where to render the template, easily overridden by child-themes. I'll evaluate whether both warrant feature into the core set of templates, or whether it would be better to expose them as components.

OleVik commented 4 years ago

I added a component compatible with - and dependent on - the Backlinks-plugin, named "What Links Here" in v2.1.0-beta.1. The term "backlinks" is a bit misleading, as it's also used more generally for external links to a page, essentially pingbacks and webmentions. "What Links Here" seems to be more common in the wiki-software from which it stems.

andjar commented 4 years ago

Very nice, Ole! Thank you, I am excited to test it!

OleVik commented 4 years ago

It's available on the GPM now if you have it set to testing rather than stable, and thanks for the suggestion and testing.

OleVik commented 4 years ago

Released as stable in v2.1.0.