Highβlevel guide for someone new to Quarto and this project.
- This is a Quarto project configured as a book (multiβchapter report). A Quarto project is simply a folder with a
_quarto.ymlfile, which Quarto uses to manage and render multiple.qmdfiles together :contentReference[oaicite:0]{index=0}. - The
_quarto.ymlfile setsproject.type: bookand lists the chapters in order underbook.chapters, such asbook: chapters: - index.qmd - 01-setup.qmd - 02-univariate.qmd - 03-correlations.qmd ``` :contentReference[oaicite:1]{index=1}.
- Install Quarto CLI from quarto.org. Make sure the version is β₯β―1.0. You can verify with:
quarto --versionEnsure Python 3.9+, Jupyter, and packages like numpy, pandas, matplotlib, seaborn are installed. Use:
pip install -r requirements.txt
# or
conda env create -f environment.yml.
βββ _quarto.yml # Quarto project config (book type + format settings)
βββ README.md # You are here
βββ index.qmd # Preface / Overview
βββ 01-setup.qmd # Data loading and cleaning
βββ 02-univariate.qmd # Single-variable stats & plots
βββ 03-correlations.qmd # Pairwise and regression analyses
βββ data/ # Data files (.csv, .tsv, Parquet, etc.)
βββ src/ # Python modules (e.g. src/eda.py)
βββ tests/ # Pytest tests for code in src/
βββ environment.yml # Optional conda env specification
- The folder acts as a Quarto project because of the _quarto.yml config file
- Every .qmd chapter renders via the book engine, producing both HTML and PDF according to the formats defined in _quarto.yml.
- To render the book, run:
quarto render- This generates HTML and PDF files in the
_sitefolder (default output location). - To view the HTML book, open
_site/index.htmlin a web browser. - To render a specific chapter, use:
quarto render 01-setup.qmd- To render all chapters, simply run
quarto renderwithout specifying a chapter. - To render to a specific format, use:
quarto render --to html- or
quarto render --to pdf