summaryrefslogtreecommitdiff
path: root/pkgs/development/python-modules/sphinx-hoverxref/default.nix
blob: a476099165d4b8f0bb2805dc57a78babecea7644 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
{
  lib,
  buildPythonPackage,
  fetchFromGitHub,
  flit-core,
  # documentation build dependencies
  sphinxHook,
  sphinx-notfound-page,
  sphinx-prompt,
  sphinx-rtd-theme,
  sphinx-tabs,
  sphinx-version-warning,
  sphinx-autoapi,
  sphinxcontrib-bibtex,
  sphinxemoji,
  # runtime dependencies
  sphinx,
  sphinxcontrib-jquery,
}:

buildPythonPackage rec {
  pname = "sphinx-hoverxref";
  version = "1.5.0";
  pyproject = true;

  outputs = [
    "out"
    "doc"
  ];

  src = fetchFromGitHub {
    owner = "readthedocs";
    repo = "sphinx-hoverxref";
    rev = version;
    hash = "sha256-JHNJGUkO/HXnnnROYBd1pAcoAEYo6b7eK4tyC+ujc+A=";
  };

  postPatch = ''
    substituteInPlace docs/conf.py --replace-fail "sphinx-prompt" "sphinx_prompt"
  '';

  build-system = [
    flit-core
  ];

  nativeBuildInputs = [
    sphinxHook
    sphinx-autoapi
    sphinx-rtd-theme
    sphinx-tabs
    sphinx-prompt
    sphinx-version-warning
    sphinx-notfound-page
    sphinxcontrib-bibtex
    sphinxemoji
  ];

  dependencies = [
    sphinx
    sphinxcontrib-jquery
  ];

  pythonImportsCheck = [ "hoverxref" ];

  meta = {
    description = "Sphinx extension for creating tooltips on the cross references of the documentation";
    longDescription = ''
      sphinx-hoverxref is a Sphinx extension to show a floating window
      (tooltips or modal dialogues) on the cross references of the
      documentation embedding the content of the linked section on them.

      With sphinx-hoverxref, you don’t need to click a link to see what’s
      in there.
    '';
    homepage = "https://github.com/readthedocs/sphinx-hoverxref";
    license = lib.licenses.mit;
    maintainers = with lib.maintainers; [ kaction ];
  };
}