transcranial / jupyter-themer

Apply custom CSS styling to your jupyter notebooks
MIT License
329 stars 53 forks source link
jupyter-notebook

jupyter-themer

https://travis-ci.org/transcranial/jupyter-themer https://pypi.python.org/pypi/jupyter-themer/0.1.0

Apply custom CSS styling to your jupyter notebooks. Contributions are welcome!

Mix and match themes by:

layout

typography

color

You can always revert back to the default:

default

Installation

pip install jupyter-themer

or

python setup.py install

Usage

NOTE: Old ipython configuration files, for example at the default ~/.ipython, may need to be removed in order for jupyter to use the correct files.

usage: jupyter-themer [-c COLOR, --color COLOR]
                      [-l LAYOUT, --layout LAYOUT]
                      [-t TYPOGRAPHY, --typography TYPOGRAPHY]
                      [-f CODE_FONT, --font CODE_FONT]
                      [-b BACKGROUND, --background BACKGROUND]
                      [-s OPTION, --show OPTION]
                      [-p PATH, --css_path PATH]

If no arguments are supplied, the program will revert the jupyter notebook style back to default.

Any combination of the style types can be specified, and the program will mix together the associated color/layout/typographic/code font/background css files accordingly, writing it to the custom.css file used by the notebook. Use -p or --css_path to specify a custom path for the css file, for example if you need per-user configuration.

To get a list of available options use the show argument, e.g. jupyter-themer --show color

For all running notebooks, a quick browser refresh will be needed to apply the stylesheet.

Available themes

-c, --color
-l, --layout
-t, --typography
-f, --font
-b, --background

License

MIT License