Books & Websites
This page describes how you can publish full websites for more complex data science projects - like Jupyter Books - to Kyso.
There is a little more to publishing full websites over simple, single-page HTML files. For this doc, we're going to use two separate examples. But do note that Kyso will render any website.
https://kyso.io/kyso-examples/financial-services/quantitative-economics-with-python/
Jupyter Book Website on Kyso
A Jupyter Book is compiled to HTML from multiple Jupyter Notebooks, with optional JS and/or CSS styling. See Jupyter's gallery for examples:
We cover the basics of Jupyter Book creation in this document. Please refer to the official Jupyter documentation for more robust information on creating your Book reports:
First you need to install the jupyter-book package. You can install Jupyter Book via
pip
:// pip install -U jupyter-book
// conda install -c conda-forge jupyter-book
This will install everything you need to build a Jupyter Book locally.
Once you’ve added content (notebooks) and configured your book, it’s time to build outputs for your book.
You can use the
jupyter-book build
command line tool for this. You should already have a collection of notebook/Markdown files in your mybookname/
folder, a _toc.yml
file that defines the structure of your book, and any configuration you’d like in the _config.yml
file.Now that your book’s content is in your book folder and you’ve defined your book’s structure in
_toc.yml
, you can build the HTML for your book. Do so by running the following command:// jupyter-book build mybookname/
This will generate a fully-functioning HTML site using a static site generator. The site will be placed in the
_build/html
folder, something like this:mybookname
└──_build
└── html
├── _images
├── _static
├── index.html
├── intro.html
...
You can now publish to Kyso. Make sure you specify the main file in the reports YAML, for example:
main: _build/html/index.html
This use case is for R users who compile their projects to HTML. Example:
https://kyso.io/kyso-examples/financial-services/guide-to-wise-investing/
Bookdown Website on Kyso
Very similar to Jupyter Books, you need to compile your R Markdown project files into HTML. Rather than duplicating documentation, follow the link below to learn how to do this:
As with Jupyter Books, make sure you specify that
index.html
or intro.html
as your main entry point for the report on Kyso!Last modified 2d ago