Backlinks

Yore embeds a backlink system based on jmooring/hugo-module-backlinks to track and display bidirectional links.

Principle

The system utilizes Hugo's render-link hook to capture internal references. It functions by passing the link's destination to the .GetPage method. If Hugo successfully resolves the path to a page, a backlink entry is recorded in the site-wide store.

Setup

Enable the backlinks output format in hugo.yaml:

outputs:
  home:
    - HTML
    - RSS
    - backlinks
outputFormats:
  backlinks:
    mediaType: application/json
    baseName: backlinks
    isPlainText: true
    notAlternative: true
    weight: 1
params:
  backlinkEnabled: true

Link Resolution

To ensure backlinks are correctly indexed, use paths relative to the current file or the content directory.

For example, with this directory structure:

content/
├── docs/
│   ├── installation
│   │   └── index.md
│   └── usage.md
└── posts/
    └── feature-update.md

In docs/installation/index.md, you can reference the other content using:

• [text](../usage.md)
• [text](/posts/feature-update.md) or [text](../../posts/feature-update.md)

And in docs/usage.md, you can reference the other content using:

• [text](./installation/index.md)
• [text](/posts/feature-update.md) or [text](../posts/feature-update.md)