Metadata-Version: 2.1
Name: rise
Version: 5.3.0
Summary: Reveal.js - Jupyter/IPython Slideshow Extension
Home-page: UNKNOWN
Author: Damián Avila
Author-email: info@oquanta.info
License: BSD-3-Clause
Project-URL: gitter, https://gitter.im/damianavila/RISE
Project-URL: documentation, http://rise.readthedocs.io
Project-URL: source, http://github.com/damianavila/RISE
Keywords: jupyter,ipython,presentation,slides,revealjs
Platform: Linux
Platform: Mac OS X
Platform: Windows
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4
Requires-Dist: notebook (>=5.5.0)

# RISE

RISE allows you to instantly turn your Jupyter Notebooks into a
slideshow. No out-of-band conversion is needed, switch from jupyter
notebook to a live *reveal.js*-based slideshow in a single keystroke,
and back.

![Basic usage](https://media.giphy.com/media/3oxHQtTxAaZwMOHr9u/giphy.gif)

## Resources
RISE stands for
***Reveal.js - Jupyter/IPython Slideshow Extension***:

* Demo notebook (no installation required)
  * [![](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/parmentelat/RISE.git/doc2?filepath=examples%2FREADME.ipynb)

* Source code is on github <https://github.com/damianavila/RISE>
  * [![Issues](http://img.shields.io/github/issues/damianavila/RISE.svg)](https://github.com/damianavila/RISE/issues)

* Documentation is hosted on readthedocs
  * [![doc status](https://readthedocs.org/projects/rise/badge)](http://rise.readthedocs.io/en/latest/)
  * Note / check out another location here that is planned to be phased out: <https://damianavila.github.io/RISE/>

* Chat room on gitter
  * [![Gitter chat](https://badges.gitter.im/damianavila/RISE.png)](https://gitter.im/damianavila/RISE "Gitter chat")

* Videos on youtube
  * basic usage (4'30'')

    <https://youtu.be/sXyFa_r1nxA>


## Installation

From the most simple to the most complex one, you have 3 options:

### Option 1 - Using conda (recommended):

```
conda install -c damianavila82 rise
```

If you are a Julia user, you can do this from the Julia REPL with
```
using Conda
Conda.add_channel("damianavila82")
Conda.add("rise")
```

### Option 2 - Using pip (less recommended):

```
pip install RISE
```

and then one more step to install the JS and CSS in the proper places:

```
jupyter-nbextension install rise --py --sys-prefix
```

As of version 5.3.0, it is **no longer required** to explicitly enable
the nbextension, which you would do with

```
jupyter-nbextension enable rise --py --sys-prefix
```

### Option 3 - The old way (are sure sure you want to go this path?):

To install this nbextension, simply run ``python setup.py install`` from the
*RISE* repository (please use the latest tag available or try master if you want).

And then the same step as described in the pip-based installation:

```
jupyter-nbextension install rise --py --sys-prefix
```

### Conclusion

If you use conda, life will be easy ;-)

**NOTE**: in all the options available the `--sys-prefix` option will install and
enable the extension in the current environment, if you want a `--user` based or a
`--system` based installation just use those options instead in the above commands.

## Development

To install RISE in development mode, see the
[Developer section](https://damianavila.github.io/RISE/dev/develop.html) of the RISE
documentation.

## Feedback

If you have any feedback, or find any bugs, please let me know just opening
an issue.


