forked from M-Labs/nix-scripts
improved ARTIQ manual (#1)
Signed-off-by: Stephan Maka <stephan@spaceboyz.net>
This commit is contained in:
parent
9ce9ee2624
commit
d12b4c98c9
|
@ -37,6 +37,7 @@ in
|
||||||
llvm-or1k = callPackage ./pkgs/llvm-or1k.nix { inherit llvm-src; };
|
llvm-or1k = callPackage ./pkgs/llvm-or1k.nix { inherit llvm-src; };
|
||||||
llvmlite-artiq = callPackage ./pkgs/llvmlite-artiq.nix { inherit llvm-or1k; };
|
llvmlite-artiq = callPackage ./pkgs/llvmlite-artiq.nix { inherit llvm-or1k; };
|
||||||
artiq = callPackage ./pkgs/artiq.nix { inherit binutils-or1k; inherit llvm-or1k; inherit llvmlite-artiq; };
|
artiq = callPackage ./pkgs/artiq.nix { inherit binutils-or1k; inherit llvm-or1k; inherit llvmlite-artiq; };
|
||||||
|
artiq-manual = callPackage ./pkgs/artiq-manual.nix { inherit artiq; };
|
||||||
openocd = callPackage ./pkgs/openocd.nix {};
|
openocd = callPackage ./pkgs/openocd.nix {};
|
||||||
conda-artiq = import ./conda-artiq.nix { inherit pkgs; };
|
conda-artiq = import ./conda-artiq.nix { inherit pkgs; };
|
||||||
} // boardPackages
|
} // boardPackages
|
||||||
|
|
|
@ -0,0 +1,147 @@
|
||||||
|
{ stdenv, lib,
|
||||||
|
git, fetchFromGitHub, fetchgit,
|
||||||
|
python3Packages, texlive, texinfo,
|
||||||
|
artiq
|
||||||
|
}:
|
||||||
|
|
||||||
|
with python3Packages;
|
||||||
|
let
|
||||||
|
artiqVersion = import ./artiq-version.nix;
|
||||||
|
|
||||||
|
# TODO: sphinx-argparse will be available from nixos-19.XX
|
||||||
|
sphinx-argparse = buildPythonPackage rec {
|
||||||
|
pname = "sphinx-argparse";
|
||||||
|
version = "0.2.5";
|
||||||
|
|
||||||
|
src = fetchPypi {
|
||||||
|
inherit pname version;
|
||||||
|
sha256 = "05wc8f5hb3jsg2vh2jf7jsyan8d4i09ifrz2c8fp6f7x1zw9iav0";
|
||||||
|
};
|
||||||
|
|
||||||
|
checkInputs = [
|
||||||
|
pytest
|
||||||
|
];
|
||||||
|
|
||||||
|
checkPhase = "py.test";
|
||||||
|
|
||||||
|
propagatedBuildInputs = [
|
||||||
|
sphinx
|
||||||
|
];
|
||||||
|
|
||||||
|
meta = {
|
||||||
|
description = "A sphinx extension that automatically documents argparse commands and options";
|
||||||
|
homepage = https://github.com/ribozz/sphinx-argparse;
|
||||||
|
license = lib.licenses.mit;
|
||||||
|
maintainers = with lib.maintainers; [ clacke ];
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
wavedrom = buildPythonPackage rec {
|
||||||
|
pname = "wavedrom";
|
||||||
|
version = "0.1";
|
||||||
|
|
||||||
|
src = fetchPypi {
|
||||||
|
inherit pname version;
|
||||||
|
sha256 = "006w683zlmmwcw5xz1n5dwg34ims5jg3gl2700ql4wr0myjz6710";
|
||||||
|
};
|
||||||
|
|
||||||
|
buildInputs = [ setuptools_scm ];
|
||||||
|
propagatedBuildInputs = [
|
||||||
|
svgwrite attrdict
|
||||||
|
];
|
||||||
|
doCheck = false;
|
||||||
|
};
|
||||||
|
|
||||||
|
sphinxcontrib-wavedrom-1_3_1 = buildPythonPackage rec {
|
||||||
|
pname = "sphinxcontrib-wavedrom";
|
||||||
|
version = "1.3.1";
|
||||||
|
|
||||||
|
src = fetchPypi {
|
||||||
|
inherit pname version;
|
||||||
|
sha256 = "1q2hk630nz734cln2wwngjidlb7xyk6ly8qqlpsj259n9n2iab6v";
|
||||||
|
};
|
||||||
|
|
||||||
|
buildInputs = [ setuptools_scm ];
|
||||||
|
propagatedBuildInputs = [
|
||||||
|
sphinx
|
||||||
|
];
|
||||||
|
doCheck = false;
|
||||||
|
};
|
||||||
|
|
||||||
|
sphinxcontrib-wavedrom-2_0_0 = buildPythonPackage rec {
|
||||||
|
pname = "sphinxcontrib-wavedrom";
|
||||||
|
version = "2.0.0";
|
||||||
|
|
||||||
|
src = fetchPypi {
|
||||||
|
inherit pname version;
|
||||||
|
sha256 = "0nk36zqq5ipxqx9izz2iazb3iraasanv3nm05bjr21gw42zgkz22";
|
||||||
|
};
|
||||||
|
|
||||||
|
buildInputs = [ setuptools_scm ];
|
||||||
|
propagatedBuildInputs = [
|
||||||
|
sphinx wavedrom xcffib cairosvg
|
||||||
|
];
|
||||||
|
doCheck = false;
|
||||||
|
};
|
||||||
|
|
||||||
|
sphinxcontrib-wavedrom =
|
||||||
|
if builtins.compareVersions sphinx.version "1.8" == -1
|
||||||
|
then sphinxcontrib-wavedrom-1_3_1
|
||||||
|
else sphinxcontrib-wavedrom-2_0_0;
|
||||||
|
|
||||||
|
latex = texlive.combine {
|
||||||
|
inherit (texlive)
|
||||||
|
scheme-basic latexmk cmap collection-fontsrecommended fncychap
|
||||||
|
titlesec tabulary varwidth framed fancyvrb float wrapfig parskip
|
||||||
|
upquote capt-of needspace;
|
||||||
|
};
|
||||||
|
|
||||||
|
isLatexPdfTarget = target: builtins.match "latexpdf.*" target != null;
|
||||||
|
|
||||||
|
artiq-manual = target: stdenv.mkDerivation rec {
|
||||||
|
name = "artiq-manual-${target}";
|
||||||
|
version = artiqVersion;
|
||||||
|
|
||||||
|
src = import ./artiq-src.nix { inherit fetchgit; };
|
||||||
|
buildInputs = [
|
||||||
|
sphinx sphinx_rtd_theme
|
||||||
|
sphinx-argparse sphinxcontrib-wavedrom
|
||||||
|
artiq
|
||||||
|
] ++
|
||||||
|
lib.optional (isLatexPdfTarget target) latex ++
|
||||||
|
lib.optional (target == "texinfo") texinfo;
|
||||||
|
|
||||||
|
preBuild = ''
|
||||||
|
export VERSIONEER_OVERRIDE=${artiqVersion}
|
||||||
|
cd doc/manual
|
||||||
|
'';
|
||||||
|
makeFlags = [ target ];
|
||||||
|
|
||||||
|
installPhase =
|
||||||
|
let
|
||||||
|
dest = "$out/share/doc/artiq-manual";
|
||||||
|
in
|
||||||
|
if isLatexPdfTarget target
|
||||||
|
then ''
|
||||||
|
mkdir -p ${dest}
|
||||||
|
cp _build/latex/ARTIQ.pdf ${dest}/
|
||||||
|
|
||||||
|
mkdir -p $out/nix-support/
|
||||||
|
echo doc-pdf manual ${dest} ARTIQ.pdf >> $out/nix-support/hydra-build-products
|
||||||
|
''
|
||||||
|
else ''
|
||||||
|
mkdir -p ${dest}
|
||||||
|
cp -r _build/${target} ${dest}/
|
||||||
|
|
||||||
|
mkdir -p $out/nix-support/
|
||||||
|
echo doc manual ${dest}/${target} index.html >> $out/nix-support/hydra-build-products
|
||||||
|
'';
|
||||||
|
};
|
||||||
|
|
||||||
|
# TODO: starting with NixOS 19.XX, drop sphinxcontrib-wavedrom-1_3_1
|
||||||
|
# and simplify `targets`:
|
||||||
|
targets = [
|
||||||
|
"html" "singlehtml"
|
||||||
|
] ++ (lib.optional (builtins.compareVersions sphinxcontrib-wavedrom.version "2.0.0" != -1) "latexpdf");
|
||||||
|
in
|
||||||
|
builtins.listToAttrs (map (target: { name = target; value = artiq-manual target; }) targets)
|
12
main.nix
12
main.nix
|
@ -28,18 +28,6 @@ in
|
||||||
src = generatedNix;
|
src = generatedNix;
|
||||||
constituents = builtins.attrValues jobs;
|
constituents = builtins.attrValues jobs;
|
||||||
};
|
};
|
||||||
docs = pkgs.runCommand "docs"
|
|
||||||
{
|
|
||||||
buildInputs = [
|
|
||||||
(pkgs.python3.withPackages(ps: [ artiqpkgs.sphinx-argparse artiqpkgs.sphinxcontrib-wavedrom ps.sphinx_rtd_theme ps.sphinx ]))
|
|
||||||
];
|
|
||||||
}
|
|
||||||
''
|
|
||||||
mkdir $out
|
|
||||||
VERSIONEER_OVERRIDE=${artiqVersion} sphinx-build ${artiqSrc}/doc/manual $out/html
|
|
||||||
mkdir $out/nix-support
|
|
||||||
echo doc manual $out/html >> $out/nix-support/hydra-build-products
|
|
||||||
'';
|
|
||||||
extended-tests = pkgs.runCommand "extended-tests" {
|
extended-tests = pkgs.runCommand "extended-tests" {
|
||||||
propagatedBuildInputs = [
|
propagatedBuildInputs = [
|
||||||
(pkgs.python3.withPackages(ps: [ artiqpkgs.artiq artiqpkgs.artiq-board-kc705-nist_clock ]))
|
(pkgs.python3.withPackages(ps: [ artiqpkgs.artiq artiqpkgs.artiq-board-kc705-nist_clock ]))
|
||||||
|
|
Loading…
Reference in New Issue