Once you’ve generated the markdown for your notebooks, your site is ready to be pushed and served by GitHub. To do this, take the following steps:
- Confirm that your site files are built. You should see a
collection of markdown files/folders in the
_buildfolder, or a collection of HTML in your
- Commit and push the changes to your repository.
Enable GitHub site building for your repository.
From your GitHub repository, click
Settingsthen scroll down to the
GitHub Pagessection. You should see the message
Your site is published at <YOUR-URL>. Ensure that you’re building from the correct folder.
- Go to the URL listed at
<YOUR-URL>and you should see your live site.
To preview your built site locally
You can also preview your built site using Jekyll on your computer. To do this, you must take the following steps:
- Ensure that Jekyll and Ruby are installed.
- Ensure that your notebooks have been converted to markdown, there should be a
collection of them in
Run the Jekyll site preview command:
This should open up a port on your computer with a live version of the book.