github executablebooks/jupyter-book v0.6.0
on GitHub

latest releases: v1.0.0, v1.0.0rc1, v0.15.1...
4 years ago

v0.6.0 (2019-09-17)

Full Changelog

Major changes

This version of Jupyter Book contains several major enhancements to the book's
build process and layout. Here as some major highlights:

Page build process

When you run jupyter-book build, your pages will now be converted into HTML
instead of Jekyll Markdown. This uses nbconvert under the hood, and should make
behavior more consistent (and less-dependent on Jekyll's specific markdown flavor, Kramdown).
This will also make it easier to build individual page HTML without requiring a full book.

Page layout enhancements.

There are a number of enhancements to the layout of each page of the book.
The topbar is now sticky, and uses whitespace more effectively. In addition, the
right TOC will now only show up when the page is wide enough, and let the user
hover over it to see the page's TOC content on narrower screens.

ag6EmkYWp0

Jupytext integration

✨✨experimental✨✨

Jupyter Book can now build page HTML from Jupytext text files. This allows
you to store your book content in plain text and convert into Jupyter Notebooks
and page HTML at build time. See the documentation on using jupytext
for more information.

PDF downloads

There's now a button that uses PrintJS to download a PDF version of each
page of your book. This will let readers download content offline and
read on their own.

image

TOC auto-generation

We've improved the auto-generation of the Table of Contents for a folder
of book content. This should make it easier to quickly get started
generating a TOC file for your Jupyter Book.

Popouts and full-width cells

There are now two different kinds of cell layouts. popouts will
be placed to the right of your book content. This allows you to call out
information without disrupting the narrative flow of your page. full-width
cells will take up a larger width on the page, causing the reader to focus on
this information. This makes it easier to highlight wide-form visual content.
Here are a few examples of this, you can find out more on the layouts documentation

image

Footers

You can now add a configurable footer to each page of your book! You can
do so from the footer_text field in the config.yml file for your book.

image

PRs and Issues

Implemented enhancements:

Fixed bugs:

Closed issues:

  • Jupyter Notebook can't close a running notebook #317
  • Building book fails with a jinja2.exceptions.TemplateNotFound error #310
  • serving non- md/ipynb content #295
  • Broken links #259
  • Missing file error #253
  • Multicursor sometimes only deletes one line when there's spaces #251
  • Release summary for v0.6 #331

Merged pull requests:

Check out latest releases or
releases around executablebooks/jupyter-book v0.6.0

Don't miss a new jupyter-book release

NewReleases is sending notifications on new releases.

Get notifications