hide-code 0.2.0

A Jupyter notebook extension to hide code and prompts.

Hide_code

Release build

Development build

Introduction

hide_code is an extension for Jupyter/IPython notebooks to selectively hide code and prompts. Make a notebook a code free document for exporting or presenting with a single click by pressing

Normal

Hide code enabled

Or customize each cell by selecting “Hide code” from the Cell Toolbar dropdown. Then use “Hide Code” and “Hide Prompts” checkboxes to hide the specific cell’s code or cell’s input/output prompts.

Normal

Hide code enabled

Exporting

Exporting respects hide code/prmpt cell selections only. Output is saved in Jupyter’s current working directory with the notebook’s file name + ‘.html’ or ‘.pdf’.**Exporting to PDF via notebook requires** wkhtmltopdf.

This feature continues to evolve. Items on the road map incude:

• saving to a different file loaction.

• saving as a different file name.

• support for custom CSS.

• single click exporting with all code and prompts hidden (similar to how the toolbar button).

Via notebook

To export via HTML or PDF simply click on the respective button.

Via nbconvert command line

To export via nbconvert command line, nbconvert 4.2 or later is required. Hide_code adds two export options to nbconvert, hide_code_html and hide_code_pdf.

Note: PDF exporting via command line uses nbconvert’s built in PDF exporter.

jupyter nbconvert –to hide_code_html notebook_to_convert.ipynb

jupyter nbconvert –to hide_code_pdf notebook_to_convert.ipynb

Installation

Via pip

pip install hide_code

Via setuptools

1. Download and unzip this repository.

2. Change to unzipped directory.

3. Execute python setup.py install

Installation Troubleshooting

If installation complains the directory doesn’t exist, you’re Jupyter/IPython installation probably isn’t in one of the usual places. Locate Jupyter’s configuration directory, then use code below to install in a non-standard directory.

` import hide_code.hide_code as hc dir = “<full path to Jupyter config directory>” hc.install(dir) `

Requirements

• Jupyter notebook 4.x+

• Jupyter nbconvert 4.2+ if using nbconvert command line exporting

• pdfkit & wkhtmltopdf

• Python 2.7 or 3.3+