index.md -> readme.md; add molab links

altair/README.md

@@ -0,0 +1,27 @@
+---
+title: Learn Altair
+description: >
+    Learn the basics of Altair, a high-performance visualization library,
+    using lessons developed at the University of Washington.
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+## Notebooks
+
+- Introduction to Altair [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/01_introduction.py)
+- Data Types, Graphical Marks, and Visual Encoding Channels [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/02_marks_encoding.py)
+- Data Transformation [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/03_data_transformation.py)
+- Scales, Axes, and Legends [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/04_scales_axes_legends.py)
+- Multi-View Composition [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/05_view_composition.py)
+- Interaction [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/06_interaction.py)
+- Cartographic Visualization [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/07_cartographic.py)
+- Altair Debugging Guide [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/altair/08_debugging.py)
+
+## Acknowledgments
+
+These notebooks were created by Jeffrey Heer, Dominik Moritz, Jake VanderPlas, and Brock Craft
+as part of the [Visualization Curriculum](https://uwdata.github.io/visualization-curriculum/intro.html)
+at the University of Washington.
+Our thanks to the authors for making their work available under an open license:
+if we all share a little, we all get a lot.

bin/build.py

@@ -30,8 +30,8 @@ def transform_lessons(data: dict, root: Path, branch: str) -> dict:
             }
             for nb in course.get("notebooks", [])
         ]
-        index_md = root / course_id / "index.md"
-        post = frontmatter.load(index_md)
+        readme_md = root / course_id / "README.md"
+        post = frontmatter.load(readme_md)
         course["body_html"] = md.markdown(post.content, extensions=["fenced_code", "tables"])
     return data
 

bin/extract.py

@@ -14,9 +14,9 @@
 
 def extract_lessons(root: Path) -> dict:
     lessons = {}
-    for index_file in sorted(root.glob("*/index.md")):
-        lesson_dir = index_file.parent
-        post = frontmatter.load(index_file)
+    for readme_file in sorted(root.glob("*/README.md")):
+        lesson_dir = readme_file.parent
+        post = frontmatter.load(readme_file)
         notebooks = sorted(
             p.name
             for p in lesson_dir.glob("*.py")

duckdb/README.md

@@ -0,0 +1,26 @@
+---
+title: Learn DuckDB
+description: >
+    These notebooks teach you the basics of DuckDB,
+    a fast in-memory database engine that can interoperate
+    with dataframes, and show how marimo gives DuckDB superpowers.
+tracking: 48
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+## Notebooks
+
+- What is DuckDB? [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/duckdb/01_getting_started.py)
+- Loading Parquet files with DuckDB [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/duckdb/08_loading_parquet.py)
+- Loading JSON [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/duckdb/09_loading_json.py)
+- Working with Apache Arrow [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/duckdb/11_working_with_apache_arrow.py)
+- Loading CSVs [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/duckdb/DuckDB_Loading_CSVs.py)
+
+## Contributors
+
+Thanks to our notebook authors:
+
+* [Mustjaab](https://github.com/Mustjaab)
+* [julius383](https://github.com/julius383)
+* [thliang01](https://github.com/thliang01)

optimization/README.md

@@ -0,0 +1,34 @@
+---
+title: Learn Optimization
+description: >
+    Learn the basics of convex optimization using Python, and
+    see how to apply these ideas to vehicle control, portfolio
+    allocation in finance, and other areas.
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+After working through these notebooks, you'll understand how to create
+and solve optimization problems using Python's
+[CVXPY](https://github.com/cvxpy/cvxpy) library, as well as how to
+apply what you've learned to real-world problems.
+
+## Notebooks
+
+- Least Squares [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/01_least_squares.py)
+- Linear Program [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/02_linear_program.py)
+- Minimal Fuel Optimal Control [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/03_minimum_fuel_optimal_control.py)
+- Quadratic Program [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/04_quadratic_program.py)
+- Portfolio Optimization [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/05_portfolio_optimization.py)
+- Convex Optimization [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/06_convex_optimization.py)
+- Semidefinite Program [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/optimization/07_sdp.py)
+
+![SpaceX](https://www.debugmind.com/wp-content/uploads/2020/01/spacex-1.jpg)
+
+_SpaceX solves convex optimization problems onboard to land its rockets, using CVXGEN, a code generator for quadratic programming developed at Stephen Boyd's Stanford lab. Photo by SpaceX, licensed CC BY-NC 2.0._
+
+## Contributors
+
+Thanks to our notebook authors:
+
+* [Akshay Agrawal](https://github.com/akshayka)

polars/README.md

@@ -0,0 +1,37 @@
+---
+title: Learn Polars
+description: >
+    Learn the basics of data wrangling with a high-performance Python library
+    called Polars.
+tracking: 40
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+## Notebooks
+
+- An introduction to Polars [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/01_why_polars.py)
+- DataFrames [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/02_dataframes.py)
+- Loading Data [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/03_loading_data.py)
+- Basic operations on data [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/04_basic_operations.py)
+- Reactive Plots [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/05_reactive_plots.py)
+- Polars with Marimo's Dataframe Transformer [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/06_dataframe_transformer.py)
+- SQL Features in Marimo and Polars [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/07_querying_with_sql.py)
+- Working with Columns [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/08_working_with_columns.py)
+- Data Types [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/09_data_types.py)
+- Strings [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/10_strings.py)
+- Dealing with Missing Data [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/11_missing_data.py)
+- Aggregations [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/12_aggregations.py)
+- Window Functions [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/13_window_functions.py)
+- User-Defined Functions [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/14_user_defined_functions.py)
+- Lazy Execution [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/polars/16_lazy_execution.py)
+
+## Contributors
+
+Thanks to our notebook authors:
+
+* [Koushik Khan](https://github.com/koushikkhan)
+* [Péter Gyarmati](https://github.com/peter-gy)
+* [Joram Mutenge](https://github.com/jorammutenge)
+* [etrotta](https://github.com/etrotta)
+* [Debajyoti Das](https://github.com/debajyotid2)

probability/README.md

@@ -0,0 +1,42 @@
+---
+title: Learn Probability
+description: >
+    These marimo notebooks teach the fundamental of probability with
+    an emphasis on interactive learning and computation in Python.
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+Much of the structure and many explanations are adapted from Chris Piech's
+[Probability for Computer Scientists](https://chrispiech.github.io/probabilityForComputerScientists/en/index.html)
+course reader.
+
+## Notebooks
+
+- Sets [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/01_sets.py)
+- Axioms of Probability [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/02_axioms.py)
+- Probability of Or [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/03_probability_of_or.py)
+- Conditional Probability [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/04_conditional_probability.py)
+- Independence in Probability Theory [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/05_independence.py)
+- Probability of And [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/06_probability_of_and.py)
+- Law of Total Probability [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/07_law_of_total_probability.py)
+- Bayes' Theorem [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/08_bayes_theorem.py)
+- Random Variables [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/09_random_variables.py)
+- Probability Mass Functions [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/10_probability_mass_function.py)
+- Expectation [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/11_expectation.py)
+- Variance [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/12_variance.py)
+- Bernoulli Distribution [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/13_bernoulli_distribution.py)
+- Binomial Distribution [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/14_binomial_distribution.py)
+- Poisson Distribution [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/15_poisson_distribution.py)
+- Continuous Distributions [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/16_continuous_distribution.py)
+- Normal Distribution [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/17_normal_distribution.py)
+- Central Limit Theorem [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/18_central_limit_theorem.py)
+- Maximum Likelihood Estimation [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/19_maximum_likelihood_estimation.py)
+- Naive Bayes Classification [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/20_naive_bayes.py)
+- Logistic Regression [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/probability/21_logistic_regression.py)
+
+## Contributors
+
+Thanks to our notebook authors:
+
+* [Srihari Thyagarajan](https://github.com/Haleshot)

python/README.md

@@ -0,0 +1,27 @@
+---
+title: Learn Python
+description: >
+    These notebooks will help you learn the basics of Python
+    programming in an easy, interactive way.
+---
+
+You can open and run these notebooks in [molab](https://molab.marimo.io), marimo's free hosted notebook platform.
+
+## Notebooks
+
+- Numbers [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/01_numbers.py)
+- Strings [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/02_strings.py)
+- Collections [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/03_collections.py)
+- Conditional logic [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/04_conditional_logic.py)
+- Loops [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/05_loops.py)
+- Dictionaries [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/06_dictionaries.py)
+- Advanced Collections [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/07_advanced_collections.py)
+- Functions [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/08_functions.py)
+- Using Modules [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/09_modules.py)
+- Handling Errors [![Open in molab](https://marimo.io/molab-shield.svg)](https://molab.marimo.io/github/marimo-team/learn/blob/main/python/10_exceptions.py)
+
+## Contributors
+
+Thanks to our notebook authors:
+
+* [Srihari Thyagarajan](https://github.com/Haleshot)