diff options
Diffstat (limited to 'nixpkgs/pkgs/development/python-modules/sphinx-better-theme/default.nix')
-rw-r--r-- | nixpkgs/pkgs/development/python-modules/sphinx-better-theme/default.nix | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/nixpkgs/pkgs/development/python-modules/sphinx-better-theme/default.nix b/nixpkgs/pkgs/development/python-modules/sphinx-better-theme/default.nix new file mode 100644 index 000000000000..8227eca47d84 --- /dev/null +++ b/nixpkgs/pkgs/development/python-modules/sphinx-better-theme/default.nix @@ -0,0 +1,45 @@ +{ lib, buildPythonPackage, fetchFromGitHub, sphinxHook }: + +buildPythonPackage rec { + pname = "sphinx-better-theme"; + version = "0.1.5"; + outputs = [ "out" "doc" ]; + + src = fetchFromGitHub { + owner = "irskep"; + repo = "sphinx-better-theme"; + rev = "v${version}"; + sha256 = "07lhfmsjcfzcchsjzh6kxdq5s47j2a6lb5wv3m1kmv2hcm3gvddh"; + }; + + nativeBuildInputs = [ sphinxHook ]; + + pythonImportsCheck = [ "better" ]; + + meta = with lib; { + homepage = "https://github.com/irskep/sphinx-better-theme"; + description = "Better Sphinx Theme"; + longDescription = '' + This is a modified version of the default Sphinx theme with the following + goals: + + 1. Remove frivolous colors, especially hard-coded ones + 2. Improve readability by limiting width and using more whitespace + 3. Encourage visual customization through CSS, not themeconf + 4. Use semantic markup + + v0.1 meets goals one and two. Goal three is partially complete; it's simple to + add your own CSS file without creating a whole new theme. + you'd like something changed. + + To use the theme, set ``html_theme_path`` to contain + ``better.better_theme_path``, and set ``html_theme`` to ``'better'``:: + + from better import better_theme_path + html_theme_path = [better_theme_path] + html_theme = 'better' + ''; + license = licenses.bsd2; + maintainers = with maintainers; [ kaction ]; + }; +} |