Hiding or removing code blocks or entire cells

In this case, you have two options:

• Hiding the inputs of a code cell will hide the cell's contents and providea button that lets readers reveal the content.
• Removing the inputs (or the entire cell) will prevent the contents frommaking it into your book's HTML. It will be entirely gone (though still present inthe file) In both cases, Jupyter Books uses notebook cell tags to determine which code cells to hide.To make this process easier to manage, we recommend theJupyterLab Cell Tags extension

If you add the tag hide_input to a cell, then Jupyter Book will hide the cell butdisplay the outputs.

Here's an example of cell metadata that would trigger the "hide code" behavior:

Jupyter Book will display a small button to the right of the location that used to hold the hidden contents. If a user clicks the button,the contents will be displayed. For example, see the cell below contains the tag:

import matplotlib.pyplot as plt
plt.ion()
 
data = np.random.randn(2, 100)
fig, ax = plt.subplots()
ax.scatter(*data, c=data[1], s=100*np.abs(data[0]));

Note how we only see the output by default. Now try clicking the buttonto the right of the empty spot above!

Note that this button only shows up for cells where you've hidden the code:

This cell will show up!

Removing inputs from the HTML

To remove the inputs of a cell:

The following cell demonstrates removing inputs. Note that inthis case, there is no button available to show the input contents,the entire input cell is gone!

Removing inputs

The following cell has its inputs removed

Similar to hiding inputs, it is also possible to hide the outputsof a cell.

To remove the outputs of a cell:

{
        "remove_output",
    ]
}

Removing an entire cell

To remove both the inputs and outputs of a cell, add the tag remove_cell to the tagsof the cell. Here's an example of cell metadata that would trigger the "remove cell" behavior:

These cells will be entirely removed from each book page - remember that if you'd like tooptionally display the inputs of a cell instead, you should use the tag.

For example, there's a cell below this one that won't make it into the final book,because it has been removed!

Sometimes, you have extra Markdown in your documents that isn't meant for thereader. For example, if you want to organize your notebook based on developer-relevantinformation (like "# Import packages") but you don't want the reader to see this.

In this case, you can use the remove_cell pattern described above as well.

Here's an example of markdown cell metadata that would trigger the "hide text" behavior:

{
    "tags": [
        "remove_cell",
    ]
}

Removing empty cells

You don't need to do anything to remove empty cells from your pages.Jupyter Book will remove these automatically. Any cell with _only_whitespace will be removed.

This page was created by The Jupyter Book Community