adding page doc

jupyter_book/book_template/_data/toc.yml

@@ -85,6 +85,9 @@
     - title: Controlling page layout
       url: /features/layout
       not_numbered: true
+    - title: Build an individual page instead of a book
+      url: /features/page
+      not_numbered: true
   - title: Feature Limits
     url: /features/limits
     not_numbered: true

jupyter_book/book_template/content/features/page.md

@@ -0,0 +1,23 @@
+# Building a single page instead of a book
+
+Sometimes you'd like to build a single page of content rather than an
+entire book. For example, if you'd like to generate a web-friendly HTML
+page from a Jupyter Notebook for a report or publication.
+
+You can generate a standalone HTML file for a single page of Jupyter Book
+content by running the following command:
+
+```
+jupyter-book page path/to/mybook.ipynb
+```
+
+This will do the following:
+
+1. Convert your page to HTML
+2. Add the Jupyter Book CSS and Javascript to the header of
+   that HTML.
+3. Write the result to disk
+
+The page's HTML will be missing a few Jupyter Book features, such as
+a Table of Contents, however the layout and style will largely be the
+same. [Here is an example of what this looks like](/notebooks.html).

netlify.toml

@@ -1,5 +1,5 @@
 [build]
-  command = "gem install bundler -v '2.0.2' && pip install -U git+https://github.com/jupyter/jupyter-book && jupyter-book build ./ --overwrite && bundle exec jekyll build"
+  command = "gem install bundler -v '2.0.2' && pip install -U git+https://github.com/jupyter/jupyter-book && jupyter-book build ./ --overwrite && jupyter-book page ./content/features/notebooks.ipynb -o _build && bundle exec jekyll build"
 
 [context.deploy-preview]
-  command = "gem install bundler -v '2.0.2' && pip install -e ../../ && jupyter-book build ./ --overwrite && bundle exec jekyll build"
+  command = "gem install bundler -v '2.0.2' && pip install -e ../../ && jupyter-book build ./ --overwrite && jupyter-book page ./content/features/notebooks.ipynb -o _build && bundle exec jekyll build"