Create New Notebook

Create a new Jupyter notebook with Jupytext pairing and register it in the manuscript.

Arguments

• $ARGUMENTS

  — the notebook name and title (e.g., "notebook-02 Regression Analysis")

Steps

1. Parse the name and title from the arguments. Follow the naming convention:

   notebook-NN.ipynb

   (sequential numbering)
2. Check

   notebooks/

   for existing notebooks to determine the next number
3. Create the

   .ipynb

   file in

   notebooks/

   with:
   • The correct kernel (ask user: Python, R, or Stata)
   • A first code cell with the setup appropriate for the chosen kernel:
     • Python:

       import sys; sys.path.insert(0, ".."); from config import set_seeds, DATA_DIR; set_seeds()

     • R:

       source("../config.R"); set_seeds()

     • Stata:

       clear all

       followed by

       set seed 42

   • A markdown cell with the notebook title
4. Create the Jupytext

   .md

   pair by running:

   uv run jupytext --set-formats ipynb,md:myst notebooks/<name>.ipynb

5. Register the notebook in

   _quarto.yml

   under

   manuscript.notebooks

   :

   - notebook: notebooks/<name>.ipynb
     title: "N<number>: <title>"
   

6. Confirm the notebook renders:

   quarto render notebooks/<name>.ipynb