MyNixOS website logo
Description

Vignette Engine Wrapping Jupyter Notebooks.

Calls the 'Jupyter' script 'nbconvert' to create vignettes from notebooks. Those notebooks ('.ipynb' files) are files containing rich text, code, and its output. Code cells can be edited and evaluated interactively. See <https://jupyter.org/> for more information.

nbconvertR

Travis build status AppVeyor build status

A small shim to use jupyter’s nbconvert as vignette engine and Jupyter notebooks as vignette sources.

To get started, create a notebook in the vignettes/ directory of your package, and a .ipynbmeta file of the same name next to it.

E.g. next to the notebook vignettes/floob.ipynb, create vignettes/floob.ipynbmeta:

%\VignetteIndexEntry{About Floob}
%\VignetteEngine{nbconvertR::nbconvert}

Don’t forget VignetteBuilder: nbconvertR in your DESCRIPTION file!

Options

There are some customization options available that you can put into your .ipynbmeta file.

  1. You can use custom templates via %\VignetteTemplate{<format>}{<filename>}.

    E.g. %\VignetteTemplate{latex}{floob.tplx} will result in nbconvert --template floob.tplx ... being called when converting to LaTeX.

  2. Another mighty customization option are preprocessors: %\VignettePreprocessors{<format>}{<module>.<Preproc>[, ...]}

    This will pass --<Format>Exporter.preprocessors=["<module>.<Preproc>",...] to nbconvert. It’s possible to specify multiple comma-separated preprocessors in one line.

Installation

The system requirements include nbconvert and pandoc.

nbconvert can easily be installed with the usual python package managers: pip install nbconvert or conda install nbconvert. At least Arch Linux users can find it in the official repositories: pacman -S jupyter-nbconvert

Pandoc is in the repositories of most linux distributions (e.g. apt-get install pandoc or pacman -S pandoc) and Homebrew for OS X (brew install pandoc), and has windows and OS X installers for each release (Download links are below the release notes). Otherwise look here.

Metadata

Version

1.3.2

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows