Skip to content

Esupports Hop

github-actions[bot] edited this page Apr 12, 2024 · 422 revisions

core.esupports.hop

Follow Various Link Locations

esupport.hop handles the process of dealing with links so you don't have to

Overview

The hop module serves to provide an easy way to follow and fix broken links with a single keypress.

By default, pressing <CR> in normal mode under a link will attempt to follow said link. If the link location is found, you will be taken to the destination - if it is not, you will be prompted with a set of actions that you can perform on the broken link.

Configuration

  • external_filetypes
    (empty list)

    List of strings specifying which filetypes to open in an external application, should the user want to open a link to such a file.

  • fuzzing_threshold
    (number)

    This value determines the strictness of fuzzy matching when trying to fix a link. Zero means only exact matches will be found, and higher values mean more lenience.

    0.5 is the optimal default value, and it is recommended to keep this option as-is.

    0.5
  • lookahead
    (boolean)

    If true, will attempt to find a link further than your cursor on the current line, even if your cursor is not over the link itself.

    true

Required Modules

  • core.dirman.utils - A set of utilities for the core.dirman module.
  • core.integrations.treesitter - A module designed to integrate Treesitter into Neorg.
  • core.ui - A set of public functions to help developers create and manage UI (selection popups, prompts...) in their modules.