About
About This Repository
Welcome to the Quarto Notebook Publish Demo repository! This repository serves as a demonstration of how to integrate Jupyter notebooks with Quarto for rendering and publishing.
Purpose
The primary goal of this repository is to showcase the capabilities of Quarto in converting Jupyter notebooks into beautifully formatted HTML documents. It provides an example of how to include code, outputs, and markdown content while using Quarto’s powerful features.
Features
- Jupyter Notebook Integration: Easily convert existing Jupyter notebooks into Quarto format.
- Customizable Output: Specify front matter to control document settings such as titles, authors, and output formats.
- Code Control: Options to include or exclude code and outputs, allowing for clean presentations.
- Interactive Visualisations: Examples of creatoing and display plots using libraries like Matplotlib and Seaborn.
- GitHub Actions: Automated rendering and publishing of notebooks using GitHub Actions.
Getting Started
Clone the Repository:
git clone https://github.com/DataBooth/quarto-nb-publish-demo.git cd quarto-nb-publish-demo
Install Quarto: Make sure you have Quarto installed on your system. You can find installation instructions on the Quarto website. On macOS this is simplyy:
brew install --cask quarto
Render Notebooks: Use the following command to render the notebooks:
quarto render
View Published Site: After rendering, view the output in the
_site
directory or publish it using GitHub Pages.